Installing the AUTOIDMS Facility (CMS)

AUTOIDMS and Secondary Dictionaries (CMS)

By default, AUTOIDMS searches for subschema descriptions in the primary dictionary. However, subschemas frequently reside in dictionaries other than the primary dictionary. These are called secondary dictionaries. When a subschema being described by AUTOIDMS is located in a secondary dictionary, DBNAME= and DICTNAME= parameters are needed in the AUTOIDMS Access File, IDMSIDD FOCIDMS. See Determining which IDD Dictionaries will be Accessed for more information on how to set up a secondary dictionary environment.

Determining which IDD Dictionaries will be Accessed (CMS) in IDMS

If there is only one primary dictionary used to generate descriptions, skip to Verifying IDMS and AUTOIDMS Installation. This topic sets up AUTOIDMS to access several IDD secondary dictionaries (these are the dictionaries in which subschemas reside).

1. Determine which IDD dictionaries are accessed by AUTOIDMS. For each dictionary, select a one character identifier. This value is used to uniquely identify the dictionary for reporting purposes and is displayed on the Main Menu of AUTOIDMS. The identifier may be the letter A through Z, the number 0 through 9, or blank. For example, if you have a primary IDD dictionary and secondary dictionaries for production and test, you might select blank (primary dictionary), P (secondary production dictionary), and T (secondary test dictionary) as the identifiers.
2. Copy and rename the following files, once for each suffix selected in the previous step
   (where n represents the identifier):

From:	To:
IDMSIDD MASTER	IDMSIDDn MASTER
IDMSIDD FOCIDMS	IDMSIDDn FOCIDMS

3. Edit IDMSIDDn FOCIDMS to include the appropriate DBNAME and DICTNAME on the first line. For example

SSCHEMA=IDMSNWKA,RELEASE=14,DBNAME=SYSDIRL,DICTNAME=SYSDIRL,$

4. Edit AUTOIDMS FOCEXEC. Locate the line that reads:

-DEFAULT &DICT_FILES=' ' 

Change the value to include each of the identifiers selected in Step 1 of this topic, and only those values. The first character is used as the default dictionary on the AUTOIDMS Main Menu. For example, if you chose P, T, and blank as your identifiers and you wish to have the production dictionary as the default, the line would read:

-DEFAULT &DICT_FILES='PT '

This indicates the following dictionaries:

P	Is the IDMSIDDP dictionary.
T	Is the IDMSIDDT dictionary.
blank	Is the IDMSIDD dictionary.

Note: Characters must be entered in upper case.

5. Repeat Steps 2 and 3 above for each of the identifiers that were selected in Step 1.

Verifying IDMS and AUTOIDMS Installation (CMS)

To verify the installation process, begin a FOCUS session and enter:

TABLE FILE IDMSIDDn
PRINT SS_NAM_026
IF RECORDLIMIT EQ 10
END

where:

n

Represents the secondary dictionary identifier.

These commands, due to the record limit, will create a report that includes up to 10 subschemas from the selected dictionary. Repeat this report for each dictionary.

If the record limit was not included, the report would contain all subschemas for that dictionary defined in the DICTNAME. We recommend including the record limit. If you are looking for a particular subschema, execute

TABLE FILE IDMSIDDn
PRINT SS_NAM_026
WHERE SS_NAM_026 EQ 'subschema_name'
END

where:

subschema_name

Is the value you are interested in.