z/OS Communications Server: SNA Customization
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Operation

z/OS Communications Server: SNA Customization
SC27-3666-00

The logon-interpret routine is run synchronously in pageable storage under the control of VTAM®, not under the control of an application program. For the application program to receive the logon, this routine must validate the logon, obtain the symbolic name of the application program to receive control, and provide this name to VTAM. Otherwise, the routine specifies that the logon is not valid or that the name of the application program was not found.

Because the logon-interpret routine operates at VTAM's main task dispatching priority, there is a possibility of lockout if a wait requires another task action. The routine gets control in supervisor state with a VTAM storage key, so errors within the routine could cause damage to VTAM or to system control blocks and modules.

The logon-interpret routine must also:
  • Save and restore the contents of registers 2–14 when receiving and passing control.
  • Use reenterable code (the routine must not store anything within itself or modify itself while it has control).
  • Perform no I/O operations; an I/O request causes the routine to end abnormally.
Notes:
  • The logon message that is passed to the interpret routine is read-only, and cannot be modified.
  • For LOGON requests, VTAM again searches the interpret table—after USS translation—looking just for the specified APPLID. After USS translation, register 1 contains the address of the first byte of the APPLID.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014