SEND-VM-MESSAGE (Pass messages to VM administrators)

/SEND-VM-MESSAGE enables messages to be sent to the VM administrators.

SEND-VM-MESSAGE

MESSAGE = <c-string 1..72>

,VM-IDENTIFICATION = *ALL / <integer 1..99> / <name 1..8>

MESSAGE = <c-string 1..72>
Message to be sent to all VM administrators of the specified VM.

VM-IDENTIFICATION =
Identification of the virtual machine.

VM-IDENTIFICATION = *ALL
The message is sent to all VM administrators of all VMs.

VM-IDENTIFICATION = <integer 1..99> / <name 1..8>
Identifies the virtual machine by means of a VM index or VM name.

Command return codes

(SC2)   SC1	Main code	Meaning
0 64 64	CMD0001 VMS1015 VMS4000	Command successfully executed No VM administrator connected VM not yet created

Example (via $VMCONS)

vm01:/send-vm-message message=c'*** shutdown in 5 min ***',vm-id=*all —— (1)
VM01:VMS3000 VM2000 COMMAND /SEND-VM-MESSAGE FOR
             VIRTUAL MACHINE ( ,*ALL) PROCESSED SUCCESSFULLY
VM01:NBR0740 COMMAND COMPLETED 'SEND-VM-MESSAGE';
             (RESULT: SC2=000, SC1=000, MC=CMD0001); DATE: <date>
VM01:VMS2036 MESSAGE FROM VIRTUAL MACHINE (1,VM1):
             '*** SHUTDOWN IN 5 MIN ***'———————————————————————————————  (2)
VM02:VMS2036 MESSAGE FROM VIRTUAL MACHINE (1,VM1):
             '*** SHUTDOWN IN 5 MIN ***'———————————————————————————————  (3)
VM04:VMS2036 MESSAGE FROM VIRTUAL MACHINE (1,VM1):
             '*** SHUTDOWN IN 5 MIN ***'———————————————————————————————  (4) 
vm04:/send-vm-message message=c'** shutdown !!! **',vm-id=2 ———————————  (5)
VM04:VMS3000 VM2000 COMMAND /SEND-VM-MESSAGE FOR
             VIRTUAL MACHINE (2,SYSTEM2) PROCESSED SUCCESSFULLY
VM04:NBR0740 COMMAND COMPLETED 'SEND-VM-MESSAGE';
             (RESULT: SC2=000, SC1=000, MC=CMD0001); DATE: <date>
VM02:VMS2036 MESSAGE FROM VIRTUAL MACHINE (4,SYSTEM4):
             '** SHUTDOWN !!! **'——————————————————————————————————————  (6)

----------------------------------------------------------------------------------------------------------------

(1)	The VM2000 administrator sends the message *** SHUTDOWN IN 5 MIN *** to all VM administrators.
(2)	This message appears in the ADMIN dialog for the monitor VM.
(3)	This message appears in the ADMIN dialog for VM2.
(4)	This message appears in the ADMIN dialog for VM4.
(5)	The VM4 administrator sends the message ** SHUTDOWN !!! ** to the VM2 administrator.
(6)	This message appears in the ADMIN dialog for VM2.

----------------------------------------------------------------------------------------------------------------

When administration is carried out in a user task, message VMS2036 is displayed as an asynchronous message in the user event stream or at the next input.