CA ENF MUF upgrade to Datacom/AD 15.1 from AD 14.0 or 15.0

Products

• COMMON SERVICES FOR Z/OS
• Datacom/AD

Issue/Introduction

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

Method #1 - Continue to use the existing Datacom/AD Version 14.0 or 15.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

Datacom/AD 15.1 

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

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

Review  "Perform a 14.0 or 15.0 to 15.1 Active MUF Upgrade" as described in the Datacom/AD 15.1 documentation 

1.Customize and Submit member AXCUS00 in the CAAXSAMP to create the INSTJCL installation library
2.Customize and Submit INSTJCL member AXCUSACT -  create the "Active MUF Upgrade" ACT.INSTJCL installation library
3.Customize and Submit ACT.INSTJCL member AXACTAPF -  CA SYSVIEW to dynamically add the libraries to be APF listed
4.Customize and Submit ACT.INSTJCL member AXRIM01 -  CAIRIM execution to load the program call routines
5.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)

6.Shutdown the currently executing ENF task running AD 14.0
7.Start the AD 15.1 MUF using ACT.INSTJCL member AD15STRT as an example.
8.Customize and Submit ACT.INSTJCL member AXACTALC – Allocate Upgrade related data sets
9.Customize and Submit ACT.INSTJCL member AXACTDD1 – DBUTLTY Version 14.0 DD and DDD backup
10.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 or 15.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 AD 15.1 custom CUSLIB and CAAXLOAD libraries; the other Datacom data sets will be the same.

11.Shutdown the currently executing ENF task.
12.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 

1.Customize and Submit member AXCUS00 in the CAAXSAMP to create the INSTJCL installation library
2.Customize and Submit INSTJCL member AXAPFADD to apf-authorize the required Datacom/AD 15.1 libraries
3.Customize and Submit INSTJCL member AXRIM01 to load Datacom PC routine
4.Customize and Submit INSTJCL member AXCUSNEW to ASSEMBLE/LINK CUSTOM modules to the CUSTOM libraries
5.Customize and Submit INSTJCL member AXNEW01 to allocate all the MUF instance datasets and the databases
6.Customize and Submit INSTJCL member AD15STRT to start the 15.1 MUF. You should run with the default AXDATIN1 and AXDATIN2 values
7.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 COMMON COMPONENTS AND SERVICES guide

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

9.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

10.Shutdown the currently executing ENF task.
11.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

Remember that the ENF MUF cannot be used for any other AD using product.