Debugging an HCON AUTOLOG Script

This procedure explains how to debug an HCON AUTOLOG script.

Prerequisite

An AUTOLOG script must be stored in your $HOME directory.

Note: The /usr/lib/hcon directory provides sample AUTOLOG scripts: SYSvm1, SYSvm2, and SYStso. The directory also contains the logform file, which shows the format of the genprof command menu.

Procedure

The tracing facility assists in debugging the AUTOLOG script by enabling you to view the result of the AUTOLOG script execution. To use the tracing facility, you must:

1. Enable the AUTOLOG script execution tracing facility either by setting the AUTOLOG trace option to yes in the session profile, or by including trace as an option in the Host Logon ID string. For example, if Alex is the user name and vm6 is the AUTOLOG node ID:

   Enter logon id:
   Alex,vm6,trace

2. Use the time-out facility to specify the maximum amount of time, in seconds, to wait for a successful event. Set the AUTOLOG Timeout parameter in the session profile or, if the logon ID is prompted, enter a , (comma) and time= Seconds following the word trace . For example:

   Enter logon id:
   Alex,vm6,trace,time=10

   where the Seconds variable (time =  10 ) indicates the number of seconds to wait for host activity.
3. Start an emulator with the e789 or xhcon command.
4. Enter an emulator subshell.
5. Use the tlog program to execute the AUTOLOG script.

As the AUTOLOG script attempts to automatically log on to the host, the tracing facility monitors the script execution. The facility prints the results of each string pattern search and the key strokes sent to the host. This enables you to monitor the results and modify the script, if necessary.