IBM CICS Transaction Server for OS/390 SC33-1686-02 - Manual (Page 214)

CEMT SET SYDUMPCODE
CEMT SET SYDUMPCODE
Function: Change the attributes of the system dump
codes.
Description: SET SYDUMPCODE allows you to define
the entries that you require in the system dump table. You
control system dumps by creating an entry in the system
dump table for each dump code that requires a change from
the default action.
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 shut down. See the
CICS
Messages and Codes manual for information about the
system action for each message.
There are other system parameters that take priority over
your dump table entries. For example, EXEC CICS SET
SYSTEM NOSYSDUMP, or a DUMP=NO system initialization
parameter, inhibits system dumping. For more information on
using dumps, see the
CICS Problem Determination Guide.
The transaction dump command SET TRDUMPCODE can
also cause CICS to produce system dumps for the specified
transaction dump code.
The SET command allows you to:
Add a new entry to the system dump table
Remove an entry from the system dump table
Indicate whether or not you want a system dump taken
Indicate whether the system dump request is to be local
or related
Indicate whether or not you want CICS to shut down
following the dump
Set the maximum number of dumps
Reset the counter of the current number of dumps to
zero
Determine whether or not a dump produced by CICS is
eligible for any suppression by the MVS Dump Analysis
and Elimination (DAE) component.
Syntax: Press the Clear key to clear the screen. There are
two ways of commencing this transaction:
Type CEMT SET SYDUMPCODE (the minimum abbreviation is
CEMT S SYD ) with code or ALL. You get a display that
lists the current status, similar to that obtained by CEMT
INQUIRE SYDUMPCODE. You can then tab to the
highlighted or blank fields and overtype them with the
required values.
Type CEMT SET SYDUMPCODE ( CEMT S SYD ) with code or
ALL, followed by one or more attribute settings that you
wish to change. For example, to add a system dump
code:
CEMT SET SYDUMPCODE(value) ADD
To remove a system dump code:
CEMT SET SYDUMPCODE(value) REMOVE
To change the maximum count to 10:
CEMT SET SYDUMPCODE(value) MAX(1 )
Shut down CICS on occurrence of this system dump
code:
CEMT SET SYDUMPCODE(value) SHUTDOWN
Typing ? at the beginning of either the first or second line
gives a syntax prompt. Resetting the values takes effect
immediately.
─ ─ ─CEMT Set SYDumpcode ─ ─┬ ┬ ─ ─(value) ──────────
└ ┘ ─ALl─────
─ ─ ─┬ ┬ ─────────── ─ ─┬ ┬ ──────────── ──────────────
├ ┤ ─SYsdump─── ├ ┤ ─SHutdown───
└ ┘ ─NOSYsdump─ └ ┘ ─NOSHutdown─
─ ─ ─┬ ┬ ───────── ─ ─┬ ┬ ──────────────── ────────────
├ ┤ ─RELated─ └ ┘ ─ ─Maximum(value)
└ ┘ ─Local───
─ ─ ─┬ ┬ ──────── ─ ─┬ ┬ ─────── ─
├ ┤ ─RESet── ├ ┤ ─Dae───
├ ┤ ─REMove─ └ ┘ ─NODae─
└ ┘ ─ADd────
Options
( value)
specifies an 8-character system dump code. See the
CICS Messages and Codes manual for details of the
codes.
ADd
This system dump code is added to the system dump
code table.
ALl
specifies that any changes you request are made to all
resources of the specified type that you are authorized
to access.
Dae
A system dump is eligible for suppression by the DAE
component.
Local
A system dump request is not to be sent to other MVS
images in the sysplex for this system dump code.
Maximum( value)
specifies the maximum number of dump calls for this
system dump code that result in system dumps being
taken. The value must be in the range 0-999; a value of
999 means the default, ‘no limit’.
196 CICS Supplied Transactions