INQUIRE SYSDUMPCODE

Retrieve information about a system dump table entry.

Read syntax diagramSkip visual syntax diagramINQUIRE 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).

Description

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.

Browsing

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.

Options

CURRENT(data-area)
returns a fullword binary field giving the number of dump requests with this dump code made since the count was last reset. (The count is reset automatically at CICS shutdown and can be reset explicitly with a SET SYSDUMPCODE command or its CEMT equivalent.) The count includes requests that do not result in a dump because either CICS or MVS suppressed it.
DAEOPTION
returns a CVDA value identifying whether a dump produced for this dump code is eligible for subsequent suppression by the MVS Dump Analysis and Elimination (DAE) component. CVDA values are:
DAE
The dump is eligible for DAE suppression.
NODAE
The dump is not eligible for DAE suppression--if CICS determines that a dump should be written, MVS does not suppress it. (However, be aware of the SUPPRESS and SUPPRESSALL options in the ADYSETxx parmlib member. These are controlled by the VRADAE and VRANODAE keys in the SDWA. They may lead to dump suppression even though NODAE is set here. For information about DAE, SUPPRESS, and SUPPRESSALL, see the z/OS V1R4.0 MVS Diagnosis: Tools and Service Aids manual.
DUMPSCOPE(cvda)
returns a CVDA value indicating whether a request for a dump with this dump code should cause an SDUMP (system dump) request to be sent to related MVS images.

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:

LOCAL
SDUMP requests are not to be sent.
RELATED
SDUMP requests are to be sent.
MAXIMUM(data-area)
returns a fullword binary field giving the maximum number of dumps with this code that CICS will take. A value of 999 means the default, ‘no limit’.
SHUTOPTION(cvda)
returns a CVDA value indicating whether the CICS system is to be shut down after a request for a dump with this dump code. CVDA values are:
NOSHUTDOWN
The CICS system is not to be shut down.
SHUTDOWN
The CICS system is to be shut down.
SYSDUMPCODE(data-value)
specifies the 8-character system dump code about which you are inquiring. A valid code contains no leading or imbedded blanks.
SYSDUMPING(cvda)
returns a CVDA value indicating whether a dump request with this code should produce a dump or not. Even when a dump is specified, CICS will take one only when the CURRENT value is no greater than the MAXIMUM, and when system dumps are not suppressed globally (see the DUMPING option of the INQUIRE SYSTEM command on topic INQUIRE SYSTEM command options - DTRPROGRAM). MVS may also be allowed to suppress the dump if appropriate (the DAE option). CVDA values are:
NOSYSDUMP
A dump is not to be taken.
SYSDUMP
A dump is to be taken.
Note:
Dumps from the kernel domain of CICS are not subject to suppression and are taken regardless of SYSDUMPCODE value.

Conditions

END
RESP2 values:
2
There are no more resource definitions of this type.
ILLOGIC
RESP2 values:
1
You have issued a START command when a browse of this resource type is already in progress, or you have issued a NEXT or an END command when a browse of this resource type is not in progress.
NOTAUTH
RESP2 values:
100
The user associated with the issuing task is not authorized to use this command.
NOTFND
RESP2 values:
1
The named dump code cannot be found.
[[ Contents Previous Page | Next Page Index ]]