Apr il 1, 1981 0 r- I V*1 I V*2 I VMCPFUNC VMCPMID 8 I I VMCPUSER 10 I- I VMCPVADA VMCPLENA 18 I , VliCPVADB VMCPLENB 20 I , VMCPUSE 28 L- V* 1 (VMCPFLG1 )
is a flaq byte used to specify options associated with a
particular subfunction.
This flaq byte can be set to the following values: VMCPAUTS (X'SO') Indicates, for the AUTHORIZE subfunction, an AUTHORIZE SPECIFIC request. When this bit is set, the VMCPUSER field
must contain the userid of the sink virtual machine. The
status of the specified sink virtual machine is not checked by the control program (CP) at this time. VMCPPRTY (X'40') Indicates, for SEND, SEND/RECV, SENDX, and IDENTIFY requests, a PRIORITY message request. For an AUTHORIZE request, it indicates an AUTHORIZE PRIORITY request. You cannot send PRIORITY messages to another virtual machine
unless that virtual machine has been authorized for PRIORITY messages. The SEND and RESPONSE external
interrupts for a PRIORITY' message are queued ahead of
pending nonpriority external interrupts. VMCPSMSG (X'20') Indicates that the virtual machine will accept messages
sent via the SMSG command.
Bits 3 through 7 are reserved for IBM use.
160 IBM System programmer's Guide

Page of GC20-1807-7 As Updated April 1, 1981 by TNL GN25-0829 V*2 (VIiCPFLG2j Reserved for IBM use. VMCPFUNC contains the halfword DIAGNOSE X'68' subfunction code that
defines the VMCF subfunction being requested as follows: VMCPMID • I I Command Hexadecimal Code Subfunction VMCPAUTH VMCPUAUT VMCPSEND VMCPSENR VMCPSENX VMCPRECV VMCPCANC VMCPREPL VMCPQUIE VMCPRESM VMCPIDEN VMCPRJCT X'OOOO' X'0001' X'0002' X'0003' X'0004' X'0005' X'0006' X'0007' X'0008' X' 0009' X'OOOA' X'OOOB' AUTHORIZE UN AUTHORIZE SEND SEND/RECV SENDX RECEIVE CANCEL REPLY QUIESCE RESUME IDENTIFY REJECT L- __________ ____________ . __ ____________________ Contains a unique message identifier associated with a
transaction. The source virtual machine must originate the
message ID for SEND, SEND/RECV, and SENDX requests. The
message ID is used by the sink virtual machine (along with VMCPUSER) to respond to the source request with a RECEIVE, REPLY, or REJECT request. The message ID allows the sink
virtual machine to selectively RECEIVE, REPLY, or REJECT messages when more than one message is enqueued. The message
ID is used by both the source and sink as a unique
identification for all messages. You may send messages with
the same message ID to multiple users; you cannot send
multiple messages with the same message ID to one user. Once a transaction is completed, however, the message ID may be
reused .. VMCPUSER Specifies the userid of the sink virtual machine for SEND, SEND/BECY, SENDX, IDENTIFY, and CANCEL requests and the userid
of the source virtual machine for RECEIVE, REPLY, and REJECT requests. The sink virtual machine uses this field in
combination with the message ID (VMCPMID) to respond to source
requests. When the oriqinal source parameter list VMCPARM is
passed to the sink as the messaqe header VMCMHDR, the userid
is changed from sink to source.
This field is also used to specify the SPECIFIC userid for an AUTHORIZE SPECIFIC request. VMCPVADA Contains one of four addresses, depending upon which VMCF subfunction is requested:
For SEND, SEND/RECV, and SENDX requests
6 VMCPVADA contains the
address of the source virtual machine data. For RECEIVE requests,. VMCPVADA contains the addressof a sink virtual
machine RECEIVE buffer. For REPLY requests, VMCPVADA contains
the address in sink virtual machine storage where REPLY data
is located. For an AUTHORIZE request, VMCPVADA specifies the
address of the virtual machine external interrupt buffer. Part 2. Control Proqram (CP) 161