chtgtpool
Use the
chtgtpool command
to change description, name, or volume membership of an existing Replication
Manager pool.
- The pool name must be unique; it cannot be the same name as another Replication
Manager pool name.
- Volumes must be of the same device type.
- A volume cannot belong to multiple groups.
- Deleting volumes in a group can affect current sessions.
Syntax

>>-repcli-- --chtgtpool-- --+--------------------------+-- ----->
'--desc--"new_description"-'
>--+-------------------------+-- --+-----------------------+---->
'--addvol--volume-- [...]-' '--rmvol--volume--[...]-'
>-- --+-------------------------+-- --+--------+-- ------------->
'--loc--new_pool_location-' '--quiet-'
>--pool_name---------------------------------------------------><
Parameters
- -desc "new_description"
- An optional parameter that specifies the new user-defined description
of the pool. The maximum alphanumeric character length for this value is 250.
- -addvol volume [...]
- An optional parameter that specifies new volumes to add to the pool
specified. All volumes must be of the same device type and cannot belong to
multiple pools.
- -rmvol volume [...]
- An optional parameter that specifies volumes that are to be removed
from the pool specified.
- -loc new_pool_location
- An optional parameter that specifies the location of the pool.
- -quiet
- An optional parameter that turns off the confirmation prompt for this
command.
- pool_name
- Specifies the existing name of the pool to be changed.
Description
You can use the chtgtpool command to change description,
name, or volume membership of an existing Replication Manager pool.
Return values
Pool pool_name successfully modified.
Possible failures
- Pool pool_name does not exist.
- Pool pool_name already exists.
- Volume volume does not currently belong to pool pool_name.
- Volume volume already belongs to pool pool_name. You can only add volumes that do not already belong to the
pool specified.
- Volume volume already belongs to pool pool_name. A volume cannot belong to more than one pool.
- Volume volume already belongs to pool pool_name. A volume cannot belong to more than one pool.
- Volumes are not all of the same device type.
Examples
An invocation example:
repcli chtgtpool -loc newlocation mypool
The resulting output:
Pool mypool successfully modified.