Commands Reference, Volume 3

lscondition Command

Purpose

Lists information about one or more conditions.

Syntax

lscondition [-h] [-A] [-m | -n | -e] [-C | -l | -t | -d | -D Delimiter] [-q] [-x] [-T] [-V] [Condition [Condition...]]

Description

The lscondition command lists information about defined conditions.

The following information about the condition is listed:

EventDescription

The text description of EventExpression.

EventExpression

The expression used in monitoring this condition.

MonitorStatus

The status of the condition: monitored without error, not monitored, or in error.

Name

The name of the condition.

NodeNames

The host names of the nodes where the condition is registered, if any. An asterisk (*) indicates all nodes defined in the ManagedNode resource class.

RearmDescription

The text description of RearmExpression.

RearmExpression

The expression used in determining when monitoring should restart for this condition after an event has occurred.

ResourceClass

The resource class monitored by this condition.

Severity

The severity of the condition: critical, warning, or informational.

SelectionString

The selection string that is applied to the attributes of the ResourceClass to determine which resources are included in the monitoring of this condition.

For a list of all conditions, enter the lscondition command without any condition names specified. A list of all the condition names is returned with the monitoring status for each condition. The default format in this case is tabular.

For all the information about all condition names, specify the -A flag with the lscondition command. The -A flag causes all information about a condition to be listed when no condition names are specified. When all the information about all conditions is listed, the default format is long. If a monitoring-status flag (-e, -m, or -n ) is specified, the conditions with that status are listed.

When more than one Condition is specified, the condition information is listed in the order that the condition names are entered.

By default, when a condition name is entered with the lscondition command, all of the attributes of the condition are displayed.

Parameters

Condition

Name of the condition whose information we want to list. Additional condition names may also be supplied.

Flags

-A

Displays all of the attributes linked with the condition names.

-C

Outputs the mkcondition command that could be used to create the Condition. If more than one condition is specified, every mkcondition command appears on a separate line. This flag is ignored when no conditions are specified.

-d

Produces delimiter-formatted output. The default delimiter is a colon (:). Use the -D flag if you wish to change the default delimiter.

-D Delimiter

Produces delimiter-formatted output that uses the specified delimiter. Use this flag to specify something other than the default, colon (:). An example is when the data to be displayed contains colons. Use this flag to specify a delimiter of one or more characters.

-e

Lists only those conditions that are monitored in error.

-h

Writes the command's usage statement to standard output.

-l

Produces long formatted output. Displays the condition information on separate lines.

-m

Lists only those conditions that are being monitored without error.

-n

Lists only those conditions that are not being monitored.

-q

Does not return an error when Condition does not exist.

-t

Produces tabular formatted output. The condition information is displayed in separate columns.

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

-x

Suppresses header printing.

Exit Status

0

Command has run 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 that was based on faulty command line input.

Examples

1. To list all conditions and their monitoring status, type:

   lscondition 
    
   

   Output is similar to:

   Name                	MonitorStatus       
   "JFS space used up" 	"Monitored"      
   "tmp space used up" 	"Not monitored"
   "var space used up" 	"Error"       
       
   

2. To list general information about the condition "JFS space used up" in long form, type:

   lscondition "JFS space used up"
   

   Output is similar to:

      Name              = "JFS space used up"
      MonitorStatus     = "Monitored"
      ResourceClass     = "IBM.FileSystem"
      EventExpression   = "PercentTotUsed > 99"												
      EventDescription  = "Generate event when space used is 											
   		greater than 99 percent full"											
      RearmExpression   = "PercentTotUsed < 85"												
      RearmDescription  = "Start monitoring again after it is 											
   		less than 85 percent"											
      SelectionString   = ""												
      Severity          = "w"
      NodeNames         = "localnode"
   

3. To list the command that would create the condition "JFS space used up", type:

   lscondition -C "JFS space used up"
   

   Output is similar to:

   mkcondition -r IBM.FileSystem -e "PercentTotUsed > 99"\
    -E "PercentTotUsed < 85"\
    -d "Generate event when space used is greater than 99 percent full"\
    -D "Start monitoring after it is less than 85 percent"\
    -S w "JFS space used up"
   

Files

Related Information

The chcondition, lscondresp, mkcondition, rmcondition commands.

The rmccli General Information file.

The RSCT 2.2 Resource Monitoring and Control Guide and Reference contains more information regarding Event Response operations.