Subcode X'OOOO' Subcode X'0004' Condition
Code
o
1
2
3
3
3
3
3
3
Ry+l
4
8
12
16 20 24
Error
Data transfer successful
End of file or if subcode X'OOI8' and file is
at first record
File not found
Device address invalid
Device type invalid
Device busy, reader not ready, or device is a
real device
Fatal paging I/O error
Page already locked for I/O File in use by system; probable paging or
spooling error.
Rx = start address of fuUpage virtual buffer
Ry = virtual spool reader address
Ry + 1 = function subcode
The specified device is checked for a file activated via DIAGNOSE. If one is
found, the next fullpage buffer is made available to the virtual machine via a call to
DMKRP AGT. If a file is not found, the chain of reader files is searched for a file
for the calling user and connected to the virtual device for further reading. If no file
is found, virtual condition code 2 is set. When the end of an active file is reached,
the device status settings are tested for "spool continuous." If not set, virtual con­
dition code 1 is set, indicating end of file. If the device is set for continuous input,
the active file is examined to determine whether or not it is a multiple-copy file. If it
is, reading is restarted at the beginning of the file. If it is not, the file is closed via
DMKVSUCR and the reader chain is searched for another input file. If no other
file is found, virtual condition code 1 is set. A specific DIAGNOSE X'14' Subcode X'OOOO' must be issued to get the first spooled page again.
Notes:
1. Subcode X'OOOO' returns a 3 condition code if an active monitor file or CP
dump file is found.
2. Issuing DIAGNOSE X'14' subcode X'OOOO' against a locked page causes the
page to become unlocked.
Rx = virtual address of an SFBLOK buffer
Ry = virtual spool reader address
Ry+ 1 = flag, optional size of SFBLOK in doublewords, and function subcode.
If the specified device is in use via DIAGNOSE, theVSPLCTL block is checked to
see whether or not this is a repeated call for printer SFBLOKs. If it is, then the
chain search continues from the point where the last SFBLOK was given to the vir­
tual machine. In this case, cc = 1 is set when there are no more print files. If this is DIAGNOSE Instruction in a Virtual Machine 229

Sllbcode X'0008' Subcode X'OOOC'
Subcode X'0010'
Subcode X'OO 14 '
the first call for an SFBLOK, or if there have been intervening calls for file reading,
the spool input chain is searched from the beginning, and cc=2 is set if no files are
found.
If the high-order byte of the sub code register (Ry+ 1) is zero, then only 13
doublewords of the SFBLOK are returned and the rest could be truncated. How­
ever, if bit zero of the register is on, then bits 2 to 7 specify the amount of data to
be returned (in doublewords). If the actual SFBLOK is shorter, the extra space is
filled with zeros.
Note: The virtual buffer specified via Rx must not cross a page boundary or a spec­
ification exception results.
Rx = virtual address of an SFBLOK buffer
Ry = virtual spool reader address
Ry+ 1 = flag, optional size of SFBLOK in doublewords, and function subcode.
Processing for subcode X'0008' is the same as for subcode X'0004', except that
only punch files are processed.
Note: For both subcode X'0004' and subcode X'0008', the format definition for a
VM!SP SFBLOK can be found in the system macro library.
Rx = file identifier of requested file
Ry = virtual spool reader address
Ry+ 1 = function subcode
The spool input chain is searched for the file specified. If it is not found, cc=2 is
set. If it is found, the file is moved to the head of the chain so that it is the next file
processed by any of the other functions.
Rx = new copy count for the active file
Ry = virtual spool reader address
Ry + 1 = function subcode
The specified device is checked for an active file. If no file is active, cc=2 is set.
Otherwise, the copy COUNT for the file is set to the specified value, with a maxi­
mum of 255. If the specified count is not positive, a specification exception is gen­
erated.
Rx = start address of virtual fullpage buffer
Ry = virtual spool reader address
Ry + 1 = function subcode
The specified device is checked for an active file. If no active file is found, cc=2 is
set. Otherwise, the VSPLCTL pointers are reset to the beginning of the file. 230 VM/SP System Programmer's Guide