The chrank command assigns an unassigned rank to an extent pool, or removes an assigned rank from a extent pool. This command can also be used to change an assigned rank to an unassigned rank.
>>-chrank--+-------------------------+--+-----------+-----------> '- -dev--storage_image_ID-' '- -reserve-' >--+-----------+--+------------+--------------------------------> '- -release-' '- -unassign-' >--+--------------------------+--+-rank_ID--+-------+-+-------->< '- -extpool--extentpool_ID-' | '-. . .-' | '-" - "--------------'
Parameters
- -dev storage_image_ID
- (Optional) Specifies the storage image ID, which consists of manufacturer, type, and serial number. This parameter is required if you do not specify a fully qualified ID for all ranks; otherwise, it is optional.
- -reserve
- (Optional) Specifies that the rank configuration state be set to Reserved.
- -release
- (Optional) Specifies that the rank configuration state be set to Normal.
- -unassign
- (Optional) Specifies that the rank configuration state be set to Unassigned.
- -extpool extentpool_ID
- (Optional) Assigns the rank to an extent pool. Accepts either a fully qualified extent pool ID including storage image ID or a shortened version if the -dev parameter is used. The shortened version is a four-digit decimal number with no leading zeroes, prefixed with the letter P.
- rank_ID . . . | -
- (Required) Specifies one or more ranks to be modified. Accepts either a fully qualified rank ID, or a rank number if the -dev parameter is used. A rank number is a four-digit decimal number with no leading zeroes, prefixed by the letter R.
Example (1750)
Invoking
the chrank command
dscli>chrank -dev IBM.1750-68FA120 -extpool P101 R2
The resulting output
Sun Aug 11 02:23:49 PST 2004 IBM DS CLI Version: 5.0.0.0 DS: IBM.1750-68FA120 Rank IBM.1750-68FA120/R2 successfully modified.