manageckdvol

Parameters

-dev storage_image_ID

(Optional) The storage image ID, which consists of manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified volume ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter temporarily overrides any defined value for devid for the current command.

-action migstart|migcancel|migpause|migresume|sfdisable|spidfdisable|tierassign|tierunassign|etmonpause
|etmonresume|etmonreset|mksafeguardedcap|rmsafeguardedcap|migsafeguardedcap
|migsafeguardedcapcancel|migsafeguardedcappause|migsafeguardedcapresume |expandsafeguardedcap

(Required) One of the following actions is to be performed:

migstart

Initiates volume migration on the specified volumes that are in the "normal" or "canceled" state. Volumes are placed into the migrating state. Volumes that are in the canceled state must have the original source or the destination extent pool as the value of the -extpool parameter.

migcancel

Cancels volume migration on the specified volumes that are in the migrating state. Volumes that have not yet started migrating data are defined to a "normal" state. Volumes that have started migrating data are define to a "canceled" state.

migpause

Pauses volume migration on the specified volumes that are in the migrating state. Volumes that have not yet started migration or that are in the middle of migration are put in the "paused" state.

migresume

Resumes volume migration on the specified volumes that are in the "paused" state.

sfdisable

Sends a soft fence reset command to each specified volume. This action cannot be used with any other parameter.

spidfdisable

Sends a set path group ID (SPID fence reset command to each specified volume. This action cannot be used with any other parameters.

tierassign

Initiates the assigning volume action on the specified volumes to the specified tier. The -tier option is required with this action.

Note: By assigning a volume to a tier, a process that migrates the data in the volume to the specified tier begins. You can check the progress of the migration by using the showfbvol or showckdvol command with the -tier parameter. However, there is a maximum capacity that can be assigned to each tier in a pool. If this maximum capacity is reached, then all of the volumes that are still migrating to that tier, because of assignment, pause their migrations. You can check how much total capacity has been assigned to a specific tier in a pool by using the showextpool command with the -tier parameter. If the maximum was reached, you can remedy the problem either by unassigning other volumes from the tier or by adding more capacity to the tier. Either method automatically restarts any paused migrations.

tierunassign

Initiates the unassigning volume action on the specified volumes.

etmonpause

Easy Tier® monitoring of this volume is paused. During the pause, all Easy Tier storage migrations are unaffected, but no new migration plans are formed.

etmonresume

Easy Tier monitoring of this volume is resumed. All Easy Tier storage migrations are unaffected.

etmonreset

Easy Tier monitoring data (history), including migration plans are erased. All new plans are based on new monitoring data.

mksafeguardedcap

Creates the safeguarded backup capacity for one or more of the specified volumes.

rmsafeguardedcap

Deletes the safeguarded backup capacity, including all Safeguarded Copies, that were defined for one or more of the specified volumes.

migsafeguardedcap

Migrates the safeguarded backup capacity to a new pool for one or more of the specified volumes.

migsafeguardedcapcancel

Cancels migrating the safeguarded capacity to a new pool for one or more of the specified volumes.

migsafeguardedcappause

Pauses migrating the safeguarded backup capacity to a new pool for one or more of the specified volumes.

migsafeguardedcapresume

Resumes migrating the safeguarded backup capacity to a new pool for one or more of the specified volumes.

expandsafeguardedcap

Increases the safeguarded backup capacity for one or more of the specified volumes, without having to first delete existing backups or the Safeguarded Copy relationship.

-eam

(Optional) The extent allocation method as follows:

rotateexts

The extents for each new logical volume are allocated across all available ranks, and is also known as storage-pool striping. This value is the default.

rotatevols

The extents for each new logical volume are allocated from each successive rank. This means that the extents for a particular volume are allocated from one rank, while the extents for the next volume are allocated from the next successive rank, and so on.

Note: You can specify only the -eam parameter if -action migstart is also specified.

-extpool extent_pool_ID

(Optional) The multiplier value. Selecting the correct backup capacity multiplier depends on a number of factors. For example, the provisioned capacity being backed up, the number of copies, the interval over which the copies are kept, and the predicted destagerate of the volume data.

Note: When the command returns, the volume migration might still be occurring. It can be available for I/O and copy services during migration. Its configstate can indicate that it is migrating.

-multiplier multiplier

(Optional) The safeguarded virtual capacity multiplier value. Safeguarded virtual capacity is the amount of volume (virtual) capacity that is configured to store safeguarded backups for a safeguarded source. To configure the amount of virtual capacity that is required for safeguarded backups, you must determine an estimate for the safeguarded capacity multiplier.

Note: The size of the volume will be rounded to the nearest large extent. For CKD volumes, the size can be a multiple of 1113 cylinder granularity.

For more information about determining a backup capacity multiplier, see Configuring safeguarded virtual capacity.

-cap capacity

(Optional) The safeguarded backup capacity for one or more specified volumes. The unit type is set with the parameter -captype, if the unit type is not set. The default is cylinders.

-captype cyl | mod1

(Optional) The unit type for safeguarded backup capacity. If the unit type is not set, the default is cylinders.

cyl

The capacity unit type as cylinders. This capacity unit type can be selected only for CKD storage. One cylinder = 15 tracks.

mod1

The capacity unit type in mod1 units. This capacity unit type can be selected only for CKD storage (mod1 = 1113 cylinders).

-tier flashtier0 | flashtier1 | flashtier2 | ent | nl | nlexclude | hddexclude

(Optional) Which tier the volume is assigned to. This option is required with the -action tierassign parameter.

flashtier0

The tier of high-performance flash drives.

flashtier1

The first tier of high capacity flash drives.

flashtier2

The second tier of high capacity flash drives.

ent

Enterprise tier, which consists of drives with speeds of 10K RPM, 15K RPM, or a mixture of 10K RPM and 15K RPM speeds.

nl

Nearline tier consists of high-volume disks that are either SATA or SAS Nearline drives.

nlexclude

Enterprise tiers but not a Nearline tier.

hddexclude

Any tier except enterprise (ENT) or nearline (NL).

" - "

No assign action was specified.

-assignorder etdata|access

(Optional) The order in which the data is migrated. This option is valid only with the -action tierassign parameter.

etdata

While all data is scheduled to migrate, the migration order is based on the prioritization of the data as specified in the Easy Tier heat map. This value allows the specified volume to be pre-staged onto the specified tier. The value "etdata" is the default value if -assignorder is not specified.

access

While all data is scheduled to migrate, the data is migrated only when accessed. In other words, data that is never accessed is never migrated to the specified tier.

-duration time

(Optional) The hours of the pause time in ISO 8601 format. For example, -duration 24H. The maximum value of the time is a week, which is 168 hours (168H). You can specify this option only with -action etmigpause or etmonpause parameters.

Note: If you want the duration of the pause to be infinite, you must specify -duration 0H. Otherwise, if you do not specify a value with the -duration parameter, the default is 168H.

volume_ID ... | -

(Required) An array of one or more CKD base volume IDs or volume ID ranges to modify.

A volume ID range is defined by two volume IDs that are separated by a dash. Multiple volume IDs or volume ID ranges must be separated with a blank space between each ID.

Example: 0100-010F 0180-018F 0120

The volume ID format is four hexadecimal characters LLVV that represents the following values:

LL

The logical control unit number, 00 - FE

VV

The volume number, 00 - FF

You must fully qualify the volume ID with manufacturer, machine type, and serial number if you do not use the -dev parameter.

The ellipsis (...) indicates that, optionally, you can specify multiple values. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) if you are in the DS CLI interactive mode.