lsequ

Name

lsequ - Lists already-defined resource equivalencies and their attributes.

Synopsis

lsequ [-h] [-s "selection_string"] [-e Equivalency] [-A p | d | b] [-l | -t | -d | -D Delimiter] [-T] [-V] [Attr...]

Description

The lsequ command lists the Equivalencies. If the equivalency name is omitted, all of the defined equivalencies are listed. If an equivalency is specified, the persistent attributes of the specified equivalency is listed. If the Attr operand is specified, the attributes that are specified for the equivalency is listed.

If the attribute flag is specified, the persistent, or dynamic, or both attributes of the equivalencies are listed. If specified, the Attr operand overrides the -A option. The Attr operand must be a valid equivalency attribute, when listing equivalency information. When the Attr operands are specified, the exact value of these attributes are listed. Otherwise, some of these attribute values are translated into English words.

Options

-A p | d | b
Attribute type. By default, only persistent attributes are displayed. To view all the attributes of the member resources, this option must be used with -A b attribute type. The value can be:
p
Display only persistent attributes. For best performance, specify this value.
d
Display only dynamic attributes.
b
Display both persistent and dynamic attributes.
-d
Specifies delimiter-formatted output. The default delimiter is a colon (:). Use the -D option if you want to change the default delimiter.
-D Delimiter
Specifies delimiter-formatted output that uses the specified delimiter. Use this option to specify something other than the default colon (:); for example, when the data to be displayed contains colons. Use this option to specify a delimiter of one or more characters.
-e Equivalency
The name of the defined Equivalency to be listed.
-h
Writes the command's usage statement to standard output.
-l
Specifies long formatted output. Each attribute is displayed on a separate line, which is the default display format.
-s "Selection_string"
Specifies a selection string. Used without the -e option, this option is applied to all the defined equivalencies. If the -e option is specified with a selection string, then this selection is applied only to the specified equivalency. 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"'

Only persistent attributes can be included in a selection string.

-t
Specifies tabular formatted output. Each attribute is displayed in a separate column, one resource per line.
-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

Attr
Specifies the names of one or more attributes whose values are to be displayed. These attributes must be separated by spaces.

Exit Status

0
The command ran successfully.
1
Error occurred with RMC.
2
Error occurred with CLI script.
3
Incorrect option 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.

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

  1. To list all currently defined equivalencies, enter: 
    lsequ

    Output:

    Displaying Equivalency Information:
resA
resB
equ1
equ2
  2. To list the persistent attributes of the equivalency resA, enter: 
    lsequ -A p -e resA

    Output:

    Displaying Equivalency Information:
Persistent Attributes
for Equivalency "resA".

Equivalency 1:
 Name                      = resA
 MemberClass               = IBM.Application
 Resource:Node[Membership] = {resource1-name:node-name, 
                                resource2-name:node-name,…}
 SelectString              = ""
 SelectFromPolicy          = ORDERED
 MinimumNecessary          = 1
 Subscription              = {}
 ActivePeerDomain          = domain-name
  3. To list all the attributes of the equivalency equ1, enter: 
    lsequ -A b -e equ1
    Output: 
    Displaying Equivalency Information:
All Attributes
For Equivalency "equ1".

Equivalency 1:
 Name                                = equ1
 MemberClass                         = IBM.Application
 Resource:Node[Membership]           = {resource1-name:node-name, 
                                          resource2-name:node-name,…}
 SelectString                        = ""
 SelectFromPolicy                    = ORDERED
 MinimumNecessary                    = 1
 Subscription                        = {}
 ActivePeerDomain                    = domain-name
 Resource:Node[ValidSelectResources] = {resource1-name:node-name, 
                                          resource2-name:node-name,…}
 Resource:Node[InvalidResources]     = {}
 ConfigValidity                      =
 AutomationDetails[CompoundState]    = Automation
  4. To list all the attributes of the equivalency equ1 in verbose mode, enter: 
    lsequ -V -A b -e equ1
    Output: 
    Starting to list equivalency information.
lsequ: Executed on Thu May  8 14:42:32 2008 at "node-name", 
master node "node-name".

Displaying Equivalency information:
All Attributes
For Equivalency "equ1".

Equivalency 1:
   Name                                = equ1
   MemberClass                         = IBM.Application
   Resource:Node[Membership]           = {resource1-name:node-name, 
                                            resource2-name:node-name,…}
   SelectString                        = ""
   SelectFromPolicy                    = ORDERED
   MinimumNecessary                    = 1
   Subscription                        = {}
   ActivePeerDomain                    = domain-name
   Resource:Node[ValidSelectResources] = {resource1-name:node-name, 
                                            resource2-name:node-name,…}
   Resource:Node[InvalidResources]     = {}
   ConfigValidity                      =
   AutomationDetails[CompoundState]    = Automation
                          [DesiredState]    = Undefined
                         [ObservedState]    = Unknown
                          [BindingState]    = Unbound
                       [AutomationState]    = Unknown
                          [ControlState]    = Undefined
                           [HealthState]    = Not Applicable
Completed listing equivalency information.
  5. To list the dynamic attributes of equivalency resA, enter: 
    lsequ -A d -e resA

Files

/usr/sbin/rsct/bin/lsequ
Location of the lsequ command.

See Also

The chequ, samctrl, mkequ, rmequ commands.

The rmccli general information file.