NAME

   lartq - spool queue examination program
    

SYNOPSIS

   lartq [-l] [-Llart] [job # ...] [luser ...]
    

DESCRIPTION

   lartq examines the spooling area used by lartd(8) for larts, and
   reports the status of the specified jobs or all jobs associated with a
   lart. lartq invoked without any arguments reports on any jobs
   currently in the queue.

   Options:

   -L   Specify a particular lart, otherwise the default lart is used
        (or the value of the LART variable in the environment). All
        other arguments supplied are interpreted as luser names or job
        numbers to filter out only those jobs of interest.

   -l   Information about each of the lusers comprising the job entry is
        printed. Normally, only as much information as will fit on one
        line is displayed.

   -a   Report on the local queues for all larts, rather than just the
        specified lart.

   For each job submitted (i.e. invocation of rlart(1m) lartq reports
   the admin's name, current rank in the queue, the names of lusers
   comprising the job, and the job identifier (a number which may be
   supplied to rlartrm(1m) for removing a specific job). Job ordering is
   dependent on the algorithm used to scan the spooling directory and is
   supposed to be FIFO (First in First Out). Luser names comprising a job
   may be unavailable (when rlart(1m) is used as a sink in a pipeline) in
   which case the luser is indicated as ``(standard input)''.

   If lartq warns that there is no daemon present (i.e. due to some
   malfunction), the lartc(8) command can be used to restart the lart
   daemon.


ENVIRONMENT

   If the following environment variable exists, it is used by lartq:

   LART Specifies an alternate default lart.


FILES

   /etc/lartcap To determine lart characteristics.
   /var/larts/* The spooling directory, as determined from lartcap.
   /var/larts/*/cf* Control files specifying jobs.
   /var/larts/*/lock The lock file to obtain the currently active job.


SEE ALSO

   rlart(1m), rlartrm(1m), lartc(8), lartd(8)


DIAGNOSTICS

   'Permission denied' will be reported if any luser attempts to use this
   command. Further, a lart will be immediately queued for the offending
   luser.


BUGS

   Due to the dynamic nature of the information in the spooling directory
   lartq may report unreliably.


AUTHORS

   Michael Firestone and Larry Lile © 1997