Implement Parallel Upgrade MUF Resources

Steps that you must perform the implementation phase of the Parallel Upgrade procedure.
datacom151
This scenario describes the steps that a database administrator takes to perform the implementation phase of the Parallel Upgrade procedure.
The Parallel Upgrade procedure, as described in the How to Perform a Parallel Upgrade scenario, provides a means where a
CA Datacom®
Version 14.0 Multi-User Facility (MUF) instance can be upgraded to the next version with no outage. Therefore, there are no interruptions to batch and online application processing until the upgraded resources are ready to be implemented back into the original environment.
For more information about this type of upgrade procedure, see the How to Perform a Parallel Upgrade scenario.
It is assumed that from the time stable Version 14.0 backups are taken from a candidate MUF and the upgraded resources are restored to their original location, no changes to the MUF resources involved occurred. The MUF resources that need to remain unchanged until they are re-implemented are, the CA
CA Datacom® Datadictionary™
database (DBID 2) and the CA Data Definition Directory database (DBID 15).
In a non-SQL
CA Datacom®/DB
environment, this means:
  • No user database definition structure or attribute value changes
  • No new
    CA Dataquery
    users added
  • No CA IDEAL application changes performed
  • No CA Meta-COBOL application changes performed
In a SQL
CA Datacom®/DB
environment, all of the above plus:
  • No Data Definitions Language (DDL) SQL statements performed
  • No manual static SQL plan rebind.
On this page:
Overview
The Parallel Upgrade phase produces a set of three Version 15.1 DBUTLTY backup datasets.
  • MUF directory (CXX) backup
  • CA Datacom® Datadictionary™
    (DD) database backup
  • Data Definition Directory (DDD) database backup
Implementing the Version 15.1 backups into their original Version 14.0 environment is accomplished by:
  • Shutting down the Version 14.0 MUF and associated CICS regions
  • Executing DBUTLTY to replace the DD, DDD, and Dynamic System Tables (DST) definitions in the Version 14.0 CXX
  • Loading the Version 15.1 DD and DDD databases with the Version 15.0 Parallel Upgrade backups
  • Upgrading the
    CA Dataquery
    DQM data area tables to Version 15.1
  • Modifying the Version 14.0 startup options and custom macro parameter values
  • Modifying the CICS(s) startup JCL members that are associated with the MUF
  • Updating the
    CA Datacom® Datadictionary™
    On-Line (DDOL) sign-on/off panels
  • Starting the candidate MUF and CICS regions using the Version 15.0 code level
How to Implement Parallel Upgrade MUF Resources
As a DBA in your mainframe environment, you can install, maintain, deploy, configure, and customize features for the database product.
Benefit
This new upgrade method reduces the downtime to get a MUF from the old version to the new version from an hour or more to just a few minutes.
The following graphic shows the workflow that is associated with implementing one set of
CA Datacom®/DB
Parallel Upgrade resources.
Implement a Parallel Upgrade_u3
To implement one set of parallel upgrade MUF resources, complete the following steps:
Review the prerequisites
The following prerequisites help ensure a successful new Version 15.0 creation:
  • A version of z/OS as supported by IBM.
  • Experience with the
    CA Datacom®/DB
    installation and upgrade process.
  • The following
    CA Datacom®/DB
    system DBIDs (database IDs) are assumed to be in use:
    • CA Datacom® Datadictionary™
      (DD) DBID is 002
    • Data Definition Directory (DDD) DBID is 015
    • Dataquery (DQ) DBID is 003
    • Dynamic System Tables DBID is 1000
    • History Database DBID is 1007
Create the CAI.HLQ.INSTJCL Installation JCL Library
This task is the beginning point for any of the Version 14.0 to Version 15.0 upgrade methods. It must be performed for each MUF being upgraded since the group of datasets and their contents are unique to a specific MUF. When edited and executed, the CAI.THLQ.CABDSAMP dataset member BDCUS00 creates and populates the following:
CAI.HLQ.INSTJCL dataset
CAI.CHLQ.CUSLIB dataset
CAI.CHLQ.CUSMAC dataset
CAI.CHLQ.CUSPROC dataset
Follow these steps:
  1. Locate CAI.THLQ.CABDSAMP dataset member BDCUS00. This member allocates the CAI.HLQ.INSTJCL dataset. It also copies the
    CA Datacom®
    Version 15.0 upgrade JCL members from the CAI.THLQ.CABDSAMP library into the CAI.HLQ.INSTJCL dataset.
  2. Type
    UPG15
    in the command line and press Enter. The ISREDIT macro is invoked, and all the member variables are changed to your site standards.
  3. Submit the member for execution and then cancel out of it. Do not save the changes because the members in the CAI.THLQ.CABDSAMP dataset are under SMP/E control.
