VTLAPSY parameter: Difference between revisions
Jump to navigation
Jump to search
mNo edit summary |
mNo edit summary |
||
| Line 14: | Line 14: | ||
==Description== | ==Description== | ||
VTLAPSY is a ten-character resettable User 0 parameter that if set | <var>VTLAPSY</var> 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 | to a non-blank value indicates an APSY subsystem that can be used to | ||
provide full-screen login support for IODEV=7 terminals. | provide full-screen login support for IODEV=7 terminals. | ||
When an IODEV=7 terminal connects to Model 204, one of four connection | When an IODEV=7 terminal connects to <var class="product">Model 204</var>, one of four connection | ||
states is possible: | states is possible: | ||
<ul> | <ul> | ||
<li>Terminal connection is the result of a VTAM transfer of | <li>Terminal connection is the result of a VTAM transfer of | ||
control from a different Model 204 online. A zap for | control from a different <var class="product">Model 204</var> online. A zap for <var class="product">SirMods</var> Version 7.7 | ||
allows VTAM transfer of control even when RACF is used. | allows VTAM transfer of control even when RACF is used. | ||
<li>Terminal connection request passed user data, and the X'0040' | <li>Terminal connection request passed user data, and the X'0040' | ||
bit of TERMOPT is not set. In this case the user data will be | bit of <var>TERMOPT</var> is not set. In this case the user data will be | ||
processed as a command at connect time. | processed as a command at connect time. | ||
<li>Terminal connection contains user data, and TERMOPT=X'0040' | <li>Terminal connection contains user data, and <code>TERMOPT=X'0040'</code>. | ||
In this case the user data will be prefixed with the | |||
string "LOGON " and the result will be processed as a command. | string "LOGON " and the result will be processed as a command. | ||
| Line 37: | Line 37: | ||
</ul> | </ul> | ||
When an IODEV=7 terminal connects with no user data and VTLAPSY is | When an IODEV=7 terminal connects with no user data and <var>VTLAPSY</var> is | ||
set to a non-blank value, the following processing is performed: | set to a non-blank value, the following processing is performed: | ||
<ol> | <ol> | ||
<li>The user is "logged in" with a User ID and account matching | <li>The user is "logged in" with a User ID and account matching | ||
the VTLAPSY string and | the <var>VTLAPSY</var> string and with X'00' privileges. | ||
<li>The $Sir_Login function is enabled. | <li>The <var>[[$Sir_Login]]</var> function is enabled. | ||
<li>The VTLAPSY string is entered as a command. | <li>The <var>VTLAPSY</var> string is entered as a command. | ||
<li>The VTLAPSY subsystem is expected to format a full screen and | <li>The <var>VTLAPSY</var> subsystem is expected to format a full screen and | ||
use $Sir_Login to log the user in. | use <var>$Sir_Login</var> to log the user in. | ||
<li>If command level is reached without a successful $Sir_Login | <li>If command level is reached without a successful <var>$Sir_Login</var> | ||
call, or if the VTLAPSY subsystem attempts an APSY transfer | call, or if the <var>VTLAPSY</var> subsystem attempts an APSY transfer | ||
without a successful $Sir_Login 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 $Sir_Login, | <li>If command level is reached after a successful <var>$Sir_Login</var>, | ||
then any AUTOSYS subsystem for the thread will be processed. | then any <var>AUTOSYS</var> subsystem for the thread will be processed. | ||
<li>Any environmental error in $Sir_Login will result in request | <li>Any environmental error in <var>$Sir_Login</var> will result in request | ||
cancellation. Note that a VTLAPSY must be configured to not log | cancellation. Note that a <var>VTLAPSY</var> must be configured to not log | ||
a user in or out. | a user in or out. | ||
</ol> | </ol> | ||
Revision as of 15:20, 26 May 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.
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:
- The user is "logged in" with a User ID and account matching the VTLAPSY string and with X'00' privileges.
- The $Sir_Login function is enabled.
- The VTLAPSY string is 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 that a VTLAPSY must be configured to not log a user in or out.