Language Environment runtime options

The following Language Environment runtime options can affect your routine's exception handling behavior:

  Description of runtime option
TERMTHDACT Sets the level of information that is produced when a condition of severity 2 or greater remains unhandled within the enclave. The possible parameter settings for different levels of information are:
  • QUIET for no information
  • MSG for message only
  • TRACE for message and a traceback
  • DUMP for message, traceback, and Language Environment dump
  • UAONLY for message and a system dump of the user address space
  • UATRACE for message, Language Environment dump with traceback information only, and a system dump of the user address space
  • UADUMP for message, traceback, Language Environment dump, and system dump
  • UAIMM for a system dump of the user address space of the original abend or program interrupt prior to the Language Environment condition manager processing the condition.
TRAP(ON) Fully enables the Language Environment exception handler. This causes the Language Environment exception handler to intercept error conditions and routine interrupts.

When TRAP(ON, NOSPIE) is specified, Language Environment handles all program interrupts and abends through an ESTAE. Use this feature when you do not want Language Environment to issue an ESPIE macro.

During normal operation, you should use TRAP(ON) when running your applications.

TRAP(OFF) Disables the Language Environment condition handler from handling abends and program checks/interrupts. ESPIE is not issued with TRAP(OFF).

Specify TRAP(OFF) when you do not want Language Environment to issue an ESPIE.

When TRAP(OFF), TRAP(OFF,SPIE), or TRAP(OFF,NOSPIE) is specified and either a program interrupt or abend occurs, the user exit for termination is ignored.

TRAP(OFF) can cause several unexpected side effects. It is not supported in AMODE 64 production execution.

For further information, see the TRAP runtime option in z/OS Language Environment Programming Reference.