TRAPLIST subcommand — list the status of IPCS traps

Use the TRAPLIST subcommand to display the status of IPCS-supplied traps.

If you write your own installation exit and use one of the exit service routines, which are described in z/OS MVS IPCS Customization, use the TRAPON, TRAPOFF, and TRAPLIST subcommands to obtain diagnostic input and output information. You can also use these subcommands to set traps when executing IPCS code that uses the exit service routines.
  • Related subcommands
    • TRAPON
    • TRAPOFF
    • GO
  • Syntax
        TRAPLIST  { ALL         }
                  { code        }
                  { (code-list) }
  • Parameters
    ALL
    code
    code-list
    Identifies the IPCS-supplied traps whose status is to be displayed. ALL specifies all IPCS-supplied traps. All is the default; if you do not specify any codes, IPCS displays the status of all traps.

    code specifies a code that identifies an IPCS-supplied exit service routine.

    code-list specifies a list of codes. When you specify a list, separate the list members with commas and enclose the list in parentheses. Otherwise, parentheses are optional.

    The codes are:
    Code
    Exit Service Routine
    ACC
    Storage access service
    ADS
    Add symptom service
    CBF
    Control block formatter service
    CBS
    Control block status service
    CQE
    Contention queue element create service
    CSI
    CSVINFO macro
    ECT
    ECT exit service
    EQS
    Equate symbol service
    FMT
    Format model processor service
    GTS
    Get symbol service
    MAP
    Map service
    NAM
    Name service
    NDX
    Table of contents service
    NTK
    NAME/TOKEN lookup service
    PRT
    Standard print service
    PR2
    Expanded print service
    SEL
    Select ASID service
    SYM
    Symbol service
    WHS
    WHERE service
  • Return Codes

    See Standard subcommand return codes for a description of the return codes produced by the TRAPLIST subcommand.

  • Example 1: List the traps and the options associated with all the exit service routines.
    • Action
      COMMAND ===> traplist all
    • Result

      TRAPLIST generates the following output, after the TRAPON ALL INPUT OUTPUT subcommand activated all the trap options for each of the exit service routines.

       ACC   INPUT(ABDPL PARMS STOP) OUTPUT(RETC DATA PARMS STOP ERROR)
       ADS   INPUT(ABDPL PARMS STOP) OUTPUT(RETC PARMS STOP ERROR)
       CBF   INPUT(ABDPL PARMS STOP) OUTPUT(RETC PARMS STOP ERROR)
       CBS   INPUT(ABDPL PARMS STOP) OUTPUT(RETC PARMS STOP ERROR)
       CQE   INPUT(ABDPL PARMS STOP) OUTPUT(RETC PARMS STOP ERROR)
       CSI   INPUT(ABDPL PARMS STOP) OUTPUT(RETC PARMS STOP ERROR)
       ECT   INPUT(ABDPL PARMS STOP) OUTPUT(RETC PARMS STOP ERROR)
       EQS   INPUT(ABDPL PARMS STOP) OUTPUT(RETC PARMS STOP ERROR)
       FMT   INPUT(ABDPL PARMS DATA STOP) OUTPUT(RETC PARMS STOP ERROR)
       GTS   INPUT(ABDPL PARMS STOP) OUTPUT(RETC PARMS STOP ERROR)
       MAP   INPUT(ABDPL PARMS STOP) OUTPUT(RETC PARMS STOP ERROR)
       NAM   INPUT(ABDPL PARMS STOP) OUTPUT(RETC PARMS STOP ERROR)
       NDX   INPUT(ABDPL STOP) OUTPUT(RETC STOP )
       NTK   INPUT(ABDPL STOP) OUTPUT(RETC STOP )
       PRT   INPUT(ABDPL STOP) OUTPUT(RETC STOP )
       PR2   INPUT(ABDPL PARMS STOP) OUTPUT(RETC PARMS STOP ERROR)
       SEL   INPUT(ABDPL PARMS STOP) OUTPUT(RETC DATA PARMS STOP ERROR)
       SYM   INPUT(ABDPL PARMS STOP) OUTPUT(RETC PARMS STOP ERROR)
       WHS   INPUT(ABDPL PARMS STOP) OUTPUT(RETC PARMS STOP ERROR)
  • Example 2: List the trap options associated with the storage access service.
    • Action
      COMMAND ===> traplist acc
    • Result

      TRAPLIST generates the following output line, after the TRAPON ACC subcommand activated the trap options for the storage access service.

      ACC INPUT(ABDPL PARM STOP) OUTPUT(RETC PARM DATA STOP ERROR)