Troubleshooting Tracing


The Design Tool provides the following types of tracing to aid you in the modeling process:

Host Emulator Recordings

Host Emulator recordings capture negotiations between entities in your model and can capture the data sent to the host at the transport level. When you use the Host Emulator, these files can be played back to simulate the host environment without having a direct connection to the host. This feature is helpful if you plan to use the Host Emulator as a model testing tool during production and for offsite model development.

To create trace (.trc) files for the Host Emulator

  1. On the Connection menu, point to Host Emulator Recording and choose Start. You must start the recording before you make the host connection.
  2. Choose the file seed name and location for the recording. Recordings are saved, by default, in <My Documents>\Micro Focus\Verastream\HostIntegrator\recordings. The file is saved with a .trc or .trc_GROOMED extension.
  3. Click Trace. For every new session a new recording file is created.
  4. Step through your model entities including any login and logout command lists. This records all the data traffic with the host.
  5. Click Stop to terminate the recording. The trace file is groomed automatically, which makes it suitable to be played back immediately.

Recordings are played back using the options in the Administrative Console. You can disable automatic grooming using the View Settings option available from the Settings menu.

Datastream Tracing

Datastream tracing interprets 3270 and 5250 datastreams by capturing data transmissions to and from the host during a live connection. Tracing is intended primarily for diagnostic purposes. Use the model debug messages feature for more options on interpreting the datastream.

To create a datastream trace (.hst file)

  1. On the Connection menu, point Datastream Trace, and select Start Trace.
  2. Type a name in the File name box and click Trace. By default, the .hst file is saved in the \<VHI install directory>\etc\tracing folder.
  3. Navigate through the entities in question, and select Stop Trace.

To play back the datastream trace

  1. On the Connection menu, point to Datastream Trace, and select Play Back Trace.
  2. Select the .hst file and click Play.

The trace navigation displays on the Terminal window, which enables you to see the sequencing of host writes to the terminal screen to track navigation in offline mode.

Playing back a trace does not redisplay the user's input and does not require a live host connection.

Debug Tracing

Debug tracing is a more intricate form of configuration tracing that is used to help debug the product. This form of tracing should only be used if the other forms of tracing have failed. Make sure to contact a technical support representative before proceeding with a debug trace. A trace configuration file (.cfgtrc file) and an actual trace file (.trace file) results from a debug trace.

Some reasons to create a debug trace:

 

Related Topics
Bullet Using nonprintable characters