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

  1. To increase the size of a the backing device client1, in the default storage pool by 3 gigabytes, type:
    chbdsp -bd client1 -size 3g
  2. 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



Last updated: Wed, November 18, 2020