[an error occurred while processing this directive]

HP OpenVMS Systems Documentation

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

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

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

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

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

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

$ 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

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

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

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

Contents

Index