When installing a new release of CA-IDMS, it is recommended that clients install the latest version of the CA-IDMS SVC and use it for all releases. To avoid sysgen changes etc., the latest SVC should be created with the same SVC number that your releases are currently using.
For example, if you are running r18.5 with SVC 173, install the latest release of the CA-IDMS SVC using that same SVC 173. When all CVs using that SVC number are shut down, use CAIRIM to install the new SVC using the latest GJxxINIT program.
The CA-IDMS SVC and all of the related APFLIB load modules that are loaded when an SVC is installed using CAIRIM are always downward compatible and thoroughly tested by CA.
Therefore, when sharing an SVC across multiple releases, the SVC from the latest release should be used.
This document describes the nature of the CAIRIM statements required to set up such a configuration.
The following example assumes that the SVC number being used is 173, that you are currently running both r18.0 and r18.5, and that you are upgrading to r19.0
In such a case, the existing CAIRIM statements that you run at IPL would probably look like this:-
//PARMLIB DD *
PRODUCT(CA IDMS) VERSION(GJI5) INIT(GJI5INIT) PARM(SVC=173)
PRODUCT(CA IDMS) VERSION(GJI0) INIT(GJI5INIT) PARM(REFRESH(SVC=173))
Note that the second statement VERSION refers to r18.0 - this specifies that your LPAR will be running CA IDMS release r18.0 as well as the r18.5 release.
When you run the r19.0 install and configuration jobs to upgrade CA-IDMS, you need to run a CAIRIM step to make sure the new SVC will be used, that any existing APFLIB modules are refreshed using the new 19.0 APFLIB members, and that any new ones are loaded. Note that any CV using SVC 173 must be shut down while this CAIRIM job is run. CAIRIM STEPLIB/JOBLIB must have the latest APFLIB defined first. This syntax will refresh all modules in the LPA with the 19.0 versions.
This is the syntax required in the CAIRIM job for release 19.0:-
//PARMLIB DD *
PRODUCT(CA IDMS) VERSION(GJJ0) INIT(GJJ0INIT) PARM(REFRESH(SVC=173))
PRODUCT(CA IDMS) VERSION(GJJ0) INIT(GJJ0INIT) PARM(REFRESH(RHDCSSFM))
PRODUCT(CA IDMS) VERSION(GJJ0) INIT(GJJ0INIT) PARM(REFRESH(IDMSMSVA))
PRODUCT(CA IDMS) VERSION(GJJ0) INIT(GJJ0INIT) PARM(REFRESH(CAIXDOA$))
PRODUCT(CA IDMS) VERSION(GJJ0) INIT(GJJ0INIT) PARM(REFRESH(PMRTDATA))
Note that running the above CAIRIM is required only to allow r19.0 to use this SVC until the next IPL of z/OS. For the next and all subsequent IPLs, all you need is the following CAIRIM statements:-
//PARMLIB DD *
PRODUCT(CA IDMS) VERSION(GJJ0) INIT(GJJ0INIT) PARM(SVC=173)
PRODUCT(CA IDMS) VERSION(GJI5) INIT(GJJ0INIT) PARM(REFRESH(SVC=173))
PRODUCT(CA IDMS) VERSION(GJI0) INIT(GJJ0INIT) PARM(REFRESH(SVC=173))
The second line above is needed to support the r18.5 version on the LPAR, and the third line supports the r18.0 version on this same LPAR. Note that no statements of the form PARM(REFRESH(module-name)) are required because the first line will have loaded the r19.0 versions of all modules required for all releases (as they are downward compatible).
Always use the latest GJxxINIT module.
Please also note the following related to CAIRIM:
* Be sure that the STEPLIB concatenation of the CAIRIM job points to the APFLIB containing the correct modules - in this case those from the r19.0 configuration.
* Do not run any CAIRIM jobs while the related CVs are active. If you do, ERUS tasks will not work against those CVs until they are cycled.
* The following is a list of the APFLIB modules and the released at which they were added to CA-IDMS:-