X'OOOl' ........ INITIATE X'0002' ........ ACCEPT X'0003' ........ PRESENT X'0004' ........ TERMINATE X'0005' ........ TERMINATE (all) On completion of an ACCEPT function, this register contains the length of the
data.
Ry+1
For the ACCEPT and PRESENT functions, this is a register that contains the
length of the data buffer when Rx+ 1 specifies a buffer address. On completion of
any DIAGNOSE operation, this register contains the return code.
Completion and Condition Codes: Return codes are returned from this facility in reg­
ister Ry+ 1. PSW completion codes and return codes are described below. Subf­
unctions that apply specifically to given combinations of completion and return
codes are shown in parentheses. CC=O Subfunction completed with no errors. RC=O (any) Normal completion.
RC= 1 (ACCEPT) Indicates another ACCEPT required for another data
stream.
RC=2 (ACCEPT) Indicates another ACCEPT required for next segment
of current data stream.
CC= 1 Error condition.
RC=l (any) Invalid function used in register Ry.
RC=2 (ACCEPT) No data available.
RC=3 (ACCEPT) Buffer too short. No data transferred. Another
ACCEPT is required to retrieve the data. Register Ry
contains the required data length.
RC=4 (ACCEPT or PRESENT) One of the following:
Buffer is greater than 4096 bytes.
Buffer length is not positive.
Buffer not in user's address space. Paging 110 error.
RC=5 (INITIATE) Already have eight virtual machines that have created
logical devices. Logical devices can be created for a
maximum of eight concurrently active virtual machines
in a VM/SP system.
RC=9 (INITIATE) Max of 512 logical devices per virtual machine
reached. DIAGNOSE Instruction in a Virtual Machine 261
RC= 10 (ACCEPT or PRESENT) FETCH or STORE protection violation.
CC=2 Busy condition
CC=3
RC= 1 (PRESENT) CP has pending data that must be accepted first. The PRESENT is not performed.
RC=2 (PRESENT) A previous PRESENT has not completed execution.
The current PRESENT is not performed. An external interrupt is
issued to indicate when this PRESENT should be reissued.
RC=3 (PRESENT) CP has an active READ BUFFER command. The PRESENT issued is for READ MODIFIED data.
RC=4 (PRESENT) The data presented is from a READ BUFFER. No CP READ is outstanding, or the READ is a READ MODIFIED. a. (INITIATE) Logical device type, class, or model is invalid.
b. (Other functions) Logical device number in register Rx is invalid.
RC= 1 (ACCEPT, PRESENT, TERMINATE) CP is in the process of ter­
minating the logical device.
RC=2 (ACCEPT, PRESENT, TERMINATE) The logical device number
does not exist.
RC=3 (INITIATE) The logical device class, type,
or model is invalid.
Descriptions 0/ Logical Device Support Facility Sub/unctions
Logical device subfunctions manage communications and the transfer of data
between CP and the virtual machine for which the logical device was created.
INITIATE: DIAGNOSE CODE X'7C' SUBFUNCTION CODE X'OOOI' The INITIATE subfunction opens a logical communications path between the call­
ing virtual machine issuing the DIAGNOSE and the VM/SP Control Program. It
causes a logical device to be created and the VM/370 logo to be directed to it.
This results in an external interrupt to the issuing virtual machine to indicate that CP has data to be processed.
Register Rx + 1 must contain the model number in byte 1, and the device class and
type in bytes 2 and 3. Register Rx is not used for input.
The address of the logical device is placed in register Rx. This value is used on
subsequent DIAGNOSE operations to indicate the logical device being used. This
address is also provided with the external interrupt so that the issuing virtual
machine can associate the interrupt with a specific logical device. ACCEPT: DIAGNOSE CODE X'7C' SUBFUNCTION CODE X'0002' 262 VM/SP System Programmer's Guide
Previous Page Next Page