VTLAPSY parameter: Difference between revisions

From m204wiki
Jump to navigation Jump to search
mNo edit summary
mNo edit summary
Line 16: Line 16:
<var>VTLAPSY</var> 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 (3270-type).  


When an IODEV=7 terminal connects to <var class="product">Model 204</var>, one of four connection
When an IODEV=7 terminal connects to <var class="product">Model 204</var>, one of four connection
Line 38: Line 38:
   
   
When an IODEV=7 terminal connects with no user data and <var>VTLAPSY</var> 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 (for example, <code>RESET VTLAPSY VT75LOGIN</code>), 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 <var>VTLAPSY</var> string and with X'00' privileges.
<code>VT75LOGIN</code> and with X'00' privileges.
   
   
<li>The <var>[[$Sir_Login]]</var> function is enabled.
<li>The <var>[[$Sir_Login]]</var> function is enabled.
   
   
<li>The <var>VTLAPSY</var> string is entered as a command.
<li><code>VT75LOGIN</code> is entered as a command.
   
   
<li>The <var>VTLAPSY</var> subsystem is expected to format a full screen and
<li>The <var>VTLAPSY</var> subsystem is expected to format a full screen and
Line 60: Line 60:
   
   
<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. Note that a <var>VTLAPSY</var> must be configured to not log
cancellation. <br>'''Note:''' A <var>VTLAPSY</var> subsystem must be configured to <i>not</i> log
a user in or out.
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>


[[Category:System parameters]]
[[Category:System parameters]]
[[Category:Parameters]]
[[Category:Parameters]]

Revision as of 19:39, 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 (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:

  1. The user is "logged in" with a User ID and account matching VT75LOGIN and with X'00' privileges.
  2. The $Sir_Login function is enabled.
  3. VT75LOGIN 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: A VTLAPSY subsystem must be configured to not log a user in or out (N settings for Log user into M204 and for Log user out of M204 in the APSY SUBSYSMGMT Operational Parameters screen).