Commands Reference, Volume 1

chcondition Command

Purpose

Changes any of the attributes of a defined condition.

Syntax

chcondition [-h] [-c New_condition] [-r Resource_class] [-e Event_expression] [-E Rearm_expression] [-d Event_description] [-D Rearm_description] [-n Node_name[,Node_name...]] [-s "Selection_string"] [-S c | w | i] [-T] [-V] Condition

Description

The chcondition command changes the attributes of a defined condition to the values supplied. If the name of the condition is changed using the -c flag, any links with responses remain intact.

Parameters

Condition

The name of an existing condition.

Flags

-c New_condition

Assigns a new name to the condition. The new name must not already exist. The new name replaces the current name.

-d Event_description

Specifies a user-supplied text that describes the event expression.

-D Rearm_description

Specifies a user-supplied text that describes the rearm expression.

-e Event_expression

Specifies an event expression. The event expression determines when an event occurs. It includes a dynamic attribute of the Resource_class with a mathematical comparison symbol (for example, >, <) and a constant. When this expression evaluates to TRUE, an event is generated.

-E Rearm_expression

Specifies a rearm expression. After the Event_expression has evaluated to TRUE and an event is generated, the rearm expression determines when monitoring for the Event_expression begins again. Typically, the rearm expression prevents multiple events from being generated for the same event evaluation. The rearm expression includes a dynamic attribute of the Resource_class with a mathematical comparison symbol (for example, >) and a constant.

-h

Writes the command's usage statement to standard output.

-n Node_name

Specifies the host name for a node or list of host names for a list of nodes, separated by commas, where this condition is registered. The default is the local node. Use asterisk (*) to register the condition on all nodes defined in the ManagedNode resource class.

Attention: This flag is not supported on AIX 5.1.

-r Resource_class

Specifies the resource class to be monitored by this condition. The lsrsrcdef command can be used to list the resource class names.

-s "Selection_string"

Specifies a selection string that is applied to all of the Resource_class attributes to determine which resources should be monitored by the Event_expression. The default is to monitor all resources within the Resource_class. The selection string must be enclosed within double or single quotation marks. For information on how to specify selection strings, see "Using Expressions" in the chapter "Using the Monitoring Application" of the RSCT 2.2 Resource Monitoring and Control Guide and Reference.

-S c |w | i

The severity of the event:

c

Critical

w

Warning

i

Informational

The default is i.

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

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.

Security

This command requires root authority.

Examples

1. To change the condition name from "JFS space used up" to "Watch JFS space", type:

   chcondition -c "Watch JFS space"  "JFS space used up"
    
   

2. To change a rearm expression and rearm description for a condition with the name "tmp space used up", type:

   chcondition -E "PercentTotUsed < 80"\
    -D "Start monitoring tmp again after it is less than 80 percent full" \       
   "tmp space used up"
    
   

Files

Related Information

The lscondition, 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 and information on how to use expressions and selection strings.