Configuring a Client Trace

You can configure a client to capture its communications with the host to help resolve connection problems. When the user launches the client, a temporary (trace) file is created on his or her machine. You specify the Web server to which the trace file is sent, a name for the temporary file that is created on the user's machine, and a description that is incorporated into the file.

The client creates a separate trace file for each host session. Attachmate Technical Support uses the information generated by the trace to help diagnose and resolve problems.

To configure a client trace
  1. In the MCS Selection panel, point to Products and then click Terminal Viewers.

    The Terminal Viewers tree appears.

  2. In the Terminal Viewers tree, choose a host type.

    The configuration types you can configure for the selected host type appear.

  3. If necessary, click Plus sign next to a configuration type to further expand the list of configuration types.

  4. Select a configuration type.

    The Configuration List page appears.

  5. From the Configuration List page, select a configuration and then click Properties.

  6. From the Properties page, select Trace and then click Configure.

    The Trace Properties page appears.

  7. Select Enable Trace, then complete the settings as desired:
    To
    Do this
    Send the trace file to Management and Control Services (MCS) Accept the default value for the MCS trace file directory in the URL box. (Spaces are not permitted in the URL.) The URL for Management and Control Server's default trace file directory is:

    http://server_name/mcs/logtrace

    Using the default URL, the trace file will be saved to:

    ...\mcs\data\mcs\trace

    It will also appear in the MCS Tracing facility as a trace file of type LEGACY. (Contact Attachmate Technical Support for assistance in decoding the trace file.)

    Terminal Viewers automatically names trace files as sessionname.binary, where sessionname is the name of the current client session.

    Send the trace file to a server other than MCS Type the appropriate URL. You can send trace files to any server that accepts HTTP PUT requests. However, the path and naming schemes that the server uses to save trace files depends on that server's internal rules.
    Name the temporary file that the client creates on the user's machine Type a name in the Temp File box, if desired. This temporary file stores the trace information that will be sent to a server. If left blank, the client trace utility will name the temporary file based on the URL.
    Caution If you enter a temporary file name and the file cannot be transmitted to its destination (for example, if the destination server is down), the temporary file will be saved on the client computer. If you do not enter a temporary file name and the file cannot be transmitted to its destination, the temporary file will be deleted from the client computer.
    (Optional) Include a description in the trace file In the Description box, type a description. (For example, you might type the name of the user and a brief description of the problem that corresponds to the trace file.)

  8. Click OK to save your changes, and then on the Properties page click Save.

Related Topics
Bullet Managing EXTRA! Terminal Viewers, Overview
Bullet Tracing Communications
Bullet Enabling Client Trace
  Attachmate