Using the delete Command

Related Topics

Use this command and its parameters to do the following:

For more information about standard logical drives, FlashCopy and repository logical drives, and logical drive-to-LUN mappings, see the Subsystem Management Window online help.

This reference contains commands and parameters that are current with the latest storage management software. If you are managing storage subsystems running firmware for previous releases, not all of these commands may be supported. See the for a complete list of commands and their associated firmware levels.

If you want to...

Use this command and parameters

delete an array and its associated logical drives

Back to the top

Base Command and Required Parameters

delete array [array number];

where:

[array number] = the sequence number of the array, enclosed in square braces.

Example

Back to the top

Command statement:

delete array [3];

Execution results:

  • Array 3 and its associated logical drives are deleted.
  • Any data on this array is lost.

delete a standard logical drive

Back to the top

Base Command and Required Parameters

delete logicalDrive[logicalDriveLabel];

where:

[logicalDriveLabel] = the logical drive user label, enclosed in square braces

Important: If the logical drive user label contains more than one word, white space, or any special character(s), then enclose the label in double quotes. The square braces are required.

Example

Back to the top

Command Statement:

delete logicalDrive [Chevelle];

Execution Results:

  • The logical drive named Chevelle is deleted.
  • Any data on this logical drive is lost.

delete a FlashCopy logical drive

Back to the top

Base Command and Required Parameters

delete logicalDrive[logicalDriveLabel];

where:

[logicalDriveLabel] = the logical drive user label, enclosed in square braces

Important:

  • This syntax is identical to the delete logical drive syntax. The storage management software and firmware determine whether the specified logical drive is a standard logical drive or a FlashCopy logical drive and execute the command appropriately for each case.
  • If the logical drive user label contains more than one word, white space, or any special character(s), then enclose the label in double quotes. The square braces are required.

Example

Back to the top

Command Statement:

delete logicalDrive [Chevelle-S1];

Execution Results:

  • The FlashCopy logical drive named Chevelle-S1 is deleted.
  • The repository logical drive associated with Chevelle-S1 is also deleted and any data on it is lost.
  • The base logical drive associated with Chevelle-S1 is NOT deleted.

delete defined storage partition topology

Back to the top

Base Command and Required Parameters to Delete a Host Group

delete hostGroup ["group label"];

where:

["group label"] = the name of the host group you wish to delete, enclosed in square braces

Important:

  • If the group label contains more than one word, white space, or any special character(s), then enclose the label in double quotes. The square braces are required.
  • This command will also delete all host definitions that are part of this host group.

Base Command and Required Parameters to Delete a Host

Back to the top

delete host ["host label"];

where:

["host label"] = the name of the host you wish to delete, enclosed in square braces

Important:

  • If the host label contains more than one word, white space, or any special character(s), then enclose the label in double quotes. The square braces are required.
  • This command will also delete all host port definitions that are associated with this host.

Base Command and Required Parameters to Delete a Host Port

Back to the top

delete hostPort ["port label"];

where:

["port label"] = the name of the host port you wish to delete, enclosed in square braces

Important: If the port label contains more than one word, white space, or any special character(s), then enclose the label in double quotes. The square braces are required.

Examples

Back to the top

Command statement to delete a host group definition:

delete hostGroup ["Midwest Group"];

Execution result: The defined host group named "Midwest Group" is deleted and will no longer appear in the Subsystem Management Window Mappings View.  All host definitions that were part of the host group are also deleted.

Command statement to delete a host definition:

delete host ["Kansas City"];

Execution result: The defined host named "Kansas City" is deleted and will no longer appear in the Subsystem Management Window Mappings View. All host port definitions associated with this host are also deleted.

Command statement to delete a host port definition:

delete hostPort ["Kansas City A-1"];

Execution result: The defined host port named "Kansas City A-1" is deleted and will no longer appear in the Subsystem Management Window Mappings View.

delete a logical drive-to-LUN mapping

Back to the top

Base Command and Required Parameters

delete mapping logicalDrive=<logicalDriveLabel>

where:

<logicalDriveLabel> = the logical drive user label for which you are deleting the mapping.

Important:  

  • You can use this command with either a standard or a FlashCopy logical drive.
  • You must enclose the logicalDriveLabel in quotes if it contains more than one word, white space, or any special character(s).
  • You do not have to enclose the logicalDriveLabel in square braces when deleting a mapping.

Additional Parameters You Can Use

Back to the top

host or hostGroup=<host or hostGroup>;

where:

host or hostGroup = the defined name of the host or host group topological element for which you are deleting the mapping.

Important: If the host or host group label contains more than one word, white space, or any special character(s), then enclose the label in double quotes.

Note:

If you do not use the host or host group optional parameter when deleting a mapping, the Default Host Group mapping to the specified logical drive, if it exists, will be deleted by default.

Example

Back to the top

Command statement:

delete mapping logicalDrive="Chevelle-S1" host=BackupServer;

Execution result:

The logical drive-to-LUN mapping granting host BackupServer access to FlashCopy logical drive Chevelle-S1 is deleted.

Related Topics

Learn About the Script Editor

Using the Script Editor

Command Reference

Firmware Compatibility List

Learn About the Command Line Interface

Using the Command Line Interface