| Previous | dContents | fIndex |
D This chapter describes the commands for maintaining and controlling 0 print jobs, print queues, and the queue manager.
B Some of the commands described in this chapter require privileges. Y 5.1 Displaying Print Job Status
D You can use the SHOW ENTRY command to display the status of a print H job. You do not need privileges to use this command to display your own H print jobs, but privileges are required to display another user's print jobs.
H The SHOW ENTRY command lists all your print jobs. To display the status E of another user's print job, you must supply the job number with the F SHOW ENTRY command or specify the user using the /USER qualifier. You E can display the job numbers for all print jobs in a designated queue . using the SHOW QUEUE /ALL command, as follows:
|
" + $ SHOW QUEUE /ALL PS40$A12 |
|
" L Printer queue PS40$A12, busy, on LEVEL::PS40, mounted form DCPS$DEFAULT (stock=DEFAULT) 9 Entry Jobname Username Blocks Status 9 ----- ------- -------- ------ ------ ; 304 MEMO MSMITH 5 Printing |
H You can use the SHOW ENTRY /FULL command to display information about a specific print job. For example:
|
" ' $ SHOW ENTRY 304 /FULL |
|
" 7 Entry Jobname Username Blocks Status 7 ----- ------- -------- ------ ------ 9 304 MEMO MSMITH 5 Printing * On busy printer queue PS40$A12 ' Submitted 14-JUN-2005 10:41 6 /FORM=DCPS$DEFAULT (stock=DEFAULT) /NOTIFY /PRIORITY=100 9 File: _$1$DUA10:[MSMITH]MEMO.TXT;1 (printing) |
H Print job status may be shown as "Printing" when the file has 9 not yet actually started printing on the printer. |
D You can delete a print job using the DELETE /ENTRY command. You can D delete you own print job without privileges. However, you must have / privileges to delete another user's print jobs.
G The DELETE /ENTRY command accepts the print job number as an argument. For example:
|
" ( $ DELETE /ENTRY=569 |
> This command deletes print job 569. The system sends messages - indicating the successful print job deletion.
F The print job is terminated in a method that depends on the status of 7 the print job when you issue the DELETE /ENTRY command.
| If you issue DELETE /ENTRY... | +DCPS software... |
|---|---|
| $ When the print job is printing | O May take several seconds to stop the print job. The printer prints data N in its buffers, plus any required job trailer pages and job log pages. K During this time, a SHOW QUEUE command displays the job's status as Aborting. |
| ? Before a connection is established with a network printer | Prints no pages. |
| ) After the connection is established | O Prints the job trailer page with a message indicating the fact that you deleted the print job. |
| 8 Before the job burst or job flag pages are printed | N May not print the job burst or job flag page. However, job trailer and F job log pages are printed if the queue is set up to print them. |
H When a print job is in the Holding state, you must release it for it to C print. The user can put a job in the Holding state using the PRINT E /AFTER or PRINT /HOLD command. The user or system operator can put a A print job in the Holding state using the SET ENTRY /HOLD command.
B Use the SET ENTRY /RELEASE command to release the print job to be H printed. You must specify the job number in the SET ENTRY command. This E command does not require privileges if you are releasing a print job F that you submitted. Privileges are required to release another user's print jobs.
For example:
|
" - $ SET ENTRY /RELEASE 569 |
@ In this example, print job 569 was in the Holding state and was released for printing. S 5.4 Requeuing Print Jobs
H You can change the print queue for one or more print jobs, as described in the following sections. E 5.4.1 Requeuing Pending Print Jobs
H You can requeue a print job that has not started printing using the SET G ENTRY /REQUEUE command. Without privileges, you can requeue your jobs. D With privileges, you can requeue any print job that has not started B printing. You must supply the job entry number with the SET ENTRY C command. The /REQUEUE qualifier requires the name of the new print queue. For example:
|
" ? $ SET ENTRY /REQUEUE=POSTSCRIPT$DUPLEX 596 |
H This command changes the print queue for job 596. The print job is sent to the POSTSCRIPT$DUPLEX queue. _ 5.4.2 Requeuing the Currently Printing Job to Another Queue
H When a printer problem prevents completion of the printing job, you can G requeue the print job to another printer. Use the STOP /QUEUE /REQUEUE F command to send the print job to another print queue. You supply both H the old queue name and the new queue name for this command. For example:
|
" P $ STOP /QUEUE /REQUEUE=POSTSCRIPT$DUPLEX POSTSCRIPT$SIMPLEX |
G In this example, the print job that is currently printing on the queue E POSTSCRIPT$SIMPLEX is stopped and requeued to POSTSCRIPT$DUPLEX. The H POSTSCRIPT$SIMPLEX queue is not stopped and continues with printing the next job in the queue. ^ 5.4.3 Requeuing Current and Future Print Jobs in a Queue
G The ASSIGN /MERGE command allows you to specify that all print jobs in E a certain queue, and those submitted later for that queue, are to be F sent to another queue. The ASSIGN /MERGE command requires privileges. C You must supply the old queue name and the new queue name. Use the following procedure:
|
" 8 $ STOP /QUEUE /NEXT PRINTER$NOTABLEH $ STOP /QUEUE /REQUEUE=PRINTER$ABLE PRINTER$NOTABLEA $ ASSIGN /MERGE PRINTER$ABLE PRINTER$NOTABLE |
B The SET ENTRY command allows a user to modify the attributes of a @ pending print job. You cannot modify a print job that has begun C printing. If you have privileges, you can modify the attributes of D print jobs submitted by other users. The SET ENTRY command requires F that you specify the job number and allows you to specify one or more q PRINT command qualifiers, which are listed in Appendix A. For example:
|
" K $ SET ENTRY 596 /PARAMETERS=PAGE_ORIENTATION=LANDSCAPE |
H This example changes a print job from portrait orientation to landscape G orientation. If the original PRINT job contained any PRINT parameters, E you must specify them all again when you modify any print parameters D with the SET ENTRY /PARAMETERS command. If you do not respecify the B PRINT parameters, the print job will be printed using the default A parameter values for those not included in the SET ENTRY command. R 5.6 Displaying a Queue
H You can display a print queue, including its status, its attributes and H the print jobs in the queue, using the SHOW QUEUE command. This command D does not require privileges, unless you wish to view queue security 8 information or view print jobs belonging to other users.
F To display a specific queue, supply the queue name. To display all of E the queues, omit the queue name from the SHOW QUEUE command. Use the s commands in Table 5-1 to display information about queues.
| To list: | !Enter: |
|---|---|
| = The name and description of every print and batch queue | SHOW QUEUE |
| ' The names of all the print queues | SHOW QUEUE /DEVICE=PRINTER |
| $ All the jobs in all the queues | SHOW QUEUE /ALL |
| ) All the jobs in the specified queue | SHOW QUEUE /ALL queue-name |
| & The attributes of all the queues | SHOW QUEUE /FULL |
| ' The attributes of a certain queue | SHOW QUEUE /FULL queue-name |
G Use the STOP /QUEUE command to pause a queue. You must have privileges 5 and supply the queue name to the STOP /QUEUE command.
E You can pause the queue after the current print job has completed by D using the STOP /QUEUE /NEXT command. This allows the current job to / complete before pausing the queue. For example:
|
" . $ STOP /QUEUE /NEXT PS$A4 |
H This command pauses the queue PS$A4 after the current job has completed printing.
F If it is necessary to pause the queue without waiting for the current A job to complete, use the STOP /QUEUE /RESET command. For example:
|
" / $ STOP /QUEUE /RESET PS$A4 |
C This command pauses the queue PS$A4 and printing stops immediately.
? When communications problems arise with a serial or raw TCP/IP C interconnect, the symbiont will keep listening for up to 4 minutes = before disconnecting from the printer. Therefore, under some : conditions, the device is not released immediately after a STOP /QUEUE /RESET command is issued. |
b See Appendix A for more STOP /QUEUE qualifiers. Q 5.8 Starting a Queue
D Use the START /QUEUE command to restart a print queue that has been D paused with the STOP /QUEUE command. If you make changes to a print > queue in DCPS$STARTUP.COM, restart the queue by executing the i DCPS$STARTUP.COM file, as described in Section 3.7.
H For example, to restart print queue PS40$A15, use the following command:
|
" , $ START /QUEUE PS40$A15 |
G If you interrupt a printing job when you stop the queue, the print job $ restarts when you restart the queue.
B The logical name, DCPS$queuename_PID, is defined by the F symbiont when it starts executing. This allows the system manager to ? determine which symbiont is assigned to a given queue, and is < especially useful when using multi-streamed symbionts. See ? Section 3.5.1.
H You can temporarily modify the attributes of a print queue with the SET @ QUEUE command. When the printing system is restarted, the queue G attributes you set with the SET QUEUE command are lost. To permanently > modify print queue attributes, edit the DCPS$STARTUP.COM file.
u The qualifiers to the SET QUEUE command are listed in Appendix A. H Note that some print queue attributes cannot be set using the SET QUEUE command.
F The following command limits the print jobs for the PS$DRAFT queue to those of 1000 blocks or less.
|
" ; $ SET QUEUE PS$DRAFT /BLOCK_LIMIT=1000 |
E The SET QUEUE command requires privileges; you must supply the queue $ name and the appropriate qualifiers. k 5.10 Preventing Users from Printing to a Queue
D Use the SET QUEUE /CLOSE command to close a queue and prevent users ? from submitting print jobs to the queue. This command requires ; privileges and you must supply the queue name. For example:
|
" - $ SET QUEUE /CLOSE PS$A4 |
B After you enter this command, the PS$A4 queue is closed and users ? cannot submit print jobs to the queue. The print jobs that are C currently in the queue are completed. You can open the print queue using the following command:
|
" , $ SET QUEUE /OPEN PS$A4 |
C You can delete a print queue using the DELETE /QUEUE command. This G command requires privileges. Follow these steps to delete a DCPS queue:
|
" * $ DELETE /QUEUE PS$A4 |
A Remember to modify the DCPS$STARTUP.COM file to delete the queue C permanently. Otherwise, when the printing system is restarted, the ' print queue you deleted will come back. a 5.12 Responding to a Stalled Queue
G Printers are reported as Stalled when the DECprint Supervisor does not H receive information from the printer within a specified amount of time. E When the stalled timeout value is exceeded, the following message is displayed:
|
" = PRINTERSTALLED, Printer printer-name is stalled |
F You can alter the stalled printer timeout value be defining a logical:
|
" l $ DEFINE /SYSTEM /EXECUTIVE DCPS$queuename_STALL_TIME "0 hh:mm:ss.00" |
E where hh:mm:ss.00 is an OpenVMS delta-time value specifying the desired time delay.
F The default stalled timeout value is four minutes. HP recommends that % you do not change this timeout value.
A When you receive a message that the printer is stalled, you must D determine if action is required. If the stalled message came from a D networked printer (for example, a PrintServer printer), the stalled G message probably indicates that a long time has passed between network H communications and therefore you can safely ignore the stalled messages.
H But if the stalled message follows other printer-related messages, they E may indicate another reason for the long delay. The printer might be D out of paper, or it might have a paper jam. Therefore, when a print C queue is stalled, you should check your OPCOM messages to see if a v printer condition was previously reported. Refer to Chapter 11 for more information.
C DCPS may also temporarily define a system-wide logical giving some A indication of why the queue is stalled. To examine this logical, F execute the following command on the system where the execution queue F is running. If the queue is on an OpenVMS Cluster, be sure to use the appropriate cluster member.
|
" C $ SHOW LOGICAL DCPS$queuename_STALLED |
C To stop and start all the queuing activity on the system, stop and H start the queue manager. System shutdown and startup procedures perform C these operations automatically. The commands to stop and start the ! queue manager require privileges.
; You can stop the queue manager using the following command:
|
" 4 $ STOP /QUEUE /MANAGER /CLUSTER |
C When you are ready to start the queue manager, enter the following command:
|
" , $ START /QUEUE /MANAGER |
| Previous | aNext | dContents | fIndex |