NAME
     qshow - show information about jobs and accounts within the
     queue system 'fair que'

SYNOPSIS
     qshow [-w] [-r] [-u user] [-j jobid] [-q queue] [-sbcptl]

     qshow -d -u user [-q queue]

     qshow -d -j jobid [-q queue]

     qshow -a [-d] [-u user] [-q queue] [period]

     qshow -m

DESCRIPTION
     The qshow utility displays information waiting and running
     jobs in the queue system 'fair que'. It can also present
     accounting information for one or several queue accounts.

OPTIONS
     The following options are supported:

     -w          Show information about waiting jobs.

     -r          Show information about running jobs.

     -a          Show accounting information.

     -m          Show queue system status

     -d -j jobid Show detailed information about the job with
                 the specified jobid.

     -d -u user  Show detailed accounting information for a
                 chosen user or group.

     -d -a       Show a detailed accounting report.

     -u user     In conjunction with the -w or -r flag: Display
                 only those jobs that are owned be the specified
                 user or group.

     -j jobid    In conjunction with the -w or -r flag: Display
                 only the job with the specified jobid.

     -q queue    Show information about the specified queue. If
                 this flag is not present, the contents of the
                 QUEUE environment variable is used instead. If
                 QUEUE is undefined, the default queue is chosen.

     -s          Display the names of submitted jobs.

     -b          Display reserved resources.

     -c          Display chronological information (duration for
                 waiting jobs, start and end time for running
                 jobs.

     -p          Display job priorities: If a user or accounting
                 group has not yet used up its share of the total
                 resources available during the current 
                 accounting period, display the name of the user
                 or group in capital letters.

     -t          Display estimated start time for each waiting
                 job.

     -l          Generate a long listing; the same as -s -b -c
                 -p -t

OPERANDS
     The following operand is supported:

     period      Display accounting information for the specified
                 accounting period instead of the current one.

EXAMPLES
     1. The command

          example% qshow -l

        displays information about all waiting and running jobs.
        One line per job is printed, and each line contains
        jobid, username, jobname, reserved resources, 
        chronological information and (for waiting jobs) estimated
        start time.

     2. The command

          example% qshow -d -u marie

        displays detailed accounting information for the user
        marie.

     3. The command

          example% qshow -d -j 143

        displays detailed information about the job with jobid
        143.

     4. The command

          example% qshow -a

        displays an accounting summary for all users and groups.

     5. The command

          example% qshow -w -u marie -p

        displays priority statuses for marie's waiting jobs.
        Suppose she belongs to the group chemistry and that job
        143 belongs to her. Then the output may look like the
        following:

        Waiting jobs:

          143    marie       /chemistry/MARIE

        This means that marie has not yet used up her share of
        the available resources. However she has, together with
        other chemistry users, used up the chemistry 
        department's share of the machine, so jobs belonging to 
        users from other departments will be scheduled for
        execution before marie's job (as long as they do not
        exceed _their_ limits.)

SEE ALSO
     qsub, qdel

(c) Lennart Bengtsson         Last change: 13 Aug 1997
    CTH