Generating a Language Environment dump with TERMTHDACT
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 about enclave termination, see Enclave termination in z/OS Language Environment Programming Guide for 64-bit Virtual Addressing Mode.
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. |
- CONDITION
- ENCLAVE(ALL)
- FILES
- FNAME(CEEDUMP)
- GENOPTS
- NOBLOCKS
- NOENTRY
- NOSTORAGE
- STACKFRAME(ALL)
- THREAD(ALL)
- TRACEBACK
- VARIABLES
- BLOCKS
- CONDITION
- ENCLAVE(ALL)
- FILES
- FNAME(CEEDUMP)
- GENOPTS
- NOENTRY
- STACKFRAME(ALL)
- STORAGE
- THREAD(ALL)
- TRACEBACK
- VARIABLES
Although you can modify CEE3DMP options, you cannot change options for a traceback or dump produced by TERMTHDACT.