USRHDLR (non-CICS)
USRHDLR registers a user condition handler at
stack frame 0, without requiring you to include a call to CEEHDLR in your application and
recompile.
USRHDLR has the following suboptions :
- Yes (ON) or No (OFF) : enable or disable USRHDLR
- load module name : the name of a load module
that contains the user condition handler to be registered atstack frame 0.
This option is enabled only if USRHDLR is ON. If this user condiiton handler is in effect, it is unsupported to resume execution in the program in which the condition occurs. This includes calls in the condition handler to CEEMRCR and CEEMRCE. This restriction does not apply to load module name 2
- load module name 2 : specifies a user written handler that is commonly referred to as the Super Condiiton Handler. It is invoked like handlers registered by CEEHDLR, so you can resume execution in the program in which the execution occurs.
This option is enabled only if USRHDLR is ON.
Notes :
- Alias names of load modules may be used for load module name and load module name 2.
- The user condition handler specified by the USRHDLR run-time option must be in a separate
load module rather than be link-edited with the rest of the application.
- The user condition handler specified by load module name is invoked for conditions that
are still unhandled after being presented to condition handlers for the main program.
- You can use a user condition handler registered with the USRHDLR run-time option to
return any of the result codes allowed for a user condition handler registered with the
CEEHDLR callable service.
- The loading of the user condition handlers specified prior to giving control to an application occurs only when that user condition
handler needs to be invoked the first time.
- If the load of either handler fails, an error message is issued.