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 2–14.
When designing this routine, consider the following information:
  • If the exit returns a dynamic switched major node name:
    • The name must be 1–8 characters.
    • The first 3 characters must not be IST.
    • The first character must be alphabetic or national, and the remaining characters must be alphabetic, numeric, or national.
  • If the exit returns the name of a major node that already exists:
    • The major node cannot be an application major node.
    • The major node must be a dynamic switched major node.
    • The major node must be active.
  • If the exit does not return a major node name, ISTDSWMN is returned as the default name.
  • The name of the configuration services XID exit routine module should be ISTEXCCS; however, if you have written an alternate load module, use the load module name you assigned to your replacement module.
  • 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. Data is addressable in 24- or 31-bit mode. It is advisable that you use 31-bit addressing.
  • Exit routines that perform I/O must be link-edited AMODE=31 and RMODE=24.
  • This exit routine must be link-edited into the appropriate library. See Installing VTAM exit routines for more information.
  • This exit routine runs under a VTAM subtask that permits the exit to perform any necessary I/O or other processing without affecting the VTAM main task.
  • Do not use VTAM macroinstructions in this routine.
  • This exit routine operates enabled in pageable storage. The routine gains control in supervisor state with a VTAM storage key. Errors in the routine could damage VTAM or system control blocks or modules.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014