Copyright © TIBCO Software Inc. All Rights Reserved

> 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 © TIBCO Software Inc. All Rights Reserved