Change an entry in the system dump table.
SET SYSDUMPCODE >>-SET SYSDUMPCODE(data-value)--+--------------+----------------> +-ACTION(cvda)-+ +-ADD----------+ +-REMOVE-------+ '-RESET--------' >--+-----------------+--+-----------------+---------------------> +-DAEOPTION(cvda)-+ +-DUMPSCOPE(cvda)-+ +-DAE-------------+ +-LOCAL-----------+ '-NODAE-----------' '-RELATED---------' >--+---------------------+--+------------------+----------------> '-MAXIMUM(data-value)-' +-SHUTOPTION(cvda)-+ +-NOSHUTDOWN-------+ '-SHUTDOWN---------' >--+------------------+---------------------------------------->< +-SYSDUMPING(cvda)-+ +-NOSYSDUMP--------+ '-SYSDUMP----------'
Conditions: DUPREC, INVREQ, IOERR, NOSPACE, NOTAUTH, NOTFND
For more information about the use of CVDAs, see CICS-value data areas (CVDAs).
The SET SYSDUMPCODE command allows you to change the system dump table entry for a particular dump code, to add a new dump code to the table, or to delete one.
The table entry tells CICS the actions to take when a system dump request with this code occurs. Possible actions include taking a system dump (an MVS SDUMP), initiating requests for SDUMPs of related CICS regions, and shutting down CICS. The table entry also indicates how many times this set of actions is to be taken (the MAXIMUM value); after the maximum is reached, requests are counted but otherwise ignored.
Table updates are recorded in the CICS global catalog and preserved over executions of CICS until an initial or cold start occurs, except in the case of temporary table entries. CICS creates a temporary entry when it receives a dump request with a code for which there is no table entry; these entries, and any changes to them, last only for the current execution of CICS. If you want to preserve changes to a temporary entry over restarts, you must remove the dump code from the table and then add it back.
For information about system dumps, see the CICS® Problem Determination Guide.
When SET SYSDUMPCODE ADD is specified, if you do not also specify DAEOPTION, it defaults to NODAE--regardless of the setting of the SIT DAE parameter.
A related CICS region is one in the same sysplex, connected by MRO/XCF and doing work on behalf of your CICS region--specifically, a region that has one or more tasks doing work under the same APPC token as a task in your region.
This propagation of SDUMP requests occurs only when the table entry for this code also specifies a SYSDUMPING value of SYSDUMP, and only in a sysplex environment executing under MVS/ESA 5.1 and the MVS workload manager.
If you specify RELATED in other systems, this causes an exception condition.
CVDA values are:
LOCAL is the default for entries you add, if you do not specify a DUMPSCOPE value.
If the SYSDUMPING option is omitted from a SET SYSDUMPCODE ADD command, SYSDUMP is assumed.