Skip to main content

storage tape alias clear

Contributors
Suggest changes
PDFs

Clear alias names

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

Description

This command clears alias names for a tape drive or media changer.

Parameters

-node {<nodename>|local} - Node

Use this parameter to specify the node to which the tape drive is attached.

{ -name <text> - Alias Name That Is to Be Cleared

Use this parameter to specify the alias name that is to be cleared. You can use the 'storage tape show -alias' command to find more information about alias names of tape drives and media changers attached to a node. The -clear-scope and -name parameters are mutually exclusive. If you specify the -name parameter, a single alias name is cleared.

| -clear-scope {tape|media-changer|all} - Scope of Alias Clear Operation }

Use this parameter to specify the scope of the alias clear operation. The -clear-scope and -name parameters are mutually exclusive. If you specify the -clear-scope parameter, multiple aliases are cleared depending upon the value of the parameter.

The possible values for -clear-scope are as follows:

  • tape - Clear all tape drive aliases

  • media-changer - Clear all media-changer aliases

  • all - Clear both tape drive and media-changer aliases

Examples

The following example clears an alias name 'st3' attached to the node, cluster1-01.

cluster1::> storage tape alias clear -node cluster1-01 -name st3

The following example clears all tape drive alias names attached to the node, cluster1-01.

cluster1::> storage tape alias clear -node cluster1-01 -clear-scope tape

The following example clears all media changer alias names attached to the node, cluster1-01.

cluster1::> storage tape alias clear -node cluster1-01 -clear-scope media-changer

The following example clears both tape and media changer alias names attached to the node, cluster1-01.

cluster1::> storage tape alias clear -node cluster1-01 -clear-scope all