z/VM: CP Commands and Utilities Reference - z/VM - IBM

DEFINE (Spooling Device)
Examples
Responses
7. There is no Channel Command Word (CCW) validation performed for VAFP
devices. Therefore, spool files for VAFP devices may contain CCWs that do
not appear for other devices (for example: SENSE ID and READ FCB).
Specifically, when performing CCW I/O operations to a VAFP printer, most
CCWs in the channel program are treated as a write operation CCW. The
exceptions are X'08' which is treated as a transfer in channel command, X'03'
with a byte count of one which is treated as a no operation instruction, and
X'04' which is treated as a sense command.
The flags in the CCW flag field (for example, command chaining and data
chaining flags) will be respected for VAFP devices as they are for other virtual
printers with one exception. The SKIP flag will be ignored because most CCWs
are treated as write operations by these devices. The SKIP flag will be
preserved in the CCW that is placed in the spool file.
8. VAFP spool files with skip to channel other than 1 will not be rejected.
9. There is no corresponding real device type for a VAFP.
10. VAFP spool files are intended for use by AFP* printers and real printers
managed by RSCS. VAFP printers are not intended for normal use as a virtual
printer.
Print files created on VM using the VAFP support can be chosen for printing by
the CP real printer system. Care must be taken by the application which
creates these files. If the file is to be printed on a VM system printer, the
application must only use standard impact printer CCWs to create the file.
11. Files created on a VAFP device can be read by the virtual card reader using
either an assembler I/O instruction or DIAGNOSE code X'A8'. However, the
data in these files may be truncated. With respect to the read operation, these
files are treated like a file created on a virtual 3800 printer. That is, the file is
treated as if it has a logical record length of 204 and the records are truncated
at that point. The data in these files can be accessed without truncation by
using DIAGNOSE X'14' or the IUCV *SPL system service.
12. For more information, see “Usage Notes” on page 113.
define reader as 00c
You can specify the operands after vdev in any order and repeatedly. However, the
last specification of a repeatedly defined operand is the one used. For example, if
you enter:
define 3800 as 00a cfs datck size 07 22 2wcgm bts
BTS is the value used instead of CFS because it was specified after CFS.
Response 1:
type vdev DEFINED
confirms that the device has been defined.
type
identifies a reader, printer, or punch.
184 z/VM: CP Commands and Utilities Reference
vdev
identifies the virtual number of the spool device.