ccm message

This topic contains information about the ccm message command.

Synopsis

ccm message [-attr value] [-d|-database database_path]
            [-rfc_address address] [-u|-user username]'message_text'

Description and uses

Use the ccm message command to send a message directly to a Rational® Synergy user. Or use to broadcast a message to Rational Synergy users selected using a keyword criterion.

Messages are prepended with the name of the user who sends the message. If you want to send messages to specific sessions, use the -rfc_address option.

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

For more information, see [XXXXXX SET LINK TO Broadcasting system messages.]

Options and arguments

-attr value

Enables you to send a broadcast message to specific users selected using one of the following keywords: process, display, pid, user, host, database, engine_address, or pwa_path.

-d|-database database_path

Sends a message to all users of the specified database.

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 to send the message. 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:

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.

-u|-user username

Sends a message to username.

Examples

Caveats

If the specified -rfc_address is for an engine, the ccm message command fails.


Feedback