 |
HP OpenVMS DCL Dictionary
HP OpenVMS DCL Dictionary
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.
/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.
/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 QUEUE/ALL/BY_JOB_STATUS=pending
Printer queue KLEE$LCA0, stopped, mounted form DEFAULT
/BASE_PRIORITY=4 /DEFAULT=(FEED,FORM=ELITE (stock=DEFAULT))
/OWNER=[SYSTEM] /PROTECTION=(S:M,O:D,G:R,W:S)
Entry Jobname Username Blocks Status
----- ------- -------- ------ ------
2045 APPLICA MARTIN 102 Pending
Batch queue SYS_TEX, available, on NODE22::
/BASE_PRIORITY=3 /JOB_LIMIT=25 /OWNER=[SYSTEM]
/PROTECTION=(S:M,O:D,G:R,W:S)
Entry Jobname Username Status
----- ------- -------- ------
1388 CHAPTER1.JOB MARTIN Pending
Generic batch queue CLUSTER_BATCH
/GENERIC=(HMSCMS_BATCH,NODE22_BATCH) /OWNER=[SYSTEM]
/PROTECTION=(S:M,O:D,G:R,W:S)
Entry Jobname Username Status
----- ------- -------- ------
936 no privilege Pending
.
.
.
|
The SHOW QUEUE command in this example displays only the queues in
which jobs are currently pending. The /ALL qualifier requests the
display of all pending jobs. Notice that you cannot see job information
for entry 936. You must have GROUP privilege to show all jobs in your
group or OPER privilege to show all jobs in all groups.
| #2 |
$ SHOW QUEUE/FULL ARMADA*
Batch queue ARMADA_BATCH, idle, on ARMADA::
/AUTO_START_ON=(ARMADA::) /BASE_PRIORITY=3 /JOB_LIMIT=3
/OWNER=[SYSTEM] /PROTECTION=(S:M,O:D,G:R,W:S)
Printer queue ARMADA$PRINT, stopped, on ARMADA::LPA0,
mounted form DEFAULT
/BASE_PRIORITY=4 /DEFAULT=(FEED,FORM=ELITE (stock=DEFAULT))
/OWNER=[SYSTEM] /PROTECTION=(S:E,O:D,G:R,W:W)
Entry Jobname Username Blocks Status
----- ------- -------- ------ ------
605 SET DUDSON 140 Pending (queue stopped)
Submitted 21-DEC-2001 16:14 /FORM=ELITE (stock=DEFAULT)
/PRIORITY=200
File: _$5$DUA1:[DUDSON]SET.CLD;5
606 CLOSE DUDSON 140 Pending (queue stopped)
Submitted 21-DEC-2001 16:16 /FORM=DEFAULT /PRIORITY=200
File: _$5$DUA1:[DUDSON]CLOSE.TXT;2
Printer queue ARMADA$PRINTER_1, idle, on ARMADA::TTA3,
mounted form DEFAULT
<Printer queue on node ARMADA for a LN03R printer>
/BASE_PRIORITY=4 /DEFAULT=(FEED,FORM=DEFAULT) /LIBRARY=SMU$DEVCTL
Lowercase /OWNER=[SYSTEM] /PROCESSOR=CPS$SMB
/PROTECTION=(S:M,O:D,G:R,W:S) /SEPARATE=(FLAG)
|
The SHOW QUEUE command in this example lists information on all of your
current job entries. Complete information about the queues, the jobs
contained in those queues, and the files associated with the jobs is
displayed.
| #3 |
$ SHOW QUEUE/SUMMARY
Batch queue HMSCMS_BATCH, available, on HMSCMS::
Job summary: 1 executing, 5 holding
Server queue NM$QUE01, available, on NODE22::, mounted form DEFAULT
Job summary: 2 executing
Generic server queue NM$QUEUE
Job summary: 1 timed release
Batch queue PIZZA_BATCH, idle, on PIZZA::
Job summary: queue is empty
Batch queue NODE22_BATCH, available, on NODE22::
Job summary: 1 executing, 1 timed release
Printer queue ARMADA$PRINT, stopped, on ARMADA::LPA0, mounted
form DEFAULT
Job summary: 8 pending (565 blocks)
Terminal queue ALLBQ, stopped, on KATYA::TTA2, mounted form DEFAULT
Job summary: 2 pending (445 blocks)
.
.
.
|
The SHOW QUEUE command in this example lists all queues and displays
the total number of jobs on the queues.
| #4 |
$ SHOW QUEUE DOC$LN03
Server queue DOC$LN03, stopped, on NEWTON::, mounted form DEFAULT
Entry Jobname Username Blocks Status
----- ------- -------- ------ ------
436 DOCPLAN HERSHEY 8 Retained until 11-JAN-2001 16:56
%JBC-F-JOBABORT, job aborted during execution
Completed 11-JAN-2001 15:56 on queue DOC$LN03
|
This SHOW QUEUE display includes the date and time at which a retained
job completed and the queue on which it executed. You can specify the
/RETAIN qualifier with the PRINT, SUBMIT, or SET ENTRY command to
specify the circumstances under which you want your job to be retained
in a queue. In this example, the user set job retention to be one hour
after job completion. Depending on the queue's job retention policy,
the job might be deleted from the queue at 16:56. (See the
PRINT, SUBMIT, or SET ENTRY command descriptions for
more information on the /RETAIN qualifier.)
SHOW QUEUE/CHARACTERISTICS
Displays information about queue characteristics defined for the
system. A characteristic is a user-defined attribute of a batch or
output queue, such as ink color.
Format
SHOW QUEUE/CHARACTERISTICS
[characteristic-name]
Parameter
characteristic-name
Specifies the name of a characteristic. The asterisk (*) and the
percent sign (%) wildcard characters are allowed. The default value for
the characteristic-name parameter is the asterisk wildcard
(*). Thus, information about all characteristics is displayed when you
do not specify a characteristic name.
You create a characteristic name with the DEFINE/CHARACTERISTIC
command. You can then assign it to a queue by using the
INITIALIZE/QUEUE, the SET QUEUE, or the START/QUEUE command with the
/CHARACTERISTICS qualifier. You can also specify characteristics for a
job by using the /CHARACTERISTICS qualifier with the PRINT, the SUBMIT,
or the SET ENTRY command.
Description
The SHOW QUEUE/CHARACTERISTICS command displays the characteristic name
and number of characteristics defined for the system. To see which
characteristics are associated with a particular queue, use the SHOW
QUEUE command with the /FULL qualifier.
Qualifier
/OUTPUT[=filespec]
/NOOUTPUT
Controls where the output of the command is sent. By default the output
of the SHOW QUEUE/CHARACTERISTICS 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 file specification may not include any wildcard characters. 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.
Examples
| #1 |
$ SHOW QUEUE/CHARACTERISTICS
Characteristic name Number
------------------- ------
BLUEINK 6
BROWNINK 25
COLOR_CHART 1
REDINK 0
TEXMAC_JOB 2
|
The SHOW QUEUE/CHARACTERISTICS command in this example displays all the
characteristics that have been defined for this system.
| #2 |
$ SHOW QUEUE/CHARACTERISTICS *INK
Characteristic name Number
------------------- ------
BLUEINK 6
BROWNINK 25
REDINK 0
|
The SHOW QUEUE/CHARACTERISTICS command in this example displays the
name and number of all characteristics that end with INK.
SHOW QUEUE/FORM
Displays information about forms defined for the system. Forms define
the size and type paper and the layout of text that are used for print
jobs.
Format
SHOW QUEUE/FORM [form-name]
Parameter
form-name
Specifies the name of the form. The asterisk (*) and the percent sign
(%) wildcard characters are allowed. The default value for the
form-name parameter is an asterisk (*), which means that the
names of all forms on the system are displayed.
Description
The SHOW QUEUE/FORM command displays the name and number of forms
defined for the system. To display the attributes associated with
forms, use the /FULL qualifier.
Use the SHOW QUEUE/FORM command to find out which forms are available
on the system. To see which forms are available on one or more queues,
use the SHOW QUEUE command with the /FULL qualifier.
Form names are created by the DEFINE/FORM command. You can specify a
particular form for a print job by using the /FORM qualifier with the
PRINT or SET ENTRY command. Forms are assigned to queues with the
INITIALIZE/QUEUE, the SET QUEUE, or the START/QUEUE command.
Qualifiers
/BRIEF (default)
Displays a brief description (form names, numbers, and descriptions)
about the forms on the system.
/FULL
Displays a full description (including paper size and margin settings)
about the forms on the system.
/OUTPUT[=filespec]
/NOOUTPUT
Controls where the output of the command is sent. By default the output
of the SHOW QUEUE/FORM 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 file specification cannot include the asterisk (*) and the percent
sign (%) wildcard characters. 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.
Examples
| #1 |
$ SHOW QUEUE/FORM DEFAULT
Form name Number Description
--------- ------ -----------
DEFAULT 0 System-defined default
|
The SHOW QUEUE/FORM command in this example displays only the default
form.
| #2 |
$ SHOW QUEUE/FORM LN01*
Form name Number Description
--------- ------ -----------
LN01_LANDSCAPE (stock=DEFAULT) 105 132 by 66 (landscape)
LN01_LANDSCAPE_INDENTED (stock=DEFAULT)
107 132 by 65 (landscape)
LN01_PORTRAIT (stock=DEFAULT) 106 80 by 60 (portrait)
|
The SHOW QUEUE/FORM command in this example displays the names of all
forms, including the stock, that begin with LN01. The display includes
the names, stock for each form, numbers, and brief descriptions of
those forms.
| #3 |
$ SHOW QUEUE/FORM/FULL
Form name Number Description
--------- ------ -----------
132_51_STD (stock=DEFAULT) 102 132 by 51 (standard short)
/LENGTH=51 /MARGIN=(BOTTOM=6) /STOCK=DEFAULT /TRUNCATE
/WIDTH=132
40_66_STD (stock=DEFAULT) 103 40 by 66 (standard labels)
/LENGTH=66 /MARGIN=(BOTTOM=6) /STOCK=DEFAULT /WIDTH=40
BLUE_PAPER_STOCK (stock=DIGITAL_8X11_STOCK1412TEA)
22222 blue paper, DEC order# 22222
/LENGTH=66 /MARGIN=(BOTTOM=6) /STOCK=DIGITAL_8X11_STOCK1412TEA
/TRUNCATE /WIDTH=80
DEFAULT 0 System-defined default
/LENGTH=66 /MARGIN=(BOTTOM=6) /STOCK=DEFAULT /TRUNCATE
/WIDTH=132
LN01_LANDSCAPE (stock=DEFAULT) 105 132 by 66 (landscape)
/LENGTH=66 /STOCK=DEFAULT /WIDTH=132
LN01_LANDSCAPE_INDENTED (stock=DEFAULT)
107 132 by 65 (landscape)
/LENGTH=65 /SETUP=(LN01_TOP_MARGIN_150) /STOCK=DEFAULT
/WIDTH=132
LN01_PORTRAIT (stock=DEFAULT) 106 80 by 60 (portrait)
/LENGTH=60 /SETUP=(LN01_PORTRAIT) /STOCK=DEFAULT /WIDTH=80
MEMO (stock=DEFAULT) 110 LN03 indented memo format
/LENGTH=64 /MARGIN=(TOP=2,LEFT=5) /STOCK=DEFAULT /TRUNCATE
/WIDTH=80
|
This SHOW QUEUE/FORM command also displays the names of all form types
and stock for the system. By using the /FULL qualifier, you can see
what image size has been set for each form type.
SHOW QUEUE/MANAGERS
Provides information about the queue manager(s) on the system or
OpenVMS Cluster.
Format
SHOW QUEUE/MANAGERS [queue-manager-name]
Parameter
queue-manager-name
Specifies the name of the queue manager for which you want information
displayed. The asterisk (*) and the percent sign (%) wildcard
characters are allowed. The default value for the
queue-manager-name parameter is the asterisk (*) wildcard
character. If no queue manager name is specified, information on all
queue managers is displayed.
Description
The SHOW QUEUE/MANAGERS command displays information about the queue
manager(s) on the system or OpenVMS Cluster. The command assumes the
/BRIEF qualifier as the default, and displays a one-line description
that includes each queue manager's name, status, and process node name.
The /FULL qualifier displays the following information:
- Full file specification of the queue database master file (disk,
directory, and file name of the shared master file)
- Name of queue manager
- Status of queue manager
- The node name on which the queue manager process is running (if the
queue manager process is currently running)
- Prioritized list of nodes on which the queue manager process can run
- Disk and directory containing the queue database files specific to
the particular queue manager
If a queue manager process is not running, the current location node
name will not be displayed for that queue manager.
The queue manager status can be one of the following:
| State |
Description |
|
Start pending
|
The queue manager process is attempting to start up, however, it is
waiting for a node on which it can run to enter the cluster.
|
|
Starting
|
The queue manager is in the process of starting up as a result of a
START /QUEUE /MANAGER command or failing over from another node in the
cluster.
|
|
Running
|
The queue manager is running.
|
|
Failing over
|
The queue manager is in the process of failing over to another node in
the cluster.
|
|
Stopping
|
The queue manager is in the process of stopping.
|
|
Stopped
|
The queue manager is stopped and will not start until a START /QUEUE
/MANAGER command is executed.
|
Qualifiers
/BRIEF
Displays a one-line description of queue manager(s) on the system or
cluster. The information displayed includes the name and status of the
queue manager and the node on which its process is running. The /BRIEF
qualifier is present by default.
/FULL
Displays complete information about queue manager(s) on the system or
cluster. The /FULL qualifier overrides the /BRIEF qualifier.
Examples
| #1 |
$ SHOW QUEUE/MANAGERS/FULL
Master file: SYS$COMMON:[SYSEXE]QMAN$MASTER.DAT;
Queue manager BATCHQ_MANAGER, running, on BBBBBB::
/ON=(BBBBBB, AAAAAA, CCCCCC, EEEEEE, *)
Database location: DISK1:[QUEUES]
Queue manager PRINTQ_MANAGER, starting, on AAAAAA::
/ON=(AAAAAA, BBBBBB, CCCCCC, EEEEEE, *)
Database location: DISK2:[QUEUES]
Queue manager SYS$QUEUE_MANAGER, running, on FFFFFF::
/ON=(FFFFFF, EEEEEE, CCCCCC, BBBBBB, AAAAAA, *)
Database location: DISK1:[QUEUES]
Queue manager TRANSFER_MANAGER, stopped
/ON=(AAAAAA, BBBBBB, EEEEEE)
Database location: DISK1:[TRANSFER]
|
The SHOW QUEUE/MANAGERS/FULL command displays complete information
about a queue manager on a system or cluster.
| #2 |
$ SHOW QUEUE/MANAGERS
Queue manager BATCHQ_MANAGER, running, on BBBBBB::
Queue manager PRINTQ_MANAGER, starting, on AAAAAA::
Queue manager SYS$QUEUE_MANAGER, running, on FFFFFF::
Queue manager TRANSFER_MANAGER, stopped
|
The SHOW QUEUE/MANAGERS command in this example shows information about
the queue manager in brief format. The /BRIEF qualifier is the default
and does not need to be specified.
| #3 |
$ SHOW QUEUE/MANAGERS/FULL SYS$QUEUE_MANAGER
Master file: SYS$COMMON:[SYSEXE]QMAN$MASTER.DAT;
Queue manager SYS$QUEUE_MANAGER, running, on FFFFFF::
/ON=(FFFFFF, EEEEEE, CCCCCC, BBBBBB, AAAAAA, *)
Database location: DISK1:[QUEUES]
|
The command, SHOW QUEUE/MANAGERS/FULL SYS$QUEUE_MANAGER, in this
example shows a request for a specific queue manager by name.
SHOW QUOTA
Displays the current disk quota that is authorized for a specific user
on a specific disk. This display includes a calculation of the amount
of space available and the amount of overdraft that is permitted.
Requires read (R) access to the quota file in order to display
the quotas of other users.
Format
SHOW QUOTA
Description
The SHOW QUOTA command indicates whether a quota exists for any
specific user on a specific disk. The display that results gives the
quotas used, authorized, and available in blocks. The amount of
overdraft permitted is also shown.
Qualifiers
/DISK[=device-name[:]]
Specifies the disk whose quotas are to be examined. By default, the
current default disk (defined by the logical name SYS$DISK) is examined.
/USER=uic or identifier
Specifies which user's quotas are to be displayed. By default, the
current user's quotas are displayed.
Examples
| #1 |
$ SHOW QUOTA
User [360,010] has 2780 blocks used, 7220 available,
of 10000 authorized and permitted overdraft of 500 blocks on DISK$
|
The SHOW QUOTA command in this example displays the amount of disk
space authorized, used, and still available on the current default disk
for the present user. The permitted overdraft in this example is 500
blocks.
| #2 |
$ SHOW QUOTA /USER=[360,007]/DISK=XXX1:
%SYSTEM-F-NODISKQUOTA, no disk quota entry for this UIC
|
The SHOW QUOTA command in this example displays the fact that the user
with user identification code (UIC) [360,007] has no disk quota
allocation on device XXX1.
| #3 |
$ SHOW QUOTA /USER=[360,111]
User [360,111] has 27305 blocks used, 2305 OVERDRAWN,
of 25000 authorized and permitted overdraft of 4000 blocks on DISK$
|
The SHOW QUOTA command in this example illustrates a user with an
overdrawn quota.
|
