Retrieve information about a system dump table entry.
INQUIRE SYSDUMPCODE >>-INQUIRE SYSDUMPCODE(data-value)------------------------------> .------------------------. V | >----+--------------------+-+---------------------------------->< +-CURRENT(data-area)-+ +-DAEOPTION(cvda)----+ +-DUMPSCOPE(cvda)----+ +-MAXIMUM(data-area)-+ +-SHUTOPTION(cvda)---+ '-SYSDUMPING(cvda)---'
Conditions: END, ILLOGIC, NOTAUTH, NOTFND
For more information about the use of CVDAs, see CICS-value data areas (CVDAs).
The INQUIRE SYSDUMPCODE command allows you to look at some of the information in a system dump code table entry.
The table entry tells CICS which actions to take when a system dump request with this code occurs, and how many times to take them (the MAXIMUM option); requests received after the maximum are counted (the CURRENT option), but are otherwise ignored.
CICS provides a system dump table with entries for some CICS-defined system dump codes. If it receives a dump request for a code for which it does not have an entry, it builds one, using default values. You can add your own entries with the SET SYSDUMPCODE command or a CEMT transaction. Entries you add remain over executions of CICS until an initial or cold start occurs, but the entries that CICS builds are considered to be temporary and are discarded at shutdown. Consequently, if you enquire about a code that is not explicitly defined before it appears in a dump request, you get a "not found" response.
You can also browse through all of the entries in the system dump code table by using the browse options (START, NEXT, and END) on INQUIRE SYSDUMPCODE commands. See Browsing resource definitions for general information about browsing, including syntax, exception conditions, and examples.
A related image is one that contains a CICS region doing work on behalf of your CICS region. Specifically, it is a region that has one or more tasks doing work under the same APPC token as a task in your region.
The sending of SDUMP requests occurs only when the table entry for this code specifies a dump (that is, the SYSDUMPING value is SYSDUMP), and only in a sysplex environment executing under MVS/ESA Version 5 or later and the MVS workload manager.
CVDA values are: