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

cawtor (UNIX/Linux, z/OS)

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. This action lets cawtor and careply commands continue to function. 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 that is 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 quiet and alternate node, use this syntax:

cawtor -qn node text

-k

Displays message as a kept message on the system console. The message can then be removed from the kept message display.

-c color

The message displays on the system console in the identified color, which is other than the default. Supported colors:

Black (default), Red, Orange, Yellow, Green, Blue, Pink, and Purple

Note: The color name is not case-sensitive.

-a attribute

The message displays on the system console in the identified attribute, which is other than the default. Supported attributes:

DEFAULT

BLINK

REVERSE

Note: The attribute name is not case-sensitive.

-s source

Assigns the identified source to the message for message matching.

-g category

Assigns the identified category to the message for 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

Target node to which to direct the message or command being specified. -qn specifies that the message or reply instructions dol not display on the terminal of the user who generated the message.

[node] of cawtor command

Node to which the message is directed. If the node is not specified, the message is sent to the local node. If CA_WTOR_NODE is specified, the message is sent to the node corresponding to CA_WTOR_NODE.

Note: If the node is specified, 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.

Limits: 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, embedded blanks, special characters, and quotes in the text string require special consideration. See the documentation that is provided with your operating system for the rules and guidelines regarding text strings.