ONTAP 9.12.1 commands

50←PDF
  • ONTAP 9.12.1 commands(CA08871-263en.pdf)
  • 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
    Top of Page