z/VM: CP Commands and Utilities Reference - z/VM - IBM

MESSAGE
Purpose
Usage Notes
Messages
Use the MESSAGE commands to transmit message text to the virtual consoles of
other active users.
(General for MESSAGE)
1. If a message is issued from a CMS environment, the command and the
message text cannot be longer than 240 characters.
If a message is issued from a CP environment, the command and message
length is limited by the input area of the terminal.
2. If you send a message to a user who is not logged on and has not defined a
secondary user, or to a user who has suppressed the receiving of messages
(that is, a user who has issued the SET MSG OFF command), your message is
not transmitted, and you receive an informational message. The message that
was transmitted is not saved. You must send it again when the user is receiving
messages.
3. The MESSAGE command routes the message to the secondary user of a
disconnected virtual machine. If the secondary user is connected or the
secondary user is disconnected but has a valid path to a *MSG or *MSGALL CP
system service, the secondary user receives the message.
If the secondary user is disconnected and there is no valid path to a *MSG or
*MSGALL CP system service, userid not receiving; disconnected. is returned
to the command issuer.
4. Messages are displayed only when the display device is ready to receive
output. If you have a CP READ or a VM READ, messages are held until you
end the read. Note, however, that if you are using an SNA/CCS terminal,
messages are displayed when in CP READ or VM READ.
5. If you receive a message on a 3270 virtual console that has the alarm feature,
the alarm sounds.
6. If cross system messages are active among systems in a CSE complex, and if
MSG ALL AT ALL is entered, the message is sent to every user on every
system that is receiving messages.
7. If cross system messages are active among systems in a CSE complex, the
default for this command is AT ALL. The default is AT * if:
v The operand userid is OPerator or ALL
v The user ID specified in the operand userid is logged onto the same system
as the command issuer
v Either the user ID specified in the operand userid or the command issuer is in
the CSE exclusion list.
8. DBCS text is supported as message text for the MESSAGE commands.
(General for MESSAGE)
HCP003E Invalid option - {option|command
contains extra option(s) starting with
option}
HCP020E Userid missing or invalid
HCP026E Operand missing or invalid
HCP045E userid not logged on
HCP057I userid not receiving; text
MESSAGE
Chapter 2. CP Commands 589