rmrank

The rmrank command deletes ranks from a storage image. This command is rejected if any volume extents in the rank are being used. In addition, this command formats the drives (DDMs). Until the formatting is done, the associated array cannot be removed.


>>-rmrank--+-------------------------+--+---------+------------->
           '- -dev--storage_image_ID-'  '- -quiet-'   

>--+-rank_ID--+-------+-+--------------------------------------><
   |          '-. . .-' |   
   '-" - "--------------'

Parameters

Note: The processing time that is associated with this command can be lengthy and might inhibit your use of the array on which this command is being processed.

When the rmrank command is issued, the following processing occurs:

The rank is unassigned from the array.
The rank is removed. When this is successful a message is displayed. This piece of the process does not take long; however, the processing that is associated with this command is not complete even though you have received a message that the rank was removed.
The array is formatted. This processing can take some time. During this processing the array cannot be removed or assigned to another rank. Also, until this process is fully completed, the array is listed as assigned to the rank from which it is has been removed.
You can check the progress of the rmrank command by logging onto another session of DS CLI. Issue the lsarray command against the storage unit where the rank or ranks are being deleted. When you no longer see the array that is assigned to the rank from which you removed it, the remove rank process is complete.

The following list defines the parameters that are associated with the rmrank command:

-dev storage_image_ID: (Optional) Specifies the storage image ID, which includes manufacturer, machine type, and serial number. This parameter is required if you do not specify a fully qualified ID for all ranks; otherwise, it is optional.
-quiet: (Optional) Turns off the confirmation prompt for this command.
rank_ID . . . | -: (Required) Specifies an array of one or more ranks to be deleted. This parameter accepts a fully qualified rank ID, which includes the storage image ID, or a shortened version without the storage image ID if the -dev parameter is specified. The shortened version is a four-digit decimal number with no leading zeroes, prefixed with the letter R.; To specify a range of rank IDs, separate the rank IDs with a hyphen.; You must separate multiple rank IDs or ranges of rank IDs with a space between each ID or range of IDs.; If you specify the dash (-), this parameter information is automatically supplied.

Example (1750)

Invoking the rmrank command

dscli>rmrank -dev IBM.1750-68FA120 R23

The resulting output

Sun Aug 11 02:23:49 PST 2004 IBM DS CLI Version: 5.0.0.0 DS: IBM.1750-68FA120

Are you sure you want to delete rank R23? [y/n]: Y

Sun Aug 11 02:23:49 PST 2004 IBM DS CLI Version: 5.0.0.0 DS: IBM.1750-68FA120

Rank R23 successfully deleted.