TERMTHDACT (CICS)
TERMTHDACT sets the level of information that is produced when an unrecoverable error
occurs. Select the information you wish to receive in each environment by enabling the
appropriate checkboxes.
The Language Environment service CEE3DMP is called for the TRACE and DUMP
suboptions of TERMTHDACT.
The following CEE3DMP options are passed for TRACE and UATRACE:
- NOENTRY CONDITION TRACEBACK THREAD(ALL) NOBLOCK NOSTORAGE NOVARIABLES
NOFILES STACKFRAME(ALL) PAGESIZE(60) FNAME(CEEDUMP)GENOPTS
The following options are passed for DUMP and UADUMP:
- THREAD(ALL) NOENTRY TRACEBACK FILES VARIABLES BLOCK STORAGE
STACKFRAME(ALL) PAGESIZE(60) FNAME(CEEDUMP) CONDITION GENOPTS
If a message is printed, based upon the TERMTHDACT(MSG) run-time option,
the message is for the active condition immediately prior to the termination
imminent step. In addition, if that active condition is a promoted
condition (was not the original condition), the original condition's
message is printed.
If the TRACE run-time option is specified with the DUMP suboption, a dump
containing the trace table, at a minimum, is produced. The contents of
the dump depend on the values set in the TERMTHDACT run-time option.
- TRACE (traceback only enabled)
- Specifies that when a thread terminates due to an unhandled condition of
severity 2 or greater, Language Environment generates a message indicating the
cause of the termination and a trace of the active routines on the activation
stack.
- MSG (no selections enabled)
- Specifies that when a thread terminates due to an unhandled condition of
severity 2 or greater, Language Environment generates a message indicating the
cause of the termination.
- DUMP (LE-formatted dump or LE-formatted dump and traceback enabled)
- Specifies that when a thread terminates due to an unhandled condition of
severity 2 or greater, Language Environment generates a message indicating the
cause of the termination, a trace of the active routines on the activation
stack, and a Language Environment dump.
- UADUMP (system dump and LE-formatted dump or all options enabled)
- Specifies that when a thread terminates due to an unhandled condition of
severity 2 or greater, Language Environment generates a message indicating the
cause of the termination, a Language Environment dump, and generates a U4039
abend which allows a system dump of the user address space to be
generated. Under non-CICS, if the appropriate DD statement is used, you
will get a system dump of your user address space. Under CICS, you will
get a CICS transaction dump.
- UATRACE (traceback and system dump enabled)
- Specifies that when a thread terminates due to an unhandled condition of
severity 2 or greater, Language Environment generates a message indicating the
cause of the termination, a trace of the active routines on the activation
stack, and generates a U4039 abend which allows a system dump of the user
address space to be generated.
- UAONLY (system dump only enabled)
- Specifies that when a thread terminates due to an unhandled condition of
severity 2 or greater, Language Environment generates a U4039 abend which
allows a system dump of the user address space to be generated. Under
non-CICS, if the appropriate DD statement is used, you will get a system dump
of your user address space. Under CICS, you will get a CICS transaction
dump.
- CESE
- Specifies that Language Environment dump output will be written to the
CESE queue.
- CICSDDS
- Specifies that Language Environment dump output will be written to the
CICS transaction dump data set that contains both CICS and CEEDUMP
data.
- reg_stor_amount
- Controls the amount of storage to be dumped around registers. This
amount can be in the range from 0 to 256 bytes. The amount specified
will be rounded up to the nearest multiple of 32. The default amount is
96 bytes.
Notes :
- z/OS UNIX System Services consideration : The TERMTHDACT option applies when a
thread
terminates abnormally. Abnormal termination of a single thread causes termination of the entire
enclave. If an
unhandled condition of severity 2 or higher percolates beyond the first routine's
stack frame,
the enclave terminates abnormally. If an enclave terminates due to a POSIX default
signal action, TERMTHDACT applies only to conditions that result from program checks or
abends.
-
All TERMTHDACT output is written to the data queue based on the setting of
CESE or CICSDDS.
See the following tables for help in understanding the results of the
different options that are available.
For program checks or ABENDs in a CICS environment:
Table 20. Condition Handling of 0Cx ABENDS
Options
| TERMTHDACT(option,CESE,)
| TERMTHDACT(option,CICSDDS,)
|
QUIET
|
- No output.
- ASRA or user ABEND issued.
|
- No output.
- ASRA or user ABEND issued.
|
MSG
|
- Message written to CESE queue or MSGFILE.
- ASRA or user ABEND issued.
|
- Message written to CESE queue or MSGFILE.
- ASRA or user ABEND issued.
|
TRACE
|
- Message written to CESE queue.
- Traceback written to CESE queue.
- ASRA or user ABEND issued.
|
- Message written to CESE or MSGFILE.
- Traceback included in CICS transaction dump for this ABEND.
- ASRA or user ABEND issued.
|
DUMP
|
- Message written to CESE queue.
- Traceback written to CESE queue.
- CEEDUMP to CESE queue.
- ASRA or user ABEND issued.
|
- Invalid sub-option combination. Not supported.
|
UATRACE
|
- Message written to CESE queue.
- Traceback written to CESE queue.
- U4039 transaction dump in CICS dump data set.
- ASRA or user ABEND issued.
|
- Message written to CESE queue.
- Traceback written to CESE queue.
- U4039 transaction dump in CICS dump data set.
- ASRA or user ABEND issued.
|
UADUMP
|
- Message written to CESE queue.
- Traceback written to CESE queue.
- CEEDUMP written to CESE queue.
- U4039 transaction dump in CICS dump data set.
- ASRA or user ABEND issued.
|
- Invalid sub-option combination. Not supported.
|
UAONLY
|
- U4039 transaction dump in CICS dump data set.
|
- Invalid sub-option combination. Not supported.
|
- Note:
- Program checks end in ASRx (most commonly ASRA) CICS abend with a CICS dump
in the dump data set. Abends end with the abend code provided on the
EXEC CICS ABEND command with a CICS dump in the dump data set if the NODUMP
option was NOT specified.
For software raised errors of severity 2 or higher in a CICS
environment:
Table 21. Handling of software raised conditions
Options
| TERMTHDACT(option,CESE,)
| TERMTHDACT(option,CICSDDS,)
|
QUIET
|
- No output.
- U4038 abend issued with CANCEL and NODUMP options.
|
- No output.
- U4038 abend issued with CANCEL and NODUMP options.
|
MSG
|
- Message written to CESE queue or MSGFILE.
- U4038 abend issued.
|
- Message written to CESE queue or MSGFILE.
- U4038 abend issued.
|
TRACE
|
- Message written to CESE queue or MSGFILE.
- Traceback written to CESE queue.
- U4038 abend issued.
|
- Message written to CESE queue or MSGFILE.
- Traceback written to CESE queue.
- U4038 abend issued.
|
DUMP
|
- Message written to CESE queue or MSGFILE.
- Traceback written to CESE queue.
- CEEDUMP written to CESE queue.
- U4038 abend issued.
|
- Invalid sub-option combination. Not supported.
|
UATRACE
|
- Message written to CESE queue or MSGFILE.
- Traceback written to CESE queue.
- U4039 transaction dump in CICS dump data set.
- U4038 abend issued.
|
- Message written to CESE queue or MSGFILE.
- Traceback written to CESE queue.
- U4039 transaction dump in CICS dump data set.
- U4038 abend issued.
|
UADUMP
|
- Message written to CESE queue or MSGFILE.
- Traceback written to CESE queue.
- CEEDUMP written to CESE queue.
- U4039 transaction dump in CICS dump data set.
- U4038 abend issued.
|
- Invalid sub-option combination. Not supported.
|
UAONLY
|
- U4039 transaction dump in CICS dump data set.
- U4038 abend issued.
|
- Invalid sub-option combination. Not supported.
|
When assembling a CEECOPT, CEEROPT, or CEEUOPT, the CICSDDS option
cannot be issued with DUMP, UADUMP, UAONLY, or UAIMM. Doing this
results in a RC=8 and the following message from CEEXOPT is issued and the
setting is forced to TRACE:
8,The TERMTHDACT level setting of DUMP
8,conflicts with the CICSDDS suboption.
8,A level of TRACE or less must be used with CICSDDS.
8,The TERMTHDACT level suboption
8,was set to TRACE.
Running with something like TERMTHDACT(TRACE,CICSDDS) in the CEECOPT
or CEEROPT and then creating a CEEUOPT without specifying the second operand
(for example, TERMTHDACT(DUMP)) results in the CICS dump data set as the
output destination and the following message occurs in the CESE queue:
CEE3627I The following messages pertain to the programmer default run-time options.
CEE3775W A conflict was detected between the TERMTHDACT suboptions CICSDDS and DUMP.
The TERMTHDACT level setting has been set to TRACE.
and the traceback is written to the CICS transaction dump data set.