Commands Reference, Volume 4

rmcctrl Command

Purpose

Manages the resource monitoring and control (RMC) subsystem.

Syntax

rmcctrl { -a | -A | -d | -k | -K | -p | -P | -q | -Q | -s | -z | -h }

Description

The rmcctrl command controls the operation of the resource monitoring and control (RMC) subsystem. The subsystem is under the control of the system resource controller (SRC) with a subsystem name of ctrmc and a subsystem group name of rsct. The RMC subsystem definition is added to the subsystem object class and then started when Reliable Scalable Cluster Technology (RSCT) is installed. In addition, an entry is made in the /etc/inittab file so that the RMC subsystem is started automatically when the system is booted up.

Note: While the RMC subsystem can be stopped and started by using the stopsrc and startsrc commands, it is recommended that the rmcctrl command be used to perform these functions.

Flags

-a: Adds the RMC subsystem to the subsystem object class and places an entry at the end of the /etc/inittab file
-A: Adds and starts the RMC subsystem.
-d: Deletes the RMC subsystem from the subsystem object class and removes the RMC entry from the /etc/inittab file
-k: Stops the RMC subsystem
-K: Stops the RMC subsystem and all resource managers
-p: Enables remote client connections
-P: Disables remote client connections
-q: Enables remote client connections the next time the RMC subsystem is started
-Q: Disables remote client connections the next time the RMC subsystem is started
-s: Starts the RMC subsystem
-z: Stops the RMC subsystem and all resource managers, but the command does not return until the RMC subsystem and the resource managers are actually stopped
-h: Writes the command's usage statement to standard output.

Security

Privilege control: only the root user should have execute (x) access to this command.

Exit Status

0: Command has run successfully.
1: Command was not successful.

Restrictions

This command applies to the cthags and cthats subsystems only.

Standard Output

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

Standard Error

Error messages are written to standard error (and to the ctsnap.host_name.nnnnnnnn.log file).

Examples

To add the RMC subsystem, enter:
```
rmcctrl -a
```
To start the RMC subsystem, enter:
```
rmcctrl -s
```
To stop the RMC subsystem, enter:
```
rmcctrl -k
```
To delete the RMC subsystem, enter:
```
rmcctrl -d
```

Location

/usr/sbin/rsct/bin/rmcctrl: Contains the rmcctrl command

Files

/tmp/ctsupt: Location of the default directory that contains the output files.
/tmp/ctsupt/ctsnap.host_name.nnnnnnnn.log: Location of the log file of the command execution, where nnnnnnnn is a timestamp and host_name is the name of the host on which the command is running.
tmp/ctsupt/ctsnap.host_name.nnnnnnnn.tar.Z: Location of the compressed tar file that contains the collected data, where nnnnnnnn is a timestamp and host_name is the name of the host on which the command is running.

Related Information

Commands: lssrc