QUERY VIRTUAL PRINTER
Authorization
Privilege Class: G
Purpose
Use QUERY VIRTUAL PRINTER to display the status of all print devices accessible to your virtual machine.
Usage Notes
- 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.
Responses
Response 1:
For each virtual printer defined in your virtual machine configuration, the first three
lines of the response are:
PRT vdev CL c { CONT} { HOLD} {COPY nnn} { READY} FORM userform
{NOCONT} {NOHOLD} {CPY *nnn} {NOTREADY}
vdev TO userid {RDR} DIST distcode FLASHC ccc DEST dest
{PRT}
{PUN}
vdev FLASH name CHAR char [char[char[char]]] MDFY cmod n FCB fcb LPP nnn
For 3800 printers only, an additional line follows:
vdev SIZE width length {2WCGM} {BTS} {DATCK }
{4WCGM} {CFS} {NODATCK}
The remaining lines of the response for all printers are:
vdev type { EOF} {OPEN spoolid} { KEEP} { MSG} { NAME fname ftype}
{NOEOF} {CLOSED } {NOKEEP} {NOMSG} {NONAME }
[vdev SUBCHANNEL = vsub]
- vdev
- identifies the virtual printer.
- CL c
- identifies the spool file class given to spool files created on this device.
- CONT
- NOCONT
- controls the continuous spooling option. CONT causes all CLOSE requests to be ignored unless specified with the EOF override option.
- HOLD
- NOHOLD
- controls the HOLD status. HOLD prevents files from being printed on a real device by putting a user hold status on the file.
- COPY nnn
- CPY *nnn
- identifies the number of copies requested for the spool file. This is shown as a 3-digit number (nnn). The asterisk (*) indicates that the 3800 printer prints each page from the spooled output files nnn times before going on to the next page. If the asterisk (*) is not present, the entire file is printed sequentially.
- READY
- NOTREADY
- indicates whether the device is in ready or not-ready status. The status can be changed by the READY and NOTREADY commands.
- FORM userform
- displays the form associated with the device and assigned to the spool files as they are created.
- TO userid
- identifies the virtual machine that receives output from your virtual printer.
- RDR
- PRT
- PUN
- identifies the spool file queue to receive your printer output.
- DIST distcode
- identifies the distribution code assigned to each spool file produced from the device.
- FLASHC ccc
- identifies the number of copies printed while the forms overlay frame is superimposed on the output pages. The default is ccc=000.
- DEST dest
- identifies the destination value to be assigned to each spool file created on the device. If the destination value has not been changed by a SPOOL command, the default is OFF.
- FLASH name
- identifies the name of the forms overlay frame superimposed on the output pages if the file is printed on the 3800 printer.
- CHAR char
- identifies the name of the character set or sets used to generate output if the file is printed on the 3800 printer.
- MDFY cmod
- identifies the copy modification module used to alter output text if the file is printed on the 3800 printer.
- n
- identifies the copy modification character set number. If no copy modification character is set, n is 0.
- FCB fcb
- identifies the forms control buffer used in the vertical formatting of a page if the file is printed on the 3800 printer.
- LPP nnn
- identifies the lines per page setting for the virtual printer. The value can be a decimal number in the range 30 to 255, or 'OFF', which indicates that internal defaults will be used.
- width
- indicates the form width code (in hexadecimal) for a virtual 3800 printer and is a 2-character field.
- length
- identifies, in decimal notation, the length of the paper in half-inches loaded into a 3800 printer.
- 2WCGM
- 4WCGM
- specifies the number of writable character generation modules (WCGM) for the virtual 3800 printer. A WCGM is a 64-position portion of the 3800's character generation storage that holds the scan elements of one character set.
- BTS
- CFS
- designates the stacker assumed for the virtual 3800 printer. BTS is a burster-trimmer-stacker, and CFS is a continuous forms stacker.
- DATCK
- NODATCK
- specifies the handling of certain virtual 3800 data checks. If DATCK is specified, all 3800 data checks are reflected to the virtual machine (provided the BLOCK DATA CHECK CCW has not been issued). If NODATCK is specified, only data checks that occur because of invalid translate table specifications or unmatched FCB codes are reflected to the virtual machine.
- type
- identifies an IBM® printer type or VAFP printer.
- EOF
- NOEOF
- EOF closes, or NOEOF leaves open, the spool file on the specified device regardless of the CONT setting for the device.
- OPEN spoolid
- CLOSED
- indicates that a spool file has been created on the console and that the file is still open (OPEN), or indicates that no spool file is open on the device (CLOSED).
- KEEP
- NOKEEP
- controls the keep status, which indicates whether the current spool file is to be placed in user
hold after processing.
The keep status is placed on the spool file. After it is transcribed at the real printer, the file is assigned user hold status and is not purged. The file's keep status is retained.
- MSG
- NOMSG
- indicates whether you want to be informed about file printing and punching. If you specify MSG, you are informed. The message is sent to you when the file begins either printing or punching on a real device. This message is not sent if you have issued SET IMSG OFF. Specify NOMSG to reset the MSG option.
- NAME fname ftype
- NONAME
- identifies the file name and file type, if any, to be assigned to spool files created on the device.
- vsub
- identifies the virtual subchannel number.
Response 2:
PRT vdev ON PRT rdev [SUBCHANNEL = vsub]
is returned when the printer is a real device dedicated to your virtual machine.- vdev
- identifies the virtual device number.
- rdev
- identifies the real device number.
- vsub
- identifies the virtual subchannel number.
Messages
- HCP040E Device {rdev|vdev|ldev} does not exist
- HCP263E Too many operands were supplied for this command