How to upgrade CA ENF MUF to Datacom/AD 15.1 from AD 14.0
Article ID: 195303
Updated On:
Products
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.
The 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
Feedback
