Dataset Catalog dialog box

You use this dialog box to define a catalog entry for a single non-VSAM data set you have selected in the Tivoli® Enterprise Portal.

To learn about the standard capabilities of a dialog box, see Standard tabs in the dialog boxes of the Storage Toolkit. The topic includes a link to the Reference guides for commands that are used in the Storage Toolkit.

The action request defines a catalog entry for a non-VSAM data sets or a collection of objects. The dialog box provides the following options:
  • Catalog: Identifies the catalog in which the non-VSAM data set or OAM object is to be defined.
  • Device types: Specifies the device types of the volumes containing the non-VSAM data set being defined. If the non-VSAM data set is located on different device types, the device types must be specified in the same order as the volume serial numbers listed in the Volser(s) parameter.

    You can specify a generic device name that is supported by your system, using up to six characters. For example, 3380, 3390, 3400-2, and 3400-5 are valid device types.

    If you expect to change the device type of the system residence volume, you can enter four zeroes (0000) in one of the rows of the Device Types table. At LOCATE and DELETE time, this field is resolved to the device type. This method allows you to use the non-VSAM data sets without having to recatalog them to point to the new volume. A Device Type value of 0000 causes the actual device type to be determined from the current system residence volume (or its logical extension) at the time the catalog entry is retrieved.

    To avoid an erroneous result, you must use this wildcard convention (0000) with a Volser(s) parameter of the following types:
    • An indirect volume serial (******) identifier.
    • An extended indirect volume serial (a system symbol) identifier in the form &xxxxx, where &xxxxx is a symbol contained in some system library. The volume must be mounted and on line at the time the catalog entry is retrieved from the catalog. If it is not mounted and on line, the catalog request is terminated with a return and reason code.
  • Volser(s): Specifies the volumes that contain the non-VSAM data set. A Volser(s) value is required when you define a non-OAM non-VSAM data set. As mentioned in the previous field description, you can also specify indirect volume serial identifiers and extended indirect volume serial identifiers.

    When you use the wildcard specification of six asterisks (******), the system dynamically resolves this specification to the system residence volume serial number, whenever the catalog entry is used. This value is not resolved when the DEFINE NONVSAM command is processed. This behavior allows you to later change the volume serial number of system residence volume without also having to recatalog the non-VSAM data sets on that volume.

  • Recatalog: Specifies that the catalog entries are recreated if valid VVDS entries are found on the primary VVDS volume. RECATALOG can be specified only for an SMS-managed data set.