Troubleshooting Tracing

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

Host Emulator Tracing

Host Emulator tracing captures negotiations between entities in your model and captures the data sent to the host at the transport level. When you use the Host Emulator, these .hetrace files are 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 .hetrace files for the Host Emulator:

  1. On the Connection menu, point to Host Emulator Recording and make sure a check displays in front of Enable.
  2. Create all of your entity definitions including any login and logout command lists.
  3. Identify a Host Emulator first entity on the Model Properties dialog box. Configuring a first entity allows the Host Emulator to navigate back to this entity each time an error occurs.
  4. Click Save on the File menu and select the Save Host Emulator navigation file check box to create a navigation file (.nav file) for the Host Emulator.

Tip: On the Connection menu, point to Host Emulator Recording, and then click Screen Traces Status to check whether or not all operations in your model have been traced.

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.

Note: 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.

The following provides some possible reasons to create a debug trace:

Note: A trace configuration file (.cfgtrc file) and an actual trace file (.trace file) results from a debug trace.