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.
- 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.