Operands

The table below lists all of the operands you can use with the TAPEDSN command.

Table 1. List of operands for TAPEDSN command
Operand Description
QRY or QRY * Displays a list of all the data sets and the volume (or volumes) for each data set. For a Tape Manager catalog, this format is equivalent to using the data set name abbreviation 'user_name.*'
QRY dsnabbrv Returns data set information for data sets matching the abbreviation. The data set name abbreviation can be a complete data set name or an abbreviation of a data set name where one or more wild card characters are specified.

The dsnabbrv supports the use of regular expressions for the search argument. The following special characters are supported:

*
Represents zero (0) or more characters of any sort.
%
Represents one (1) required character of any sort.
#
Represents one (1) required numeric (0-9) character.
&
Represents one (1) required alphabetic (A-Z, a-z) character.
@
Represents one (1) required hex (A-F, a-f, 0-9) character.
"
Represents the escape character (to allow use of one of the special characters in a pattern).
A request from a non-administrative user, with an asterisk for the high-level qualifier (HLQ), will have the user ID substituted for the HLQ.
Note: When any of these characters are "special" to CP or CMS, an appropriate escape sequence must be entered in the command line for the character to be passed to Tape Manager.
ADD dsname Creates an occurrence of a data set using free volumes in a private pool. The rules for data set names in Tape Manager are:
  • The length of a data set name must not exceed 44 characters.
  • The length of a data set name qualifier must not exceed eight (8) characters.
  • The first character of a data set name qualifier should be alphabetic (A-Z) or national (# @ $). The remaining characters should be alphabetic, numeric (0-9), national, or a hyphen (-).
  • A data set name must not begin or end with a period (".").
  • A data set name must not contain two consecutive periods ("..").

Although the rules for data set names may vary among z/OS® releases, these conventions are intended to provide an acceptable level of compatibility with all levels of z/OS.

DEL dsname Deletes an occurrence of a data set and frees the volumes associated with the data set.
MOVE dsname POOL plowner plname Moves the volumes associated with the data set name to the pool specified by the pool owner and pool name.
REN dsname1 TO dsname2 Renames data set dsname1 to dsname2.
VOL qryvol Requests data set information related to a specific volume.
VOL volid Specifies the first (or only) volume of the data set. The volume must be specified when there are multiple occurrences of the data set. The volume is optional when there is only one occurrence of a data set.
VOL vollist Specifies a list of up to eight (8) volumes that will be associated with the data set name.
MSG Indicates the output will be returned as messages.
RDR Indicates the output will be returned as a reader file.
TERSE Suppresses the informational messages EUM0010I, EUM0074I, EUM0083I, EUM0084I, EUM0288I, and EUM0291I for the requestor.