Previous Topic: Emergency Mode Processing

Next Topic: Order of Parameters Passed to Your Code


Return Codes from Your Code

CA has reserved return codes in the range from 6200 to 6300 for your use. Your code should not return any other return codes.

To indicate failure conditions in your code to Notification Manager, you should exit with a return code and PUSH an entry onto the REXX XDQ. The format of the command is:

PUSH "ERROR: string"
string

Contains a return code that is optionally followed by explanatory text.

There must be a blank after the "ERROR:".

For example, if your code determines that it must terminate abnormally because of a shortage in virtual memory and you have defined return code 6208 to mean "insufficient virtual memory," your code could issue either of the following code sequences to exit properly according to the Notification Manager API:

Sequence 1:

rc = 6208
PUSH "ERROR:" rc
EXIT rc

Sequence 2:

rc = 6208
PUSH "ERROR:" rc "Insufficient Virtual Memory"
EXIT rc