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.