The BDCUS
sfx
JCL members are located in the CAI.HLQ.INSTJCL dataset. These members can be used to perform a new Version 15.1 installation or any one of the three available Version 14.0 to 15.1 upgrade processes. The JCL members are:
  • BDCUSNEW - Version 15.0 new MUF installation process
  • BDCUSACT - Version 14.0 to 15.0 Active MUF Upgrade process
  • BDCUSPAR - Version 14.0 to 15.0 Parallel Upgrade process
  • BDCUSIMP - Version 14.0 to 15.0 Parallel Upgrade implementation process
  • BDCUSUPG - Version 14.0 to 15.0 traditional or legacy MUF upgrade process
Create the CAI.HLQ.IMP.INSTJCL installation JCL library
This library is the starting point for the Parallel Upgrade Implementation phase. The following steps create the CAI.HLQ.IMP.INSTJCL JCL library. If there are more than one set of upgraded Version 14.0 MUF resources to implement, this library is also the starting point for each additional implementation. Repeat the process as many times as needed.
Follow these steps:
  1. Locate CAI.HLQ.INSTJCL member BDCUSIMP. This member allocates and populates the CAI.HLQ.IMP.INSTJCL JCL library dataset.
  2. Type
    UPG15
    in the command line and press Enter. The ISREDIT macro is invoked, and all the member variables are changed to your site standards.
  3. Submit the member for execution and then cancel out of it so the changes are not saved. Re-editing and rerunning members is easier if an error was made when the ISREDIT macro was modified and saved to your SYSPROC or TSO CLIST dataset.
Modify and execute CAI.HLQ.IMP.INSTJCL JCL members
The following CAI.HLQ.IMP.INSTJCL members implement one set of Version 15.1 MUF system resources back into their original environment. When customized and executed, the following CAI.HLQ.IMP.INSTJCL completes the implementation of one set of upgraded 15.1 MUF system resources.
  • $DCBDEDT - ISREDIT macro
  • @BDWKSHT - Upgrade JCL variable definitions
  • BDCUSUPG - Assemble and link edit the 15.1 CUSMAC custom assembly members
  • BDRIM01 - Install 15.1 PC call modules
  • APFADD - Sample batch CA SYSVIEW APF authorization JCL
  • BDUPG06B - Upgrade
    CA Dataquery
    DQM area to Version 15.1
  • BDUPG09 - Install 15.1 ADRPNL VLS file DDOL sign-on/off panels
  • DBUTLTYI - 15.1 DBUTLTY CXX, DD, and DDD load JCL
  • DBUTLTYU - 15.1 Sample DBUTLTY CXX report JCL
  • BDHST01U - Closes history database (DBID 1007)
  • BDHST02U - Rebuilds history database to make the current definition be active
Perform pre-implementation tasks
You can complete the following 15.1 upgrade related tasks at any time before performing a candidate 14.0 MUF Parallel Upgrade. Perform this task for each MUF instance that is upgraded. The MUFs can be upgraded in any order.
Complete these tasks:
  1. Locate CAI.HLQ.IMP.INSTJCL dataset member BDRIM01. This member dynamically installs the
    CA Datacom®/DB
    Version 15.1 program CALL (PC) modules using CAIRIM into the system/LPAR where it is executed. Modify the system/LPAR CA Common Services CAS9 PROC to install the CALL (PC) modules the next time an IPL of the system/LPAR is performed. CA Common Services CAMASTER is a prerequisite requirement to this task.
    Type
    UPG15
    in the command line and press Enter. The ISREDIT macro is invoked, and all the member variables are changed to your site standards.
    Submit the member for execution and then cancel out of it so the changes are not saved. This makes it easier to rerun if changes to the ISREDIT member are required.
  2. Locate CAI.HLQ.IMP.INSTJCL dataset member BDCUSUPG. This member assembles and link edits all the Version 15.1 CAI.CHLQ.CUSMAC custom macro members and populates the CAI.CHLQ.CUSLIB and CAI.HLQ.CUSPROC datasets. Review all custom macro members and as a minimum update the DBSYSID and DDSYSTBL macro parameter values as appropriate before you submit this member for execution.
    Type
    UPG15
    in the command line and press Enter. The ISREDIT macro is invoked, and all the member variables are changed to your site standards.
    Submit the member for execution and then cancel out of it so the changes are not saved. This makes it easier to rerun if changes to the ISREDIT member are required.
  3. Locate CAI.HLQ.IMP.INSTJCL dataset member BDCICS. It defines the
    CA Datacom®
    profile, transactions, and programs to the CICS CSD and assembles the CICS file table.
    Type
    UPG15
    in the command line and press Enter. The ISREDIT macro is invoked, and all the member variables are changed to your site standards.
    Submit the member for execution and then cancel out of it so the changes are not saved. This makes it easier to rerun if changes to the ISREDIT member are required.
