[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]

Commands Reference, Volume 3

lscondition Command


Lists information about one or more conditions.


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


The lscondition command lists information about defined conditions.

The following information about the condition is listed:

The text description of EventExpression.

The expression used in monitoring this condition.

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

The name of the condition.

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

The text description of RearmExpression.

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

The resource class monitored by this condition.

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

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.


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


Displays all of the attributes linked with the condition names.

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.

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.

Lists only those conditions that are monitored in error.

Writes the command's usage statement to standard output.

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

Lists only those conditions that are being monitored without error.

Lists only those conditions that are not being monitored.

Does not return an error when Condition does not exist.

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

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

Writes the command's verbose messages to standard output.

Suppresses header printing.

Exit Status

Command has run successfully.

Error occurred with RMC.

Error occurred with CLI script.

Incorrect flag on command line.

Incorrect parameter on command line.

Error occurred that was based on faulty command line input.


  1. To list all conditions and their monitoring status, type:
    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"


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

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.

[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]