RECEIVE, REPLY, and REJECT requests, the user doubleword is
transmitted to the source virtual machine within the RESPONSE mes­
sage header. The sink virtual machine can transmit the user
doubleword to the source virtual machine with REJECT or REPLY
requests only if the original request was a SEND/RECV. The user
doubleword is transmitted only with requests that result in SEND or RESPONSE external interrupts.
The following chart summarizes the VMCP ARM fields required for
execution of each of the VMCF subfunctions. Possible return codes
associated with each subfunction are also listed. A discussion of the
return codes and their meanings can be found in the section "DIAGNOSE X'68' RETURN CODES". The Virtual Machine Communication Facility 101
VMCF
Subfunction Applicable VMCPARM Parameters Return Codes AUTHORIZE VMCPFLG1 - SPECIFIC/PRIORITY option 0,1,2,6,15 VMCPFUNC - X'OOOO' - subfunction code VMCPUSER - SPECIFIC userid VMCPV ADA -external interrupt buffer address VMCPLENA - external interrupt buffer length UNAUTHORIZE VMCPFUNC - X'0001' - subfunction code 0,2,4,15 SEND VMCPFLG 1 - PRIORITY option 0,1,2,4,5,8 VMCPFUNC - X'0002' - subfunction code 9,10,15,18 VMCPMID - message identifier VMCPUSER - sink userid VMCPV ADA - SEND data address VMCPLENA - SEND data length VMCPUSE - user double word (See Note) SEND/RECV VMCPFLG 1 - PRIORITY option 0,1,2,4,5,8,9, VMCPFUNC - X'0003' - subfunction code 10,15,18 VMCPMID - message identifier VMCPUSER - sink userid VMCPV ADA - SEND data address VMCPLENA - SEND data length VMCPV ADB - REPL Y buffer address VMCPLENB - REPL Y buffer length VMCPUSE - user double word SENDX VMCPFLG 1 - PRIORITY option 0,1,2,4,5,7,8, VMCPFUNC - X'0004' - subfunction code 9,10,15,18 VMCPMID - message identifier VMCPUSER - sink userid VMCPVADA - SEND data address VMCPLENA - SEND data length VMCPUSE - user doubleword (See Note)
RECEIVE VMCPFUNC - X'0005' - subfunction code 0,1,3,2,4,5,6, VMCPMID - message identifier 12,13,15,16,17 VMCPUSER - source userid VMCPV ADA -RECEIVE buffer address VMCPLENA - RECEIVE buffer length VMCPUSE - user doubleword
CANCEL VMCPFUNC - X'0006' - subfunction code 0,2,3,4,5,11, VMCPMID - message identifier 12,14,15,20 VMCPUSER - sink userid
Figure 11 (Part 1 of 2). VMCF Subfunctions, Parameters, and Return Codes
102 VM/SP System Programmer's Guide
Previous Page Next Page