Recording an express logon macro

When recording an express logon macro, Host On-Demand prompts you for the following information:

Application ID (3270 sessions only)

Enter the application ID (3270 sessions only) in the Application ID window and then click OK. This name must match the RACF PTKTDATA (Passticket Data Profile) application name that is configured on the z/OS host. This name could be the same as the application name that the user is logging on to (for example, the name on USSMSG10). When creating PTKTDATA profiles for applications such as TSO (time sharing option), the application name portion of the profile will most likely not be the same. For example, RACF requires that the application ID portion of the profile name be TSO+SID. Refer to the RACF Security Administrator's Guide to determine the correct profile naming. You can obtain this ID from the host administrator.

Screen Criteria

Select a criteria for the macro to record. This window allows you to proceed through the host screens until you reach the screen containing the information needed by the macro to complete the logon.

Is an alternate start screen

The alternate start screen is a screen from which the user might want to play the macro to logon to the application. If the application has more than one possible start screen, you should identify it during the recording process so the macro can be played from that screen. For example, the logon process might begin from the USSMSG10 screen or the application logon screen. You can start the logon macro from either the start screen or the alternate start screen. You can designate only one screen as an alternate start screen. There is no alternate start screen after the screen that contains the user ID.

Contains a user ID field

The screen contains a host user ID field. Only one screen can be identified by a user ID field.

Contains a password field

The screen contains a password field. Only one screen can be identified by a password field.

Alternate Start Screen

Specify whether this screen is an alternate start screen. The macro can start playing when a start screen is recognized or when an alternate screen is recognized. You can have only one alternate start screen and it must be after the start screen.

Wait Conditions

Specify the wait conditions for the macro to use to identify this screen. This setting causes the macro to wait during playback until it recognizes a screen according to conditions that you set. If the macro recognizes the screen within the timeout period, it continues. If it does not, it stops.

Field Count

Total number of fields on the screen.

Input-Field Count

Total number of input fields on the screen (fields that you can type in).

Wait for OIA to become Uninhibited

If checked, the OIA must become uninhibited (no data communication and you are able to enter keystrokes) before the macro continues.

Use Cursor Position

Identifies the screen by the cursor position.

Keyword

Any word that will appear on the screen and that you want the macro to recognize. You should try to choose a word that is unique to that screen.

Timeout

A value in milliseconds (for example, 10000 is 10 seconds). Until all the conditions that you define have been satisfied, the macro will wait for the time specified. If the timeout expires before all the conditions have been met, the macro will stop playing back and display a message telling you the screen on which it failed.

A value less than or equal to zero adds an indefinite wait.

If the macro consistently times out too soon, edit the macro to increase the timeout value.

If the number of fields in your host application screen varies from time to time, you will sometimes not get a match for the screen recognition. If this happens, re-record the macro without specifying either type of field count. The macro function performs automatic screen-recognition by watching the cursor position on each screen. Do not add a Wait Condition for every screen unless you are sure that the cursor is a sufficient way of recognizing a screen.

User ID Field and Location

Select whether this screen contains a user ID field for logging on.

1. Click Current to use the cursor's current position on the session screen if you know it's correct. If the current cursor position is not correct, move the cursor to the beginning of the user ID field on the session screen to identify where the user will enter the user ID and click Current. The field values change to match the new cursor position on the screen. If the initial cursor position is correct, then there is no need to move the cursor on the session screen.

   Click Current only if you will not be using this screen for mulitple applications and the location of the user ID field never changes.

2. Enter the user ID in the User ID field on this window, not on the session screen.

Row/Column

Determines the cursor position on the screen for the user ID field.

User ID

You must enter a user ID to continue recording the macro. The macro enters the actual user ID text in the user ID field on the session screen and writes a predefined text string to the macro file.

Password Field and Location

Select whether this screen contains a password field for logging on.

1. Click Current to use the cursor's current position on the session screen if it's correct. If not, move the cursor to the beginning of the Password field on the session screen to specify where the user will enter the password and click Current. The field values change to match the new cursor position on the screen. If the initial cursor position is correct then there is no need to move the cursor on the session screen.

Click Current only if you will not be using this screen for mulitple applications and the location of the password field never changes.

2. Enter the password in the Password field on this window, not on the screen.

Row/Column

Determines the cursor position on the screen for the password field.

Password

You must enter a password to continue recording the macro. The macro enters the actual password text in the password field on the session screen and writes a predefined text string to the macro file.

Mulitple Logons

Click Yes to define another logon sequence for an additional application.

Continue

Once you click Yes to log on to multiple applications, continue recording your macro. Once you reach a point in the macro that requires another User ID and password logon, click Next on the Continue window.

Auto-Start Macro

Select whether you want this macro to run automatically when the session is started. If you select Yes, the macro will start playing the next time you start this session.