Skip to main content

storage tape position

Contributors
Suggest changes
PDFs

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