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


Design requirements

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

Follow these procedures when writing this routine:
  • Use standard linkage.
  • Save registers 0–14.
Consider the following restrictions when writing this routine:
  • The name of the session authorization exit routine module must be ISTAUCAT.
  • Do not issue any SVCs if this exit routine is running in SRB mode.
  • This exit routine should use only conditional storage invocations. You can reduce the possibility of a VTAM® abend during a storage shortage by coding conditional storage invocations.
  • All data is addressable in 24-bit mode only.
  • This exit routine must be link-edited into the appropriate library. See Installing VTAM exit routines for more information.
  • The routine operates as an internal VTAM subroutine. VTAM performance might be degraded if the routine requires lengthy processing time. While this routine has control, VTAM does not process any new operator requests, session initiation requests, or session termination requests for any resource.
  • System waits, including implied waits for I/O operations, should be avoided. System waits can cause VTAM failure in some timing-dependent situations.
  • This routine operates enabled in pageable storage. Because the routine operates at VTAM's main task dispatching priority, there is a possibility of lockout if a wait requires other task action. The routine gains control in supervisor state with a VTAM storage key. Errors within the routine could cause damage to VTAM or system control blocks and modules.
  • This exit routine should not contain VTAM macroinstructions.
  • This exit routine must not modify the parameter list pointed to by register 1 (described in Table 1) or any field pointed to from the parameter list.
  • This exit routine must supply a return code to VTAM in register 15. A return code of 0 authorizes the session to be established. Any nonzero return code means that the request is not authorized. If the request is not authorized, VTAM informs the session initiator.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014