Exit XDUREQC
Exit XDUREQC is invoked immediately after a system or transaction dump has been taken, or has failed or been suppressed.
Exit-specific parameters
- UEPTRANID
- Address of the 4-byte transaction ID.
- UEPUSER
- Address of the 8-byte user ID.
- UEPTERM
- Address of the 4-byte terminal ID.
- UEPPROG
- Address of the 8-byte application program name.
- UEPDUMPC
- Address of copy of the 8-byte dump code.
- UEPABCDE
- Address of a copy of the 8-byte Kernel error code in the format xxx/yyyy. xxx denotes the
3-digit hexadecimal MVS
completion code (for example X'0C1' or X'D37'). If an MVS completion code is not applicable,
xxx is three hyphens. The 4-digit code yyyy is a user abend code produced either by CICS® or by another
product on your system. UEPABCDE is completed only for abend codes corresponding to the following
dump codes:
- AP0001
- SR0001
- ASRA
- ASRB
- ASRD
Otherwise this field contains null characters.
- UEPDUMPT
- Address of the 1-byte dump-type identifier, which contains one of the following values:
- UEPDTRAN
- A transaction dump was requested.
- UEPDSYST
- A system dump was requested.
Note: The dump-type identifier indicates the type of dump request that was passed to the dump domain. It does not reflect any modification that may have been made to the original request by a user entry in the dump table. - UEPXDSCP
- Address of a 1-byte field indicating the current dump table DUMPSCOPE setting. It contains one
of the following values:
- UEPXDLOC
- A system dump will be taken on the local MVS image only.
- UEPXDREL
- System dumps will be taken on both the local MVS image, and on related MVS images within the sysplex.
This field may be modified by the exit to update the dump table DUMPSCOPE setting.
- UEPXDTXN
- Address of a 1-byte field indicating the current dump table TRANDUMP setting. It contains one of
the following values:
- UEPXDYES
- A transaction dump will be taken.
- UEPXDNO
- A transaction dump will not be taken.
This field may be modified by the exit to update the dump table TRANDUMP setting.
Note: This field is only valid if UEPDUMPT contains the value UEPDTRAN. - UEPXDSYS
- Address of a 1-byte field indicating the current dump table SYSDUMP setting. It contains one of
the following values:
- UEPXDYES
- A system dump will be taken.
- UEPXDNO
- A system dump will not be taken.
This field may be modified by the exit to update the dump table SYSDUMP setting.
- UEPXDTRM
- Address of a 1-byte field indicating the current dump table SHUTDOWN setting. It contains one of
the following values:
- UEPXDYES
- The CICS system is to shutdown.
- UEPXDNO
- The CICS system is not to shutdown.
This field may be modified by the exit to update the dump table SHUTDOWN setting.
- UEPXDMAX
- Address of a 4-byte field which contains the current dump table MAXIMUM setting. This field may be modified by the exit to change the current dump table MAXIMUM setting.
- UEPDXDCNT
- Address of a 4-byte field which contains the current dump table CURRENT setting.
- UEPXDTST
- Address of a 16-byte field which contains the current dump table statistics for this dumpcode.
The addressed field consists of four 4-byte fields containing binary integers:
- Number of transaction dumps taken
- Number of transaction dumps suppressed
- Number of system dumps taken
- Number of system dumps suppressed.
Note: Statistics for transactions dumps are valid only if UEPDUMPT contains the value UEPDTRAN. - UEPXDDAE
- Address of a 1-byte field which represents the current dump table DAEOPTION setting. It contains
one of the following values:
- UEPXDYES
- The dump was suppressed by DAE.
- UEPXDNO
- The dump was not suppressed by DAE.
This field may be modified by the exit to update the dump table DAEOPTION setting.
- UEPDMPID
- Address of a 9-character field in the format xxxx/xxxx, containing the dump identifier. The dump ID is the same as that output by the corresponding dump message.
- UEPDRESP
- Address of the 2-byte dump response code.
- UEPDREAS
- Address of the 2-byte dump reason code.
- UEPDLISO
- Address of the 4-byte DSPLIST.
- UEPJLISO
- Address of the 4-byte JOBLIST.
Return codes
- UERCNORM
- Continue processing.
XPI calls
WAIT_MVS can be used only when a UEPDUMPT indicates that a transaction dump is being taken. Do not use any other calls.
API and SPI calls
None can be used.