April 1, 1981 r- i VMCF i ISubfunctionl Applicable VMCPARM Parameters Return Codes l- -+- I I I AUTHORIZE I VMCPFLG1 - SPECIFIC/PRIORITY option 0,1,2,6,15 I I VMCPFUNC - X'OOOO' - subfunction code I I VMCPITSER - SPECIFIC user id I I VMCPVADA - external interrupt buffer address I I VMCPLENA - external interrupt buffer length .. ------+- I UNAUTHORIZEI VMCPFUNC - X'OO01' - subfunction code 0,2,4,15 l- I I SEND VMCPFLG1 - PRIORITY option 0,1,2,4,5,8 I I VMCPFUNC - X'OO02' - subfunction code 9,10,15,18 I I VMCPMID - message identifier I I VMCPUSER - sink userid I I VMCPVADA - SEND data address I VMCPLENA - SEND data length I I VMCPUSE - user doubleword I I I I (See Note) r I tSEND/RECV I VMCPFLG1 - PRIORITY option 0,1,2,4,5,8,9,
t I VMCPFTJNC - X'OOO3' - subfunction code 10,15,18 I t VMCPMID - message identifier I I VMCPUSER - sink userid I I VMCPVADA - SEND data address I I VMCPLENA - SEND data length , I VMCPVADB - REPLY buffer address , 1 VMCPLENB - REPL Y buffer length I I VMCPUSE - user doubleword I I I------+__ ISENDX t VMCPFLG1 - PRIORITY option 0,1,2,4,5,7,8, I t VMCPFUNC - X'OO04' - subfunction code 9,10,15,18 , , VMCPMID - message identifier I I VMCPUSER - sink userid I I VMCPVADA - SEND data address
! VMCPLENA - SEND data length
t VMCPUSE - user doubleword t I I I I (See Note) I r------+ -+ IRECEIVE t VMCPFUNC - X'0005' - subfunction code I 0,1,3,2,4,5,6, I I VMcpr1ID - message identifier I 12,13,15,16,17 I I VMCPUSER - source user id I I I VMCPVADA - RECEIVE buffer address t I I VMCPLENA - RECEIVE buffer length I I I VMCPUSE - user doubleword I I I I .. ---- ___ ________________ LI __________________ I Fields within the user parameter list that are not used by a I particular subfunction may be used to contain additional user data. I The data, however, can only be passed to the sink virtual machine by I the source virtual machine. The REPLY buffer address and length
fields (VMCPVADB+VMCPLENB) may be used to transmit additional user
data for SEND and SENDX requests. All fields except VMCPFL31, VMCPFLG2, VMCPFUNC, and VMCPUSER may be used to pass control
information with an IDENTIFY request. Figure 19. VMCF Subfunctions, Parameters, and Return Codes (Part 1 of 2) Part 2. Control Proqram (CP) 163
Page of GC20-1807-7 As Updated April 1, 1981 by TNL GN25-0829 r I VMCF I I I Subfunction I Applicable VMCPARM Fields I Return Codes I ,CANCEL I VMCPFUNC - X'0006' - subfunction code , 0,2,3,4,5,11, I , VMCPMID - message identifier I 12,14,15,20 I I VMCPUSER - sink userid , 1-'---- , , ,REPLY VKCPFUNC - X'0007' - subfunction code 0,1,2,3,4,5,6, I I VMCPMID - message identifier 12,13,15,16,17,19 I I VMCPUSER - source userid , I VMCPVADA - REPLY data address I I VMCPLENA - REPLY data length , I VMCPUSE - user doubleword I , , IQUIESCE VMCPFUNC - X'0008' - subfunction code 0,2,4,15 t I I I ,RESUKE VMCPFUNC - X'0009' - subfunction code 0,2,4,15 I I I IIDENTIFY VKCPFLG1 - PRIORITY option 0,2,4,5,9,10 I , VKCPFUNC - X'OOOA' - subfunction code 15,18 I , VKCPUSER - sink userid I I VKCPUSE - user doublevord I , I , (See Note) I I ,REJECT VMCPFUNC - X'OOOB' - subfunction code 0,2,3,4,12,13,15 I I VKCPMID - message identifier t , VMCPUSER - source userid I I VMCPUSE - user doublevord I I I I I Note: Fields within the user parameter list that are not used by a I I particular subfunction may be used to contain additional user data. I I The data, however, can only be passed to the sink virtual machine by I I the source virtual machine. The REPLY buffer address and length I I fields (VMCPVADB+VMCPLENB) may be used to transmit additional user I , data for SEND and SENDX requests. All fields except VMCPFLG1, I ,VMCPFLG2, VMCPFUNC, and VKCPUSER may be used to pass control I I information with an IDENTIFY request. I , I Figure 19. VKCF Subfunctions, Parameters, and Return Codes (Part 2 of 2) EXTERNAL INTERRUPT CODE X'4001' External interrupt code X'4001' is a special interrupt code recognized by CP as part of a VMCF transaction. Just as virtual machines use the DIAGNOSE instruction to communicate with CP, so too CP uses this
interrupt code to communicate with virtual machines. External interrupt
code X'4001' and DIAGNOSE code X'68' provide the mechanism VMCF uses to
synchronize message processing. 164 IBM VM/370 System programmer's Guide
Previous Page Next Page