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 :

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.