Upgrading Datacom/AD 15.1 from 14.0 (Active Upgrade)

Products

• Datacom
• Datacom/AD

Issue/Introduction

This article documents the steps for a Datacom/AD active MUF upgrade from version 14.0 to 15.1.

Resolution

Table of Contents

• Step 1: Acquiring and installing the Software (Product Acquisition)
• Step 2: Updating the software (applying maintenance)
• Step 3: Perform the upgrade tasks
• Step 4: Perform the post-upgrade tasks

Once these four steps are finished successfully, the upgrade to Datacom/AD version 15.1 will be complete. To upgrade another Datacom MUF environment, start again from the first step to create a new INSTJCL library and new custom libraries.

Before starting, it might be helpful to review this video: "The New Streamlined Datacom/AD Version 15.1 Upgrade Process"  

Step 1: Acquiring and installing the Software (Product Acquisition)

If using standard SMP/E processing, run these jobs from the Datacom/AD.v151.SAMPJCL library:

AAX1ALL
AAX1HOLD
AAX2CS
AAX3RECD
AAX4APP
AAX5ACC  

Step 2: Updating the software (applying maintenance)

1. Select the release and service pack for Datacom/AD from the Download section of the support portal to select and download all PTFs for Datacom/AD before proceeding to the next step. 
2. As indicated in the Datacom/AD 15.1 "Readme for Datacom/AD 15.1", apply all published Datacom/AD 15.1 PTFs. It is recommended that Datacom/AD Version 15.1 be current on maintenance for all FMID components. If all solutions cannot be applied at this point, the required solutions before upgrading are listed on the Datacom/AD 15.1 README and must be applied before you create the Datacom.v151.INSTJCL PDS through job AXCUS00. 

Step 3: Perform the upgrade tasks

1. Once all maintenance has been applied, customize and submit member AXCUS00 in the Datacom.v151.CAAXSAMP to create the Datacom.v151.INSTJCL installation library (Cancel editing after submitting this member as this is under SMP/E control).
2. Customize and submit member AXCUS01 in the Datacom.v151.INSTJCL installation library to copy configuration JCL members from CAAXSAMP to INSTJCL. Also, the $AXISET common INCLUDE member will be created in the Custom Proclib (CUSPROC).
   IMPORTANT NOTE: Since this article is for the upgrade process of Datacom/AD, you need to continue using the file format that you currently have. Therefore, you need to know if any of the file groups listed in AXCUS01 are currently defined as VSAM, and use V for those. Anything that you know are not VSAM files should be identified with B.
3. Customize and submit INSTJCL member AXCUSACT to create the Datacom.v151.ACT.INSTJCL installation library, used for the Active MUF Upgrade. 
4. Customize and submit INSTJCL member AXRIM01. This member installs the 15.1 Datacom/DB PC module DBPCCPR. This member has to run before executing the upgrade installation steps. Note that in Datacom/AD version 14.0 there were 2 modules, DBPCCPR and DBPCSPR, but in Datacom/AD 15.1 only DBPCCPR is used.
   
   Note: AXRIM01 loads Datacom 15.1 PC module DBPCCPR into memory. Be sure to update your CAS9/CAIRIM input with the control statements from AXRIM01 so that this module gets loaded after every IPL.
   
   
5. Customize and submit these ACT.INSTJCL members:
   AXACTUPG  - Assemble and link-edit custom macros to custom libraries
   AXAPFADD - SYSVIEW to dynamically add the libraries to be APF listed (you can also use your own process to APF authorize the loadlibs)
   AXACTALC - Allocate upgrade-related data sets

   Note: Job AXACTUPG copies the current custom members–including DBSIDPR–into the 15.1 CUSMAC. Review the DBSIDPR/DBSYSID macro parameters as needed, and review any JCL you use to create or assemble this DBSIDPR member if any changes are needed. 

6. Shut down the Broadcom products which use this MUF and exist any ISPF applications/sessions that access the Datacom MUF. 
7. If the Broadcom product uses Datacom Server, also shut down Server.
8. Shut down the Datacom/AD 14.0 MUF, and ensure the MUF shuts down cleanly (without any errors).
9. Make a copy of your current 14.0 MUF startup JCL and change the STEPLIB to use the Datacom/AD 15.1 CUSLIB and 15.1 CAAXLOAD. Assure the AXDATIN1 startup options are the same as used with the 14.0 MUF. Use the startup options member provided with Version 15.1 called AXDATIN2.
10. Update the JCL for the Broadcom product using the MUF and change the STEPLIB to use the new Datacom/AD 15.1 CUSLIB and CAAXLOAD libraries.
11. If the Broadcom product uses Datacom Server then update the Datacom Server JCL and change the STEPLIB to use the Datacom/AD 15.1 CUSLIB and 15.1 CAAXLOAD.
12. Start the Version 15.1 MUF that was just upgraded.  
13. Start Datacom Server if needed.
14. Start the Broadcom products that use this MUF.

Step 4: Perform the post-upgrade tasks

1. Once the Datacom/AD Version 15.1 MUF is up, and you will not revert to the prior version, run the following members in the ACT.INSTJCL library:
   AXACTDD1 - Backup of Datacom 14.0 Datadictionary
   AXACTDD2 - Update Datadictionary to 15.0. Note that this is required to complete the upgrade to Version 15.1 

Additional Information

The below links might be helpful for your upgrade process if needed.

• Documentation: Install Products Using Native SMP/E JCL
• Documentation: Install Products Using z/OSMF
• Documentation: Readme for Datacom/AD 15.1
• Documentation: Perform a 14.0 or 15.0 to 15.1 Active MUF Upgrade
• Knowledge Base article 195303: "ENF MUF upgrade to Datacom/AD 15.1 from AD 14.0 or 15.0"
• Knowledge Base article 199604: "Datacom/AD: How to Fallback to 14.0 and when to run AXACTDDR"
• Video: "The New Streamlined Datacom/AD Version 15.1 Upgrade Process" 

As always, please contact Broadcom support for Datacom if you have further questions.