DUMPCODE attributes

Describes the syntax and attributes of the DUMPCODE resource.

DAEOPTION({NODAE|DAE})

Specifies whether a system dump produced for this dump code is eligible for suppression by the MVS™ Dump Analysis and Elimination (DAE) component.

Possible values are as follows:

DAE: The system dump is eligible for DAE suppression.
NODAE: The system dump is not eligible for DAE suppression. If CICS® determines that a dump should be taken, MVS does not suppress it.
Note: Be aware of the SUPPRESS and SUPPRESSALL options in the ADYSETxx parmlib member, which are controlled by the VRADAE and VRANODAE keys in the SDWA. These options might lead to dump suppression even though NODAE is in effect. For information about these options, see z/OS MVS Diagnosis: Tools and Service Aids.

DESCRIPTION(text)

You can provide a description of the resource that you are defining in this field. The description text can be up to 58 characters in length. There are no restrictions on the characters that you can use. However, if you use parentheses, ensure that for each left parenthesis there is a matching right parenthesis. If you use the CREATE command, for each single apostrophe in the text, code two apostrophes.

DSPLIST(data-value)

Specifies a list of data spaces to be dumped. This field contains up to 255 characters. Data space names are separated with commas. Wildcards are also supported.

To specify a data space, you must provide its owning address space name, followed by a period and the data space name.

The following example shows how to request the dumping of the data spaces of the SMSVSAM and the coupling facility:

DSPLIST(SMSVSAM.*,XCFAS.*)

DUMPACTION({TRANDUMP|SYSDUMP|BOTH|NONE})

Specifies the action to take for a DUMPCODE.

Possible values are as follows:

NONE: Neither a transaction dump nor a system dump is taken.
SYSDUMP: Take a system dump. This is the default for system DUMPCODEs.
TRANDUMP: Take a transaction dump. This is the default for transaction DUMPCODEs.
This option is not applicable to a system DUMPCODE.
BOTH: Take both a transaction dump and a system dump. This option is not applicable to a system DUMPCODE.

DUMPCODE(name)

Specifies the name of the DUMPCODE resource.

For transaction DUMPCODEs, the name can be one to four characters in length. For system DUMPCODEs, the name can be one to eight characters in length.

Acceptable characters:

A-Z a-z 0-9 $ @ # . / - _ % & ? ! : | " = ¬ , ; < >

DUMPSCOPE({LOCAL|RELATED})

Specifies whether a request for a dump with this dump code causes CICS to initiate requests for SDUMPs (system dumps) of related CICS regions.

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 DUMPACTION value of SYSDUMP or BOTH, and only in a sysplex environment.

If you specify RELATED in other systems, this causes an exception condition.

Possible values are as follows:

LOCAL: SDUMP requests are not to be sent.
RELATED: SDUMP requests are to be sent.
Note: A setting of DUMPSCOPE(RELATED) results in a single dump being taken for each affected MVS image. This dump contains the output from all the affected CICS regions in the image. For more information, see Automatic dump data capture from related CICS regions.

GROUP(groupname)

Every resource definition must have a GROUP name. The resource definition becomes a member of the group and is installed in the CICS system when the group is installed.

Acceptable characters:

A-Z 0-9 $ @ #

Any lowercase characters you enter are converted to uppercase.

The GROUP name can be up to eight characters in length. Lowercase characters are treated as uppercase characters.

JOBLIST(data-value)

Specifies a list of address spaces to be dumped. This field contains a maximum of 134 characters. Address space names are separated with commas. Wildcard characters are also supported.

You can enter up to 15 address space names. However, if the matching results exceed 15 address spaces, only the first 15 spaces are dumped.

The following example shows how to request the dumping of the SMSVSAM and coupling facility address spaces:

JOBLIST(SMSVSAM,XCFAS)

MAXIMUM(data-value)

Specifies the maximum number of dumps with this dump code that CICS can request. Use a fullword binary value in the range 0 through 999.

A value of 999 means that there is no limit. The default value is determined as follows:

For a transaction DUMPCODE, the default value is taken from the TRDUMAX system initialization parameter.
For a system DUMPCODE, the default value is taken from the SYDUMAX system initialization parameter.

After the maximum is reached, CICS counts but ignores dump requests with this dump code.

SHUTOPTION({NOSHUTDOWN|SHUTDOWN})

Specifies whether to shut down the system in response to a request for a dump with this dump code.

Possible values are as follows:

NOSHUTDOWN: Do not shut down the system.
SHUTDOWN: Shut down the system.
Note: End-of-day statistics (shutdown statistics) are not written to SMF when you specify the SHUTDOWN option, so these statistics are lost.

TYPE({TRAN|SYSTEM})

Specifies the type of the DUMPCODE resource.

Possible values are as follows:

SYSTEM: Indicates a system DUMPCODE.
TRAN: Indicates a transaction DUMPCODE.