[ Previous | Next | Contents | Search ]
3270 Host Connection Program 2.1 and 1.3.3 for AIX: Guide and Reference

tlog Command

Purpose

Tests an AUTOLOG script.

Syntax

tlog SessionName

Description

The tlog command tests an AUTOLOG script with an existing emulator session to aid in debugging any problems with the logon or logoff scripts. Use the SessionName parameter to specify the session in use by the e789 HCON emulator from [a-z]. Capital letters are interpreted as lowercase letters.

The user invokes an emulator session and notes the session name from the operator information area. An emulator SHELL key is used to create a subshell, and the tlog command is invoked. The user will be prompted for the logonid string (unless specified in the session profile) and for the password string. The tlog command issues a message that testing of the logon script is to begin in 3 seconds.

This allows the user enough time to switch back to the emulator session if running in another aixterm window and observe the behavior of the logon script. By switching back and forth between the emulator session and the aixterm window running the tlog command, both the behavior of the script and any messages issued by the test program can be seen easily.

Return Values

After the logon script completes, the tlog command issues a message indicating the exit status from the script. If the status is nonzero, the test program terminates. Otherwise, a prompt is displayed requesting the user to press the Enter key to continue testing.

After the Enter key is pressed, a message is displayed indicating that testing of the logoff script is to begin in 3 seconds. The user can again observe the behavior of the script. After the logoff script completes, the exit status of the script is displayed and the test program terminates.

Files

/usr/bin/tlog Contains the tlog command.

Related Information

HCON Sessions and Session Profiles discusses HCON display and printer sessions.

HCON Host Logon Procedures introduces manual and automatic logon procedures, and discusses the AUTOLOG facility.

High-Level Language Application Programming Interface, The File Transfer Program Interface, and Using an HCON AUTOLOG Script.

Programming HCON Overview introduces the HCON programming facilities.


[ Previous | Next | Contents | Search ]