Dispatch compatibility requirements for z/OS 3.1 and how to implement?

Products

• Dispatch Output Mgmt

Issue/Introduction

Our site is upgrading to z/OS 3.1. What are the Dispatch release 11.7 compatibility requirements and how do we implement the necessary changes?

Environment

Dispatch, 11.7, z/OS, 3.1, compatibility, maintenance, ptf, implement, implementation, cvkey, change, ppt, cadssvc, initialize, svc

 

Resolution

Please refer to the z/OS Compatibility Matrix and specify product "Dispatch" to see what the support considerations are for z/OS 3.1. Then click on the "additional information" link, where you will see the following: 

Dispatch 11.7
Fix Category: CA.TargetSystem-RequiredService.z/OS.V3R1

 Requires CA Dispatch 11.7 PTFs LU10974, LU10975, LU02931 and LU11099.    

 If running z/OS 3.1 or upgrading to z/OS 3.1, all Dispatch users must    
 define CA-Dispatch to run in an alternate storage protection key         
 (0 thru 7). Please refer to steps "Step 14A - Change the CA Dispatch     
 CVKEY" and "Step 14c. Load the New SVC" in the CA Dispatch Installation  
 guide, to obtain detailed instructions on the steps needed to change     
 the storage protection key.

 

- Always review the ++HOLD instructions for any PTF's that need to be applied.

- As per the ++HOLD instructions, application of PTF LU02931 requires you to re-install the CVKEY change usermod. Please refer to Knowledge  "Article ID: 229628 - APPLY of LU02931 gets GIM38201E MODID error - DSINSVC not PRE or SUP for CADSSVC" for more information if you receive an SMP/E error trying to apply this PTF.

- If you need instructions for installing the CVKEY change usermod, please refer to Knowledge "Article ID: 11361 - SB78-5C abend starting CA Dispatch after z/OS upgrade - CVKEY Change Required" for assistance.

- After installing all of the necessary z/OS 3.1 compatibility PTF's and the CVKEY change usermod, Make sure that you move the updated code into the appropriate Dispatch run time load library. And make sure the CAS9/CAIRIM job that runs at IPL time is pulling code from this same library. If this library is defined to LINKLIST, do not forget to do an LLA REFRESH.

- ALL of the above compatibility code can be put into place ANYTIME before your actual upgrade to z/OS 3.1. All of the above code is downward compatible to lesser operating systems.

- If you are not going to be IPL'ing to implement the z/OS 3.1 compatibility code, you ARE going to have to delete the previously loaded CADDSPLx modules out of memory and reload them with the 3.1 compatibility code by executing the SVCREDO process documented in "Knowledge Article ID: 10968 - Reinitializing the CA Dispatch SVC. (Also known as the SVCREDO procedure)".

- If you ARE going to IPL the system to implement z/OS 3.1, you would NOT need to perform the SVCREDO procedure.