Perform implementation tasks
Follow these steps:
  1. Shut down the Version 14.0 MUF using normal procedures. Do not cancel or terminate the MUF. If the MUF does not end normally, the implementation is not successful.
  2. Incorporate the
    CA Datacom®
    Version 15.1 executable base and customized load modules into the MUF startup and CICS DFHRPL list.
  3. Locate CAI.HLQ.IMP.INSTJCL dataset member BDUPG01P. This member populates the CAI.CHLQ.CUSPROC dataset used by the JCL members performing the implementation process.
    Type
    UPG15
    in the command line and press Enter. The ISREDIT macro is invoked, and all the member variables are changed to your site standards.
    Submit the member for execution and then cancel out of it. The changes should not be saved because the members in the CAI.SHLQ.CABDSAMP dataset are under SMP/E control.
  4. Locate CAI.HLQ.IMP.INSTJCL member DBUTLTYI. This member executes DBUTLTY to back up the Version 14.0 candidate environment CXX, DD, and DDD data areas. It then loads the Version 15.1 MUF CXX, DD, and DDD backups created by the Parallel Upgrade phase.
    Type
    UPG15
    in the command line and press Enter. The ISREDIT macro is invoked, and all the member variables are changed to your site standards.
    Submit the member for execution and then cancel out of it so the changes are not saved.
  5. Locate CAI.HLQ.IMP.INSTJCL member BDUPG06B. This member executes DQLANGMT to update tables in the Version 14.0
    CA Dataquery
    DQM data area to Version 15.1.
    Type
    UPG15
    in the command line and press Enter. The ISREDIT macro is invoked, and all the member variables are changed to your site standards.
    Submit the member for execution then cancel out of it so the changes are not saved.
  6. Locate CAI.HLQ.IMP.INSTJCL member BDUPG09. This member executes VLSUTIL to replace the Version 14.0 DDOL sign-on and sign-off panels that are located in the environments ADRPNL library.
    Type
    UPG15
    in the command line and press Enter. The ISREDIT macro is invoked, and all the member variables are changed to your site standards.
    Submit the member for execution and then cancel out of it so the changes are not saved.
  7. Locate CAI.HLQ.IMP.INSTJCL member BDHST01. This member executes DBUTLTY to close the history database (DBID 1007).
    Type
    UPG15
    in the command line and press Enter. The ISREDIT macro is invoked, and all the member variables are changed to your site standards.
    Submit the member for execution and then cancel out of it so the changes are not saved.
  8. Locate CAI.HLQ.IMP.INSTJCL member BDHST02U. This JCL member rebuilds the Datadictionary/DDD definition for history database (DBID 1007) and posts the definition to the CXX to make the CXX definition for DBID 1007 current. At this time, we are adding area EVT and table EVT to the history database. This JOB does condition code setting based on error cases to populate each of the existing areas for the history database. It is normal to have some of the styeps bypassed because of condition codes.
    Type
    UPG15
    in the command line and press Enter. The ISREDIT macro is invoked, and all the member variables are changed to your site standards.
    Submit the member for execution and then cancel out of it so the changes are not saved.
These tasks complete the performance of one Parallel MUF Upgrade and Parallel MUF Implementation process. The original candidate Version 14.0 MUF is now fully operational on Version 15.1.
To perform another
CA Datacom®
MUF Version 14.0 to Version 15.1 upgrade using the Parallel MUF procedure, perform an additional Parallel Upgrade phase followed by a companion Implementation phase. The Parallel Upgrade phase and its companion Implementation phase can be done back to back. Or, they can be done in sets where multiple Parallel Upgrade phases are performed before performing their companion Implementations phases.