Displays the name and size from a tape's label
Synopsis
bak readlabel [-tcid tc_number] [-help]
Options
-tcid tc_number
Specifies the Tape Coordinator ID (TCID) of the Tape Coordinator for the tape drive containing the tape. If omitted, it defaults to 0 (zero).
-help
Prints the online help for this command. All other valid options specified with this option are ignored.
Description
The bak readlabel command displays the name and size from the label of the tape in the indicated tape drive. These values are placed on the tape with
either the bak dump command or the bak labeltape command.
Privilege Required
The issuer must be listed in the admin.bak files on all Backup Database machines.
Output
For tapes with complete labels, a message appears listing the name and size of the tape. The tape name is of the form fileset_family_name.dump_level.index. If
a tape has no name, the output reads NULL.
The tape size is expressed as follows: If an uppercase or lowercase "g" follows the size, it is a number of gigabytes; if an uppercase or lowercase "m" follows the size, it is a number of megabytes; if a lowercase "k" or the string Kbytes follows the size, it is a number of kilobytes.
If the tape is completely unlabeled or if the drive is empty, the output reads Failed to read tape label.
Examples
The following command shows the output for the tape with the label sys.Monthly.3. The capacity is 2 megabytes (expressed in kilobyte units). The tape is
currently in the drive with TCID 6.
$ bak read 6
Tape read was labelled : sys.Monthly.3 size : 2097152 Kbytes
The following command shows that the unlabeled tape in the drive with TCID 0 (zero) has a capacity of 5 gigabytes:
$ bak read
Tape read was labelled : NULL size : 5G
Related Information
Commands: bak dump(8dfs)