chrgmbr

Name

chrgmbr - Changes the persistent attribute value(s) of a managed resource in a resource group.

Synopsis

chrgmbr [-h] [-i] [-c New_group] [-m T | F] [-T] [-V] -g Resource_group [-p A |O]

chrgmbr [-h] [-i] -s [ -c New_group] [-m T | F] [-T] [-V] [-g Resource_group] [-p A |O[,Failback] "selection_string"

chrgmbr [-h] [-i] [-c New_group] [-m T | F ] [-T] [-V] -s [-g Resource_group] [-p A |O[,Failback] Resource_class:"selection_string" [Resource_class:"selection_string" [...]]

chrgmbr [-h] [-i] [-c New_group] [-m T | F ] [-T] [-V] [-g Resource_group] [-p A |O[,Failback] Resource_class:Resource_name[:Node][,Resource_name[:Node][,...]] [Resource_class:Resource_name[:Node][,Resource_name[:Node][,...]] [... ]]

Description

The chrgmbr command changes the attributes of the specified member resources. When the selection string is the only parameter, then it is applied directly to IBM.ManagedResource class. Otherwise, a resource name or selection string must be specified with the class to which it belongs. This command allows the user to specify changes to the Mandatory attribute of a managed resource by using the -m option and also allows the user to change the resource group to which the resource belongs by using the -c option. A fixed resource must include the resource class and the node name at which it resides. The resource class and resource name, the resource name and the node must be separated by a colon.

Options

-c New_group

Specifies a new resource group name, which changes the MemberOf attribute of the managed resource. This option specifies the Resource_group, or changes the Resource_group of which this managed resource is a member, to the New_group.

-g Resource_group

Specifies the name of the resource group of which the resources are members. This represents the MemberOf attribute of the Managed Resource.

-h

Writes the command's usage statement to standard output.

-i

Interactive. Prompt before changing resource groups.

-m T | F

Specifies whether this managed resource is required in the resource group.

T: TRUE. These managed resources are required by the resource group.
F: FALSE. These managed resources are not required by the resource group.

-p A|O[,Failback]

Specifies the method to be used when selecting a node for placing the resource on. The value can be:

A: Any.
O: Ordered. This is the default.
Failback: Optional. Occurrence as comma separated value. In combination with O (Ordered) only.

-s

Specifies that a selection string will be used.

-T

Writes the command's trace messages to standard error. For your software-service organization's use only.

-V

Writes the command's verbose messages to standard output.

-r 0 | AutomaticRecovery | 1 | LockOnResFailure | 2 | LockOnAnyFailure

Specifies the RecoveryPolicy attribute that defines how the group member is recovered from a failure. The value can be:

0 | AutomaticRecovery: Automatically recover from the failure. This is the default.
1 | LockOnResFailure: Process a lock request on the resource group if the member fails. Automatically recover the member if the node hosting the member fails.
2 | LockOnAnyFailure: Process a lock request on the resource group if the member or the hosting node fails.

Parameters

Resource_class

Specifies the name of the resource class to which the member resource belongs. The resource and the resource class must be separated by the colon (:) delimiter. Also the selection_string and its resource_class must be separated by the colon (:) delimiter.

Resource_class:"selection_string"

The -s option determines this operand. Each selection string must be preceded by a resource class. Resource_class indicates the name of the resource class the selection_string will be applied to. The selection_string and it's Resource_class must be separated by the colon (:) delimiter. The specified selection string will be applied to its corresponding Resource_class attributes to determine which member resources are to be changed. The selection string must be enclosed within double or single quotation marks. If the selection string contains double quotation marks, enclose the entire selection string in single quotation marks. For example:

-s 'Name == "testing"'
-s 'Name ?= "test"'
-s 'Name like "%"' ( For all resources)

Resource_class:Resource_name[:Node]

This specifies one or more member resources that are to be changed. Resources belonging to different resource classes can also be specified using this syntax. However, member resources belonging to different classes must be separated by spaces. A member resource is identified by the resource's class ( Resource_class), the resource's name (Resource_name), and optionally the node ( Node) the resource is on. The Resource_class, Resource_name, and Node must be separated by a colon.

Resource_class is the name of the resource class the member resource belongs to. Resource_name is the name of the actual member resource in its class. Node is the name of the node the resource is located on. The Node is required when attempting to change a fixed member resource. The Node and its resource must be separated by the colon delimiter (:). Multiple resources belonging to the same resource class can also be specified and are separated by a comma. In this case the first resource or Resource_name[:Node] of a resource class must be preceded by the Resource_class it belongs to and it must be separated by the colon delimiter (:), while the remaining resources are separated by a comma.

Resource_class:Resource_name[:Node][Resource_name[:Node][,...]]

The member resources must exist in the resource group for it to be changed.

Selection_string

Specifies the selection string. The -s option determines this parameter. When this is the only parameter, then the selection string is applied to the member resources. But when included with Resource_class, each selection string in this case will be applied to its corresponding Resource_class attributes to determine which resources are to be modified in the Resource_group. The Selection_string and its Resource_class must be separated by the colon (:) delimiter. The selection string must be enclosed within either double or single quotation marks. If the selection string contains double quotation marks, enclose the entire selection string in single quotation marks. For example:

-s 'Name == "testing"'

-s 'Name ?= "test"'

-s 'Name like "%"' ( For all resources)

Exit Status

0: The command ran successfully.
1: Error occurred with RMC.
2: Error occurred with CLI script.
3: Incorrect flag on command line.
4: Incorrect parameter on command line.
5: Error occurred with RMC that was based on faulty command line input.
6: Resource specified was not found.
7: Resource already exists.

Security

This command requires root authority, or a user ID with appropriate permissions. For more information, see Setting up non-root user Ids for the command line interface.

Examples

To change the mandatory attribute to TRUE of a member resource tester that belongs to resource class IBM.Application, enter:
```
chrgmbr -m T IBM.Application:tester
```
To change the resource group to which member resources testerA, testerB, and testerC of resource classIBM.Application belong from the current resource group resA to resource group resAtest, enter:
```
chrgmbr -c resAtest -g resA IBM.Application:testerA,testerB,testerC
```
To change the Mandatory attribute to FALSE of selected member resources of resource group resA with ResourceType attribute set to one, belonging to resource class IBM.Application, enter:
```
chrgmbr -m F -s -g resA IBM.Application:"ResourceType==1"
```

Files

/usr/sbin/rsct/bin/chrgmbr: Location of the chrgmbr command.