# tibems_SetTraceFile

Function

## Purpose

Start or stop directing client trace information to a file.

## C Declaration

    tibems_status tibems_SetTraceFile(
        const char* fileName);

## COBOL Call

    CALL "tibems_SetTraceFile"
     USING BY REFERENCE fileName,
           RETURNING tibems-status
    END-CALL.

## Parameters

Parameter | Description
--- | ---
`fileName` | The name of the file to which tracing information should be directed, or NULL to stop directing tracing to a file.

## Remarks

This call directs client tracing information to the file specified by the `fileName` argument. This function does not generate tracing; tracing must be enabled separately. Tracing can be enabled using the `set server client_trace` command in the administration tool, or, for SSL tracing, using the tibemsSSL_SetTrace or ``tibemsSSL`_SetDebugTrace` function. See the TIBCO Enterprise Message Service User’s Guide for more information about the administration tool.

To stop sending tracing information to the file and resume regular tracing to `stderr` or `stdout`, call `tibems_SetTraceFile`, passing NULL for `fileName` parameter.

Status Code | Description
--- | ---
`TIBEMS_ILLEGAL_STATE` | Tracing information is already being directed to a file, and the fileName argument was not NULL.
`TIBEMS_IO_FAILED` | The file specified by fileName could not be opened in append mode.

Copyright © Cloud Software Group, Inc. All rights reserved.