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.