ccm monitor [-attr value] [-d|-database database_path] [-rfc_address address] [-u|-user username]
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.
-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.
$ ccm monitor -user ann -process engine IBM Rational Synergy process monitor...2 process(es) located: user process host port pid database path ---- ------- ---- ---- --- ------------- ann engine marlin 3745 25748 /vol/fish/ccmdb/ann_test ann engine marlin 3943 8645 /vol/fish/ccmdb/ann_eval
$ ccm monitor -host guppy IBM Rational Synergy process monitor...1 process(es) located: user process host port pid database path ---- ------- ---- ---- --- ------------- ann gui guppy 1945 13275 /vol/fish/ccmdb/ann_eval