System dump codes - SYSDUMP

The CICS system dump code (SYSDUMP) views display information about system dump codes for active CICS systems.

Supplied views

To access from the main menu, click:

CICS operations views > CICS region operations views > System dump codes

Table 1. Views in the supplied **CICS system dump codes** (SYSDUMP) view set
View	Notes
CICS system dump codes EYUSTARTSYSDUMP.ADD	Create a new system dump code. Specify the scope, the code, the maximum number of dumps allowed, whether or not you want a CICS system to shut down if it gets an error related to this code, and whether or not you want CICSPlex SM to take a system dump following an occurrence of this code.
CICS system dump codes EYUSTARTSYSDUMP.DELETE	Remove the system dump code from the dump code table.
CICS system dump codes EYUSTARTSYSDUMP.DETAIL1	Detailed information about the resource signature.
CICS system dump codes EYUSTARTSYSDUMP.DETAILED	Detailed information about a selected system dump code.
CICS system dump codes EYUSTARTSYSDUMP.RESET	Reset the number of dump calls for the system dump code to 0.
CICS system dump codes EYUSTARTSYSDUMP.SET	Display the CICS system dump code Set view.
CICS system dump codes EYUSTARTSYSDUMP.TABULAR	Tabular information about system dump codes for active CICS systems.

Actions

Table 2. Actions available for SYSDUMP views
Action	Description
ADD	Create a new system dump code. Specify the scope, the code, the maximum number of dumps allowed, whether or not you want a CICS system to shut down if it gets an error related to this code, and whether or not you want CICSPlex SM to take a system dump following an occurrence of this code.
DELETE	Remove the system dump code from the dump code table.
RESET	Reset the number of dump calls for the system dump code to 0.
SET	Display the CICS system dump code Set view.

Fields

Table 3. Fields in SYSDUMP views
Field	Attribute name	Description
Last modification agent	CHANGEAGENT	The change agent identifier that made the last modification. CSDAPI - The resource was last changed by a CEDA transaction, by the programmable interface to DFHEDAP or by an EXEC CICS CSD command. CSDBATCH - The resource was last changed by a DFHCSDUP job. DREPAPI - The resource was last changed by a CICSPlex SM BAS API command. DREPBATCH - The resource was last changed by a CICSPlex SM utility. DYNAMIC - The resource was last changed dynamically. SYSTEM - The resource was last changed by CICS. CREATESPI - The resource was last changed by an EXEC CICS CREATE command. NOTAPPLIC - This is not applicable for this resource. OVERRIDE - Resource was last changed by resource overrides.
Last modification agent release	CHANGEAGREL	The CICS release level of the agent that made the last modification to the resource definition.
Last modification time	CHANGETIME	The local date and time when the definition was last changed.
Last modification user ID	CHANGEUSRID	The user ID that made the last modification to the resource definition.
Number of dump calls since last reset	CURRENT	The number of dump calls that have been made for this system dump code since the value was last reset to 0. This value can be reset using the INITIALIZE action command. Note that it is possible for this value to be higher than the value in the System Dumps Taken field, which is reset by CICS end-of-day. If this value was initialized shortly before the end-of-day statistics reset, the number of current dumps could exceed the total number of dumps taken.
Dump analysis and elimination (DAE) option	DAEOPTION	Indicates whether a dump produced for this system dump code is eligible for suppression by the MVS dump analysis and elimination (DAE) component: DAE - The dump is eligible for DAE suppression. NODAE - The dump is not eligible for DAE suppression. If CICS determines a dump should be written, MVS will not suppress it.
Source of the resource definition	DEFINESOURCE	The source of the definition, depending on which agent made the last change.
Creation time	DEFINETIME	The local date and time when the resource definition record was created on DFHCSD or EYUDREP.
Data space name list	DSPLIST	Specifies a comma separated list of data space names that will be dumped when a dump with this dumpcode is performed. This attribute can only be modified through CEMT or the CICS System Programming Interface.
Installation agent	INSTALLAGENT	The install agent identifier that made the installation. CSDAPI - The resource was installed by a CEDA transaction, by the programmable interface to DFHEDAP or by an EXEC CICS CSD command. CREATESPI - The resource was installed by an EXEC CICS CREATE command. DYNAMIC - The resource was installed dynamically. SYSTEM - The resource was installed by CICS. GRPLIST - The resource was installed by GRPLIST INSTALL.
Installation time	INSTALLTIME	The local date and time when the definition was installed.
Installation user ID	INSTALLUSRID	The user ID that installed the resource definition.
Job name list	JOBLIST	Specifies a comma separated list of address space names that will be dumped when a dump with this dumpcode is performed. This attribute can only be modified through CEMT or the CICS System Programming Interface.
Maximum number of dumps with this code	MAXIMUM	The maximum number of dump calls for this system dump code that result in a system dump being taken. Input Values: 0 - 999 (SYSDUMP only)
Number of system dumps suppressed	SDMPSUPP	The number of system dumps requested for this system dump code (by CICS or a user) that were suppressed by one of the following: a user exit the dump table a global system dump suppression
Number of system dumps taken	SDMPTOTL	The number of system dumps taken for this system dump code since the last CICS end-of-day statistics reset. This number does not include suppressed dumps.
System dump scope type	SDUMPSCOPE	Indicates whether SDUMP requests with this system dump code are sent to other MVS images in the sysplex. The MVS images would be those that are running XCF/MRO connected CICS systems related to the CICS system that initiated the dump request: LOCAL - SDUMP requests are not sent to related CICS systems. RELATED - SDUMP requests are sent to related CICS systems. The CICS systems must be running under MVS/ESA 5.1 or later with the MVS workload manager.
Shutdown option	SHUTOPTION	Indicates whether the CICS system is to be shut down after a call to this system dump code. Input Values: SHUTDOWN, NOSHUTDOWN
System dump code	SYSDUMPCODE	Specifies the 8-character system dump code for which the system dump table entry is to be modified. A valid system dump code contains no leading or imbedded blanks.
System dump option	SYSDUMPING	Specifies whether a system dump request with this code should produce a dump. CVDA values are: NOSYSDUMP - A dump is not to be taken. SYSDUMP - A dump is to be taken. Even when SYSDUMP is specified, CICS takes a dump only if the number of requests for this code is less than the MAXIMUM and system dumps are not suppressed globally (see the DUMPING option of the INQUIRE SYSTEM command). MVS may also be allowed to suppress the dump if appropriate, depending on the DAEOPTION value.