[TIBCO.EMS .NET client library 5.1 documentation]

Use this method to instruct the TIBCO EMS Client library to direct the tracing, that would normally go to stderr or stdout, to a file named fileName.

Namespace:  TIBCO.EMS
Assembly:  TIBCO.EMS (in TIBCO.EMS.dll)

Syntax

public static void SetTraceFile(
	string fileName
)
Public Shared Sub SetTraceFile ( _
	fileName As String _
)
public:
static void SetTraceFile(
	String^ fileName
)

Parameters

fileName
Type: System..::.String
the name of the TIBCO EMS Client trace file for this application, or null to stop directing tracing to the file.

Remarks

This call alone does not generate tracing, that is, the tracing still needs to be enabled as usual: from the admin tool and/or with the ssl trace parameter in order to trace SSL connections' handshake.

The trace file is opened in append mode. An IOException will be thrown if the file can not be opened, and the tracing will be directed to stderr or stdout based on the connection's tracing setting (check the admin command set server client_trace for more details).

Since there is only one trace file allowed, an InvalidOperationException will be thrown if this method is called with a non null file name after a trace file has already been set.

Pass null to this method to instruct the TIBCO EMS Client library to stop directing tracing to the file. Normal tracing (stderr or stdout) will then resume.

Exceptions

ExceptionCondition
System..::.InvalidOperationException if this method is called twice with a non null fileName.
System.IO..::.IOException if an error occurs while opening/creating the file.

See Also