IMS™ Catalog Specification panel

The IMS Catalog Specification panel is displayed in the Template dialog (option 4.1) and in the Template Update Utility dialog (option 4.4).

On the panel, you specify the IMS catalog that contains the database definitions (DBDs) that you want the function to use. You identify the IMS catalog that the function is to use by specifying the subsystem that uses it.

Template dialog

The panel is displayed in the Template dialog when the template specified on the Template Entry panel has an IMS catalog name stored in it rather than a DBD library list and any of the following are true:
  • The ID of the subsystem used to identify the IMS catalog cannot be found in the FM/IMS installation options module.
  • The specified subsystem does not use IMS-managed ACBs.
  • One of the DBDs that the function uses cannot be found in the IMS catalog.
  • You issue the SSID command on the Template Specification panel.

The function searches the IMS catalog for a DBD for the database that the template is for and obtains a list of the segment types in the database from the DBD that it finds. For a new template, this list is used to create the template's segment list. For an existing template, if the template's segment list is not the same as this list, the function updates the template's segment list to make it the same.

The ID of the subsystem that you specify is saved in the template and is used for subsequent updates.

When you issue the SSID command, the panel displays the ID of the subsystem that is currently stored in your template.

Template Update Utility dialog

The panel is displayed in the Template Update Utility dialog when the Specify IMS catalog option is selected and the Skip database segment list update option is not selected. Both these options are on the Template Update Utility panel.

The utility uses the DBDs in the specified IMS catalog when either or both of these conditions are true:
  • The Specify DBDLIB list option is not selected.
  • The DBDs that were used the previous time the template's segment list was updated came from an IMS catalog rather than DBD libraries.

When this is the case, the utility searches the specified IMS catalog for a DBD for the database that the template is for and obtains a list of the segment types in the database from the DBD that it finds. If the template's segment list is not the same as this list, the utility updates the template's segment list to make it the same.

If the update of the template is successful, the utility saves the name of the specified IMS catalog in the template.

Note:
  1. When the Skip database segment list update option is not selected, the Specify IMS catalog and the Specify DBDLIB list options are selected, and the DBDs that were used the previous time the template's segment list was updated came from DBD libraries, the utility uses the DBDs in the libraries specified on the DBD Library List panel.
  2. When the Skip database segment list update, the Specify IMS catalog and the Specify DBDLIB list options are all not selected, the utility uses the DBDs in either the DBD library list stored in the template or the IMS catalog stored in the template.

Panel and field definitions

Figure 1. IMS Catalog Specification panel
 Process   Options   Help
────────────────────────────────────────────────────────────────────────────────
 FM/IMS                         IMS Catalog Specification panel                           
                                                                           
  IMS catalog:                                                                   
    Subsystem name  . . IFG1                                      
                                                                           
                                                                           
                                                                           
                                                                           
                                                                           
                                                                           
                                                                           
                                                                           
                                                                           
 Command ===>  
  F1=Help      F2=Split     F3=Exit      F7=Backward  F8=Forward   F9=Swap 
 F10=Actions  F12=Cancel
Subsystem name
Specify the ID of the subsystem that uses the IMS catalog that you want the function to get the DBDs from.

Only subsystems that use IMS-managed ACBs may be specified.

If you enter either no subsystem name or a subsystem name pattern, the Subsystem Selection panel is displayed. You can select a subsystem from the list of subsystems displayed on that panel.

Parent panels