Resource Initialization Manager › Error Handling

Error Handling

The following error conditions are handled by CAIRIM:

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 identifies the product being initialized. If the error cannot be isolated to a single product, product and version are replaced by N/A.

When a product initialization routine ends with a nonzero return code, the CAS9140E error message is issued. By default, this message is not highlighted. If you want to have this message highlighted and make it non-scrollable, add this statement in the RIMPARM member defined by the PARMLIB DD statement, starting in Column 1:

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