tibems_SetTraceFile

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.

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.

Contents