Upgrading Datacom/AD 10.0/11.0/12.0 to 15.1
search cancel

Upgrading Datacom/AD 10.0/11.0/12.0 to 15.1


Article ID: 12045


Updated On:


Datacom DATACOM - AD Datacom/AD


This article explains how a Datacom/AD 10.0/11.0/12.0  Multi-User (MUF) can be upgraded to Datacom/AD 15.1.


z/OS Datacom/AD 15.1 15.0 14.0 12.0 11.0 10.0


The upgrade procedure changed in Datacom/AD 15.x and is now called an Active MUF upgrade and is documented in the section How to Perform an Active MUF Upgrade.

However, the new Active MUF Upgrade process can only be performed from the previously supported release of Datacom/AD 14.0.  

This article applies only to products that are not using SQL for database management. Please review CAAXSAMP member AXPOR01 or AXPOR02, and the list of products in Instruction #7 to be sure your MUF can be upgraded this way. If your current MUF is used to support any other products than those listed, please open a support case with Datacom/AD for further assistance.

To upgrade from releases prior to 14.0 you need to use the same upgrade method as was used in prior releases, the new installation with migrate/porting process. You can upgrade directly from Datacom/AD 10.0/11.0/12.0 to Datacom/AD 15.1 using the migrate/porting process. The procedure to upgrade to Datacom/AD 15.1 involves installing the software, then running the jobs to create a new Datacom/AD 15.1 MUF.   After this you migrate/port the Broadcom base product database to the new MUF, for 12.0 you need to run job AXPOR01, for 10.0/11.0 run job AXPOR02.  

Below is a summary of the steps and jobs that you need to run to install the new 15.1 MUF and complete the upgrade. Steps 1 - 6 can be run while the current Datacom/AD MUF and Broadcom base products are running. 


  1. Before starting this upgrade process, be sure that you have installed the most recent version of the software and applied all current maintenance.
  2. Review the Readme for Datacom/AD 15.1 to note any recent changes or issues.
  3. Run CAAXSAMP member AXCUS00 to create the INSTJCL PDS. For details see Create the CAI.HLQ.INSTJCL Installation JCL Library
  4. Copy the AXPOR01 and AXPOR02  members from CAAXSAMP into the INSTJCL PDS
  5. Create a new Version 15.1 MUF for Datacom/AD by following the instructions in the documentation sections "Customization and Environment Steps" and "New Installation Phase". Follow this process to create and customize each new MUF that you will need; however, the AXRIM01 job only needs to be run once for all the MUFs that will be executed on a particular LPAR.
  6. Customize the 15.x AXDATIN1 if needed. Do not use your existing 10,0 11.0, or 12.0 MUF startup SYSIN parameters. Once you have completed the New Installation Phase, you can now follow the process in the Installation Verification Phase to confirm that the MUF is operating correctly. 

Important note:  All of the above steps can be completed at any point prior to your migration, and will not affect your existing MUF operation. The remaining steps should be performed on your implementation day, and require the products and existing MUF to be stopped.

The using product being migrated must be stopped so its databases can be closed before this process begins. In other words, while both the "old" MUF and the "new" MUF must be running for the AXPOR* job to complete successfully, the applications using the MUF must be shut down so that this job has exclusive control of the databases.

You will also need to update the JCL for these applications so that they reference the "new" loadlibs. These applications need to be shut down when running the migrate process, but the source MUF should still be up and running, and the target MUF should be up and running as well. This is also noted in the flower box instructions of AXPOR01/02 jobs. 

Migrate the base product database to the new MUF by running job AXPOR01 for AD 12.0 or AXPOR02 for AD 10.0/11.0. This step will disconnect the product database from the existing MUF, and will connect the database files to the new Version 15.1 MUF. As there is no data conversion being performed, the existing files will be used as is. If you are upgrading the MUF to Version 15.1 from 12.0, use INSTJCL member AXPOR01; if you are upgrading from 11.0 or 10.0, use member AXPOR02. These members were manually copied into INSTJCL in Step 3 above.

These jobs are designed to migrate one database at a time, and you will need to run this for each database being migrated into the Version 15.1 MUF.

Update the STEPLIB in the JCL for each product being migrated to use the Version 15.1 CUSLIB and CAAXLOAD. Please note: some products might require changes to the TSO logon proc if the Datacom/AD loadlibs are used there. Once the JCL has been changed, you can now start the product and perform confirmation testing with the Version 15.1 database.

If you have not already done so, update your CAS9 or CAIRIM process on each LPAR where Datacom/AD work will be executed. Add the PARMLIB input statements from the AXRIM01 job into the CAS9/CAIRIM PARMLIB dataset. No other JCL changes are needed.

Additional Information

Refer to Datacom/AD 15.1 documentation for further installation details. In particular, please see the sections called Installing and also the Readme file.