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 TLS tracing, using the
tibemsSSL_SetTrace or
function.
tibemsSSL
_SetDebugTrace
See the TIBCO Enterprise Message Service User 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. |