Library /sys$common/syshlp/helplib.hlb  —  SHOW  QUEUE  Qualifiers

1    /ALL_JOBS

    Displays all the jobs in the specified queues. You must have read
    (R) access to the job to show information about any jobs.

2    /BATCH

    Displays only batch queues and jobs in those queues.

3    /BRIEF

       /BRIEF (default)

    Displays a one-line description of each queue and jobs that are
    in it. This information includes the name, type, and status of
    each queue. It also includes the entry number, the job name,
    the user name, and the status for each job shown. The /FULL and
    /FILES qualifiers override the /BRIEF qualifier.

4    /BY_JOB_STATUS

       /BY_JOB_STATUS=(keyword-list)

    Displays queues that contain jobs that match the specified
    status. By default, jobs owned by the user are displayed. Specify
    the status with one or more of the following keywords:

    EXECUTING     Requests the display of jobs in any of the
                  following states:

                     ABORTING    STALLED
                     EXECUTING   STARTING
                     PRINTING    SUSPENDED
                     PROCESSING

                  ABORTING means that the job is halting prior to
                  normal completion and will not continue processing.
                  A SUSPENDED state means that the job stopped during
                  processing, but should continue when the cause of
                  the SUSPENDED state is resolved. PROCESSING is the
                  executing state for server queues. PRINTING is the
                  executing state for printer and terminal queues.
                  STARTING means the job is beginning to be processed
                  or printed. A STALLED or SUSPENDED state means
                  that the job stopped during processing, but should
                  continue when the cause of the STALLED or SUSPENDED
                  state is resolved.

    HOLDING       Requests the display of jobs on hold. Holding
                  status indicates that the job is being held in
                  the queue indefinitely.

    PENDING       Requests the display of jobs with pending status.
                  Pending status indicates that the job is waiting
                  its turn to execute.

    RETAINED      Requests the display of jobs retained in the queue
                  after execution. Retained status indicates that the
                  job has completed, but it remains in the queue.

    TIMED_        Requests the display of jobs on hold until a
    RELEASE       specified time. Timed release status indicates that
                  the job is being held in the queue for execution at
                  a specified time.

    Note that if you specify the qualifier without a keyword, the
    system will only display queues that actually contain jobs.

5    /DEVICE

       /DEVICE[=(keyword-list)]

    Displays a particular type of queue and jobs in that queue.

    Specify the type of device queue with one or more of the
    following keywords:

    PRINTER       Requests the display of print queues.
    SERVER        Requests the display of server queues.
    TERMINAL      Requests the display of terminal queues.

    You can specify more than one keyword. If you do not specify a
    keyword with the /DEVICE qualifier, all printer, terminal, and
    server queues are displayed.

6    /EXACT

    Use with the /PAGE=SAVE and /SEARCH qualifiers to specify a
    search string that must match the search string exactly and must
    be enclosed with quotation marks (" ").

    If you specify the /EXACT qualifier without the /SEARCH
    qualifier, exact search mode is enabled when you set the search
    string with the Find (E1) key.

7    /FILES

    Adds to the display the list of files associated with each job.
    The /FILES qualifier overrides the /BRIEF qualifier.

8    /FULL

    Displays complete information about queues, jobs contained
    in queues, and the files associated with the jobs. The /FULL
    qualifier overrides the /BRIEF qualifier.

9    /GENERIC

    Displays only generic queues and jobs in those queues. A generic
    queue is not an execution queue. Its function is to hold jobs
    of a particular type (line printer jobs, for example) and direct
    them to execution queues for processing.

10    /HIGHLIGHT

       /HIGHLIGHT[=keyword]

    Use with the /PAGE=SAVE and /SEARCH qualifiers to specify the
    type of highlighting you want when a search string is found. When
    a string is found, the entire line is highlighted. You can use
    the following keywords: BOLD, BLINK, REVERSE, and UNDERLINE. BOLD
    is the default highlighting.

11    /OUTPUT

       /OUTPUT[=filespec]
       /NOOUTPUT

    Controls where the output of the command is sent. By default,
    the output of the SHOW QUEUE command is sent to the current
    SYS$OUTPUT device (usually your terminal). To send the output
    to a file, use the /OUTPUT qualifier followed by a file
    specification.

    The asterisk (*)  and the percent sign (%) wildcard characters
    are not allowed in the file specification. If you enter a partial
    file specification (for example, specifying only a directory),
    SHOW is the default file name and .LIS is the default file type.

    If you enter the /NOOUTPUT qualifier, output is suppressed.

12    /PAGE

       /PAGE[=keyword]
       /NOPAGE (default)

    Controls the display of information on the screen.

    You can use the following keywords with the /PAGE qualifier:

    CLEAR_SCREEN   Clears the screen before each page is displayed.

    SCROLL         Displays information one line at a time.

    SAVE[=n]       Enables screen navigation of information, where n
                   is the number of pages to store.

    The /PAGE=SAVE qualifier allows you to navigate through screens
    of information. The /PAGE=SAVE qualifier stores up to 5 screens
    of up to 255 columns of information. When you use the /PAGE=SAVE
    qualifier, you can use the following keys to navigate through the
    information:

    Key Sequence              Description

    Up arrow key, Ctrl/B      Scroll up one line.
    Down arrow key            Scroll down one line.
    Left arrow key            Scroll left one column.
    Right arrow key           Scroll right one column.
    Find (E1)                 Specify a string to find when the
                              information is displayed.
    Insert Here (E2)          Scroll right one half screen.
    Remove (E3)               Scroll left one half screen.
    Select (E4)               Toggle 80/132 column mode.
    Prev Screen (E5)          Get the previous page of information.
    Next Screen (E6),         Get the next page of information.
    Return, Enter, Space
    F10, Ctrl/Z               Exit. (Some utilities define these
                              differently.)
    Help (F15)                Display utility help text.
    Do (F16)                  Toggle the display to oldest/newest
                              page.
    Ctrl/W                    Refresh the display.

    The /PAGE qualifier is not compatible with the /OUTPUT qualifier.

13    /SEARCH

       /SEARCH="string"

    Use with the /PAGE=SAVE qualifier to specify a string that you
    want to find in the information being displayed. Quotation marks
    are required for the /SEARCH qualifier, if you include spaces in
    the text string.

    You can also dynamically change the search string by pressing the
    Find key (E1) while the information is being displayed. Quotation
    marks are not required for a dynamic search.

14    /SUMMARY

    Displays the total number of executing jobs, pending jobs,
    holding jobs, retained jobs, and timed release jobs for each
    queue. For output queues, the total block count for pending jobs
    is also shown.

15    /WRAP

       /WRAP
       /NOWRAP (default)

    Use with the /PAGE=SAVE qualifier to limit the number of columns
    to the width of the screen and to wrap lines that extend beyond
    the width of the screen to the next line.

    The /NOWRAP qualifier extends lines beyond the width of the
    screen and can be seen when you use the scrolling (left and
    right) features provided by the /PAGE=SAVE qualifier.
Close Help