ccm monitor

This topic contains information about the ccm monitor command.

Synopsis

ccm monitor [-attr value] [-d|-database database_path]
            [-rfc_address address] [-u|-user username]

Description and uses

Use the ccm monitor command to show a network-wide view of Rational® Synergy user and process information, including the:

If you specify no options with ccm monitor, the command shows information for all users and processes for the current Rational Synergy installation ($CCM_HOME).

The ccm monitor command appends an exclamation point (!) to the status field of a process when that process has not responded to the router for a fixed amount of time. A failure to respond is assumed to indicate a problem. For example, the machine that was running the process has gone down or the process has hung.

If a delay in response is due to a busy machine, the exclamation point disappears when the operation that is using the machine is completed.

You can run this command as any user, in any role.

The process names shown by the ccm monitor command indicate the following processes:

Name shown by ccm monitor Process
engine Engine (any kind)
cmd Classic CLI or back-end sessions
gui Classic GUI
dev_clnt Rational Synergy GUI
usr_cmd Rational Synergy CLI
server CCM server
router Message router daemon
objreg Object registrar notification daemon
ccm_ess Engine start service for Windows®
monitor Monitor (this command)

For more information, see Monitoring users.

Options and arguments

-attr value

Specifies the name of the field to be monitored. The possible -attr option arguments are: process, display, pid, user, host, database, engine_address, or pwa_path.

-d|-database database_path

Specifies that all users of database_path are monitored.

You can use a regular expression to monitor multiple databases. The regular expression must contain a leading question mark ( ? ) character.

-rfc_address address

Specifies the RFC (Remote Function Call) address of the Rational Synergy interface (GUI) process to be monitored.

The RFC address used must be the exact RFC address of the target process. This address can be determined by running the ccm ps command.

The format for machines with a known host name is:

host:port[:ip]*

The format for machines with no known host name is:

ip:port[:ip]*

where [:ip]* represents zero or more IP addresses separated by colons.

-user username

Specifies the user to be monitored.

Examples


Feedback