Fields of the Inquire/Update Entry Panel

From the entry panel you can specify any of the following selection criteria to control which volumes and data sets appear in the list:

Note: The relationship between each category is AND – meaning, all specified criteria in each category must be satisfied for a volume or data set to appear in the list.

SELECT BY

Note: SELECT BY selection criteria that are marked below with the H symbol permit character masking. For more information, see Character Masking.

Table 64 Inquire/Update Entry Panel SELECT BY Selection Criteria

Criterion	Description
MEDIA	Type of volume media.
DSNAME^M	Data set name. To indicate a specific generation of a GDG data set, specify the generation number in parentheses after the data set name. Example: DB.LOG96(-1). If a mask is specified for the data set name, Control-M/Tape displays the specified generation of all GDG data sets matching the specified mask. For more information, see Control-M/Tape Handling of Data Set Generations.
DSNAME^M
VOLSER from/to^M	Lowest and highest volume serial numbers.
SL-NAME from/to^M	Lowest and highest standard label name values.
POOL^M	Volumes of the specified pools.
LOCATION^M	Volumes in the specified locations (for example, VAULTA, VAULTB, MAINLIB).

SELECT BY DATE

Table 65 Inquire/Update Entry Panel SELECT BY DATE Selection Criteria

Criterion	Description
CREATE from/to	Earliest and latest data set creation dates to be included in the list.a
EXPIRE from/to	Earliest and latest volume and data set expiration dates to be included in the list.a
ACCESS from/to	Earliest and latest volume and data set last access dates to be included in the list.a

SELECT BY STATUS

Only volumes and data sets that meet the selected status criteria are displayed:

Table 66 Inquire/Update Entry Panel SELECT BY STATUS Selection Criteria

Criterion	Description
ACTIVE	Volumes that contain data sets (meaning, non-scratch), including volumes that are currently out of the library (checked out), vaulted, and volumes pending scratch.
SCRATCH	Volumes that have been scratched, including those that are pending scratch or deleted.
EDM CONTROL	Volumes under EDM control, including EDM volumes that are currently out of the library (checked out) and EDM volumes that are vaulted.
VAULTED only	Vaulted volumes and volumes that are pending vault only.
EXTERNAL	External volumes that are currently out of the library (checked out) and external volumes that are vaulted.
Robot onlya	Volumes that currently reside in a robotic tape library.

DISPLAY OPTIONS

Table 67 Inquire/Update DISPLAY OPTIONS

Option	Description
DISPLAY TYPE	Display type (or format) of the Media Database list. Valid values:a D – Data set format. V – Volume format. B – Format that lists both volumes and data sets. S – System programmer format. Examples of these formats are provided later in this chapter. Note: While in the Inquire/Update screen, the display type can be changed using the DISPLAY command.
RECORD TYPE	Identifies whether Media Database information from data set records, volume records or both should be displayed. Valid values are: Blank – The type of record to display is determined by specifications in the SELECT BY criteria fields. If data set criteria are specified (meaning, DSNAME), data set records are displayed (record type =D). If volume criteria are specified (meaning, MEDIA, VOLSER, SL-NAME, POOL, and LOCATION), volume records are displayed (record type =V). This is the recommended value. D – Data set record information. V – Volume record information. DV – Data set record information, followed by corresponding volume record information. VD – Volume record information, followed by corresponding data set record information.

Option

Description

DISPLAY TYPE

Display type (or format) of the Media Database list. Valid values:a

D – Data set format.
V – Volume format.
B – Format that lists both volumes and data sets.
S – System programmer format.

Examples of these formats are provided later in this chapter.

Note: While in the Inquire/Update screen, the display type can be changed using the DISPLAY command.

RECORD TYPE

Identifies whether Media Database information from data set records, volume records or both should be displayed. Valid values are:

Blank – The type of record to display is determined by specifications in the SELECT BY criteria fields. If data set criteria are specified (meaning, DSNAME), data set records are displayed (record type =D). If volume criteria are specified (meaning, MEDIA, VOLSER, SL-NAME, POOL, and LOCATION), volume records are displayed (record type =V). This is the recommended value.
D – Data set record information.
V – Volume record information.
DV – Data set record information, followed by corresponding volume record information.
VD – Volume record information, followed by corresponding data set record information.

The records are displayed in the format specified by field DISPLAY TYPE (see above).

A blank value for the RECORD TYPE field is recommended because:

When Control-M/Tape anticipates the desired record type, it is guaranteed that the volumes and data sets are listed in a logical, meaningful order.
The record type also determines the search method used by Control-M/Tape when listing the volumes and data sets. Leaving the RECORD TYPE field blank ensures that Control-M/Tape uses the optimal search method for a faster response time and best performance.

Control-M/Tape automatically selects an appropriate record type depending on the display type. The automatically selected record type can be overridden through a value specified in the RECORD TYPE field. This field should only be used when a sophisticated display is needed.

Note: Choosing a record type that does not match the selection criteria forces Control-M/Tape to scan the database record by record, instead of retrieving records through the index. This can cause considerable delay in retrieval of relevant records.

Parent Topic

Inquire/Update Entry Panel