Several runtime options affect debugging in Language Environment. The TEST runtime option, for example, can be used with a debugging tool to specify the level of control in effect for the debugging tool when the routine being initialized is started. The DYNDUMP, HEAPCHK, TERMTHDACT, TRACE, and TRAP options affect exception handling. The following Language Environment runtime options affect debugging. For a more detailed discussion of these runtime options, see z/OS Language Environment Programming Reference.
Description of runtime option | |
---|---|
CEEDUMP | Specifies options to control the processing of the Language Environment® dump report. |
DYNDUMP | Provides a way to obtain IPCS readable dumps of user applications that would ordinarily be lost due to the absence of a SYSMDUMP, SYSUDUMP, or SYSABEND DD statement |
HEAPCHK | Determines whether additional heap check tests are performed. |
HEAPZONES | Activates user heap overlay toleration and checking. |
INFOMSGFILTER | Filters user specified informational
messages from stderr. Note: Affects only those messages generated
by Language Environment and
any routine that calls __le_msg_get_and_write().
Other routines that
write to stderr, such as __le_msg_write(), do not have a filtering option.
|
PROFILE | Controls the use of an optional profiler tool, which collects performance data for the running application. When this option is in effect, the profiler is loaded and the debugger cannot be loaded. If the TEST option is in effect when PROFILE is specified, the profiler tool will not be loaded. |
RPTOPTS | Causes a report to be produced which contains the runtime options in effect. See Determining runtime options in effect below. |
RPTSTG | Generates a report of the storage used by an enclave. See Controlling storage allocation. |
STORAGE | Specifies that Language Environment initializes all heap and stack storage to a user-specified value. |
TERMTHDACT | Controls response when an enclave terminates due to an unhandled condition of severity 2 or greater. |
TEST | Specifies the conditions under which a debugging tool assumes control. |
TRACE | Activates Language Environment runtime library tracing and controls the size of the trace table, the type of trace, and whether the trace table should be dumped unconditionally upon termination of the application. |
TRAP | When TRAP is set to ON, Language Environment traps routine interrupts and abends, and optionally prints trace information or invokes a user-written exception handling routine. With TRAP set to OFF, the operating system handles all interrupts and abends. You should generally set TRAP to ON, or your runtime results can be unpredictable. |