Provided by: gnuspool_1.7_amd64 bug

NAME

       gspl-qlist - display job queue

SYNOPSIS

       gspl-qlist [ -options ] [ job number ... ]

DESCRIPTION

       gspl-qlist outputs a table on standard output showing jobs on the GNUspool spool queue,
       including those queued on other hosts on the network.

       Each line of the output corresponds to a single job, and by default the output is
       generally similar to the default format of the jobs screen of the gspl-pq(1) command,
       something like:

        0024139     jmc report1 a4      23K 1 150
        0026921     jmc prgm.c  listing 12K 1 150
        red:0021941 pbt report  a4.lh   17K 2 150

       The first field on each line is the numeric job number, preceded by a host name and a
       colon if on a remote machine.

       Various options described below enable the user to control the output in various ways. The
       job data itself may also be extracted.

       To limit the output to information about a given job or jobs, job numbers may be placed on
       the command line.

OPTIONS

       Note that the order of treatment, letters and keywords described below may be modified by
       editing the file rest.help - see spsyntax(5).  The environment variable on which options
       are supplied is "GSPL_QLIST" and the environment variable to specify the help file is
       "SPRESTCONF".

       -? or +explain
           causes a summary of the other options to be displayed without taking further action.

       -C nnnn or +classcode nnnn
           restricts attention to jobs matching the class code given. This may be reduced further
           by the user's class code unless he/she has override class privilege.

       -D or +default-format
           cancel a -F option and restore the default format.

       -e or +no-page-counts
           do not try to represent page numbers and counts on the output (this only affects the
           default format).

       -E or +page-counts
           do try to represent page numbers and counts on the output (this only affects the
           default format).

       -F string or +format string
           Specify user defined output format. The string argument contains characters to be
           printed and symbols representing the required data fields. This option overrides and
           preceding -D option, and is itself overridden by a following -D option.  See the
           section on format codes below for details of the format code sequences.

       -H or +header
           generate a header for each column of the output according to the field displayed
           there. The headers are taken from the message file, by default rest.help, which may be
           adjusted as required.

       -l or +local-only
           display only jobs local to the current host.

       -N or +no-header
           cancel the -H option.

       -n or +no-view-job
           cancel the -V option.

       -P range or +view-pages range
           with the -V option, specify a range of pages to output.

           A range may consist of single page numbers or subranges separated by commas, thus:

                   -V -P 1
                   -V -P 1,3,4-9

                   -V -P 2-7,12-
           such arguments would respectively select page 1, pages 1, 3 and 4 to 9 and pages 2 to
           7 and 12 to the end. Omitted numbers either side of the - denote "the beginning" and
           "the end".

       -p or +printed-jobs
           restricts attention to jobs which have been printed.

       -q name or +list-only name
           List only jobs for, or which could be printed on the specified subset of printers. The
           set of printers may contain just one name, a list of names or a list of patters for
           matching printer names. Shell-like pattern matching applies to the pattern. You may
           well need to put quotes around the pattern to avoid misinterpretation by the shell.
           This is further described below.

           To cancel this argument, give a single - sign as an argument.

       -r or +remotes
           display jobs local to the current host and connected hosts.

       -t string or +just-title string.
           restricts attention to jobs whose title matches the pattern given.  The pattern is
           further described below.

       -u user or +just-user user
           restricts attention to jobs owned by the given user or list of users given by a
           pattern.  The pattern is further described below.

       -V or +view-job
           cancel the job listing output and send the text of the job or jobs to standard output.

       -Y or +all-jobs
           displays all jobs, canceling -y or -p.

       -y or +unprinted-jobs
           restricts attention to jobs which have not been printed.

       -z or +include-null
           when listing jobs restricted by a -q argument, include jobs with no destination
           printer.

       -Z or +no-include-null
           when listing jobs and printers restricted by a -q argument, do not include jobs
           without a destination printer.

       +freeze-current
           Save all the current options in a .gnuspool file in the current directory.

       +freeze-home
           Save all the current options in a .gnuspool file in the user's home directory.

   Patterns
       The -q, -t and -u options may all be given a name, a comma-separated list of names or
       shell-like wildcard patterns. The patterns all take the standard form:

       *   matches anything

       ?   matches a single character

       [a-mp-ru]
           matches any one character in the range of characters given

       [!n-z9]
           matches any one character not in the range of characters given

       Be careful to enclose these sequences in quotes in case the shell misinterprets them.

       For example

               gspl-qlist -q ljet,ptr3
               gspl-qlist -q 'ptr*,lp[1-9]'
               gspl-qlist -u 'j*'
               gspl-qlist -t 'Acc*'

   Format codes
       The format string consists of a string containing the following character sequences, which
       are replaced by the corresponding job parameters. The string may contain various other
       printing characters or spaces as required.

       Each column is padded, usually on the right, to the length of the longest entry. If a
       header is requested, the appropriate abbreviation is obtained from the message file and
       inserted.

       %%  insert a single "%" sign

       %A  "wattn" if the write attention message flag is set.

       %a  "mattn" if the mail attention message flag is set.

       %C  class code

       %c  copies (right-justified)

       %D  page delimiter

       %d  delimiter number

       %F  post-processing flags

       %f  form type

       %G  "halted at" page number.

       %H  hold time

       %h  job title.

       %K  size of job in bytes

       %L  position reached in bytes.

       %l  "local" if local job only

       %m  "mail" if mail completion flag set.

       %N  job number, prefixed by host name if remote.

       %O  odd/even/swap flags.

       %o  originating host (might be different if via gspl-rpr(1)).

       %P  printer destination

       %p  priority.

       %Q  page reached.

       %q  "retain" if retained on queue.

       %R  page range.

       %S  size in pages.

       %s  "nohdr" if header suppressed.

       %T  delete time if not printed.

       %t  delete time if printed.

       %U  user name to be posted to.

       %u  user name owned by

       %W  submission or start time.

       %w  "write" if write completion message flag set.

       Note that the various strings such as nohdr etc are read from the message file also, so it
       is possible to modify them as required by the user.

       The default format is

               %N %u %h %f %Q %S %c %p %P

       with the (default) -E option and

               %N %u %h %f %L %K %c %p %P

       with the -e option.

FILES

       ~/.gnuspool configuration file (home directory)

        .gnuspool configuration file (current directory)

       rest.help message file

ENVIRONMENT

       GSPL_QLIST
           space-separated options to override defaults.

       SPRESTCONF
           location of alternative help file.

SEE ALSO

       gspl-plist(1), gspl-pq(1), gspl-qchange(1), gspl-qdel(1), spsyntax(5), gnuspool.conf(5),
       gnuspool.hosts(5).

DIAGNOSTICS

       Various diagnostics are read and printed as required from the message file, by default
       rest.help.

COPYRIGHT

       Copyright (c) 2009 Free Software Foundation, Inc.  This is free software. You may
       redistribute copies of it under the terms of the GNU General Public License
       <http://www.gnu.org/licenses/gpl.html>.  There is NO WARRANTY, to the extent permitted by
       law.

AUTHOR

       John M Collins, Xi Software Ltd.