The following provides a description of each parameter for listing saved tapes:
Identifies the tapes for which to list information.
You can specify one volser to list information for that tape only. You can use a trailing asterisk as a pattern-matching character in volser to specify multiple volsers for which to list information.
You can specify a data set name to have CA VM:Tape list information only for the tapes on which the specified data set begins. If the specified data set name is part of a GDG, you can specify particular generations of the data set. Values for gdg are as follows:
The tape that contains the most recent generation of the data set
The tape that contains the generation of the data set that is n generations before the most recent generation
All tapes that contain generations of the data set
Note: For information about specifying data set names and generations, see Specifying Data Set Names.
If you want to specify another user's tapes, you must use the OWNEDBY option.
Specifies the information to list for the specified tapes, as follows:
Internal and external volsers for the specified tapes that are in the Bin system
Volsers and volume chaining information for the specified tapes
For each of the specified tapes: volser; owner; expiration date; type of label; real address, recording technique, and density of the tape drive on which the tape was created; user ID that last mounted the tape; number of times the tape was mounted; sequence number of the tape in a multivolume sequence if applicable; date the tape was last mounted; real address of the tape drive on which the tape was last mounted; values of displayable site-defined fields
For each data set name on the specified tapes: sequence number of the data set on the tape, date and time the data set was created; name of the data set.
For each of the specified tapes: volser; owner; expiration date; type of label; real address, recording technique, and density of the drives on which the tape was created.
For each of the specified tapes: same as DSN
For each data set name on the specified tapes: same as DSN plus expiration date of the data set; number of blocks recorded in the TMC for the data set; and user ID that created the data set.
For each of the specified tapes: volser, expiration date, and data set names
Unformatted contents of the TMC records for the specified tapes; site-defined fields whose display is suppressed are shown as all binary zeros
Note: By default, CA VM:Tape only lists data set information for a tape if the data set begins on that tape. If a data set spans multiple tapes and you want to list all the tapes in the sequence, you must specify the SEQUENCE option. You can only display values for site-defined fields that CA VM:Tape is configured to display. Check with your system administrator to find out which fields you can display.
If you specify the UNFMT option, you must use the FILE filename option to specify the file in which to store the output.
Limits the tapes for which to list information by expiration date.
EXPDT date specifies that CA VM:Tape is to list only those of the specified tapes whose expiration date is on or before a certain date. RETPD days specifies that CA VM:Tape is to list only those of the specified tapes that are due to expire within the specified number of days from the current date.
Note: For more information about values for date and days, see Setting Expiration Dates for Tapes..
Specifies the destination for the output from this command, as follows:
Output sent to : Variable-length format CMS file named filename svmuserid on the A-disk, where svmuserid is the user ID of the CA VM:Tape service virtual machine
Output sent to : Your virtual printer
Output sent to : Program stack, where it is placed in last in, first out (LIFO) or first in, first out (FIFO) order
Output sent to : Your terminal
If you are using CP SMSG, the only valid output destination is TERM.
Limits the tapes for which to list information by location, or specifies that CA VM:Tape is to list the location for each of the specified tapes.
If you specify one location or use a trailing asterisk as a pattern-matching character in location to specify multiple locations, CA VM:Tape only lists information for those of the specified tapes that are in the specified locations. CA VM:Tape also lists the location for each of the tapes.
If you specify an asterisk for location, CA VM:Tape lists the location for each of the specified tapes. If the ARM interface for a specified location is halted, CA VM:Tape lists any tape from that location as being in the non-ARM location.
Note: For more information about values for location, see LOCation location Option.
Specifies the user ID whose tape or data set information to list. If you specify one user ID or use a trailing asterisk to specify multiple user IDs, CA VM:Tape only lists information for those of the specified tapes that belong to the indicated user IDs. If you specify an asterisk for userid, CA VM:Tape lists information for all the specified tapes, regardless of user ID.
If you identified the tapes for which to list information by volser, use of this option requires ANYUSER authorization.
[Authorization: ANYUSER]
If you identified the tapes for which to list information by data set name, use of this option requires OWNEDBY authorization.
[Authorization: OWNEDBY]
If any of the specified tapes are part of a multivolume sequence, specifies that CA VM:Tape is to list information for all tapes in the sequence in the order in which they are chained.
[Authorization: OWNEDBY]
The following provides a description of each parameter for listing saved tapes by volser:
Indicates that the listed information is to include those of the specified tapes that are non-VM tapes. You can only use this option if you identified the tapes by volser.
|
Copyright © 2013 CA.
All rights reserved.
|
|