rmcondition Command

Purpose

Removes a condition.

Syntax

rmcondition [-f] [-q] [-h] [-TV] condition[:node_name]

Description

The rmcondition command removes the condition specified by the condition parameter. The condition must already exist to be removed. When the condition must be removed even if it has linked responses, use the -f flag to force the condition and the links with the responses to be removed. If the -f flag is not specified and links with responses exist, the condition is not removed. This command does not remove responses.

If a particular condition is needed for system software to work properly, it may be locked. A locked condition cannot be modified or removed until it is unlocked. If the condition you specify on the rmcondition command is locked, it will not be removed; instead an error will be generated informing you that the condition is locked. To unlock a condition, you can use the -U flag of the chcondition command. However, since a condition is typically locked because it is essential for system software to work properly, you should exercise caution before unlocking it.

Flags

-f: Forces the condition to be removed even if it is linked to responses. The links with the responses are removed as well as the condition, but the responses are not removed.
-q: Does not return an error when condition does not exist.
-h: Writes the command's usage statement to standard output.
-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

condition: Specifies the name of a condition to be removed.
node_name: Specifies the node where the condition is defined. If node_name is not specified, the local node is used. node_name is a node within the scope determined by the CT_MANAGEMENT_SCOPE environment variable.

Security

The user needs write permission for the IBM.Condition resource class to run rmcondition. Permissions are specified in the access control list (ACL) file on the contacted system.

Exit Status

0: The command ran successfully.
1: An error occurred with RMC.
2: An error occurred with a command-line interface script.
3: An incorrect flag was entered on the command line.
4: An incorrect parameter was entered on the command line.
5: An error occurred that was based on incorrect command-line input.

Environment Variables

CT_CONTACT

Determines the system where the session with the resource monitoring and control (RMC) daemon occurs. When CT_CONTACT is set to a host name or IP address, the command contacts the RMC daemon on the specified host. If CT_CONTACT is not set, the command contacts the RMC daemon on the local system where the command is being run. The target of the RMC daemon session and the management scope determine the resource classes or resources that are processed.

CT_IP_AUTHENT

When the CT_IP_AUTHENT environment variable exists, the RMC daemon uses IP-based network authentication to contact the RMC daemon on the system that is specified by the IP address to which the CT_CONTACT environment variable is set. CT_IP_AUTHENT only has meaning if CT_CONTACT is set to an IP address; it does not rely on the domain name system (DNS) service.

CT_MANAGEMENT_SCOPE

Determines the management scope that is used for the session with the RMC daemon in processing the resources of the event-response resource manager (ERRM). The management scope determines the set of possible target nodes where the resources can be processed. The valid values are:

0: Specifies local scope.
1: Specifies local scope.
2: Specifies peer domain scope.
3: Specifies management domain scope.

If this environment variable is not set, local scope is used.

Standard Output

When the -h flag is specified, this command's usage statement is written to standard output. All verbose messages are written to standard output.

Standard Error

All trace messages are written to standard error.

Examples

These examples apply to standalone systems:

To remove the condition definition named "FileSystem space used", run this command:
```
 rmcondition "FileSystem space used"
```
To remove the condition definition named "FileSystem space used" even if the condition is linked with responses, run this command:
```
rmcondition -f "FileSystem space used"
```

This example applies to management domains:

In this example, the current node is the management server. To remove the condition definition named "nodeB FileSystem space used" that is defined on managed node nodeB, run this command:
```
 rmcondition "FileSystem space used:nodeB"
```

This example applies to peer domains:

To remove the condition definition named "nodeA FileSystem space used" that is defined on node nodeA, run this command from any node in the domain:
```
 rmcondition "nodeA FileSystem space used:nodeA"
```

Location

/usr/sbin/rsct/bin/rmcondition