chequ

Name

chequ - Changes an already-defined resource equivalency.

Synopsis

chequ [-h] [-i] -u r [-p A[,NoFailure | NoControl]] [-m Minimum_Necessary] [-T] [-V] -D "Dynamic_select_string" Equivalency Resource_class

Description

The chequ command changes a resource equivalency. Resources can be added, removed, or replaced in an equivalency. All resources in an equivalency must be from the same resource class. Even the name of the equivalency can be changed with this command.

Equivalencies and their attribute flags can be specified on the command prompt as the syntax indicates. The value must be the same data type that is defined for the resource attributes. Use the lsrsrcdef command to verify the data type and attribute field for each attribute.

Explicit specification of resource names without selection string is not supported for IPv6–enabled IBM.NetworkInterface equivalency members.

Options

-u a | d | r

Update Equivalency resources.

a: Adds the specified resources to the specified equivalency.
d: Deletes the specified resources from the specified equivalency.
r: Replace/Overwrite Equivalency resources. Replaces the equivalency resources with the specified equivalency resources.

-c New_Equiv

Specifies a new name that replaces the current Equivalency parameter.

-D "Dynamic_selection_string"

The specified selection string is saved as the SelectString attribute for the concerned equivalency. The option dynamic_selection_string is then applied to all resources of the specified resource class by the Recovery Manager to dynamically determine what members are to be included in the specified equivalency. This option must be used with the r option and also cannot be combined with the Resource_name [:Node] operand. 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:

-D 'Name == "testing"'

-D 'Name ?= "test"'

The -D option cannot be combined with the -S option or with an -p O option [ORDERED SelectFromPolicy).

-h

Help. Writes the command's usage statement to standard output.

-i

Interactive Prompt. Prompt before changing equivalency.

-p A | O [,Failback | NoFailure | NoControl]

Specifies the equivalency select-from policy. The value can be:

A: Any. Default value.
O: Ordered. The value cannot be used together with the -D option.

Optional comma-separated values:

Failback: only in combination with Ordered.
NoFailure
NoControl

-m Minimum_Necessary

Minimum Necessary Equivalency. Specifies the minimum necessary members to make an equivalency valid.

-S "Static_selection_string"

The specified selection string applies to the specified resource class to determine the resources that make up the equivalency. These resources are saved as the MemberShip attribute for the concerned equivalency. This option cannot be combined with the Resource_name [: Node] operand. Resources can be added, deleted, and replaced when this string is used. 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 cannot be combined with -D.

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

Parameters

Equivalency

Specifies the unique name of the already defined equivalency to be changed.

Resource_class:Resource_name[:Node]

Specifies one or more resources that are added to or deleted from the specified equivalency. All of the resources must be from the same resource class. An equivalency resource is identified by the resource class (Resource_class) and the resource name (Resource_name), and, optionally, the node (Node) at which the resource is located. Resource_class, Resource_Name, and Node must be separated by a colon. Resource_class is the name of the Resource class the equivalency resource belongs to. The first resource or Resource_name[:Node] must be preceded by the Resource_class it belongs to and it must be separated by the colon (:) delimiter. Multiple resources can be specified and are separated by a comma. Since all resources must be from the same class, the Resource_class is to be specified only once as the syntax indicates.

This syntax is not supported for IPv6–enabled IBM.NetworkInterface equivalency members: use selection string syntax instead.

Exit Status

0: The command ran successfully.
1: Error occurred with RMC.
2: Error occurred with CLI script.
3: Incorrect flag on command prompt.
4: Incorrect parameter on command prompt.
5: Error occurred with RMC that was based on faulty command prompt input.
6: Resource specified was not found.
7: Resource 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 add another resource tester that belongs to resource class IBM.Application to an equivalency called resA, type:
```
chequ -u a  resA IBM.Application:tester:node-name
```
To delete a resource tester1 that belongs to resource class IBM.Application from an equivalency that is called test, enter:
```
chequ -u d test IBM.Application:tester1:node-name
```
To add an equivalency that is called Jfoo with selected members of the resource class IBM.Application by using a select string, enter:
```
chequ -u a -S "ResourceType==0" Jfoo IBM.Application 
```
To overwrite an equivalency that is called Jfoo with selected members of the resource class IBM.Application by using a dynamic select string, enter:
```
chequ -u r -D "ResourceType==0" Jfoo IBM.Application
```

Files

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