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

SMSG
SMSG
►►
SMsg
Authorization
Purpose
Operands
userid
*
Usage Notes
AT
AT
sysname
*
Privilege Class: G
msgtext
1444 z/VM: CP Commands and Utilities Reference
Use SMSG to send a special message to a virtual machine programmed to accept
and process the message.
userid
* is the virtual machine to which the special message is to be sent. To send the
message to yourself, specify an asterisk (*).
AT sysname
sends the special message to a user ID on a specific system, sysname, in the
CSE complex. The return code is sent to the command issuer.
AT *
sends the special message to the system you are logged onto.
msgtext
is the message to be sent. The length of the message is limited by the number
of characters remaining on the input line after the command and the appropriate
operand are entered. Mixed DBCS data may be used as input message text.
1. Special messages do not appear on the receiving user’s console because the
messages are expected to be instructions or commands that are processed by
the receiving virtual machine.
2. Virtual machines can only receive special messages under the following
conditions:
v The receiving virtual machine has issued the SET SMSG ON command, or
set the VMCPSMSG flag at authorization time.
v The user wishing to receive special messages has issued an AUTHORIZE
with the Virtual Machine Communication Facility (VMCF).
You can also receive special messages through IUCV by issuing the SET
SMSG IUCV command.
3. If AT * or AT sysname is not specified, the message is sent to all systems if
cross system messages are active among systems in the CSE complex. The
message is sent only to the local system if the user ID specified is:
v Logged onto the local system
v Not logged onto the local system, but in a CSE exclusion list.
4. If an external security manager (ESM) is installed on your system, you may not
be authorized to enter this command. However, messages sent to or from the
►◄