Commands Reference, Volume 1

cthatsctrl Command

Purpose

Controls the topology services subsystem.

Syntax

cthatsctrl { -a [ -p port-number ] | -s | -k | -d | -b | -t | -o | -r | -h }

Description

The cthatsctrl control command controls the operation of the topology services subsystem. The subsystem is under the control of the system resource controller (SRC) and belongs to a subsystem group called cthats. Associated with each subsystem is a daemon and a command that configures and starts the daemon.

An instance of the topology services subsystem runs on every node of a cluster.

Adding the subsystem

When the -a flag is specified, the control command uses the mkssys command to add the topology services subsystem to the SRC. The control command:

Makes sure the cthats subsystem is stopped.
Gets the port number from the cluster data makes sure the port number is set in the /etc/services file.
The service name that is entered in the /etc/services file is cthats.
Removes the cthats subsystem from the SRC (in case it is still there).
Adds the cthats subsystem to the SRC.

Starting the subsystem

When the -s flag is specified, the control command uses the startsrc command to start to start the topology services subsystem, cthats.

Stopping the subsystem

When the -k flag is specified, the control command uses the stoptsrc command to stop the topology services subsystem, cthats.

Deleting the subsystem

When the -d flag is specified, the control command uses the rmssys command to remove the topology services subsystem from the SRC. The control command:

Makes sure the cthats subsystem is stopped
Removes the cthats subsystem from the SRC using the rmssys command
Removes the cthats port number from the /etc/services file

Rebuilding the configuration

When the -b flag is specified, the control command reads the configuration information from the cluster data and builds a configuration file, machines.lst, for the topology services daemon.

Turning tracing on

When the -t flag is specified, the control command turns tracing on for the topology services daemon using the traceson command.

Turning tracing off

When the -o flag is specified, the control command turns tracing off (returns it to its default level) for the topology services daemon using the tracesoff command.

Refreshing the subsystem

When the -r flag is specified, the control command refreshes the subsystem using the refresh command. The -r flag signals the daemon to read the rebuilt information.

Flags

-a [-p port-number]: Adds the subsystem.
-s: Starts the subsystem.
-k: Stops the subsystem.
-d: Deletes the subsystem.
-t: Turns tracing on for the subsystem.
-o: Turns tracing off for the subsystem.
-b: Rebuilds the topology services configuration file from the configuration information in the cluster data.
-r: Refreshes the subsystem.
-h: Writes the command's usage statement to standard output.

Security

You must have root authority to run this command.

Exit Status

0: Indicates that the command completed successfully.
a non-zero value: Indicates that an error occurred.

Restrictions

This command is valid in a peer domain only.

Use this command only under the direction of the IBM Support Center.

Standard Output

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

Standard Error

This command writes any error messages to standard error.

Examples

To add the topology services subsystem to the SRC, enter:
```
cthatsctrl -a
```
To start the topology services subsystem, enter:
```
cthatsctrl -s
```
To stop the topology services subsystem, enter:
```
cthatsctrl -k
```
To delete the topology services subsystem from the SRC, enter:
```
cthatsctrl -d
```
To turn tracing on for the topology services daemon, enter:
```
cthatsctrl -t
```
To turn tracing off for the topology services daemon, enter:
```
cthatsctrl -o
```
To rebuild the topology services configuration file from the configuration information in the cluster data, enter:
```
cthatsctrl -b
```
To signal all the topology services daemons in the cluster to read the new configuration file, enter:
```
cthatsctrl -r
```
To write usage information to standard output, enter:
```
cthatsctrl -h
```

Location

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

Related Information

Commands: cthactrl, cthagsctrl, cthatstune, lssrc