lsrgreq

Name

lsrgreq - Lists the outstanding requests that are applied against the resource groups or managed resources.

The lsrgreq command belongs to a group of commands (rgreq, rgmbrreq, and lsrgreq) which allow an operator to introduce persistent requests into System Automation for Multiplatforms Administrator's and User's Guide. Using this set of commands the operator can start, stop, cancel, or move resource groups and managed resources.

Synopsis

lsrgreq [-h] [-L] [-m] [-l | -t |-d |-D Delimiter] [-g Resource_ group] [-T] [-V]

lsrgreq [-h] [-L] -m [-l |-t |-d |-D Delimiter] [-T] [-V] [-L]Resource_class:Resource[:Node][,Resource[:Node][,...]][Resource_class:Resource[:Node][,Resource[:Node][,...]]]

lsrgreq [-h] [-L] -m [-l |-t |-d |-D Delimiter] -s [-T] [-V] Resource_class:"Selection_String" [Resource_class:"Selection_String" [...]]

Description

The lsrgreq command lists the outstanding requests that are applied against the resource groups or managed resources. By using the lsrgreq command, either the active or all the outstanding requests can be listed. The -m option lists only the action requests on the managed or member resources. Otherwise, the action requests on the resource groups are listed.

-h: Help. Writes the command's usage statement to standard output.
-g Resource_group: The name of the resource group whose actions are to be listed.
-L: Lists all the action requests on the specified resource group or managed resources. If this option is not specified, then only the active requests are displayed or listed.
-m: Member Resources. Lists or displays the actions on the member resources.
-s: Specifies that a selection string is used.
-l: Long formatted output. Each attribute is displayed on a separate line, which is the default display format.
-t: Tabular formatted output. Each attribute is displayed on a separate column, one resource per line.
-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.
-T: Trace. Writes the command's trace messages to standard error. For software-service organization's use only.
-V: Verbose. Writes the command's verbose messages to standard output.

Parameters

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 is applied to. The selection_string and its Resource_class must be separated by colon or ":"delimiter. The specified selection string is applied to its corresponding Resource_class attributes to determine which member resources are to be removed from the Resource_group. 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 IBM.Application:`Name=="testing"`
-s IBM.Application:`Name ?="test"`
-s IBM.Application:`Name like "%"` (For all resources)

Resource_class:Resource[:Node]

The member resources specifies one or more member resources whose action requests are to be listed. Resources belonging to different resource classes can also be specified by using this syntax. However, member resources that belong to different classes must be separated by spaces. A member resource is identified by the Resource_class, Resource), and optionally the Node the resource is on. The Resource_class, Resource, and Node must be separated by a colon. Node is the name of the resource class the member resource belongs to. Node is the name of the actual member resource in its class. The node can be included when trying to act on a fixed member resource. The node and its resource must be separated by the colon or ":" delimiter. Multiple resources that belong to the same resource class can also be specified and are separated by a comma:Resource_class:Resource[:Node][,Resource[:Node][,...]] The member resources must exist in the resource group for the requested action to take place.

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.

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 list the active action requests on the resource group RG1, enter:
```
lsrgreq -g RG1
```

To list the requests for the resource group top-rg, enter:

lsrgreq -L -g top-rg

Output:

Resource Group 1:
        ResourceGroup = top-rg
        Priority      = High
        Action        = lock
        Source        = Operator
        NodeList      = {}
        ActiveStatus  = Inactive
        Token         = 8f5697eb5f84c0f044995b3d00040a5b
        UserID        =
        MoveStatus    = None

To list the requests on all the resources that belong to resource group RG1 in tabular format, enter:

lsrgreq -m -g RG1

Output:

Displaying Member Resource request information:
Active Requests
For Resource Group "RG1":             
      Member Resource 1:
      Class:Resource:Node[ManagedResource] = IBM.Application:R1
      Priority = Force
      Action = start
      Source = Operator
      ActiveStatus = Active

      Member Resource 2:
      Class:Resource:Node[ManagedResource] = IBM.Application:R2
      Priority = low
      Action = start
      Source = ExtSched
      ActiveStatus = Active

To list all the action requests applied to resource group RG1, enter:

lsrgreq -L -t -g RG1