Upgrade Installation Phase

Upgrade Installation Phase steps for upgrading to 15.0 or 15.1 from 14.0
datacom
The following comprehensive list shows all possible steps for 
CA Datacom®
 Version 14.0 to Version 15.x upgrade installations only.
Before you perform these steps:
  • Back up your entire 
    CA Datacom®
     environment using your standard site procedure.
  • Run ADSDC14 before beginning this process. If ADSDC14 receives Condition Code (CC) 0000, you are ready to proceed. If CC is not 0000, contact Broadcom Support. If you ran ADSDC14 and the reported problems were dealt with successfully, proceed with this process. The 
    CA Datacom® Datadictionary™
     Comparator Process (DDSDCLM) must run to a successful conclusion before running BDUPG03. For more information, see DDSDCLM - Comparing DATA-DICT Prior to Upgrading in the 
    CA Datacom® Datadictionary™
     documentation.
  • Complete the SMP/E jobs described in the following topics (as appropriate):
  • For more information about upgrading from Version 14.0, see the Version 15.x README.
For this phase of installation, run the INSTJCL library members whose names start with 
BDUPG
.
 
Step
 
 
Description
 
 
Purpose
 
1
Retrieve BDUPG01 from INSTJCL, perform changes as directed, and submit the JCL.
Add JCLLIB members and the 
CA Datacom®/DB
 upgrade data sets.
2
Retrieve BDUPG02 from INSTJCL, perform changes as directed, and submit the JCL.
Start the 
CA Datacom®/DB
 Version 14.0 MUF.
3
Retrieve BDUPG03 from INSTJCL, perform changes as directed, and submit the JCL.
Run the 
CA Datacom® Datadictionary™
 and DDD backups.
3B
 
(Conditional)
 Retrieve BDUPG03B from INSTJCL, perform changes as directed, and submit the JCL.
Back up the Version 14.0 
CA Dataquery™ for CA Datacom®
 database.
3R
 
(Conditional)
 Retrieve BDUPG03R from INSTJCL, perform changes as directed, and submit the JCL.
Reload database files from Version 14.0 backups. This can be used as a hard restore back from Version 15.x to Version 14.0. If you made changes to the CXX, DD, or DDD or have SQL, all changes are lost. This is not recommended. It is only used as a last resort. We recommend the soft fall back process as defined for this type of upgrade.
4
Retrieve BDUPG04 from INSTJCL, perform changes as directed, and submit the JCL.
Shut down the 
CA Datacom®/DB
 Version 14.0 MUF.
5
Retrieve BDUPG05 from INSTJCL, perform changes as directed, and submit the JCL.
Start up the 
CA Datacom®/DB
 Version 15.x MUF.
6
Retrieve BDUPG06 from INSTJCL, perform changes as directed, and submit the JCL.
Performs the actual upgrade to DD/DDD and HSD RESET. Defines SYSTEMTABLES for this MUF instance.
6B
 
(Conditional)
 Retrieve BDUPG06B from INSTJCL, perform changes as directed, and submit the JCL.
Initialize and load the panel files in the 
CA Dataquery™ for CA Datacom®
 database.
7
Retrieve BDHST01U from INSTJCL, perform changes as directed, and submit the JCL.
Performs a close on history database (DBID 1007).
8
Retrieve BDHST02U from INSTJCL, perform changes as directed, and submit the JCL
Updates the definition for history database and posts to the CXX. Null loads the database areas/tables as needed.
9
Retrieve BDUPG07 from INSTJCL, perform changes as directed, and submit the JCL.
Back up the upgraded 
CA Datacom®/DB
 Version 15.x CXX and 
CA Datacom® Datadictionary™
.
9B
Retrieve BDUPG07B from INSTJCL, perform changes as directed, and submit the JCL.
Back up the upgraded 
CA Dataquery™ for CA Datacom®
 Version 15.x database.
10
Retrieve BDUPG08 from INSTJCL, perform changes as directed, and submit the JCL.
Shut down the 
CA Datacom®/DB
 Version 15.x MUF.
11
Retrieve BDUPG09 from INSTJCL, perform changes as directed, and submit the JCL.
Load the VLS files for Version 15.x.
Step 1. Add JCLLIB Members
This step:
  • Executes IEBUPDTE to add the customized JCLLIB members
  • Allocates the backup and VLS files for 
    CA Datacom®/DB
     Version 15.x
  • Allocates all the database areas and control data sets
  • Formats and loads all the databases and control areas for the MUF
 
Follow these steps:
 
  1. Retrieve member BDUPG01 from your INSTJCL library.
  2. Make the required global changes (see the instruction block).
  3. Submit the JCL to complete this step.
  4. Review the output for successful completion which is indicated by a condition code of 00. If you receive any other code, correct your changes and resubmit the JCL.
