VMCF
Subfunction Applicable VMCPARM Parameters Return Codes
REPLYVMCPFUNC - X'OOO7' - subfunction code 0,1,2,3,4,5,6,
VMCPMID -message identifier 12,13,15,16,17,19VMCPUSER -. source use rid VMCPV ADA -REPL Y data address
VMCPLENA -REPLY data lengthVMCPUSE - user doubleword
QUIESCEVMCPFUNC - X'0008' - subfunction code 0,2,4,15
RESUMEVMCPFUNC - X'0009' - 8ubfunction code 0,2,4,15
IDENTIFY VMCPFLG 1 -PRIORITY option0,2,4,5,9,10 VMCPFUNC - X'OOOA' - subfunction code 15,18 VMCPUSER - sink userid VMCPUSE - user doubleword
(See Note)
REJECTVMCPFUNC - X'OOOB' - subfunction code 0,2,3,4,12,13,15
VMCPMID -message identifierVMCPUSER - source userid VMCPUSE - user doubleword
Figure 11 (Part 2 of 2). VMCF Subfunctions, Parameters, and Return Codes
Note: Fields within the user parameter list that are not used by a particular sub
function may be used to contain additional user data. The data, however, can only
be passed to the sink virtual machine by the source virtual machine. The REPLY
buffer address and length fields(VMCPV ADB+ VMCPLENB) may be used to
transmit additional user data for SEND and SENDX requests. All fields except
VMCPFLG1, VMCPFLG2, VMCPFUNC, andVMCPUSER may be used to pass
control information with an IDENTIFY request.
External Interrupt Code X'4001'
External interrupt codeX'4001' is a special interrupt code recognized by CP as
part of a VMCF transaction. Just as virtual machines use the DIAGNOSE instruc
tion to communicate with CP, so too CP uses this interrupt code to communicate
with virtual machines. External interrupt codeX'4001' and DIAGNOSE code
X'68' provide the mechanism VMCF uses to synchronize message processing.
The External Interrupt Message Header
Associated with external interrupt codeX'4001' is a storage area referred to as the
external interrupt message header. The external interrupt message header
(VMCMHDR) contains the control information required to SEND and RECEIVE
messages. The fields within the message header are, for the most part, a copy of
VMCPARM parameter list fields.
Before the receiving virtual machine can receive special messages via VMCF, it
must
Enable itself to receive external interrupts
Set bit 31 of control register0 to a value of 1
Authorize itself.
The Virtual Machine Communication Facility103
Subfunction Applicable VMCPARM Parameters Return Codes
REPLY
VMCPMID -message identifier 12,13,15,16,17,19
VMCPLENA -REPLY data length
QUIESCE
RESUME
IDENTIFY VMCPFLG 1 -PRIORITY option
(See Note)
REJECT
VMCPMID -message identifier
Figure 11 (Part 2 of 2). VMCF Subfunctions, Parameters, and Return Codes
Note: Fields within the user parameter list that are not used by a particular sub
function may be used to contain additional user data. The data, however, can only
be passed to the sink virtual machine by the source virtual machine. The REPLY
buffer address and length fields
transmit additional user data for SEND and SENDX requests. All fields except
VMCPFLG1, VMCPFLG2, VMCPFUNC, and
control information with an IDENTIFY request.
External Interrupt Code X'4001'
External interrupt code
part of a VMCF transaction. Just as virtual machines use the DIAGNOSE instruc
tion to communicate with CP, so too CP uses this interrupt code to communicate
with virtual machines. External interrupt code
X'68' provide the mechanism VMCF uses to synchronize message processing.
The External Interrupt Message Header
Associated with external interrupt code
external interrupt message header. The external interrupt message header
(VMCMHDR) contains the control information required to SEND and RECEIVE
messages. The fields within the message header are, for the most part, a copy of
VMCPARM parameter list fields.
Before the receiving virtual machine can receive special messages via VMCF, it
must
Enable itself to receive external interrupts
Set bit 31 of control register
Authorize itself.
The Virtual Machine Communication Facility