Using VMCF for communication with z/VSE guests
Ingolf24 120000DRN3 Visits (6797)
Today I have some more information about the VMCF (Virtual Machine Communication Facility) interface of z/VM, which can be used to send information between z/VM guests. z/VSE provides the VSECMD for that purpose.
On a CMS guest VSECMD allows you to send commands to the z/VSE virtual machine for execution. These can be attention routine commands such as MAP, PRTY, VSE/POWER commands, VTAM commands etc. If you send, for example, the MAP command to the z/VSE virtual machine VSEGUEST, all messages issued from the attention routine and resulting from the MAP command will be routed to your VM CMS user ID.
More information about VSECMD is in the books z/VSE Installation and z/VSE Operation. They are both on the z/VSE documentation web page - here.
On z/VSE you may use the attention routine (AR) command SIR VMCF=ON (ON is default) to accept VMCF messages, or SIR VMCF=OFF to deactivate VMCF. SIR VMCF without a parameter gives the VMCF status (ON or OFF) on your z/VSE system.
If VMCF is ON and you issue the AR command SIR VMCF=OFF, you will get the message "VMCF12I CMS-Z/VSE CONSOLE INTERFACE DEACTIVATED" on your z/VSE console.
z/VSE guests IPLed with security - SYS SEC=YES
If z/VSE is running with (batch) security, the CMS user id must be defined in the security table DTSECTAB to accept commands from the CMS user. If the CMS user id is not in the DTSECTAB, any command from that user stops the VMCF interface on z/VSE indicated by message VMCF12I on the z/VSE console. VSECMD will end with return code 00064.
You may restart the VMCF interface with "SIR VMCF=ON" on your z/VSE system. Message VMCF12I is described in book z/VSE Messages & Codes Volume 2.
With an update of that book, we will improve the message explanation as follows (or similar):
VMCF12I CMS-z/VSE CONSOLE INTERFACE DEACTIVATED