Upgrade All Dictionaries and Systems

Installation Best Practices › Upgrade All Dictionaries and Systems

On an upgrade, be sure to update all application dictionaries and DC/UCF system definitions. If you maintain multiple SYSDIRL dictionaries or multiple CA IDMS message areas, be sure to upgrade each of those as well. For more information about SYSDIRL dictionaries, see Use a Single SYSDIRL Dictionary later in this guide.

Business Value:

By ensuring that all application dictionaries, SYSDIRL dictionaries, message areas, and DC/UCF systems are updated with the changes for the release being installed, you avoid problems caused when the definition of objects does not match what the software expects.

Additional Considerations:

If you do a manual (not using CA CSM) upgrade, configuration Job 10 updates only the application dictionary identified in the VARBLIST with parameter APPLDICT. To update additional application dictionaries, rerun steps APPLDEFS, DLODAIDN, APPLPROT, and APPLARSQ in JOB10 for each additional dictionary. You must alter the job stream on each execution to name the DMCL and target dictionary to be updated.

Additionally, you must update the definition of every DC/UCF system in use with new and revised task and program definitions. This two-step process is described next.

Update SYSTEM 99 in each of your SYSTEM dictionaries. The JCL generated for Job09 contains a section that adds sysgen source to the system dictionary. This section uses IDMSDDDL to load the DLODxxxx or DNODxxxx members, depending on the option you chose for the STORPROT variable. Subsequent steps update SYSTEM 99 for various products. Extract the sysgen steps and run them against each of your system dictionaries, altering the job stream on each execution to identify the appropriate DMCL.
Update each of your system definitions.
The simplest way to update your system definitions is to copy the task and program definitions from SYSTEM 99 to your DC/UCF system. Copying can be done by rerunning the SGN90GJU step from JOB16 and changing the number of the target system from 90 to that of your DC/UCF system. The input to JOB16 is shown next:
```
//SYSIPT DD *
  SIGNON DICTIONARY SYSTEM
  USA UPDATE FOR DDLDML
  USA UPDATE FOR DDLDCLOD
  USA RET FOR DDLDCMSG
  SET OPT FOR SESSION DEF ON NO LIST INP 1 THRU 72.
  MODIFY SYSTEM nnn.
  COPY TASK FROM SYSTEM 99.
  COPY PROGRAM FROM SYSTEM 99.
  GENERATE.
```