chfbvol

Parameters

-v on | off

(Optional) Turns verbose mode on or off. The default is off. You can specify -v on or -v off to turn verbose mode on or off; but if you specify only -v, you get an error.

-bnr on | off

(Optional) Turns the banner on or off. The default is on. You can specify -bnr on or -bnr off to turn the banner on or off; but if you specify only -bnr, you get an error.

-dev storage_image_ID

(Optional) The storage image ID, which consists of the 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.

-name new_volume_name

(Optional) The nickname for this volume. A nickname cannot exceed 16 characters.

-type ess | ds | blocks

(Optional) The unit type of capacity that is specified by the -cap parameter.

ess

The unit is 10^9 bytes.

ds

The unit is 2^30 bytes.

blocks

The unit is 512 blocks.

TiB

The unit is tebibytes (TiB) 2^40 bytes.

GiB

The unit is gibibytes (GiB) 2^30 bytes.

MiB

The unit is mebibytes (MiB) 2^20 bytes.

Note: If the -type parameter is not specified, the LUN is created as type ds.

-cap new_capacity

(Optional) The storage size that you want to allocate to the specified volume. Check your operating system documentation to ensure that volume expansion is supported before you proceed with the expansion.

• If the -type parameter is omitted or the -type ds parameter is specified, the new_capacity value is the volume size in gibibytes (GiB), where 1 gibibyte (GiB) = 1 073 741 824 (2^30 bytes).
• If the -type ess parameter is specified, the new_capacity value is the volume size in gigabytes (GB), to the nearest 1/10 GB (format xxxx.x), where one GB = 1 000 000 000 (10^9 bytes).
• If the -type blocks parameter is specified, the new_capacity value is the volume size in 512 byte blocks.

Notes:

1. The maximum volume size varies and depends on storage system model and type.
2. If you attempt to reduce the volume size, the command fails.

-quiet

(Optional) Turns off the confirmation prompt for this command.

-perfgrp performance_group_ID

(Optional) The performance group ID that the volumes are assigned to. The performance group ID begins with the letters PG. The default is PG0.

-resgrp resource_group_ID

(Optional) The resource group that the volumes are assigned to. The resource group ID begins with the letters RG and ends with a decimal number.

volume_ID ... | -

(Required) One or more volume IDs to be modified. The volume ID is a 32-bit number that can be represented as four hexadecimal digits in the form of XYZZ where:

X

The address group, 0 - F.

XY

The logical subsystem number, 00 - FE.

ZZ

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.

To specify a range of volume IDs, separate the volume IDs with a hyphen.

You must separate multiple volume IDs or ranges of volume IDs with a blank space between each ID or range of IDs.

Example: 0100-010F 0180-018F 0120

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