A reply can be executed in response to a SEND /RECY request without executing
the RECEIYE subfunction. This indicates that you do not want to receive the
message but may want to send a reply. A reply of zero length could be executed
simply to terminate the SEND /RECY request. The application of the REPLY
subfunction is a user decision. It must be used to terminate a SEND/RECY
request, however, unless the REJECT sub function is executed (See "REJECT: DIAGNOSE Code X'68' Subfunction Code X'OOll "'.) The reply is complete
when the source virtual machine receives the external interrupt response.
A REPLY subfunction cannot be executed in response to a SEND request (this is a
protocol violation).
Invoking VMCF Subfunctions
YMCF sub functions are invoked by means of: DIAGNOSE code X'68' subfunction codes
The YMCP ARM parameter list
External interrupt code X'4001' The external interrupt message header
The Virtual Machine Communication Facility 97
Diagnose Code X'68' All VMCF subfunctions are invoked from within assembler language programs by
means of DIAGNOSE code X'68':
<--------------- 4 bytes --------------->
83 Rx Ry CODE
where:
83 is X'83' and interpreted by the assembler as the DIAGNOSE instruc­
tion.
Rx
Ry CODE Note: There is no mnemonic for DIAGNOSE. specifies a register containing the address of the VMCPARM parame­
ter list.
is a register that contains a return code.
is X'0068' and specifies that you are requesting execution of a VMCF. The. VMCPARM Parameter List
The Rx register of DIAGNOSE X'68' contains the address of a parameter list
(VMCPARM). This parameter list is used to specify the VMCF subfunction to be
executed, along with other information required by VMCF to execute that
function. The address of VMCP ARM must be doubleword-aligned. The following
is the format of the VMCP ARM parameter list and a description of each of the
fields in that list.
o
8 10 18 20 28
where: V*l I V*2 I VMCPFUNC VMCPUSER Vr1CPVADA Vt1CPVADB VMCPUSE VMCPMID VMCPLENA VMCPLENB V*l
(VMCPFLGl)
98 VM/SP System Programmer's Guide
is a flag byte used to specify options associated with a particular sub­
function.
This flag byte can be set to the following values:
VMCPAUTS (X'80') Indicates, for the AUTHORIZE subfunction, an AUTHORIZE SPECIFIC request. When this bit is set, the VMCPUSER field
Previous Page Next Page