HELPLIB.HLB  —  SHOW  ENTRY
    Displays information about a user's batch and print jobs or about
    specific job entries.

    Requires read (R) access to the queue.

    Format

      SHOW ENTRY  [entry-number[,...]],[job-name[,...]]

1  –  Parameters

 entry-number[,...]

    Specifies the entry number of the job you want displayed. If
    no entry number or job name is specified, all your own jobs (or
    those owned by the user specified with the /USER_NAME qualifier)
    are displayed.

 job-name[,...]

    Specifies the name of the jobs you want displayed. The asterisk
    (*)  and the percent sign (%) wildcard characters are allowed. If
    no job name or entry number is specified, all your own jobs (or
    those owned by the user specified with the /USER_NAME qualifier)
    are displayed.

2  –  Qualifiers

2.1    /BATCH

    Selects batch jobs for display.

2.2    /BRIEF

       /BRIEF (default)

    Displays the following information for each job: entry number,
    job name, user name, job size in blocks (for print jobs), job
    status, queue name, queue status, and queue type. The /FULL and
    /FILES qualifiers override the /BRIEF qualifier.

    Specify the /FULL qualifier to obtain more job information.

2.3    /BY_JOB_STATUS

       /BY_JOB_STATUS[=(keyword,...)]

    Selects for display only those jobs with the specified status.
    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. 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.
                  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.

    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 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.

    If no keyword is specified, the /BY_JOB_STATUS qualifier displays
    the status of all jobs.

2.4    /DEVICE

       /DEVICE[=(keyword,...)]

    Selects for display only those print jobs in the queue types
    specified. Specify the queue type with one or more of the
    following keywords:

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

    If no keyword is specified, the /DEVICE qualifier displays all
    jobs in printer, terminal, or server queues.

2.5    /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.

2.6    /FILES

    Adds to the default display the list of full file specifications
    for each file in each job. The /FILES qualifier overrides the
    default /BRIEF qualifier.

2.7    /FULL

    Displays the following information for each job: entry number,
    job name, user name, job status, full file specification
    associated with each job, date and time of submission, settings
    specified for the job, queue name, queue status, and queue type.

    The /FULL qualifier overrides the default /BRIEF qualifier.

2.8    /GENERIC

    Selects for display only those jobs contained in generic queues.
    A generic queue holds jobs of a particular type (for example,
    batch or line printer jobs) and directs them to execution queues
    for processing.

2.9    /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.

2.10    /OUTPUT

       /OUTPUT[=filespec]
       /NOOUTPUT

    Controls where the output of the SHOW ENTRY command is sent.
    By default, the output 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.

2.11    /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.

2.12    /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.

2.13    /USER_NAME

       /USER_NAME=username

    Selects for display those jobs owned by the specified user. If
    the /USER_NAME qualifier is not specified, information about
    your own jobs is displayed. The name must be 1 to 12 alphanumeric
    characters.

2.14    /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.

3  –  Examples

    1.$ SHOW ENTRY/BY_JOB_STATUS=RETAINED
      Entry    Jobname       Username    Blocks      Status
      -----    -------       --------    ------      ------
        422    FORECAST      JONES                   Retained on completion
               On stopped generic batch queue CLUSTER_BATCH
               Completed 21-DEC-2001 16:18 on queue NODE_BATCH

      In this example, the SHOW ENTRY command displays a job entry
      that was retained on completion.

    2.$ SHOW ENTRY/FULL S*
      Entry     Jobname      Username    Blocks     Status
      -----     -------      --------    ------     ------
        625     STAFF        ESTES          112     Pending (queue stopped)
                On stopped printer queue LN01$PRINT
                Submitted 19-DEC-2001 12:14 /FORM=LN01$PORTRAIT
                (stock=DEFAULT) /NOTIFY /PRIORITY=100
                File: _DKA1:[ESTES]STAFF.DIS;3

        629     SEARCH         ESTES          94      Printing
                On printer queue LINE$PRINT
                Submitted  19-DEC-2001 12:16 /FORM=DEFAULT /NOTIFY
                /PRIORITY=100 /COPIES=2 /NOFEED /PASSALL
                File: _DKA1:[ESTES.DAILY]SEARCH.TXT;2 (printing copy 2)

      In this example, the SHOW ENTRY command displays the current
      jobname entries beginning with the letter "S" owned by ESTES
      on all queues. The /FULL qualifier lists the submission
      information, the full file specification, and the current
      settings for the job.

      Note that entry 629 specified the /COPIES, /NOFEED, and
      /PASSALL qualifiers to the PRINT command. The /NOFEED qualifier
      suppresses automatic form feeds. The /PASSALL qualifier
      suppresses formatting (including form feeds and carriage return
      characters) performed by the print symbiont.

    3.$ SUBMIT ASSIGNMENTS.COM
      Job ASSIGNMENTS.COM (queue SYS$BATCH, entry 199) pending
         .
         .
         .
      $ SHOW ENTRY 199/FULL
      Entry    Jobname       Username     Status
      -----    -------       --------     ------
        199    ASSIGNMENTS   JONES        Executing
               Submitted 19-DEC-2001 08:36 /KEEP /NOLOG/ NOPRINT
               /PRIORITY=100
               File: DUA2:[JONES]ASSIGNMENTS.COM;34

      In this example, JONES submits ASSIGNMENTS.COM for batch
      processing. Because JONES does not specify a specific queue,
      the job is entered into the generic SYS$BATCH queue to await
      processing. After performing other tasks, JONES checks the job
      status and sees that the file is now executing. Note that the
      job entry migrated from a generic to an execution batch queue
      and that JONES was able to check the job status without knowing
      the specific batch queue name. If the user did not specify an
      entry number, all jobs would have been displayed.
Close Help