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

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

book

Article ID: 195303

calendar_today

Updated On:

Products

Datacom Datacom/AD Common Components and Services for z/OS

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

Resolution

IMPORTANT NOTE: Remember that ENF must use its own MUF, which must not be used for any other product.  

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

Review the Readme for 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. Once all maintenance has been applied, customize and Submit member AXCUS00 in the CAAXSAMP to create the 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 "Active MUF Upgrade" ACT.INSTJCL installation library.
  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. Customize and Submit ACT.INSTJCL member AXAPFSVW - SYSVIEW to dynamically add the libraries to be APF listed. If you do not have SYSVIEW, use AXAPFZOS or you can also use your own process to APF authorize the loadlibs.
  8. Start the AD 15.1 MUF using ACT.INSTJCL member AD15STRT as an example.
  9. Customize and Submit ACT.INSTJCL member AXACTALC - Allocate Upgrade related data sets.
  10. Customize and Submit ACT.INSTJCL member AXACTDD1 - DBUTLTY Version 14.0 DD and DDD backup.
  11. Customize and Submit ACT.INSTJCL member AXACTDD2 - Version 14.0 to 15.0 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:
    1.  ENFIMUF - change references to the Datacom/AD 14.0 CAAXLOAD and CUSTOM CUSLIB to point to the new Datacom/AD 15.1 libraries.
    2.  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 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.

  12. Shutdown the currently executing ENF task.
  13. Restart the appropriate ENF task:
    1. If running with an external MUF, start ENFXMUF. It should connect to the external Datacom/AD 15.1 MUF that was previously started.
    2. If running with an internal MUF, first shut down 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 Datacom/AD Environment process.

  1. Customize and Submit member AXCUS00 in the CAAXSAMP to create the 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 AXCUSNEW to ASSEMBLE/LINK CUSTOM modules to the CUSTOM libraries.
  4. Customize and Submit ACT.INSTJCL member AXAPFSVW - SYSVIEW to dynamically add the libraries to be APF listed. If you do not have SYSVIEW, use AXAPFZOS or you can also use your own process to APF authorize the loadlibs.
  5. Customize and Submit INSTJCL member AXRIM01 to load Datacom PC routine.
  6. Customize and Submit INSTJCL member AXNEW01 to allocate all the MUF instance datasets and the databases.
  7. Customize and Submit INSTJCL member AD15STRT to start the 15.1 MUF. You should run with the default AXDATIN1 and AXDATIN2 values.
  8. Customize and Submit INSTJCL member AXIVP01 to execute the sample SQL driver program for the Datacom/AD  product.

    The next steps will follow the Customize Datacom/AD for CAIENF process as described in the Common Components and Services for z/OS documentation:

  9. Customize and Submit Common Components and Services CAW0JCL member AW1ID001 to customize this new Datacom/AD 15.1 MUF for ENF's use.
  10. Edit the existing ENF proc as it pertains to your setup:
    1. 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.
    2. 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.

  11. Shutdown the currently executing ENF task.
  12. Restart the appropriate ENF task:
    1. If running with an external MUF, start ENFXMUF. It should connect to the external Datacom/AD 15.1 MUF that was previously started.
    2. If running with an internal MUF, first shutdown the AD 15.1 MUF. Then start ENFIMUF.
Powered by Wolken Software