The ccm message command communicates a message directly or broadcasts the message to users who are running a Rational® Synergy session.
Synopsis
ccm message [/attr value][/d|/database database]
[/rfc_address address] [/u|/user username]
Uses
Messages are prepended with the name of the user who sends the message. To send messages to specific sessions, use the /rfc_address switch.
Options and arguments
- /attr value
- Enables you to send a broadcast message to a specific audience by specifying one of the following values in place of the /attr switch: process, display, pid, user, host, database, engine_address, and pwa_path.
- /d|/database database
- Specifies that all users of database are sent the message.
- You can use a regular expression to specify 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 which the messages are sent. 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 whom the messages are sent.
Example
Send a message to the \\joe\ccmdb\juno database.
> ccm message /d \\joe\ccmdb\juno "Server going down for repair
in 2 minutes."
Attention
If the specified /rfc_address is for an engine, the ccm message command fails.