VTLAPSY parameter

From m204wiki
Revision as of 15:20, 26 May 2011 by JAL2 (talk | contribs)
Jump to navigation Jump to search

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 SirMods Version 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'. 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 with X'00' privileges.
  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.