genprof Command

3270 Host Connection Program 2.1 and 1.3.3 for AIX: Guide and Reference

genprof Command

Purpose

Generates an automatic logon/logoff profile for an AUTOLOG procedure.

Syntax

genprof

Description

The genprof command generates an input file for the AUTOLOG procedure. The genprof command prompts the user for information on logon/logoff events through a sequence of menus. When invoked, the genprof command displays the following menu:

HCON API AUTOMATIC LOGON / LOGOFF PROCEDURE

Type the number for the desired function and press the Enter key:

1       Create a new automatic logon/logoff information file.
2       Display an existing logon/logoff information file.
3       Change an existing logon/logoff information file.
4       Exit.

The genprof command menus also display the following fields:

NODE ID:________________________

LOGON STARTS:____         LOGOFF STARTS:____

EVENT  PROMPT     INPUT         KEY      NEXT EVENTS

1   ___________   ___________   _____    __ __ __ __ __ __

2   ___________   ___________   _____    __ __ __ __ __ __
.
.

These fields are defined as:

NODE ID

Used for naming the AUTOLOG procedure. The procedure is stored in the $HOME directory as SYSnode_id. The node name represents the node that will be used to log on.

LOGON STARTS

Event number of the first logon event.

LOGOFF STARTS

Event number of the first logoff event.

EVENT

Designates the AUTOLOG procedure event number. An event is defined as a single unit consisting of a search pattern, a command, and a key.

PROMPT

Specifies a unique pattern to search for in the presentation space. The following special characters may be used:

?	Represents an arbitrary character. This character matches any one character.
*	Represents a wildcard character. This character matches any sequence of characters.

\	Represents an escape character. The backslash can be used as a character by specifying two backslashes (\\). The \ does not work for an asterisk. This is a special character for which a DOUBLE backslash is required. To search for "**", you must enter "\\\\\\".

INPUT

Keystrokes to send to the host if the PROMPT field is found. The host ID and password can be passed on to the host system by using variables &id and &pw in this field. The logon ID and password are input at the beginning of the AUTOLOG procedure.

KEY

Name of the key to be sent to the emulator following the INPUT string. The following is a list of valid key names:

Key Name	Function
NEW (n)	Sends n NEWLINEs to the screen.
ENT (n)	Sends n ENTERs to the host.
CLE (n)	Sends n CLEARs to the host.
RES (n)	Sends n RESETs to the screen.
PAx	(where x = 1,2,3) PA1-PA3
PFx	(where x = 1...12) PF1-PF12
ATN	ATTN
REQ	SYSREQ
TAB (n)	Sends n TABs to the host.
CUP (n)	Sends n cursor up s to the screen.
CDN (n)	Sends n cursor down s to the screen.
CRT (n)	Sends n cursor right s to the screen.
CLT (n)	Sends n cursor left s to the screen.

The ENTER, CLEAR, NEWLINE and RESET functions may be repeated by using KeyName(x), where x is the number of repetitions in the range of 1 through 9, or ' r' , which causes the key to be repeated until the PROMPT string no longer appears on the screen.

NEXT EVENTS

List of next events. The first field indicates the next event to be processed if the PROMPT is found in the presentation space. Subsequent fields indicate which event should be processed if the PROMPT is not found in the presentation space. The following values are valid for the NEXT EVENT field:

-2	Directs AUTOLOG to exit. The current event number will be returned as the error.
-1	Return to the calling event.
0	End of logon or logoff script.
Number	Event number of the event to process.

Once the user supplies and saves the menu information and exits the menu, the genprof command performs the following tasks:

Creates the AUTOLOG procedure.
Outputs the procedure as a file named with a SYS prefix followed by the node ID specified in the menu.
Places the SYSxxx file in the users $HOME directory.

The genprof command generates the following output:

AUTOLOG script:
            /$HOME/SYSnode_id

Cursor Movement

The genprof command allow the use of arrow keys and function keys to enter and edit menu information. The following list describes the types of cursor movement:

The cursor can be moved without destroying data by using the arrow keys. The arrow keys move the cursor left and right, one character at a time, and up or down, one line at a time.
The Tab and BackTab keys move the cursor forward and backward by fields.
The Enter or Return keys position the cursor at the beginning of the next line on the genprof menu.

Attention: The Backspace key is destructive. On the DEC VT220 or VT100, do not use the Backspace key unless you have done an stty erase. The Backspace key halts operation of the genprof command. Use Ctrl-H instead.

The initial genprof Add/Change menu contains four options: add, display, change, and exit. The following function keys work within the Add/Change menu:

F1	Exit and save entries made in the menu.
F3	Quit without saving entries. F3 also works within the Create/Change menu.
F7	Move backward to a previous menu page.
F8	Move forward to the next menu page.
F9	Insert a line in the menu.
F10	Delete a specified line in the menu.

Examples

An example of an output file generated by the genprof command is:

/home/henry/SYShotspur

where /home/henry is the home directory and hotspur is the node ID.

Files

/usr/bin/genprof

Contains the genprof command.

Related Information

The tlog command.

The File Transfer Program Interface.

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

Programming HCON Overview introduces the HCON programming facilities.

[ Previous | Next | Contents | Search ]