chbdsp command
Purpose
Changes the characteristics of a backing device within a storage pool.
Syntax
Increase the size of a backing device:
chbdsp [-sp StoragePool ] -bd BackingDevice {-size Size}
Rename a backing device:
chbdsp [-sp StoragePool ] -bd BackingDevice {-mv NewName}
Description
The chbdsp command changes attributes of the specified backing device. If the -size flag is specified the backing devices's size is increased. Size can be given in megabytes (###M/m) or gigabytes (###G/g).
If the -mv flag is specified, the backing device is renamed.
This command does not support shared storage pools.
Note: The backing
device that you specified cannot be assigned to a shared memory pool
(to be used as a paging space device by a shared memory partition).
Flags
Flag name | Description |
---|---|
-bd BackingDevice | Specifies the backing device. |
-mv NewName | Specifies the new name of the backing device. |
-size Size | Specifies the minimum amount of storage to add to the backing device. |
-sp StoragePool | Specifies the storage pool to be used. |
Exit Status
Return code | Description |
---|---|
23 | Specified storage pool is not a valid storage pool. |
39 | The given backing device is not in the specified storage pool. |
40 | File backing device names cannot exceed "38" characters in length. |
Examples
- To increase the size of a the backing device client1, in the default
storage pool by 3 gigabytes, type:
chbdsp -bd client1 -size 3g
- To rename the backing device cl_data, in the storage pool partition_3,
to bank_data, type:
chbdsp -sp partition_3 -bd cl_data -mv bank_data