Functional description

The logon pre-prompt exit routine initially receives control after the logon processor receives a LOGON command from a terminal user and before:

The logon processor accesses the UADS or the RACF® data base to verify logon information, and
Displays the full-screen logon panel, if your installation uses full-screen logon processing, or
Prompts the user for information in addition to the user ID, if your installation does not use full-screen logon.

Note: For more information about defining users in the RACF data base rather than in the UADS, see Maintaining the UADS, RACF data base, and broadcast data set.

You can write a logon pre-prompt exit to verify, change, or supply various logon operands and system characteristics. The exit can display a message at the user's terminal, request a response, and for full-screen logon, display your own logon panel instead of the default panel. You cannot change the TSO/E full-screen logon panel, but you can use the exit to display your own panel. The exit can also cancel a logon request to prevent a user from logging on.

The following highlights some ways you can use the logon pre-prompt exits. For more information, see Possible uses.

Supply information for the LOGON command, such as user ID, password, procedure name, account number, region size, and performance group.
Supply system attributes and user attributes for the protected step control block (PSCB), the generic unit name, and default SYSOUT destination. The user attributes can include authorization for the ACCOUNT, CONSOLE, and OPERATOR commands.
Provide your own JCL statements instead of the standard JOB and EXEC statements that the logon processor builds.
Validate the logon information that users specify.
Display your own logon panel.
Prevent users from logging on.
Change logon processing depending on whether a user was disconnected or logged off from a previous TSO/E session.
For IKJEFLD1 only:
- Supply a TSO/E user command to be executed at the start of the user's session.
- Supply job and SYSOUT classes.
- Supply a security label (SECLABEL) for the session, if you have RACF installed and you use security label checking at your installation.
- Set up the console profile for the user.
- Specify primary and secondary languages to be used for displaying translated information.
- Perform RACF processing and instruct logon processing not to issue a RACF RACINIT command.
- Supply the relative block address (RBA) of the user's mail directory entry in the broadcast data set.
- Supply a 4-byte user word for information to be used by the other logoff and logon exits.