Dictionary/204 operation and file maintenance

Overview

This topic describes how to run jobs to perform Dictionary/204 tasks and maintain its files.

These jobs are all contained in RKOBJLIB. They are summarized in the following table and described in later sections.

Task	Job	Login privileges required
Restore Dictionary/204 files from the dump version created by DDBKP.	DDRST	File manager; System manager if operating on CCASYS
Restore M204PROC.	DDRSPROC	File manager
Reorganize Dictionary/204 files.	DDROG	Superuser; File manager; System manager if operating on CCASYS
Populate Dictionary/204 from a Model 204 file.	DDGEN	User
Set up DDGEN based on Dictionary/204 files.	DDGENSET	User
Update files using the Dictionary/204 File Management delayed processing batch job.	DDFIMCMD	System manager
Reinitialize the M204TEMP file.	DDTINIT	Superuser; File manager

Backing up Dictionary/204 files

Use DDBKP to back up the Dictionary/204 files, including:

METADATA
DATALINK
D204RPT
CCASYS
M204DCTL

The following guidelines apply when backing up Dictionary/204 files:

You can modify DDBKP to back up one or any combination of the Dictionary/204 files.
You must back up Dictionary/204 files, except M204TEMP, D204SYS, and M204PROC on a regular basis. The frequency of backup depends on the amount of Dictionary/204 updating.
You do not have to back up M204TEMP, because the file can be reinitialized at any time with DDTINIT.
M204PROC is backed up in a separate job, because it must be backed up after installing a new product, upgrading to a new release, or applying maintenance to M204PROC. See Backing up M204PROC.

Backing up M204PROC

The job to back up M204PROC is DDBKPRC.

Back up M204PROC before, and again after, updating its contents; for example, when you:

add procedures to support additional products
install a new version of a product

M204PROC could contain procedures for Dictionary/204.

You must back up M204PROC each time a product that transfers procedures into M204PROC is installed. Dictionary/204 does not update M204PROC.

Restoring Dictionary/204 files

The DDRST JCL assumes that the backup files are generation data groups. If you are going to use DDRST as given, use the appropriate IBM utility to create the generation data group files.

Because D204SYS is an intermediate file that holds data on a temporary basis, it is not included in the backup options. If desired, you can modify DDBKP and DDRST to include D204SYS for backup and restore.

Reorganizing Dictionary/204 files

DDROG uses the Model 204 File Load utility. Use the DDROG job to reorganize one or all of the following Dictionary/204 files:

METADATA DATALINK D204RPT CCASYS M204DCTL

Make a current backup before attempting to reorganize the file.
If you have any of the optional end-user products or if your Dictionary/204 has been extended by adding new entity types or new attributes to existing entity types, then fields have been added to METADATA that are not defined again with the standard procedure for defining standard fields. In this case, use one of the following techniques to define METADATA fields:

Use the DISPLAY command to display all the field definitions into an OUTFILE. Use this file as input for defining the fields again.
Run DDGEN for the METADATA file.
In Dictionary/204 File Management, use the RECREATE command to execute the commands with the inactive option. Using the inactive option puts the DEFINE commands into a procedure or a sequential OUTFILE.

Use this procedure or sequential OUTFILE as the input to the reorganization.

Run DDROG when the file to be reorganized is not in use.

You can reinitialize M204TEMP instead of reorganizing it.

Adding new fields to METADATA

When new fields are added to METADATA by adding new entity types or new attributes to existing entity types, define METADATA fields as described in Reorganizing Dictionary/204 files.

Reorganizing the D204RPT file

To reorganize D204RPT, use the following process:

Run the TRANSFR job to temporarily transfer procedures from D204RPT (replace FILENAME with D204RPT) to another Model 204 procedure file.
Run DDROG for D204RPT to reorganize the data and change file parameters.
Run the TRANSFR job again to transfer procedures from the temporary file (replace FILENAME with TEMPRPT) to the D204RPT file (replace M204PROC with D204RPT).

Populating Dictionary/204 from a Model 204 file

The DDGEN job populates Dictionary/204 from existing Model 204 files. You can specify up to 100 Model 204 files. Run DDGEN when creating Dictionary/204 for the first time or to update Dictionary/204 to include definitions of new files. DDGENSET, described in the next section, can be used as a front end to DDGEN.

To run DDGEN in ONLINE mode, see Creating or updating Dictionary entries with DDGEN.

Setting up DDGEN based on Dictionary/204 files

Use DDGENSET to select a set of defined Dictionary/204 files to run through DDGEN. DDGENSET reads the dictionary and automatically creates CCAIN and step override statements. The override statements are appended to the DDGEN JCL and used to update the files, including corresponding fields and procedures within the files, in the dictionary.

DDGENSET requires a dictionary entry for each file used to populate your dictionary. File entries must have a valid DDname. No other attribute is required.

A valid step override statement is generated if the dictionary entry contains correct data set information. If valid data set information is not present, you must edit the step override statement to specify the data set name or add it later through the Dictionary/204 File Management facility.

Using DDGENSET with more than 100 files

If you have more than 100 files (the limit for DDGEN), DDGENSET generates multiple sets of CCAIN and step override statements. DDGENSET generates step override statements and CCAIN into the OUTDDG1 data set. Split DDGENSET and use each set of CCAIN and step override statements to run DDGENSET once for each set of 100 files.

Editing DDGENSET

Edit DDGENSET as follows:

Enter missing data set information and delete files that do not actually exist as Model 204 files.
Add step override statements for data sets in excess of six. (If you have any Model 204 files with more than six data sets, only the first six data sets have step override statements.)
Add passwords in CCAIN for secured files.
Make additional changes as described in the comments section of the JCL.

DDGENSET is useful to synchronize Model 204 files with Dictionary/204.

Updating files using delayed processing

DDFIMCMD is a batch job that selectively updates Model 204 files having pending commands specified by the Dictionary/204 File Management facility.

Use the following commands to obtain a list of the files that have pending commands:

OPEN METADATA OPEN DATALINK OPEN M204PROC INCLUDE FIMO.PENDFILE

If you do not enter a file name for an output USE file, the list is displayed at the terminal.

For more information about the File Management facility, see the FILEMGMT overview.