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:
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. This 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 busy machine causes a delay in response, 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 processes for UNIX.
-attr value
Specifies the name of the field to be monitored. The possible -attr option arguments are as follows: process, display, pid, user, host, database, engine_address, and pwa_path.
-d|-database database_path
Specifies that all users of database_path are monitored.
Use a regular expression to monitor multiple databases. The regular expression must contain a leading question mark (?) character.
-rfc_address address
Specifies the remote Function Call (RFC) address of the Rational Synergy interface (GUI) process to be monitored. 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 kim -process engine IBM Rational Synergy process monitor...2 process(es) located: user process host port pid database path ---- ------- ---- ---- --- ------------- kim engine marlin 3745 25748 /vol/fish/ccmdb/kim_test kim engine marlin 3943 8645 /vol/fish/ccmdb/kim_eval
$ ccm monitor -host guppy IBM Rational Synergy process monitor...1 process(es) located: user process host port pid database path ---- ------- ---- ---- --- ------------- kim gui guppy 1945 13275 /vol/fish/ccmdb/kim_eval