CEMT SET TRDUMPCODE
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.
Options
- (value)
- Specifies a 4-byte transaction dump code.
- 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.