
                                 ===========
                                 QUEMON v1.8
                                 ===========

                        Copyright (c)1993/94 Roy Coates
                             roy@mechnet.liv.ac.uk
                             roysan@liverpool.ac.uk

Version 1.8
-----------
Quemon v1.8 is upwardly compatible from earlier versions the difference being
that it will now exit to DOS quicker than it did before and the exit keys can
be either ESC for normal use, or CTRL/SHIFT/Z for standalone use which helps
keep prying fingers at bay. See the /SECURE option below.


Overview
--------
Quemon is a print queue monitor for Novell 3.11 networks. It was written to
display print queue contents on an idle PC so that users didn't keep on
bothering me by asking where their print jobs had gone! It also saved me
having to explain PCONSOLE to them which I didn't really want them using 
anyway!. Quemon will display the first 20 jobs in each specified queue and
will cycle through the queues at a given speed.


Using Quemon
------------------------------------------------------------------------------
The syntax for calling QUEMON is:-

     QUEMON <queuename1> <queuename2> .. <queuename'n'> <options}

Where:-
       The queue-names will obviously be site specific. Should you wish
       to display all of your queues, then use /ALL instead of specifying
       individual queue names. Quemon currently recognises up to 100
       queues. (Anyone need more?)

and the Available options are:

/M[ono]  for mono monitors

/I[nt]=n to change the update speed. The default is to change between queues
         every 3 seconds but as an example, you could change this to every 10
         seconds by adding the switch /INT=10 to the command line.
         
/D[iag]  Causes Quemon to display the options you have selected before it
         starts to show queue contents.
         
/L[og]=[filename]  Causes Quemon to write each print job detected to a log-file.
         The workstation using Quemon must obviously have write/modify access
         to this file! The file will contain the job number, the date & time,
         the username, the queue name, and the job size. The file is in plain
         ASCII with each field seperated by a slash '/'. I will write some
         support s/w to read this file shortly!
         
         NOTES: If a very small print job is sent, it might slip through the 
         logging process while Quemon is looking at another queue. This is
         not a bug, Quemon was never intended to be a full blown print logger!

/AP[pend]  Causes Quemon to append to an existing log-file if it already 
           exists. If a file does already exist and you do NOT specify /APPEND
           then Quemon will prompt you before continuing.

/S[ecure]  Changes the exit key sequence from a simple hit of the ESC key to
           CTRL/SHIFT/Z for standalone use. This has stopped my users from
           buggering up the pc anyway!

Examples:-

   1.  QUEMON laser1 laser2 matrix /int=5

   2a. QUEMON /int=4 accounts /mono payroll /log=sys:\logs\print.log /append

   2b. QUEMON /i=4 account /m payroll /l=sys:\logs\print.log /ap

( 2a. and 2b. are the same )
(It doesn't matter where the switches are located on the command line!)

Alternatively, you can place each command line option required into a text 
file and call Quemon using  QUEMON @<filename>  a sample file for example 2a.
would contain:-

     /int=4
     account
     /mono
     payroll
     /log=sys:\logs\print.log
     /append



If Quemon is run with no parameters, it will show a help script.

To install Quemon, just copy it to whichever directory suits you!

Oh yeah! To exit from Quemon press CTRL-SHIFT-Z  I didn't use the usual <ESC>
since I didn't want my users to muck it up too easily!


BUGS
----
There is a bug regarding log files. Novell doesn't report job sizes accurately 
which makes this feature a little sticky. I am working on it at the moment but 
for the time being - watch the log size!! and do NOT log Mail queues!


DISCLAIMER AND STUFF
--------------------
This software is released to the public domain as freeware provided that it
is not used for any financial gain. The software is released 'as is' and
the author will not be held responsible for any damages arising through the
direct or indirect use of this software. Fair nuff?

I would like to hear your views and comments regarding Quemon. It is through
user comments that the /ALL and /LOG switches were added. I'm always open to
new ideas both for Quemon and for any other utils you would like!

My sincerest thanks to those on NOVELL-L who helped me out with the CRF info,
especially the (almost?) legendary John Baird.

                                --- END ---
