gtpi1m3c | System Installation Support Reference |
The Dump Data user exit, CPSU, is called by system error processing.
This exit provides an interface for dumps with an associated entry control
block (ECB) that will enable a user to save dump data for on-line
processing. Both SERRC and SNAPC dumps are supported. Dump data
will be presented to the dump data user exit. Activating the dump data
user exit does not bypass normal system processing.
Input
- Dump data from system error dumps (EBXSW0 = X'00')
The data is chained in 4KB blocks in SNAPC format, parsed according to the
data name, and attached to the following chains:
- CE1CR0
- Data Name
- Content
- DCTERI
- First dump block:
- Error message
- Registers
- Program
- Prog old PSW
- LN/IA/TA
- Subsystem
- or MESSAGE
- If the dump is a duplicate dump, appended messages are dumped. No
other data is provided.
- CE1CR1
- Data Name
- Content
- ECB
- ECB all pages: (if any)
- ECB data fields
- ECB MACRO TRACE
- DECBFRAM
- Frame containing active and inactive data event control blocks
(DECBs). Zero or more occurrences possible.
- CE1CR2
- Data Name
- Content
- PROGRAM
- Program block (if any)
- D0
- Data level 0 (if any)
- D1
- Data level 1 (if any)
- D2
- Data level 2 (if any)
- ...
- ...
- DF
- Data level F (if any)
- DLIBLOCK
- Data block that is attached to the TPFDF SW00SR slot. Zero or more
occurrences possible
- DECBBLK
- Core block that is attached to a DECB. Zero or more occurrences
possible.
- CE1CR3
- Data Name
- Content
- DETAC0
- Detached data block Level 0. Zero or more occurrences possible
- DETAC1
- Detached data block Level 1. Zero or more occurrences possible
- ...
- ...
- DETACF
- Detached data block Level F. Zero or more occurrences possible
- DETACDEC
- Detached data block from a DECB. Zero or more occurrences possible
- CE1CR4
- Data Name
- Content
- C/ISTACK
- Initial C stack frame (if any)
- C/STACK
- Current C stack frame (if any)
- C/STATIC
- Current C static block (if any)
- AUTOSTOR
- Current auto storage block (if any)
- SW00SR
- Current TPFDF parameter block (if any)
- Dump data from snap dumps (EBXSW0 = X'FF')
The snap data blocks are chained to CE1CR0 and parsed using the IDSSNP
DSECT.
Programming Considerations
- The released version of CPSU contains sample code which will release the
dump data blocks and exit the ECB.
- Issuing a SNAPC dump in dump data processing will cause an infinite
loop. Use the appropriate tests to terminate the loop when coding a
SNAPC macro.
- The dump data user exit cannot be controlled independently for SERRC and
SNAPC.
- A SYSTC tag, SBDTAC, is defined for this user exit. The tag
specifies whether detached data blocks are presented. If the switch is
on, there are detached data blocks. The maximum number of detached
blocks, including both ECB data levels and DECBs, is specified by the DETDATAX
constant in CZOCP.
- You can use the IDECB DSECT to map the DECB frames that are
presented.