InfoConnect Desktop Help & How To > Creating Terminal Sessions > Performing a Trace > Tracing ALC, UTS, and T27 Sessions > Trace Log Options Dialog Box

Trace Log Options Dialog Box

Use this dialog box to configure session tracing for ALC, UTS, and T27 sessions. All trace information is sent to the Trace Log Library (ictracel.dll), which creates a log file and provides an optional window that displays trace information.

NOTE:Sessions which are already active when tracing is enabled will not be traced by the Trace Library.

To activate the Trace Log Library, select Enable Trace Log. Once the Trace Log Library has been enabled, it continues to operate until explicitly disabled. When InfoConnect Manager is started, the Trace Log Library is also started if it has been previously enabled.

To view the Trace Log Library window, clear Hide Trace Window. You can use the Options menu in this window to trace all sessions or certain paths or path templates.

Enable Trace Log

Select this option to enable the trace log facility for the session document. Once enabled, the Trace Log Library continues to operate until explicitly disabled. When the InfoConnect Manager is started, the Trace Log Library is also started if it has been previously enabled.

You cannot enable tracing unless you are signed on as Administrator.

Write to log file

Select this option to store trace information in a disk file in the InfoConnect application data folder This folder location is configurable using the Data Location tab during installation. The default is C:\Users\Public\Documents\Micro Focus\InfoConnect. called Trace.log. This option can be set at any time, however, only information logged after this is selected will be stored in the trace file.

Add time stamps

Select this option to add a time stamp to each entry that is logged. The time stamp will appear in front of an entry and take the form hh:mm:ss.ss. Where hh is the hour of the day (use 24 hour clock) mm is the number of minutes after the hour and ss.ss is the number of seconds after the minute (to two decimal points).

Show Xmt/Rcv buffer contents

Select this option to show the contents of data buffers that are being transmitted and received. This will generate a listing of both the hexadecimal value of each byte plus the character. The format will be 16 bytes per line.

Trace Library API calls

Select this option to show the returned results from routines that InfoConnect called in a library. The APIs that are logged are IcLibOpenChannel, IcLibOpenSession, IcLibCloseChannel, IcLibCloseSession, IcLibIdentifySession, IcLibInstall and IcLibTerminate. This option also cause the library Load and Free calls to be logged.

Trace IC_OK results

This option works in conjunction with the Trace Library API calls. If not selected, only API calls that return a result other than IC_OK will be logged.

Hide Trace Window

Select this option to prevent the Trace Window from opening every time a traced session is launched (the default).

Optional

Custom Trace File Location

Specify the path where you want log files to be saved. Enter a fully qualified path and filename. If you leave this box blank, a file called Trace.log is created in the InfoConnect application data folder This folder location is configurable using the Data Location tab during installation. The default is C:\Users\Public\Documents\Micro Focus\InfoConnect. .

Maximum File Size (MBytes)

Specify the maximum file size before the trace file splits into a new file.

Number of File Cycles

Specify the maximum number of files the trace log creates at the Maximum File Size. When this number is met, the trace log creates an additional file. When the additional file reaches the Maximum File Size, it starts to overwrite the trace files, starting with the first one created.

Related Topics