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
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
April 1, 1981
The length of the associated data or buffer is specified in
the VMCPLENA field. VMCPLENA contains the length of the data sent by a user, the length of
a RECEIVE buffer, or the length of an external interrupt
buffer, whichever is specified in the field VMCPVADA. The
size of the value specified in VMCPLENA is restricted only by
virtual machine storage size. The sink virtual machine can use the value in this field as
the data length for RECEIVE operations. VMCPVADB Contains the address of a source virtual machine's REPLY buffer for a SEND/RECV request. When the sink virtual machine
issues a REPLY in response to a SEND/RECV from the source
virtual machine, the REPLY data is moved in this buffer. The
length of the REPLY buffer is contained in the field VMCPLENB. VMCPLENB Specifies the length of the source virtual machine's REPLY buffer. The sink virtual machine uses this field to determine
the maximum length of the REPLY. A corresponding field within
the response message header contains a residual data count.
The source virtual machine uses this residual to
determine the length of the sink reply. The original REPLY buffer length (less the residual count) is the length of the REPLY from the sink virtual machine. VMCPUSE contains the VMCF user doubleword. The user doubleword is
transmitted to .the sink virtual machine in the SEND message
header for SEND, SEND/RECV, SENDX, and IDENTIFY requests. For RECEIVE, REPLY, and REJECT requests, the user doubleword is
transmitted to the source virtual machine within the RESPONSE message 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 VMCPARM 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'0068' RETURN CODES." 162 IBM VM/3 7 0 System Programmer's Guide
Previous Page Next Page