CEMT INQUIRE SYDUMPCODE

Retrieve information about the system dump code table.

Description

You can use the INQUIRE SYDUMPCODE command to see the current settings of the entries in the system dump table. Settings that begin with NO, for example NOSYSDUMP, are shown as blank.

The INQUIRE command shows the following information:

The system dump code or message identifier
Whether CICS® produces a system dump
Whether the system dump request is local or related
Whether CICS is to shut down following the dump
The current number of dumps produced
The maximum number of dumps
Whether a dump produced by CICS is eligible for suppression by the MVS™ Dump Analysis and Elimination (DAE) component.

A system dump code is the CICS message number with the DFH prefix removed. Typically, this leaves a 6-character code comprising 2 alphabetic characters and 4 numeric characters, for example AP0001. The command syntax permits up to 8 characters for the dump code and the dump codes you specify are padded with trailing spaces.

Each message has its own system default actions that you cannot necessarily override with the SET command. For example, when a serious error occurs, CICS shuts down even if you have asked for no shutdown. See CICS Messages and Codes Vol 1 for information about the system action for each message.

Other system parameters can take priority over your dump table entries. For example, an EXEC CICS SET SYSTEM DUMPING NOSYSDUMP command, or a DUMP=NO system initialization parameter, inhibits system dumping. For information on using dumps, see Using dumps in problem determination.

The INQUIRE SYDUMPCODE command returns entries that were added to the dump table by a user application program or CEMT command, and also entries that CICS added to the dump table through dump requests. Be aware that the entries that CICS added to the dump table are temporary, and they are not restored during a warm start, or during a cold or initial start. Entries added by a user application program or CEMT command are restored during a warm start, but not during a cold or initial start.

The transaction dump command SET TRDUMPCODE can also cause CICS to produce system dumps for the specified transaction dump code.

Input

Press the Clear key to clear the screen. You can start this transaction in two ways:

Type CEMT INQUIRE SYDUMPCODE (or suitable abbreviations for the keywords). The resulting display lists the current status.
Type CEMT INQUIRE SYDUMPCODE (or suitable abbreviations for the keywords), followed by the attributes that are necessary to limit the range of information that you require. For example, if you enter cemt i syd sy sh, the resulting display shows the details of only those system dump codes for which a system dump is to be produced and CICS is to be shut down.

You can tab to the highlighted or blank fields and overtype them with the required values.

(value): An 8-character system dump code. See CICS Messages and Codes Vol 1 for details of the codes.
ALL: The default.

Sample screen

Figure 1. CEMT INQUIRE SYDUMPCODE screen

  I SYD
  STATUS:  RESULTS - OVERTYPE TO MODIFY
   Syd(AP0001  ) Sys Loc     Max( 010 ) Cur(0000)     Dae
   Syd(AP0002  ) Sys Loc     Max( 999 ) Cur(0000)

Note: When a value does not apply, or is negative (the value begins with No), the fields on the screen are blank. To modify these fields, locate them by tabbing (they appear in the same sequence as in the expanded format), and overtype with input valid for that field. You might find it more convenient to use the expanded format when setting one of these values.

If you place the cursor against the result and press ENTER, CICS displays an expanded format, as shown in Figure 2.

Figure 2. The expanded display

  I SYD
  RESULT - OVERTYPE TO MODIFY
    Sydumpcode(AP0001)
    Sysdumping( Sysdump )
    Dumpscope( Local )
    Shutoption( Noshutdown )
    Maximum( 010 )
    Current(0000)
    Action(              )
    Daeoption( Dae )

CEMT INQUIRE SYDUMPCODE

Displayed fields

ACTION (input only field)

Specifies the action to take with this system dump code. The values are as follows:

RESET: The current number of calls for this dump code is reset to zero.
REMOVE: This system dump code is removed from the system dump code table.
ADD: This system dump code is added to the system dump code table.

CURRENT (value)

Displays the number of dump calls that have been made for this dump code since it was last reset.

DAEOPTION

Displays whether a dump taken for CICS is eligible for suppression by the MVS dump analysis and elimination (DAE) component. The values are as follows:

DAE: A system dump is eligible for suppression by the DAE component.
NODAE: A system dump is not suppressed by the DAE component. However, the SUPPRESS and SUPPRESSALL options in the ADYSETxx parmlib member might lead to dump suppression even though NODAE is set here. These options are controlled by the VRADAE and VRANODAE keys in the SDWA. For information about DAE, SUPPRESS, and SUPPRESSALL, see z/OS MVS Diagnosis: Tools and Service Aids.