Creates the label on a tape
Synopsis
bak labeltape [-tape tape_name] [-size tape_size] [-tcid tc_number] [-help]
Options
-tape tape_name
Specifies the name to assign to the tape. If this option is omitted, the tape is marked as empty with a null identifier.
An assigned name must reflect the dump set that is to go on the tape. It must be of the form fileset_family_name.dump_level.index, where fileset_family_name and dump_level constitute the name of the dump set to go on the tape. The dump_level is the last component of the name of the appropriate dump level; the index is an integer that represents the tape's place in the collection of tapes needed to contain the entire dump set. If the dump set fits on one tape, the index is 1.
-size tape_size
Indicates the tape capacity. Providing this option is necessary only for information purposes. The Tape Coordinator uses the capacity specified in the
TapeConfig file for any tape used in its tape drive. If this option is omitted, the size specified in the TapeConfig file for the drive is used for the tape's label.
The default unit of size is kilobytes. It is also possible to express this number in megabyte or gigabyte units. To indicate megabyte units, add an uppercase or lowercase "m" with the number (with no space between the number and letter). To indicate gigabyte units, add an uppercase or lowercase "g" with the number (with no space between the number and letter).
-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 labeltape command creates a label, readable by the Backup System, at the beginning of a tape. The issuer can either assign a name with the
-tape option or omit the option to label the tape as empty.
The -size option is useful mainly for information purposes. The Tape Coordinator uses the capacity specified in the TapeConfig file for any tape used in its drive. It also copies the size specified in the TapeConfig file to the label of any tape that has no size specified in its label.
Labeling a tape is not a prerequisite to putting a dump set on it. The bak dump command accepts partially labeled or completely unlabeled tapes. However, the bak labeltape command can be used to overwrite an existing label. This is useful if the data on a tape is no longer needed, but the tape's label prevents the tape from being used (because the label bears an inappropriate name or contains an unexpired expiration date). Overwriting the label with this command removes the obstacle to the tape's reuse.
Privilege Required
The issuer must be listed in the admin.bak files on all Backup Database machines.
Examples
The following command puts the label user.monthly.1 on the tape in the drive whose TCID is 3:
$ bak la user.monthly.1 -tcid 3
The following three commands are equivalent in effect. They all mark the tape in the drive whose TCID is 4 with a capacity of 2 gigabytes and the default name null.
$ bak label -size 2g -tcid 4
$ bak label -size 2048M -tcid 4
$ bak label -size 2097152 -tcid 4
Related Information
Commands: bak readlabel(8dfs)