Dataset Catalog dialog box

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

You access this dialog box in the Dataset Actions submenu. This submenu is available in the pop-up menu that you access by right-clicking specific views in a workspace.

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.

You can also create a custom action. See Create Batch Job dialog box, Issue Command dialog box, and Submit Command or Job dialog box.

The action request defines a catalog entry for a non-VSAM datasets or a collection of objects. The dialog box provides the following options:
  • Catalog: Identifies the catalog in which the non-VSAM dataset or OAM object is to be defined.
  • Device types: Specifies the device types of the volumes containing the non-VSAM dataset being defined. If the non-VSAM dataset 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 datasets 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 dataset. A Volser(s) value is required when you define a non-OAM non-VSAM dataset. 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 datasets 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 dataset.