Version 4.2.6 for Mainframes
 —  Utilities  —

Batch Condition Codes and User Exit Routines

This section describes the condition codes returned for Object Handler functions in batch mode and the user exit routines available for function processing.


Condition Codes Returned in Batch

Object Handler processing in batch mode terminates with one of the following condition codes:

Condition Code Explanation
0 Object Handler process terminated successfully.
30 An internal Object Handler error occurred.
40 An error was detected in the Object Handler command.
50 An error occurred during Object Handler processing.
60 A Natural Security error occurred during Object Handler processing.
99 A Natural error occurred during Object Handler processing.

Top of page

Applying User Exit Routines

The Object Handler user exit routines are supplied as source objects in the Natural system library SYSOBJH. These source objects are named SRC-EXnn, where nn denotes the number of the user exit routine.

Start of instruction set To activate a user exit routine

Top of page

User Exit Routines Available

The following user exit routines are available:

OBJHEX01 for Processing Failures

Whenever a condition code is set to a value greater than 0 (zero) in batch mode, the user exit routine OBJHEX01 (if available) will be invoked before the Object Handler stops processing. With this user exit routine, you can specify whether to continue or terminate Object Handler processing. In the case of termination, you can change the condition code. For further details, see the source of the user exit routine SRC-EX01 in the Natural system library SYSOBJH.

OBJHEX02 for Object Rejection

If the Object Handler load function was executed successfully in batch mode (with Condition Code 0), but one or more objects were rejected during loading (for example, not replaced), before the Object Handler stops processing, the user exit routine OBJHEX02 (if available) is invoked. With OBJHEX02, you can specify whether to continue or terminate Object Handler processing. In the case of termination, you can set a condition code. For further details, see the source of the user exit routine SRC-EX02 in the Natural system library SYSOBJH.

OBJHEX03 for Default Option Values

You can apply user exit routine OBJHEX03 to set default options for processing Object Handler commands. This user exit is invoked before an Object Handler command is processed. For further details, see the source object of the user exit routine SRC-EX03 in the Natural system library SYSOBJH.

Top of page