Return
Code
1
Meaning
Invalid virtual buffer address or length. A virtual machine attempted to execute a
VMCF sub function but specified an invalid address or length:• External interrupt buffer n,ot within virtual storage. • External interrupt buffer address not doubleword aligned. • Message data or buffer not within virtual storage. • External interrupt buffer less than the standard message header length.
2 Invalid sub function code. A virtual machine attempted to execute a VMCF sub
function but specified an unsupported subfunction code.
3 Protocol violation. A virtual machine attempted to execute a sub function which
would violate the defined protocol:• Cancel a message it did not originate. • Reply to a message not sent via SEND /RECV. • Executed more than one RECEIVE to a SEND or SEND /RECV request.
4 Source virtual machine not authorized. A virtual machine attempted to execute a
subfunction (other thanAUTHORIZE) but was not authorized to use VMCF (had
not successfully executed theAUTHORIZE subfunction).
5User not available. A virtual machine attempted to execute a function and speci
fied a virtual machine currently not available for VMCF communication:• Not logged on. • Not authorized for VMCF communication. • Virtual machine authorized SPECIFIC for some other virtual machine.
6 Protection violation. A virtual machine attempted to execute a VMCF function
that would result in aSTORE or FETCH protection violation. The virtual
machine specified a data or buffer address that contained a storage key other than
its currentPSW key (assume key was nonzero). This return code is also set if a
virtual machine attempts to receive data in a CP-owned shared segment.
7 SENDX data too large. A virtual machine attempted to execute a SENDX request
but specified a SENDX data length larger than the sink virtual machine external
interrupt buffer.
8 Duplicate message. A virtual machine attempted to execute a SEND-type function
and specified a message ID and virtual machine userid for which there was already
an active message.
9 Target virtual machine in QUIESCE status. A virtual machine attempted to exe
cute a SEND-type function and specified a sink virtual machine userid of a virtual
machine in QUIESCE status.10 Message limit exceeded. A virtual machine attempted to execute a SEND subfunc
tion but already had50 messages active. The virtual machine should clear any
pendingRESPONSE external interrupts or CANCEL previously sent messages in
order to continue processing.
Figure 12 (Part 2 of 3).DIAGNOSE Code X'68' Return Codes
The Virtual Machine Communication Facility107
Code
1
Meaning
Invalid virtual buffer address or length. A virtual machine attempted to execute a
VMCF sub function but specified an invalid address or length:
2 Invalid sub function code. A virtual machine attempted to execute a VMCF sub
function but specified an unsupported subfunction code.
3 Protocol violation. A virtual machine attempted to execute a sub function which
would violate the defined protocol:
4 Source virtual machine not authorized. A virtual machine attempted to execute a
subfunction (other than
not successfully executed the
5
fied a virtual machine currently not available for VMCF communication:
6 Protection violation. A virtual machine attempted to execute a VMCF function
that would result in a
machine specified a data or buffer address that contained a storage key other than
its current
virtual machine attempts to receive data in a CP-owned shared segment.
7 SENDX data too large. A virtual machine attempted to execute a SENDX request
but specified a SENDX data length larger than the sink virtual machine external
interrupt buffer.
8 Duplicate message. A virtual machine attempted to execute a SEND-type function
and specified a message ID and virtual machine userid for which there was already
an active message.
9 Target virtual machine in QUIESCE status. A virtual machine attempted to exe
cute a SEND-type function and specified a sink virtual machine userid of a virtual
machine in QUIESCE status.
tion but already had
pending
order to continue processing.
Figure 12 (Part 2 of 3).
The Virtual Machine Communication Facility