Skip to main content

storage tape alias clear

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