Pay special attention to the edit instructions concerning 
CA Datacom® Datadictionary™
 user entities.
Pay attention to the allocation sizes of the backup data sets. If your 
CA Datacom®
 environment is large, consider increasing the allocation size of these data sets.
Step 2. Start Up the Version 14.0 MUF
This step starts the Version 14.0 MUF. This MUF is configured to run the upgrade process and there is no need to modify the MUF startup options. This Version 14.0 MUF assumes that your site has already APF authorized the libraries.
 
Follow these steps:
 
  1. Retrieve member BDUPG02 from your INSTJCL library.
  2. Make the required global changes (see the instruction block).
  3. Submit the JCL to complete this step.
No condition code is expected because the MUF stays up through Step 4.
Step 3. Back Up Version 14.0 CXX and 
CA Datacom® Datadictionary™
 
This step executes DBUTLTY to back up the Version 14.0 
CA Datacom®/DB
 CXX and 
CA Datacom® Datadictionary™
. Backup is taken before any maintenance is applied to the Version 14.0 
CA Datacom® Datadictionary™
 and HSD RESET is performed.
 Run ADSDC14 before running this job. If ADSDC14 receives CC 0000, you are ready to proceed. If CC is not 0000, contact Broadcom Support. If you ran ADDSC14 and the reported problems were dealt with successfully, proceed with this job. The 
CA Datacom® Datadictionary™
 Comparator Process (DDSDCLM) 
must
 run to some kind of successful conclusion before running BDUPG03. For more information, see DDSDCLM in the 
 
CA Datacom® Datadictionary™
 
documentation.
 
Follow these steps:
 
  1. Retrieve member BDUPG03 from your INSTJCL library.
  2. Make the required global changes (see the instruction block).
  3. Submit the JCL to complete this step.
  4. Review the output for successful completion which is indicated by a condition code of 00. If you receive any other code, correct your changes and resubmit the JCL.
This backup job step acts as a checkpoint. If any failure occurs in a job through BDUPG08, you can restore your 
CA Datacom® Datadictionary™
 and CXX from the backup files created here using INSTJCL library member BDUPG03R.
Pay special attention to the edit instructions concerning 
CA Datacom® Datadictionary™
 user entities.
Step 3B. Back Up Version 14.0 Database for 
CA Dataquery™ for CA Datacom®
 
 
Conditional
 
This step executes DBUTLTY to back up the Version 14.0 
CA Dataquery™ for CA Datacom®
 database.
 
Follow these steps:
 
  1. Retrieve member BDUPG03B from your INSTJCL library.
  2. Make the required global changes (see the instructions block).
  3. Submit the JCL to complete this step.
  4. Review the output for successful completion which is indicated by a condition code of 00. If you receive any other code, correct your changes and resubmit the JCL.
Step 3R. Reload Database Files
 
Conditional
 
This step executes DBUTLTY to reload the 
CA Datacom®/DB
 databases from the backup taken in Step 3. Execute this job only if an upgrade has to fall back to the point where the 
CA Datacom®
 CXX and 
CA Datacom® Datadictionary™
 were backed up in Step 3. Your changes are lost if you use this job after running on Version 15.x and changes were made using SQL or to the DD/DDD/CXX. The last step of this job is for 
CA Dataquery™ for CA Datacom®
. You can remove this step if you do not have this product.
 
Follow these steps:
 
  1. Retrieve member BDUPG03R from your INSTJCL library.
  2. Make the required global changes (see the instructions block).
  3. Submit the JCL to complete this step.
  4. Review the output for successful completion which is indicated by a condition code of 00. If you receive any other code, correct your changes and resubmit the JCL.
Step 4. Shut Down the Version 14.0 MUF
This step executes DBUTLTY to shut down the Version 14.0 MUF.
 
Follow these steps:
 
  1. Retrieve member BDUPG04 from your INSTJCL library.
  2. Make the required global changes (see the instruction block).
  3. Submit the JCL to complete this step.
  4. Review the output for successful completion which is indicated by a condition code of 00. If you receive any other code, correct your changes and resubmit the JCL.
Review, edit, execute, and complete this step before continuing.
Step 5. Start Up the Version 15.x MUF
This step starts up the 
CA Datacom®/DB
 Version 15.x MUF.
Bring up this MUF with the startup options that you used for your current Version 14.0 MUF as modified for Version 15.x. For example, the EXPAND option is no longer supported. Review the 
CA Datacom®/DB
 documentation for other changes to the MUF startup option. This process eliminates the need to recycle your MUF once the upgrade is complete.
 
