What is required for ACF2 when upgrading to a new version of JES2?
If upgrading to a new version of JES2 and z/OS without upgrading ACF2, how can the ACF2/JES2 interface be re-assembled and linked with a newer version of z/OS libraries prior to upgrading?
The ACF2/JES2 interface needs to be re-assembled and linked whenever there is a change to ACF2/JES2 interface modules, JES2 updates, or z/OS upgrades. This is done with a re-receive and apply of USERMOD UMJ2999 using job JXBUMJ2. Both the USERMOD and sample JCL for this procedure can be found in ACF2 installation library cai.CAX1JCL0.
In order to perform the update ahead of time, run JXBUMJ2 and override the SHASMAC, SHASSRC, MACLIB and MODGEN libraries in the SYSLIB DDDEFs by pointing to the new z/OS libraries.
The modified JCL would look like this:
//SMP EXEC PGM=GIMSMP,REGION=0K,PARM='DATE=U'
//*
//SMPCSI DD DSN=&CAI.SMPCSI.CSI,DISP=SHR
//SYSLIB DD DSN=SYS1.SHASMAC,DISP=SHR,UNIT=DISK,VOL=SER=VOL123
// DD DSN=SYS1.SHASSRC,DISP=SHR,UNIT=DISK,VOL=SER=VOL123
// DD DSN=SYS1.MACLIB,DISP=SHR,UNIT=DISK,VOL=SER=VOL123
// DD DSN=SYS1.MODGEN,DISP=SHR,UNIT=DISK,VOL=SER=VOL123
// DD DSN=your.ACF2.SMPMTS,DISP=SHR
// DD DSN=your.ACF2.CAX1MAC0,DISP=SHR
//SMPPTFIN DD DSN=&ACF2..CAX1JCL0(UMJ2999),DISP=SHR
//* UNIT=,VOL=,LABEL=
//*
//SMPCNTL DD *
SET BOUNDARY(GLOBAL) .
REJECT SELECT (UMJ2999) BYPASS(APPLYCHECK) .
RESETRC .
RECEIVE SELECT (UMJ2999) .
SET BOUNDARY(CAIT0) .
APPLY SELECT (UMJ2999) .
/*
//
This job should get CC 0. To confirm the job worked as intended, browse ACFJ2ITF in the cai.CAX1LINK library and verify that the z/OS eye-catcher matches the new level of z/OS:
Command ===>
********************************* Top of Data *****
.......0ACFJ2ITF........ACFEXIT2........ACFEXIT4...
.......&ACFJ2VLD.._y...4ACFJ2VAL.......NACFJ2SUB..|
...................................................
...5695PMB01 .........
..d.......................................569623400
............ ..............}
MIT ACFJ2ITFz/OS 2.5 .V.&6...HJE77D0
Then copy the ACF2/JES2 ACFJ2ITF, ACFJ2USR, ACFRJES2, and ACFUJES2 members into a new library to be used to add to the LINKLIST for the new z/OS level ahead of the old versions.