Event Management Commands › cawto-Send a Message to the Console › cawto (UNIX/Linux, z/OS)

cawto (UNIX/Linux, z/OS)

This command has the following format:

cawto [-a attribute]
      [-c color]
      [-g category]
      [-k]
      [-n node]
      [-s source]
      text

External Influences

CAI_WTOR_NODE

Environment variable you can set to an alternate node. If this variable is set and cawto is issued without a node specification, the value of CAI_WTOR_NODE is used.

Files

/usr/tmp/cawto.n

If either the Event Management daemon or CAICCI is down, these files are created so that the cawto and careply commands can continue to function normally. The value of n is the message number the cawto command generated. The message number is identical to the process issuing the cawto command when either the Event Management daemon or CAICCI is down.

Example

The following example alerts the console operator on node 23 that the node is not accepting FTP connections, and asks for action to be taken. The message will be displayed in red and will remain on the node 23 system console as a kept message until released by the node 23 operator.

cawto -k -n 23 -c red node23 is not accepting ftp -- please investigate

Parameters used in this example:

-k keep

This keep option specifies that the message should be displayed as a kept message on the system console. The message can then be removed from the kept message display.

-n node

Node to which the message is directed which is one other than the node the user is on. If the node is not available, the message is sent to the local node.

-c color

Indicates that the message should be displayed on the system console in the identified color, which is other than the default. Supported colors are:

Default (black), Red, Orange, Yellow, Green, Blue, Pink, and Purple

Note: The color name can be specified in upper, lower, or mixed case.

-a attribute

Indicates that the message should be displayed on the system console in the identified attribute, which is other than the default. Supported attributes are:

DEFAULT

BLINK

REVERSE

Note: The attribute name can be specified in upper, lower, or mixed case

-s source

Assigns the identified source to the message for purposes of message matching.

-g category

Assigns the identified category to the message for purposes of message matching.

node

Node to which the message is to be directed. If the node is not specified, the message will be sent to the local node. If CAI_WTOR_NODE is specified, the message will be sent to the node that corresponds to CAI_WTOR_NODE.

text

Specify from 1 to 255 alphanumeric bytes of message text.

Note: Since the cawto command is issued from the command line, the text string you specify is subject to evaluation by the shell you are executing. Therefore, imbedded blanks, special characters, and quotes in the text string require special consideration. See the documentation provided with your operating system for the rules and guidelines regarding text strings.