Resource Initialization Manager › Error Handling

Error Handling

CAIRM handles the following error conditions:

Failure to allocate, open, or read the parmlib data set

Processing continues to issue the CAIRIM auto commands.

Syntax errors in control cards

Processing continues with the next PRODUCT parameter.

Errors while allocating, opening, or reading the product load library

Processing continues with the next PRODUCT parameter.

Missing product initialization routine

Processing continues with the next PRODUCT parameter.

Abends or nonzero return codes from any product installation routine

Processing continues with the next PRODUCT parameter.

Error while opening or reading the CAIRIM auto commands member

Processing terminates.

General abend anywhere within the CAIRIM routine

CAIRIM tries to associate the abend with a specific product initialization function and terminates that function. If CAIRIM cannot isolate the error, it aborts any further dynamic product installations. In either case, CAIRIM issues the auto commands.

SVC dumps by CAIRIM have the following title:

CAIRIM INITIALIZATION DUMP. PRODUCT = product  VERSION = version

product and version identify the product being initialized. If the error cannot be isolated to a single product, N/A replaces product and version.

When a product initialization routine ends with a nonzero return code, the CAS9140E error message is issued. By default, this message is not highlighted. Add this statement in the RIMPARM member that the PARMLIB DD statement defines. Start in Column one to highlight this message and make it nonscrollable:

HIGHLIGHT=ON

The statement affects the product initialization routines that follow it. To turn off this behavior later in the member, add the following statement:

HIGHLIGHT=OFF