home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 June / SIMTEL_0692.cdr / msdos / printer / lpr_lpq3.arc / LPQ.MAN < prev    next >
Text File  |  1989-10-14  |  4KB  |  66 lines
  1. NAME
  2.      lpq - display and manipulate the DOS print queue
  3.  
  4. SYNOPSIS
  5.      lpq [-c n] [-p n] [-t] [-s] [-r] [-1] [-v] [-h]
  6.  
  7. DESCRIPTION
  8.      lpq is a utility to display the files in the current print queue, along
  9.      with the file size and a sequential job number in the queue. lpq can
  10.      also manipulate the entries in the queue using the following options:
  11.         -c n    Cancel the job number (n) from the queue, where the job
  12.                 number is obtained from the lpq output listing.  Multiple
  13.                 -c n may be specified.
  14.         -p n    Priority to job (n).  lpq will move job (n) to the head of
  15.                 the queue and demote all other jobs by one place.
  16.         -t      Terminate printing and remove all jobs from queue.
  17.         -s      Suspend printing operation.  The current print job will
  18.                 complete, but no more will print until the queue is
  19.                 released. Print will consider the queue to have emptied,
  20.                 and the printer port will be available to other
  21.                 applications. The entries are still in the queue however
  22.                 and may be released by calling lpq with the -r option.
  23.                 May be specified along with other options.
  24.         -r      Release the print queue suspended by the -s flag.
  25.         -v      Verbose mode.  lpq is more chatty about it's activities.
  26.         -h      Display brief help text and exit.
  27.         -1      display the queue 1 file per line with no extraneous
  28.                 messages
  29.  
  30.         If any of the above options are given on the command line, lpq will
  31.     perform the requested action and then display the print queue. If no
  32.     arguments are given, lpq reports the current state of the print queue,
  33.     with a job number and file size for each entry.  If the file was entered
  34.     into the queue using lpr, the time of entry into the queue is also
  35.     displayed.  If a file has been deleted while still in the queue, this is
  36.     reported also. It is possible to delete a file in the queue and PRINT
  37.     will not notice until it reaches the head of the queue since it does not
  38.     have an open handle on the queued files.  Deleting the file currently
  39.     printing will result in a file sharing violation if share is installed,
  40.     but otherwise is allowed, and will result in termination of the print
  41.     job.  Options are processed in the order given.  It is possible to
  42.     specify more than one -c or -p on the command line.  The percentage printed
  43.     (of the file currently printing) will also be displayed.  This is
  44.     obtained by snooping in the system file table.
  45.  
  46.     lpq communicates directly with the print spooler by the TSR multiplex
  47.     interrupt 2FH.  This is documented for DOS 3.x and later.  It might
  48.     be possible to make it work with DOS 2.x since this used int 2F, but not
  49.     in the same way.
  50.  
  51. SEE ALSO
  52.     lpr, MS-DOS manual entry for PRINT
  53.  
  54. BUGS
  55.     The file time displayed by lpq is actually stored in the unused bytes of
  56.     the print queue entry, since few pathnames are actually this long (up to
  57.     64 bytes). If the pathname is too long, the time is missing.  If the
  58.     queue is loaded using "print" rather than lpr, it is possible that lpq
  59.     might find a "time" which is invalid.  This should not cause problems
  60.     beyond a bad time field in the lpq display.  The undocumented DOS service
  61.     52H (get "list of lists") is used to find out the current file pointer
  62.     position for the file handle used by print.com.  This should work for DOS
  63.     2.x, 3.x, 4.x but is not guaranteed.
  64.  
  65. AUTHOR
  66.     Richard Brittain  (richard@calvin.spp.cornell.edu)