Registering user-written condition handlers using USRHDLR

Use the USRHDLR runtime option to register a user-written condition handler to run at one of the following times (or both):
  • At stack frame 0 – the condition handler specified as lmname (see syntax below) is invoked after the default HLL condition handler for the main program, but before the HLL condition handler for stack frame 0. The condition percolated or promoted by this user-written condition handler is not passed to any other condition handler.
  • The condition handler specified as lmname2 is given control after each condition completes the enablement phase, but before any other registered user condition handler is given control.
Read syntax diagramSkip visual syntax diagram
Syntax

   .-NOUsrhdlr-.                                     
>>-+-USrhdlr---+--(--+--------+--+------------+--)-------------><
                     '-lmname-'  '-,--lmname2-'      
NOUsrhdlr
Specifies that no user-written condition handler is registered.
USrhdlr
Specifies that a user-written condition handler is registered.
lmname
The entry point name or alias name of a load module that contains the user-written condition handler to be registered at stack frame 0.
lmname2
The entry point name or alias name of a load module that contains the user-written condition handler to be registered to get control after the enablement phase and before any other condition handler.

The condition handlers registered by the USRHDLR runtime option can return any of the result codes allowed for a condition handler registered with the CEEHDLR callable service.

For more information about using the USRHDLR runtime option, see z/OS Language Environment Programming Reference.

Parent topic: Coding a user-written condition handler