CAIRIM Initialization Parameters

CAIRIM Configuration › CAIRIM Initialization Parameters

CAIRIM Initialization Parameters

You could need to modify the CAIRIM initialization parameters. This task is required if you are installing CAIRIM and you intend to execute the CAS9 procedure. If you are installing CAIRIM on behalf of another service, without intending to run CAIRIM, do not perform this task.

Each solution initialized by CAIRIM is defined through an entry in the CAIRIM parmlib member (found in YourdeployHLQ.CAW0OPTN), described as the member CARIMPRM in our sample proc. Your solution‑specific installation documentation provides you with the specific CAIRIM parm definition (if necessary) for the solution and services you are installing. Any requirements for the ordering of statements are included in the instructions that are supplied with your CA Technologies solution.

CA Technologies software solutions that can be run using CAIRIM follow two general rules:

Rule 1--Services must be initialized before products. For example, if CA Scheduler uses ADAPTER and OMS, both ADAPTER and OMS initialization statements must precede the CA Scheduler initialization statement.
Rule 2--If a previously installed CA Technologies solution has already included one or more services that a subsequent solution also uses, the statements already present are used, and extra statements are not added for the services.

The following parameter structure for initialization statements is used for all software solution and service definitions:

PRODUCT(desc) VERSION(vers) LOADLIB(dsn) INIT(name) PARM(parm)

Important! CAIRIM control statements cannot go beyond column 72. Control statements can be continued on the next line by placing a dash (-) at the end of the line. But a keyword and its operands that are contained within parentheses must be on the same line.

Example

PRODUCT(desc) VERSION(vers) LOADLIB(dsn)  - 
INIT(name) PARM(parm)

Parameter	Required?	Description
desc	Required	Solution or service description (up to 20 characters). This parameter is specified once for each product to be installed.
vers	Required	Four‑character identifier, consisting of a two‑character solution or service code plus a two‑character version code.
dsn	Optional	Data set name for solution or service load modules. If the modules are in LINKLIST or the CAIRIM procedure STEPLIB, then the LOADLIB parameter need not be specified.
name	Optional	Name of initialization routine. By default, the name of the initialization module is the version information plus 'INIT'. Thus for solution KO42, the initialization module would be KO42INIT. The INIT parameter needs to be specified only if the default module name is not appropriate.
parm	Optional	Special parameter to be passed to the initialization routine. This parameter is used for any custom solution function such as re-initialization or deactivation. Up to 32 characters can be passed in the PARM field. Note: To pass up to 66 characters in the PARM field, apply PTF RO52581.

Note: The LOADLIB parameter causes the tasklib for the indicated install program to be switched to that data set, which must be APF‑authorized. Therefore, if LOADLIB is used, the INIT program and associated CAIRIM program modules must be either in LINKLIST or in the library that the LOADLIB statement describes. If the INIT program and associated CAIRIM program modules are only in a CAIRIM STEPLIB, an ABEND S806 occurs.