storage tape position

Modify a tape drive cartridge position

Availability: This command is available to cluster administrators at the admin privilege level.

Description

This command changes the tape drive cartridge position.

Parameters

-node {<nodename>|local} - Node
Use this parameter to specify the node to which the tape drive is attached.
-name <text> - Tape Drive Device Name
Use this parameter to specify the device name of the tape drive whose cartridge position needs to be changed. The format of the device -name includes a prefix to specify how the tape cartridge is handled and a suffix to describe the density of the tape. The prefix suggests 'r', 'nr' or 'ur' for rewind, no rewind, or unload/reload and a suffix shows density of 'l', 'm', 'h' or 'a'. For example, a tape device name for this operation might have the form "nrst8m" were 'nr' is the 'no rewind' prefix, 'st8' is the alias-name and 'm' is the tape density. You can use the 'storage tape show -device-names' command to find more information about device names of tape drives attached to a node.
-operation {weof|fsf|bsf|fsr|bsr|rewind|erase|eom} - Tape Position Operation
Use this parameter to specify the tape positioning operation. The possible values for -operation are:
  • weof - Write end-of-file marks
  • fsf - Forward space end-of-file marks
  • bsf - Backward space end-of-file marks
  • fsr - Forward space records
  • bsr - Backward space records
  • rewind - Rewind the tape
  • erase - Erase then entire tape media from current position
  • eom - Position the tape at end of data (end of media if full)
[-count <integer>] - Count for Positioning
Use this parameter to specify the count for a tape positioning operation. You can specify this parameter only with the following operations: weof, fsf, bsf, fsr, and bsr. The default value of this parameter is one.

Examples

The following example specifies a rewind operation on a tape device. Note the -count parameter does not need to be specified for this type of operation.
cluster1::> storage tape position -node cluster1-01 -name nrst8m -operation  rewind
        
The following example specifies an fsf (forward space filemark) operation on a tape device. Note the -count parameter specifies 5 forward space filemarks for this operation.
cluster1::> storage tape position -node cluster1-01 -name nrst1a -operation fsf -count 5
        
The following example specifies an eom (end-of-media) operation on a tape device. The 'eom' positions a tape at end of data (end of media if full). Note the -count parameter does not need to be specified for this type of operation.
cluster1::> storage tape position -node cluster1-01 -name rst0h -operation eom