QUERY VIRTUAL PRINTER

Read syntax diagramSkip visual syntax diagram Query Virtual PrinterPRT

Authorization

Privilege Class: G

Purpose

Use QUERY VIRTUAL PRINTER to display the status of all print devices accessible to your virtual machine.

Usage Notes

  1. 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