Open a Database

You can use CA File Master Plus for IMS to browse and edit an IMS database. You can open a database that is not listed in your Directory List view by selecting a server and then selecting Open from the CA File Master for IMS menu. The following IMS database types are supported:

DEDB (Fast Path), HDAM, HIDAM, HISAM (browse only), HSAM (browse only), MSDB (Fast Path), PHDAM, PHIDAM, PSINDEX, SHISAM, SHSAM, Logical Database, Secondary Index.

Note: You can open only one database at a time.

Follow these steps:

1. Open the Directory List view.
2. Select a server.
3. Select Open Database from the CA File Master Plus for IMS menu.

   The Open Database wizard opens. The Server and IMSENV DSN fields are prefilled.

   Note: You can change the IMSENV DSN only in the Configure Mainframe Settings dialog.

4. Type the name of the IMS environment that contains the specifications for the IMS system.

   Note: The application supports standard ISPF wildcards. If you enter a wildcarded IMS environment name and click the Select button, the Select IMS Environment page displays. Select the IMS environment that you want from the table and click OK.

5. Click Next.

   The second page of the Open Database wizard opens.

6. (Optional) Type the DBD name that you want to use.

   Note: The application supports standard ISPF wildcards. If you enter a wildcarded DBD name and click the Select button, the Select a DBD page displays. Select a DBD from the table and click OK.

7. (Optional) Enter the name of a PSB or ACB that you want to use.

   Notes:

   • The application supports standard ISPF wildcards. If you enter a wildcarded PSB or ACB name and click the Select button, the Select a PSB or ACB page displays. Select a PSB or ACB from the table and click OK.
   • You must fill at least one of the DBD field or the PSB or ACB field. If you fill both fields, the DBD name works as a filter on the PSBs or ACBs list of PCBs.
8. Select Edit or Browse to specify the Open mode.

   Notes:

   • You must have authority to edit a database to use the Edit option. You cannot make changes to a database when you select Browse.
   • If change logging is enabled in the IMS environment, only browse mode will be available and a warning message at the top of the page is displayed. To choose edit mode for the database, either disable change logging in the IMS environment or choose a different IMS environment.
9. (Optional) Select the Use secondary index check box.

   Note: If you select the Use secondary index check box, the PSB or ACB Name field is grayed out and its content in these fields is ignored.

10. Click Next.
    • If a PSB or ACB name was specified, the Select PCB page opens.

      Select the PCB you want to work with and click Next.

    • If secondary index was selected, the Select Secondary Index page opens.

      Select the secondary index you want to work with and click Next.

11. If the IMS environment is defined as a DLI environment and the database type requires data set names, the Database DSN Specification page opens.

    Enter a data set name in the Data Set Name column of the table displayed and click Next. You must enter a data set name for each populated row in the table.

    Note: If any of the data set names you have specified is archived, the Restore Data Sets dialog displays. For more information about restoring data sets, see "Restore Data Sets."

12. Select one of the following Display mode options:
    • Character

      Displays segments in character format

    • Single Record

      Displays one segment at a time with the field names on the left and the formatted values on the right

      Note: If you select this option, you must specify a layout.

13. (Optional) Specify where to find layout information. Do one or both of the following:
    • Specify the Layout data set field.
      • Type the fully-qualified name of a data set that contains the segment layouts to be used.
      • Type a wildcarded layout name and click Select.

        The Select Data Set dialog opens. Select a layout data set and click OK.

    • Specify the Custom layout data set field.
      • Type the fully-qualified name of a custom layout data set.
      • Type a wildcarded custom layout data set name and click Select.

        The Select Data Set dialog opens. Select a custom layout data set and click OK.

14. (Optional) Specify selection criteria. Do one of the following:
    • Type selection conditions into the segment selection criteria text box.

      Note: For more information on valid selection conditions, see Selection Criteria Specifications.

    • Click Layout to build selection conditions based on the contents of the specified layout.

      Note: For more information on modifying selection criteria, see Modify Layout Selection Conditions.

      Note: If you specify selection criteria, you can click Validate to verify that the selection criteria listed are legitimate.

    • Click Import to import selection criteria from an existing selection criteria member.

      Note: For more information on importing selection criteria, see Import Selection Criteria.

15. Click Finish