ACF2/JES2 interface process when upgrading JES2
search cancel

ACF2/JES2 interface process when upgrading JES2

book

Article ID: 26507

calendar_today

Updated On:

Products

ACF2 ACF2 - z/OS ACF2 - MISC

Issue/Introduction

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?

Resolution

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.