Creating and Testing an HCON AUTOLOG Script

This procedure explains how to create and verify and HCON AUTOLOG script.

Prerequisites

1. The appropriate adapters for HCON must be installed.
2. The HCON program and messages must be installed.
3. You must be an HCON user and have at least one session profile defined.
4. You must have a user ID on the host.

Procedure

1. Run the e789 or xhcon command. Provide a specific session profile. To start a session profile z , enter:

   e789 z or xhcon z

2. Log on to the host, then log off. Record all the events on an AUTOLOG logform file (located in the /usr/lib/hcon directory) until the final logon/logoff prompt.
3. Generate the log script by running the genprof or hconutil command. Access the menus for creating, displaying, or changing an AUTOLOG script. The log information is stored in the user's $HOME directory and resides in the log script under the name SYSNodeID. For example, in:

   SYSdanvm1

   the suffix danvm1 is equivalent to the NodeID variable.

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

4. Use the tlog program to test the AUTOLOG script. An emulator must be running to use the tlog program. To test the script, enter:

   tlog z

   If the host logon ID is not specified in the session profile, the tlog command prompts for the logon ID string and password. Otherwise, the program only prompts for the password. Enter the logon ID string in the following format:

   UserID,NodeID,trace,time=Value

   For example:

   grace,danvm1,trace,time=5

   where:

   UserID	Specifies the Host Logon ID.
   NodeID	Specifies the node ID. The node ID is the name of the AUTOLOG script (excluding the SYS prefix).
   trace	Specifies optional trace information output to the screen.
   time=Value	Specifies the optional time parameter, enabling a change to the default time to wait for the reception of a particular pattern from a host. The Value variable specifies the time, in seconds, for the AUTOLOG procedure to wait.

   If the AUTOLOG procedure cannot find the AUTOLOG script in the $HOME directory, the procedure checks the /usr/lib/hcon directory. If the AUTOLOG script is not found there, the AUTOLOG procedure displays an error message.

Example AUTOLOG Script

The following example shows an AUTOLOG script that logs on to a CMS system while passing through multiple host systems. The AUTOLOG script can be generated using either the genprof or hconutil commands.

In EVENT 1 , the system searches for TEST MVS Test ESA on the host screen. If the system finds the PROMPT , then testvm is input to the host system and entered. Control is then passed to EVENT 2 . All events are processed until the AUTOLOG procedure is complete.

NODE ID : HOSTSYSB
LOGON STARTS  :  1_   LOGOFF STARTS : 11
EVENT      PROMPT            INPUT        KEY       NEXT EVENTS
1  TEST MVS Test ESA_  testvm________  ENT(1)  2_ __ __ __ __ __
2  HOSTSYSC__________  ______________  NEW(2)  3_ __ __ __ __ __
3  HOSTSYSC__________  d  pvm________  ENT(1)  4_ __ __ __ __ __
4  PASS-THROUGH______  HOSTSYSB______  ENT(1)  5_ __ __ __ __ __
5  HOSTSYSB__________  &id___________  ______  6_ __ __ __ __ __
6  HOSTSYSB__________  &pw___________  ENT(1)  7_ __ __ __ __ __
7  VM READ___________  ______________  ENT(1)  8_ 9_ __ __ __ __
8  HOLDING___________  ______________  CLE     0_ __ __ __ __ __
9  CP READ___________  logoff________  ENT(1)  4_ __ __ __ __ __
10 __________________  ______________  ______  __ __ __ __ __ __
11 Press one of the__  logoff________  ENT(1)  12 __ __ __ __ __
12 PASS-THROUGH______  ______________  PA1___  13 __ __ __ __ __
13 PRESS ENTER KEY___  ______________  ENT(1)  14 __ __ __ __ __
14 USERID____________  ______________  NEW(2)  15 __ __ __ __ __
15 COMMAND___________  VMEXIT________  ENT(1)  0_ __ __ __ __ __