chbdsp command

Purpose

Change 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.

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

-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

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
```