Collapse All Expand All

.NET Framework Class Library
Tibems Class See Also

[TIBCO.EMS .NET client library 6.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

Exception | Condition
--- | ---
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

Tibems Class
TIBCO.EMS Namespace