Skip Navigation Links | |
Exit Print View | |
Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual Sun QFS and Sun Storage Archive Manager 5.3 Information Library |
1. User Commands (Man Pages Section 1)
2. Maintenance Commands (Man Pages Section 1M)
3. Library Functions (Man Pages Section 3)
4. Library Functions (Man Pages Section 3X)
5. File Formats (Man Pages Section 4)
NAME tplabel - Label tape SYNOPSIS tplabel -vsn vvvvvv -[new | old vv...] [-b blksize] [-w] [-V] [-erase] eq tplabel -vsn vvvvvv -[new | old vv...] [-b blksize] [-w] [-V] [-erase] eq:slot DESCRIPTION tplabel labels the tape volume specified by eq:slot. eq is the equipment number. If eq is a library, slot is the slot in the library containing the tape cartridge. The following sequence of labels is written: VOL1 HDR1 HDR2 tapemark EOF1 tapemark tapemark The labels conform to ANSI X3.27-1987 File Structure and Labeling of Magnetic Tapes for Information Interchange. -vsn vvvvvv specifies the volume serial name (VSN) of the tape being labeled. The VSN must be one to six characters in length. All characters in the VSN must be selected from the 26 upper-case letters, the 10 digits, and the following special characters: !"%&'()*+,-./:;<=>?_. If the media being labeled was previously labeled, the VSN must be specified by -old vv.... The "old" VSN is compared with the VSN on the media to assure that the correct media is being relabeled. If the media is not labeled (i.e., blank), -new must be specified to prevent the previous label comparison from being made. OPTIONS -V Verbose, lists label information written. -b blksize specifies the blocksize for this tape. The value must be one of 16, 32, 64, 128, 256, 512, 1024 or 2048 and represents the size of the tape block in units of 1024. This option overrides the default blocksize. -erase Erases the media completely before a label is written. This is a security feature that is nor- mally not necessary. Complete media erasure will take a long time to perform since all data in the media is erased. -w Wait for the labeling operation to complete. If an error occurs, it will be reported along with a completion code of 1. All labeling errors are also logged. Note: Canceling a command that is waiting for completion will not cause the opera- tion itself to be canceled.