 |
HP OpenVMS DCL Dictionary
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[,...]]
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.
Description
The SHOW ENTRY command displays information about a user's batch and
print jobs or about specific job entries.
The information displayed includes the entry number, the job name, the
owner, job size in blocks (for print jobs), and the job status. The
name, status, and queue type of the queue in which the job is located
are also displayed.
If you are only interested in information about your own batch and
print jobs, the SHOW ENTRY command produces a better display than the
SHOW QUEUE command. Because the SHOW QUEUE command displays queue
information regardless of whether your jobs are in these queues, you
must scan the display to locate your jobs. By contrast, the SHOW ENTRY
command displays only information relevant to your jobs (or those owned
by the user you specify with the /USER_NAME qualifier). If the
/USER_NAME qualifier is not specified, information about your own jobs
is displayed.
Qualifiers
/BATCH
Selects batch jobs for display.
/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.
/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
EXECUTING
PRINTING
PROCESSING
|
STALLED
STARTING
SUSPENDED
|
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_RELEASE
|
Requests the display of jobs on hold until a 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.
/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.
/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.
/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.
/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.
/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.
/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.
/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.
/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), Return, Enter, Space
|
Get the next page of information.
|
|
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.
/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.
/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.
/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.
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.
|
