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 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.
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.
The resource signature
You can use this command to display the resource signature fields. You can use these fields to manage resources by capturing details of when the resource was defined, installed, and last changed. For more information, see Auditing resources. The resource signature fields are CHANGEAGENT, CHANGEAGREL, CHANGETIME, CHANGEUSRID, DEFINESOURCE, DEFINETIME, INSTALLAGENT, INSTALLTIME, and INSTALLUSRID. See Summary of the resource signature field values for detailed information about the content of the resource signature fields.
Input
- 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 entercemt 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.
- (value)
- An 8-character system dump code.
- ALL
- The default.
Sample 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)
If you place the cursor against the result and press ENTER, CICS displays an expanded format, as shown in Figure 2.
I SYD
RESULT - OVERTYPE TO MODIFY
Sydumpcode(AP0001)
Sysdumping( Sysdump )
Dumpscope( Local )
Shutoption( Noshutdown )
Maximum( 010 )
Current(0000)
Action( )
Daeoption( Dae )
Joblist( )
Joblist( )
Joblist( )
Dsplist( )
Dsplist( )
Dsplist( )
Dsplist( )
Dsplist( )
Installtime(19/07/22 09:01:00)
Installuserid(userid)
Installagent(Csdapi)
Definesource(TEMP)
Definetime(19/07/22 09:02:00)
Changetime(19/07/22 09:04:00)
Changeusrid(userid)
Changeagent(Csdapi)
Changeagrel(0730)
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.
- CHANGEAGENT(value)
- Displays a value that identifies the agent that made the last change to the resource definition.
You cannot use CEMT to filter on some of these values because they are duplicated. The possible
values are as follows:
- CREATESPI
- The resource definition was last changed by an EXEC CICS CREATE command.
- CSDAPI
- The resource definition was last changed by a CEDA transaction or the programmable interface to DFHEDAP.
- CSDBATCH
- The resource definition was last changed by a DFHCSDUP job.
- DYNAMIC
- The resource was last changed by a SET SYSDUMPCODE command.
- OVERRIDE
- The resource definition was last changed by application of an override rule in the resource overrides file.
- SYSTEM
- The resource definition was last changed by CICS.
- CHANGEAGREL(value)
- Displays the 4-digit number of the CICS release that was running when the resource definition was last changed.
- CHANGETIME(date time)
- Displays the date and time when the resource definition was last changed. The format of the date depends on the value that you selected for the DATFORM system initialization parameter for your CICS region. The format of the time is hh:mm:ss.
- CHANGEUSRID(value)
- Displays the 8-character user ID that ran the change agent.
- 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.
You can reset this value by overtyping it with a different value.
- DEFINESOURCE(value)
- Displays the source of the resource definition. The DEFINESOURCE value depends on the CHANGEAGENT option. For details, see Summary of the resource signature field values.
- DEFINETIME(date time)
- Displays the date and time when the resource was created. The format of the date depends on the value that you selected for the DATFORM system initialization parameter for your CICS region. The format of the time is hh:mm:ss.
- DSPLIST(data-area)
- Returns a list of data spaces to be dumped. Data space names are separated with commas. This field contains up to 255 characters.
- DUMPSCOPE (value)
- Displays whether a
system dump request is sent to MVS images in the sysplex that
are running XCF/MRO connected CICS regions related to the CICS region on which the dump is initiated. Note: A related CICS region is one in which the unit of work identifiers, in the form of APPC tokens, of one or more tasks match those in the CICS region that issued the dump request.
- RELATED
- A system dump request is sent for this system dump code.
- LOCAL
- A system dump request is not sent to other MVS images in the sysplex for this system dump code.
You can reset this value by overtyping it with a different value.
- JOBLIST(data-area)
- Returns a list of address spaces to be dumped. Address space names are separated with commas. This field contains up to 134 characters.
- INSTALLAGENT(value)
- Displays a value that identifies the agent that installed the resource. You cannot use CEMT to
filter on some of these values because they are duplicated. The possible values are as follows:
- AUTOINSTALL
- The resource was autoinstalled.
- CREATESPI
- The resource was installed by an EXEC CICS CREATE command.
- CSDAPI
- The resource was installed by a CEDA transaction or the programmable interface to DFHEDAP.
- DYNAMIC
- The resource was installed by a SET SYSDUMPCODE ADD command.
- GRPLIST
- The resource was installed by GRPLIST INSTALL.
- SYSTEM
- The resource was installed by CICS.
- INSTALLTIME(date time)
- Displays the date and time when the resource was installed. The format of the date depends on the value that you selected for the DATFORM system initialization parameter for your CICS region. The format of the time is hh:mm:ss.
- INSTALLUSRID(value)
- Displays the 8-character user ID that installed the resource.
- MAXIMUM (value)
- Displays
the maximum number of dump calls for this system dump code that result
in system dumps being taken. The value is in the range 0 - 999 and
can be specified by using SYDUMAX in the SIT parameter. A value of
999 means the default, no limit.
You can reset this value by overtyping it with a different value.
- SHUTOPTION
- Displays
whether CICS is shut down after
an error that corresponds to this dump code occurs.
- SHUTDOWN
- CICS is shut down.
- NOSHUTDOWN
- CICS is not shut down.
You can reset this value by overtyping it with a different value.
- SYDUMPCODE (value)
- Indicates that this panel relates to a SYDUMPCODE inquiry and displays an 8-character system dump code.
- SYSDUMPING
- Displays
whether a system dump is produced for this system dump code. The values
are as follows:
- SYSDUMP
- Produce a system dump for this system dump code.
- NOSYSDUMP
- Do not produce a system dump for this system dump code.
You can reset this value by overtyping it with a different value.