While troubleshooting a problem in an IBM 3270 or 5250 session, technical support may request that you obtain one or more traces. Three kinds of traces can be done: host-data, command, and HLLAPI.
|
Trace File Type |
Description |
|---|---|
|
Host-data trace (*.hst) |
Captures information passed between a terminal, or printer, session and the host. This type of trace is useful when a host connection is working, but the terminal or printer session does not behave as expected. Host traces are not useful when a connection to the host cannot be established. |
|
Command trace (*.cmd) |
Captures actions within Reflection. Each action, such as clicking a button or entering text, represents an individual command. Command traces are useful in determining if commands are correct in a script, macro, or program using OLE automation. Command traces can also be used to determine which command to use when writing a script. Use a text editor to view the command trace and determine which commands are needed to accomplish the task. |
|
HLLAPI trace |
Enables you to see the HLLAPI calls the application is making, including return codes. (HLLAPI is an API specified by IBM for automating terminal tasks.) |
To generate a host-data or command trace
Open a session or create a new session.
The steps depend on your user interface mode.
|
User Interface Mode |
Steps |
|---|---|
|
Reflection Ribbon |
On the Tools ribbon, from the Tracing group, click Start Trace. |
|
Reflection Browser |
On the Reflection menu, choose Tools, Trace, and then Start Trace. |
|
TouchUx |
Tap the Wrench icon and then under Trace, select Start Trace. |
In the Start Trace dialog box, specify a name for the trace file. If you have spoken with a support technician, use your service request number as the name of your trace file.
|
For this type of trace |
Use this extension |
|---|---|
|
Host data |
.HST |
|
Command |
.CMD |
Click Save.
"Tracing started..." displays in the Reflection status bar, indicating the trace is active.
Perform the actions that reproduce the problem you want recorded in the trace.
The steps depend on your user interface mode.
|
User Interface Mode |
Steps |
|---|---|
|
The Reflection Ribbon |
On the Tools ribbon, from the Tracing group, click Stop Trace. |
|
The Reflection Browser |
On the Reflection menu, choose Tools, Trace, and then Stop Trace. |
|
TouchUx |
On the Reflection menu, tap the Wrench icon and then under Trace, select Stop Trace. |
Upload the trace file as a binary file to http://upload.attachmate.com. If the problem relates to a service request you are currently working on with a technician, include the Micro Focus service request number with the trace and let the technician know when the file is uploaded.
To generate a HLLAPI trace
Click the Windows Start button.
In the Start Search box, type win.ini and press Enter to open your Win.ini file in Notepad.
Add the following two lines to the end of the Win.ini file:
[Reflection HLLAPI] ExtTraceOn=1
In the Reflection Workspace, open a session or create a new session to connect to your IBM host.
Start the HLLAPI application.
Perform the actions that reproduce the problem you want recorded in the trace.
Close the HLLAPI application.
The trace file is automatically named HLL*.TMP, where * is a randomly generated hex number. The file is located in the PC's TEMP directory, if a TEMP directory has been defined in the System Environment settings. Otherwise, it is located in the root Windows directory.
Re-open the Win.ini file, and change the ExtTraceOn setting to zero by changing the last line of the ini file:
ExtTraceOn=0
Upload the trace file as a binary file to http://upload.attachmate.com. If the problem relates to a service request you are currently working on with a technician, include the Micro Focus service request number with the trace and let the technician know when the file is uploaded.