VTLAPSY parameter: Difference between revisions
Jump to navigation
Jump to search
mNo edit summary |
mNo edit summary |
||
| Line 53: | Line 53: | ||
<li>If command level is reached without a successful <var>$Sir_Login</var> | <li>If command level is reached without a successful <var>$Sir_Login</var> | ||
call, or if the <var>VTLAPSY</var> subsystem attempts an APSY transfer | call, or if the <var>VTLAPSY</var> subsystem attempts an APSY transfer | ||
without a successful <var>$Sir_Login</var> call, a [[MSIR.0722]] non-terminal | without a successful <var>[[$Sir_Login]]</var> call, a [[MSIR.0722]] non-terminal | ||
message is issued and the terminal is disconnected. | message is issued and the terminal is disconnected. | ||
<li>If command level is reached after a successful <var>$Sir_Login</var>, | <li>If command level is reached after a successful <var>$Sir_Login</var>, | ||
then any <var>AUTOSYS</var> subsystem for the thread will be processed. | then any <var>AUTOSYS</var> subsystem for the thread will be processed. | ||
<li>Any environmental error in <var>$Sir_Login</var> will result in request | <li>Any environmental error in <var>$Sir_Login</var> will result in request | ||
cancellation. <br>'''Note:''' A <var>VTLAPSY</var> subsystem must be configured to <i>not</i> log | cancellation. <br>'''Note:''' A <var>VTLAPSY</var> subsystem must be configured to <i>not</i> log | ||
a user in or out (<code>N</code> settings for <code>Log user into M204</code> and for <code>Log user out of M204</code> in the <var>APSY SUBSYSMGMT Operational Parameters</var> screen). | a user in or out (<code>N</code> settings for <code>Log user into M204</code> and for <code>Log user out of M204</code> in the <var>APSY SUBSYSMGMT Operational Parameters</var> screen). | ||
</ol> | </ol> | ||
==Sample APSY== | |||
A sample apsy that can be used with the VTLAPSY parameter is provided by Sirius Software. The code is in the SIRIUS file, beginning with [[UL/SPF]] Version 7.7. Programs are VTLN.LOGIN and VTLN.ERROR, and the comments in VTLN.LOGIN explain how to customize the programs for the local environment. | |||
[[Category:System parameters]] | [[Category:System parameters]] | ||
[[Category:Parameters]] | [[Category:Parameters]] | ||
Revision as of 14:20, 1 June 2011
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 (3270-type).
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 (for example, RESET VTLAPSY VT75LOGIN), the following processing is performed:
- The user is "logged in" with a User ID and account matching
VT75LOGINand with X'00' privileges. - The $Sir_Login function is enabled.
VT75LOGINis entered as a command.- The VTLAPSY subsystem is expected to format a full screen and use $Sir_Login to log the user in.
- 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.
- If command level is reached after a successful $Sir_Login, then any AUTOSYS subsystem for the thread will be processed.
- Any environmental error in $Sir_Login will result in request
cancellation.
Note: A VTLAPSY subsystem must be configured to not log a user in or out (Nsettings forLog user into M204and forLog user out of M204in the APSY SUBSYSMGMT Operational Parameters screen).
Sample APSY
A sample apsy that can be used with the VTLAPSY parameter is provided by Sirius Software. The code is in the SIRIUS file, beginning with UL/SPF Version 7.7. Programs are VTLN.LOGIN and VTLN.ERROR, and the comments in VTLN.LOGIN explain how to customize the programs for the local environment.