How to upgrade CA ENF MUF to Datacom/AD 15.1 from AD 14.0

book

Article ID: 195303

calendar_today

Updated On:

Products

CA Common Services for z/OS CA Datacom/AD

Issue/Introduction

Here are the summarized instructions on how to upgrade your CA Commons Services ENF IMUF or XMUF to CA Datacom/AD 15.1 from CA Datacom/AD 14.0.

Cause

If you are currently running ENFIMUF or ENFXMUF running with a Datacom/AD 14.0 MUF to record event records, here are two methods you can use to upgrade to Datacom/AD 15.1.

Two methods are provided.

Method #1 - Continue to use existing Datacom/AD Version 14.0 MUF environment with new Datacom/AD Version 15.1 executables

Method #2 - Build a fresh new Datacom/AD Version 15.1 MUF environment and customize it for ENF's use

 

Method #2 may be preferred for existing ENF MUF if the wish is to create or recreate a new Datacom environment.

Environment

z/OS

Resolution

After the CA Datacom/AD 15.1 SMP/e installation and all maintenance has been applied...

Review the Readme for CA Datacom/AD 15.1 for minimum requirements
https://techdocs.broadcom.com/content/broadcom/techdocs/us/en/ca-mainframe-software/database-management/ca-datacom-ad/15-1/installing/readme-for-ca-datacom-ad-15-1.html

 

Method #1 - Continue to use existing Datacom/AD Version 14.0 MUF environment with new Datacom/AD Version 15.1 executables

Review the "How to Perform a 14.0 to 15.1 Active MUF Upgrade" process as described in the CA Datacom/AD 15.1 documentation  https://techdocs.broadcom.com/content/broadcom/techdocs/us/en/ca-mainframe-software/database-management/ca-datacom-ad/15-1.html

Next, follow the "Active Upgrade '14.0 to 15.1 steps:

-- Customize and Submit member AXCUS00 in the CAAXSAMP to create the INSTJCL installation library
-- Customize and Submit INSTJCL member AXCUSACT -  create the "Active MUF Upgrade" ACT.INSTJCL installation library
-- Customize and Submit ACT.INSTJCL member AXACTAPF -  CA SYSVIEW to dynamically add the libraries to be APF listed
-- Customize and Submit ACT.INSTJCL member AXRIM01 -  CAIRIM execution to load the program call routines
-- Customize and Submit ACT.INSTJCL member AXACTUPG  - Assemble and link-edit custom macros to custom libraries 
   Note: Be sure to use the same DBSIDPR parameters as were used for this 14.0 MUF.
   Ensure that CXXNAME= and DSN_XXX= are the same as those defined for the existing AD 14.0 environment. You can refer to your existing AD 14.0 custom CUSMAC(DBSIDPR)

-- Shutdown the currently executing ENF task running AD 14.0
-- Start the AD 15.1 MUF using ACT.INSTJCL member AD15STUP as an example.
-- Customize and Submit ACT.INSTJCL member AXACTALC – Allocate Upgrade related data sets
-- Customize and Submit ACT.INSTJCL member AXACTDD1 – DBUTLTY Version 14.0 DD and DDD backup
-- Customize and Submit ACT.INSTJCL member AXACTDD2 – Version 14.0 to 15.0 CA Datacom® Datadictionary™ upgrade


Next, for the ENF MUF start to use Datacom/AD 15.1:

-- Edit the existing ENF proc as it pertains to your setup:  
   a) ENFIMUF - change references to the Datacom/AD 14.0 CAAXLOAD and CUSTOM CUSLIB to point to the new Datacom/AD 15.1 libraries
   b) ENFXMUF - change references to the Datacom/AD 14.0 CAAXLOAD and CUSTOM CUSLIB to point to the new Datacom/AD 15.1 libraries

Note:  For the AD 15.1 startup, the same 14.0 MUF startup options in AXDATIN1 should be used.
T
he parameters in AXDATIN2 are not typically changed so use the CA Datacom/AD 15.1 provided AXDATIN2.

Whether running with an internal MUF (ENFIMUF) or and external MUF(ENFXMUF), the MUF will be using the new the AD 15.1 custom CUSLIB and CAAXLOAD libraries; the other Datacom data sets will be the same.

-- Shutdown the currently executing ENF task.
-- Restart the appropriate ENF task
    a) If running with an external MUF, start ENFXMUF. It should connect to the external Datacom/AD 15.1 MUF that was previously started 
    b) If running with an internal MUF, first shutdown the AD 15.1 MUF. Then start ENFIMUF

 

Method #2 - Build a fresh new Datacom/AD Version 15.1 MUF environment and customize it for ENF's use

The following steps will follow the "Customizing the CA Datacom/AD Environment" process as described in the
hhttps://techdocs.broadcom.com/content/broadcom/techdocs/us/en/ca-mainframe-software/database-management/ca-datacom-ad/15-1/installing/starting-your-product/customizing-the-ca-datacom-ad-environment.html

-- Customize and Submit member AXCUS00 in the CAAXSAMP to create the INSTJCL installation library
-- Customize and Submit INSTJCL member AXAPFADD to apf-authorize the required Datacom/AD 15.1 libraries
-- 
Customize and Submit INSTJCL member AXRIM01 to load Datacom PC routine
-- 
Customize and Submit INSTJCL member AXCUSNEW to ASSEMBLE/LINK CUSTOM modules to the CUSTOM libraries
-- Customize and Submit INSTJCL member AXNEW01 to allocate all the MUF instance datasets and the databases
-- Customize and Submit INSTJCL member AD15STRT to start the 15.0 MUF. You should run with the default AXDATIN1 and AXDATIN2 values
-- Customize and Submit INSTJCL member AXIVP01 to execute the sample SQL driver program for the CA Datacom/AD  product.

The following steps will follow the "Customize CA Datacom/AD for CAIENF" process as described in the CA Common Services Installation Guide.

-- Customize and Submit CA Common Services CAW0JCL member AW1ID001 to customize this new Datacom/AD 15.1 MUF for ENF's use.

-- Edit the existing ENF proc as it pertains to your setup
   a) If running ENFIMUF - change references to the Datacom/AD 14.0 CAAXLOAD and CUSTOM CUSLIB to point to the new Datacom/AD 15.1 libraries
   b) If running ENFXMUF - change references to the Datacom/AD 14.0 CAAXLOAD and CUSTOM CUSLIB to point to the new Datacom/AD 15.1 libraries

-- Shutdown the currently executing ENF task.
-- Restart the appropriate ENF task
    a) If running with an external MUF, start ENFXMUF. It should connect to the external Datacom/AD 15.1 MUF that was previously started 
    b) If running with an internal MUF, first shutdown the AD 15.1 MUF. Then start ENFIMUF

 

 

Additional Information

Note: It is recommended that you upgrade to CA Datacom/AD 15.1 instead of to 15.0.
If 15.0, refer to:
Article 45286 "How to upgrade CA ENF to Datacom/AD 15.0"
https://ca-broadcomcsm.wolkenservicedesk.com/wolken/esd/knowledgebase_list?articleId=45286