Change the status of a transaction dump.
Description
You can use the SET
TRDUMPCODE command to change entries in the transaction
dump table to request a transaction dump. You can also set the maximum
number of dumps that can be taken. See Using dumps in problem determination for
information on using dumps.
Syntax
Press the Clear key to clear the
screen. You can start this transaction in two ways:
- Type CEMT SET TRDUMPCODE (or suitable abbreviations
for the keywords), followed by (value) or
ALL. The resulting display lists the current status, similar to that
obtained by using the CEMT INQUIRE TRDUMPCODE command.
You can tab to the highlighted or blank fields and overtype them with
the required values.
- Type CEMT SET TRDUMPCODE (or suitable abbreviations
for the keywords), followed by one or more attribute settings that
you want to change. For example, cemt s trd(value)
t sh specifies that a transaction dump is produced for the
named transaction dump code and that the CICS® system shuts down after an error that corresponds
to this dump code occurs.
Typing ? at the beginning of either the first or second
line gives a syntax prompt. Resetting the values takes effect immediately.
CEMT SET TRDUMPCODE
>>-CEMT SET TRDUMPCODE--+-(value)-+--+------------+------------->
'-ALL-----' +-TRANDUMP---+
'-NOTRANDUMP-'
>--+-----------+--+------------+--+---------+------------------->
+-SYSDUMP---+ +-SHUTDOWN---+ +-RELATED-+
'-NOSYSDUMP-' '-NOSHUTDOWN-' '-LOCAL---'
>--+----------------+--+--------+------------------------------><
'-MAXIMUM(value)-' +-RESET--+
+-REMOVE-+
'-ADD----'
Options
- (value)
- Specifies
a 4-byte transaction dump code. See CICS Messages and Codes Vol 1 for
a list of transaction dump codes.
- ADD
- Add
the specified transaction dump code to the 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.
- LOCAL
- Do
not send a system dump request to other 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.
- MAXIMUM (value)
- Specifies
the largest number of dump calls for this dump code that result in
dumps being taken. The range is 0 - 999, although a value of 999 means
no limit.
- NOSHUTDOWN
- Do
not shut down the CICS system.
- NOSYSDUMP
- Do
not produce a system dump.
- NOTRANDUMP
- Do
not produce a transaction dump.
- RELATED
- Send
a system dump request 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.
- REMOVE
- Remove
this code from the dump code table.
- RESET
- Reset
the current count of dump calls for this dump code to zero.
- SHUTDOWN
- Shut
down the CICS system an error
that corresponds to this dump code occurs.
- SYSDUMP
- Produce
a system dump.
- TRANDUMP
- Produce
a transaction dump.