Event Management Commands › cawtor-Send a Message to the Console and Wait for Reply › cawtor (UNIX/Linux, z/OS)

cawtor (UNIX/Linux, z/OS)

This command has the following format:

cawtor [-a attribute]
       [-c color]
       [-g category]
       [-n node]
       [-q]
       [-qn node]
       [-s source]
       text

External Influences

CAI_WTOR_NODE

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

Files

/usr/tmp/cawtor.n

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

Example

When executed, this shell script prompts the console operator for a specific date. The date contained in the operator reply is written to standard output and assigned to the variable ATBDATE by the shell. The program atb then uses the value of the variable ATBDATE.

ATBDATE=$(cawtor -q Enter the starting date for the aged trial balance) atb $ATBDATE

Note: ATBDATE is a user-defined program.

To specify both quiet and alternate node, use this syntax:

cawtor -qn node text

-k

This 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.

-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.

-q

Quiet option. Indicates that the message reply is not echoed on the terminal of the user who generated the message.

-qn node

Identifies the target node to which to direct the message or command being specified. -qn specifies that the message or reply instructions will not be displayed on the terminal of the user who generated the message.

[node] of cawtor command

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 CA_WTOR_NODE is specified, the message will be sent to the node that corresponds to CA_WTOR_NODE.

Note: If node is specified, you must include the brackets [ ] as part of the command.

-n node

Node where the message is directed. If the node is not available, the message is sent to the local node.

text

1- to 255-alphanumeric bytes of message text.

Note: Since the cawtor 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.