HP OpenVMS Systems Documentation |
OpenVMS DCL Dictionary
SHOW PROTECTION
Displays the current default process protection to be applied to all new files created during the terminal session or batch job. FormatSHOW PROTECTION ParametersNone. DescriptionThe SHOW PROTECTION command displays the current default file protection to be applied to all new files created during the terminal session or batch job. You can change the default protection at any time with the SET PROTECTION/DEFAULT command. Example
SHOW QUEUE
Displays information about queues and the jobs that are currently in queues. FormatSHOW QUEUE [queue-name] Parameter
DescriptionThe SHOW QUEUE command displays the name, type, status, and attributes of batch and output queues as well as information about jobs in the queues. When you enter the SHOW QUEUE command with no qualifiers, the OpenVMS system lists the names, types, and status of all the specified queues along with information about your jobs in those queues. The SHOW QUEUE command assumes the /BRIEF qualifier by default. Qualifiers
|
#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.)
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.
SHOW QUEUE/CHARACTERISTICS[characteristic-name]
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.
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.
/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.
#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.
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.
SHOW QUEUE/FORM [form-name]
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.
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.
/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.
#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.
Previous | Next | Contents | Index |