ASCBEXIT subcommand — run an ASCB exit routine

Use the ASCBEXIT subcommand to run an installation-provided ASCB exit routine.
  • Syntax
      {ASCBEXIT } { pgmname | * }
      {ASCBX    }
                    asid
                  [ AMASK(mask) ]

    -------- SETDEF-Defined Parameters -------------------------
    Note: You can override the following SETDEF parameters.
    See SETDEF subcommand — set defaults.

                  [ ACTIVE| MAIN | STORAGE          ]
                  [ DSNAME(dsname)| DATASET(dsname) ]
                  [ FILE(ddname)| DDNAME(ddname)    ]
                  [ PATH(path-name)     ]
                  [ FLAG(severity) ]
                  [ PRINT | NOPRINT ]
                  [ TERMINAL | NOTERMINAL ]
                  [ TEST | NOTEST ]
  • Parameters
    pgmname or *
    pgmname specifies the name of an installation-provided exit routine that must reside in a library available to IPCS, such as a step library, job library, or link library. For information about writing ASCB exit routines, see z/OS MVS IPCS Customization.
    * specifies that the list of installation-provided ASCB exit routines (identified in the BLSCUSER parmlib member) receives control.
    Note: The z/OS MVS™ system does not supply any ASCB exit routines.
    asid
    Specifies the address space identifier (ASID) to be passed to the exit routine. The ASID can range from 1 through 65535. You can specify the ASID in decimal, hexadecimal (X‘xxx...’), or binary (B‘bbb...’).
    AMASK(mask)
    Specifies an integer mask that ASCBEXIT is to AND to the dump addresses passed by the exit to the storage access and format service routines. Only X‘7FFFFFFF’, X‘00FFFFFF’, or the corresponding decimal or binary values will be accepted.
  • Return codes
    Code Explanation
    12 Severe error; an error condition or user request forced early end to the subcommand processing.
    16 Ending error; an error condition from a called service routine forced an early end to the subcommand processing.
    other An exit-generated return code
  • Example: Invoke an installation-provided ASCB exit.
    • Action
      COMMAND ===>  ascbexit chekascb 7
    • Result

      This command runs the installation-provided routine, CHEKASCB, and passes it ASID 7. Note that CHEKASCB must be identified in the BLSCUSER parmlib member.