Follow these steps:
 
  1. Retrieve member BDUPG05 from your INSTJCL library.
  2. Make the required global changes (see the instruction block).
  3. Submit the JCL to complete this step.
No condition code is expected because the MUF stays up through Step 9.
Step 6. Upgrade DATA-DICT, DDD-DATABASE CASYSTEMTABLE Databases
This step executes DDUPDATE to update the DD and DDD to become Version 15.x and DDCFBLD performs an HSD RESET. DDUPDATE defines the CASYSTEMTABLES database. No initialization or load is required or recommended for CASYSTEMTABLES.
 
Follow these steps:
 
  1. Retrieve member BDUPG06 from your INSTJCL library.
  2. Make the required global changes (see the instruction block).
  3. Submit the JCL to complete this step.
  4. Review the output for successful completion which is indicated by a condition code of 00. If you receive any other code, correct your changes and resubmit the JCL.
Step 6B. Load 
CA Dataquery™ for CA Datacom®
 Database
 
Conditional
 
This step executes DQLANGMT to load the new panel files.
 
Follow these steps:
 
  1. Retrieve member BDUPG06B from your INSTJCL library.
  2. Make the required global changes (see the instruction block).
  3. Submit the JCL to complete this step.
  4. Review the output for successful completion which is indicated by a condition code of 00. If you receive any other code, correct your changes and resubmit the JCL.
 Verify that the DQM backup file allocation is large enough for your site requirements.
Step 7. Close history database
This step executes DBUTLTY to perform a COMM CLOSE for DBID 1007 (History database).
 
Follow these steps:
 
  1. Retrieve member BDHST01U from your INSTJCL library.
  2. Make the required global changes (see the instruction block).
  3. Submit the JCL to complete this step.
  4. Review the output for successful completion which is indicated by a condition code of 00. If you receive any other code, correct your changes and resubmit the JCL.
Step 8. Updates the definition for history database and posts to the CXX
This process ensures that all database areas and tables of the history database are present. The process determines what items are missing and adds them to the environment. The end result is that your history database has three single-table areas defined and marked loaded with no data.
 
Follow these steps:
 
  1. Retrieve member BDHST02U from your INSTJCL library.
  2. Make the required global changes (see the instruction block).
  3. Submit the JCL to complete this step.
  4. Review the output for successful completion which is indicated by an Expected Condition Code EQ 00, 04 OR 08. If you receive any other code, correct your changes and resubmit the JCL or research why you received the error. The last step should have CC 00.
Step 9. Back Up Version 15.x CXX and 
CA Datacom® Datadictionary™
/DDD
This step executes DBUTLTY to back up the Version 15.x CXX and 
CA Datacom® Datadictionary™
.
 
Follow these steps:
 
  1. Retrieve member BDUPG07 from your INSTJCL library.
  2. Make the required global changes (see the instruction block).
  3. Submit the JCL to complete this step.
  4. Review the output for successful completion which is indicated by a condition code of 00. If you receive any other code, correct your changes and resubmit the JCL.
Step 9B. Back Up Version 15.x 
CA Dataquery™ for CA Datacom®
 Database
 
Conditional
 
This step executes DBUTLTY to back up the Version 15.x 
CA Dataquery™ for CA Datacom®
 database after an upgrade.
 
Follow these steps:
 
  1. Retrieve member BDUPG07B from your INSTJCL library.
  2. Make the required global changes (see the instruction block).
  3. Submit the JCL to complete this step.
  4. Review the output for successful completion which is indicated by a condition code of 00. If you receive any other code, correct your changes and resubmit the JCL.
Step 10. Shut Down the MUF (Optional)
This step executes DBUTLTY to shut down the MUF.
 
Follow these steps:
 
  1. Retrieve member BDUPG08 from your INSTJCL library.
  2. Make the required global changes (see the instruction block).
  3. Submit the JCL to complete this step.
  4. Review the output for successful completion which is indicated by a condition code of 00. If you receive any other code, correct your changes and resubmit the JCL.
Review, edit, execute, and complete this step before continuing.
Step 11. Allocate Backups and Load VLS Files
This step allocates the upgrade backup VLS files and loads the VLS files.
 
Follow these steps:
 
  1. Retrieve member BDUPG09 from your INSTJCL library.
  2. Make the required global changes (see the instruction block).
  3. Submit the JCL to complete this step.
  4. Review the output for successful completion which is indicated by a condition code of 00. If you receive any other code, correct your changes and resubmit the JCL.
The upgrade installation phase is now complete. Proceed with the steps in the Installation Verification Phase to demonstrate your upgrade installation.