The TERMTHDACT runtime option produces a dump during program checks, abnormal terminations, or calls to the CEESGL service. You must use TERMTHDACT(DUMP) in conjunction with TRAP(ON) to generate a Language Environment dump. You can use TERMTHDACT to produce a traceback, Language Environment dump, or user address space dump when a thread ends abnormally because of an unhandled condition of severity 2 or greater. If this is the last thread in the process, the enclave goes away. A thread terminating in a non-POSIX environment is analogous to an enclave terminating because Language Environment Version 1 supports only single threads. For information on enclave termination, see z/OS Language Environment Programming Guide.
The TERMTHDACT suboptions QUIET, MSG, TRACE, DUMP, UAONLY, UATRACE, UADUMP, and UAIMM control the level of information available. Table 1 lists the suboptions, the levels of information produced, and the destination of each.
Suboption | Level of Information | Destination |
---|---|---|
QUIET | No information | No destination. |
MSG | Message | Terminal or ddname specified in MSGFILE runtime option. |
TRACE | Message and Language Environment dump containing only a traceback | Message goes to terminal or ddname specified in MSGFILE runtime option. Traceback goes to CEEDUMP file. |
DUMP | Message and complete Language Environment dump | Message goes to terminal or ddname specified in MSGFILE runtime option. Language Environment dump goes to CEEDUMP file. |
UAONLY | SYSMDUMP, SYSABEND dump, or SYSUDUMP
depending on the DD card used in the JCL in z/OS. In CICS®, a transaction dump is created.
In non-CICS you will get a system dump of your user address space
if the appropriate DD statement is used. Note: A Language Environment dump
is not generated.
|
Language Environment generates a U4039 abend which allows a system dump of the user address space to be generated. For z/OS, the system dump is written to the ddname specified; for CICS the transaction dump goes to DFHDMPA or the DFHDMPB data set. |
UATRACE | Message, Language Environment dump containing only a traceback, and a system dump of the user address space | Message goes to terminal or ddname specified in MSGFILE runtime option. Traceback goes to CEEDUMP file. Language Environment generates a U4039 abend which allows a system dump of the user address space to be generated. For z/OS, the system dump is written to the ddname specified; for CICS the transaction dump goes to DFHDMPA or the DFHDMPB data set. |
UADUMP | Message, Language Environment dump, and SYSMDUMP, SYSABEND dump, or SYSUDUMP depending on the DD card used in the JCL in z/OS. In CICS, a transaction dump is created. | Message goes to terminal or ddname specified in MSGFILE runtime option. Language Environment dump goes to CEEDUMP file. Language Environment generates a U4039 abend which allows a system dump of the user address space to be generated. For z/OS, the system dump is written to the ddname specified; for CICS the transaction dump goes to DFHDMPA or the DFHDMPB data set. |
UAIMM | Language Environment generates
a system dump of the original abend/program interrupt of the user
address space. In CICS, a transaction
dump is created. In non-CICS you will get a system dump of your user
address space if the appropriate DD statement is used. After the dump
is taken by the operating system, Language Environment condition
manager continues processing. Note: Under CICS, UAIMM yields UAONLY behavior. Under non-CICS,
TRAP(ON,NOSPIE) must be in effect. When TRAP(ON,SPIE) is in effect,
UAIMM yields UAONLY behavior. For software raised conditions or signals,
UAIMM behaves the same as UAONLY.
|
Message goes to terminal or ddname specified in MSGFILE runtime option. User address space dump goes to ddname specified for z/OS; or a CICS transaction dump goes to the DFHDMPA or DFHDMPB data set. |
Although you can modify CEE3DMP options, you cannot change options for a traceback or dump produced by TERMTHDACT.