Installing the AUTOIDMS Facility

In this section:

The following members must be renamed and copied into the appropriate libraries according to the chart below:

Member Name

Rename to

prefix.MASTER.DATA(IDMSDD1)

IDMSDD1

prefix.MASTER.DATA(AUTOIDMM)

AUTOIDMS

prefix.ACCESS.DATA(IDMSDD1)

IDMSDD1
x
AUTOIDMS and Secondary Dictionaries

How to:

AUTOIDMS is a utility that generates FOCUS Master Files for IDMS subschemas. 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, the IDMSIDD member of ddname FOCIDMS (or ACCESS). See How to Determine Which IDD Dictionaries Will Be Accessed for more information on how to set up a secondary dictionary environment.

x
Procedure: How to Determine Which IDD Dictionaries Will Be Accessed

If there is only one primary dictionary used to generate descriptions, skip to Changing the Default Data Set Names. This section sets up AUTOIDMS to access several IDD secondary dictionaries (these are the dictionaries where 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 a letter (A through Z), a 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

    prefix.MASTER.DATA(IDMSIDD)

    prefix.MASTER.DATA(IDMSIDDn)

    prefix.ACCESS.DATA(IDMSIDD)

    prefix.ACCESS.DATA(IDMSIDDn)
  3. Edit prefix.ACCESS.DATA(IDMSIDDn) to include the appropriate DBNAME and DICTNAME attributes on the first line. For example 
    SSCHEMA=IDMSNWKA,RELEASE=17,DBNAME=SYSDIRL,DICTNAME=SYSDIRL,$
  4. Edit prefix.FOCEXEC.DATA(AUTOIDMS). Locate the line that reads: 
    -DEFAULT &DICT_FILES=' '

    Change the value to include each of the identifiers selected in step 1, 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 uppercase.

  5. Repeat steps 2 and 3 for each of the identifiers that were selected in step 1.
x
Changing the Default Data Set Names

AUTOIDMS displays default output data set names for the Master File, Access File, and FOCDEF file. These defaults follow standard Information Builders naming conventions. The defaults are changed on a per-user basis by replacing the values on the screen and then logging them to disk for subsequent use. Alternatively, the AUTOIDMS FOCEXEC can be modified to include site-specific naming conventions for all users.

To customize the initial data set defaults for all users, edit the following lines in the AUTOIDMS member of 'userid.FOCEXEC.DATA'. Change the expression on the right-hand side of the equal sign as appropriate. The resulting expression must retain a length of 44 characters (&USERID accounts for eight characters). You only need to customize the following lines:

-SET &DSNP0=&USERID ||'.FOCIDMS.DATA          ';
-SET &DSNM0=&USERID ||'.MASTER.DATA           ';
-SET &DSNF0=&USERID ||'.FOCIDMS.DATA          ';

where:

&DSNP0

Is the parameter log data set.

&DSNM0

Is the Master File output data set.

DSNF0

Is the Access File output data set.
Top of page
x
Verifying IDMS and AUTOIDMS Installation

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

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

where:

n

Represents the secondary dictionary identifier.

subschema_name

Is the name of the appropriate subschema.

Information Builders