The ccm monitor command provides a network-wide view of Rational® Synergy user and process information including:
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 stops.
If a delay in response is due to a busy machine, the exclamation point disappears when the operation that is using the machine is finished.
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 Users.
/attr value
Specifies the name of the field to be monitored. The possible /attr switch values are as follows: process, display, pid, user, host, database, engine_address, and pwa_path.
/d|/database database
Specifies that all users of database 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 Remote Function Call (RFC) address of the Rational Synergy interface (GUI) process to be monitored. RFC supports machines with multiple IP addresses.
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:
hostname:port:ip[: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.
/u|/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 34728 21182 \\fish\ccmdb\ann_test ann engine marlin 34725 21181 \\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 34725 21181 \\fish\ccmdb\ann_eval