VTLAPSY parameter

Summary

Default value

null string

Parameter type

System

Where set

User 0 CCAIN parameters

Related products

All

Introduced

Sirius Mods 7.9

Description

VTLAPSY is a ten-character resettable User 0 parameter that if set to a non-blank value indicates an APSY subsystem that can be used to provide full-screen login support for IODEV=7 terminals.

When an IODEV=7 terminal connects to Model 204, one of four connection states is possible:

• Terminal connection is the result of a VTAM transfer of control from a different Model 204 online. A zap for Mods 7.7 allows VTAM transfer of control even when RACF is used.
• Terminal connection request passed user data, and the X'0040' bit of TERMOPT is not set. In this case the user data will be processed as a command at connect time.
• Terminal connection contains user data, and TERMOPT=X'0040' bit is on. In this case the user data will be prefixed with the string "LOGON " and the result will be processed as a command.
• Terminal connection contains no user data (the typical case).

When an IODEV=7 terminal connects with no user data and VTLAPSY is set to a non-blank value, the following processing is performed:

1. The user is "logged in" with a User ID and account matching the VTLAPSY string and privileges of X'00'.
2. The $Sir_Login function is enabled.
3. The VTLAPSY string is entered as a command.
4. The VTLAPSY subsystem is expected to format a full screen and use $Sir_Login to log the user in.
5. If command level is reached without a successful $Sir_Login call, or if the VTLAPSY subsystem attempts an APSY transfer without a successful $Sir_Login call, a MSIR.0722 non-terminal message is issued and the terminal is disconnected.
6. If command level is reached after a successful $Sir_Login, then any AUTOSYS subsystem for the thread will be processed.
7. Any environmental error in $Sir_Login will result in request cancellation. Note that a VTLAPSY must be configured to not log a user in or out.