Updated: 11 December 1998 |
OpenVMS System Manager's Manual
Previous | Contents | Index |
Users can specify that a job be held in a queue before processing by specifying one of the following qualifiers with the PRINT, SUBMIT, or SET ENTRY command:
You can use the following commands to hold and release jobs:
Command | Purpose |
---|---|
SET ENTRY/HOLD | Holds a job in a queue indefinitely before processing. |
SET ENTRY/AFTER= time | Holds a job in a queue for processing after a specified time. To specify /AFTER for a job on hold, you must also specify /NOHOLD to cause the job to be held only until the specified time. |
SET ENTRY/NOHOLD |
Releases a job that is held in a queue for any of the following reasons:
|
SET ENTRY/NOAFTER | Releases a job before the time specified with the SET ENTRY command. |
SET ENTRY/RELEASE |
Releases a job that is held in a queue for any of the following reasons:
|
$ SET ENTRY 1121/AFTER=12-FEB-1998:17:30 $ SET ENTRY/NOAFTER |
$ SET ENTRY 1121/AFTER=TODAY $ SET ENTRY/NOAFTER |
$ SET ENTRY 1234/HOLD $ SET ENTRY 1234/RELEASE |
To stop and requeue an executing print job, enter STOP/QUEUE/REQUEUE. This command suspends a currently executing job and requeues it to the specified queue. Other jobs remain pending in the queue until they are processed.
The STOP/QUEUE/REQUEUE command stops only the job currently executing in the queue. The queue is not stopped. |
$ STOP/QUEUE/REQUEUE=BETA_LPA0 BETA_LPB0 $ STOP/QUEUE/RESET BETA_LPB0 |
$ STOP/QUEUE/ENTRY=1251/REQUEUE=FRED_BATCH WILMA_BATCH |
To hold an aborted job, specify the /HOLD qualifier using the following format:
STOP/QUEUE/REQUEUE[=queue-name]/HOLD[/ENTRY=entry-number] queue-name |
The /HOLD qualifier places the aborted job in a hold state for later release with the SET ENTRY/RELEASE or SET ENTRY/NOHOLD command.
To change the scheduling priority of the aborted job, specify the /PRIORITY qualifier using the following format:
STOP/QUEUE/REQUEUE[=queue-name]/PRIORITY=n[/ENTRY=entry-number] queue-name |
Specify the new priority as n.
13.7.2.5 Requeuing a Pending Job
To requeue a job that is pending in a queue to a different queue, enter SET ENTRY/REQUEUE. For example:
$ SET ENTRY/REQUEUE=LN03$PRINT 196 |
This command moves job 196 to the queue LN03$PRINT.
13.7.2.6 Deleting a Job
Follow this procedure to delete either a pending or an executing batch job:
SHOW ENTRY/USER_NAME=username [entry-number] |
SHOW QUEUE/ALL_JOBS [queue-name] |
If you do not know the job name, user name, or queue name, enter
the following command:
$ SHOW QUEUE/BATCH/ALL_JOBS/BY_JOB_STATUS=EXECUTING |
DELETE/ENTRY=(entry-number)[,...] |
A user has noticed that a job is processing in an endless loop. The user is not the owner of the job and lacks sufficient privilege to stop it. The user enlists your aid as the system manager. You might enter the following command:
$ SHOW QUEUE/BATCH/ALL_JOBS/BY_JOB_STATUS=EXECUTING Batch queue JADE_BATCH, available, on JADE:: Entry Jobname Username Status ----- ------- -------- ------ 312 ARTWORK HUNTER Executing Batch queue OPAL_BATCH, available, on OPAL:: Entry Jobname Username Status ----- ------- -------- ------ 317 STOCKS CHANDLER Executing Batch queue RUBY_BATCH, available, on RUBY:: Entry Jobname Username Status ----- ------- -------- ------ 888 TEMPO ENGLISH Executing $ DELETE/ENTRY=317 |
Pausing an output queue lets you communicate with the print symbiont interactively. Enter STOP/QUEUE (without any qualifiers) to pause a queue. Once a queue is paused, you can perform the following operations:
To perform these tasks, you must enter STOP/QUEUE after the job has begun printing. |
By default, when you pause a queue and restart it, printing resumes in the current job at a checkpoint near where it left off. To specify the position at which the current job is to resume printing, pause the queue, then enter START/QUEUE with any of the following qualifiers:
Qualifier | Description |
---|---|
/BACKWARD[= n] | Restarts a print queue n pages before the current page; n defaults to 1. If you omit the value, printing resumes at the top of the current page. |
/FORWARD[= n] | Advances the specified number of pages before resuming printing the current file in the current job; the default is 1. If you omit the page value, printing resumes at the top of the next page. |
/SEARCH= "search-string" | Specifies that printing is to resume at the page containing the specified string. The search for the string moves forward, beginning on the page following the current page. During the search, consecutive tabs and spaces are treated as a single space, and character case is ignored. The string can be from 1 to 63 characters and must be enclosed in quotation marks (" "). |
/TOP_OF_FILE | Resumes printing at the beginning of the file that was current when the output execution queue paused. |
When you must use more than one positioning qualifier with the same START/QUEUE command, file positioning is performed in the following order:
$ STOP/QUEUE JADE_PRINT $ START/QUEUE/TOP_OF_FILE JADE_PRINT |
$ START/QUEUE/TOP_OF_FILE/FORWARD=15 SYS_LPA0 |
To print alignment data to aid in aligning printer forms, pause the queue, then enter START/QUEUE with the /ALIGN qualifier in the following format:
START/QUEUE/ALIGN[=(option[,...])] |
The following options control the number of alignment pages and type of alignment data:
Option | Description |
---|---|
MASK | Specifies that input data is masked by replacing alphabetic characters with the character X and numbers with the number 9. Mask characters let you prevent the printing of sensitive information. If you omit the MASK option, data is printed unaltered. |
n | A decimal number in the range 1 to 20 that specifies the number of alignment pages to print. By default, one page of alignment data is printed. |
You can use the /ALIGN qualifier with any of the file positioning qualifiers described in the previous section. File positioning is performed before alignment data is printed. After the alignment is complete, the queue enters a paused state until you restart it by reentering START/QUEUE. Printing resumes from the point that alignment data started; that is, the task is backspaced over the pages printed for alignment.
The command in the following example requests masked alignment for four pages of output. In this example, the file for the job that was being printed when the queue was paused is backspaced two pages before alignment is performed. Four pages of alignment mask characters are printed. Then the output for the current job is positioned backward four pages, and the queue pauses.
$ START/QUEUE/BACKWARD=2/ALIGN=(MASK,4) SYS_LPA0 |
The following sections can help you solve common queue problems:
Problem | Section |
---|---|
General printer problems | Section 13.8.1 |
Scheduling pending jobs | Section 13.8.2 |
Stock mismatch problems | Section 13.8.2.1 |
Characteristics mismatch problems | Section 13.8.2.2 |
Stalled output queues | Section 13.8.3 |
Autostart queues that do not start | Section 13.8.4 |
Problems deleting queues, forms, and characteristics | Section 13.8.5 |
Problems deleting files following printing | Section 13.8.6 |
Problems adding or deleting a module from a device control library | Section 13.8.7 |
Queue is disabled | Section 13.8.8 |
The following steps can help you determine the cause of general printer problems:
SHOW QUEUE/FULL queue-name |
Table 13-5 lists and describes queue statuses.
COPY input-filespec output-filespec |
If the COPY command does not produce output, a PRINT request will
not work.
If a job does not execute when expected, the job might have a pending or holding status. The SHOW QUEUE/FULL/ALL_JOBS command displays the status for all jobs on a queue.
If the job is in a holding status, see Section 13.7.2.3 for information about holding and releasing a job.
If the job is in the pending state, the /FULL qualifier enables you to see the reason why the job is ineligible to execute. (Use a 132-character wide display to make sure that all the information is displayed.)
For example:
$ SHOW QUEUE/FULL/ALL_JOBS/BY_JOB_STATUS=PENDING Generic printer queue REG$GENERIC /GENERIC=(REG$Q1,REG$Q2,REG$Q3)/OWNER=[SYSTEM]/PROTECTION=(S:M,O:D,G:R,W:R) Entry Jobname Username Blocks Status ----- ------- -------- ------ ------ 684 PROBLEMS CHURCHILL 3118 Pending (check execution queues) Submitted 7-MAR-1998 17:49 /FORM=DEFAULT /NOTIFY /PRIORITY=100 File: _$5$DUA174:[CHURCHILL]PROBLEMS.TXT;2 Printer queue REG$Q1, stopped, on LONDON::NPA1, mounted form DEFAULT /BASE_PRIORITY=4/DEFAULT=(FEED,FORM=DEFAULT)/OWNER=[SYSTEM] /PROTECTION=(S:M,O:D,G:R,W:R) Entry Jobname Username Blocks Status ----- ------- -------- ------ ------ 687 PM$SPEECH CHURCHILL 3558 Pending (queue stopped) Submitted 7-MAR-1998 17:51 /FORM=DEFAULT /NOTIFY /PRIORITY=100 File: _$5$DUA174:[CHURCHILL]PM$SPEECH.TXT;1 (checkpointed) |
A job enters the pending status whenever the job is not eligible to execute. Table 13-8 lists common causes and solutions for a pending status.
Problem | Solution |
---|---|
The queue is currently processing as many jobs as it can. | Wait until intervening jobs complete. |
The queue is stopped or stalled. |
If a SHOW QUEUE/FULL command shows the queue status as stopped or
stalled, determine why the queue is stopped or stalled.
If the queue is stopped, start it with START/QUEUE. If the stopped queue is an autostart queue, use START/QUEUE to activate the queue and ENABLE AUTOSTART/QUEUES to start the queue. If the queue is stalled, follow the steps in Section 13.8.3. |
The stock of the print job's form does not match the stock of the queue's mounted form. | Perform the steps in Section 13.8.2.1. |
The job was submitted or modified with characteristics not associated with the queue. | Perform the steps in Section 13.8.2.2. |
The queue has a block limit set and the size of the print job does not fall within the specified range. | Use SET ENTRY/REQUEUE to move the job to another queue, or use SET QUEUE/[NO]BLOCK_LIMIT to change or remove the block limit on the queue. |
The owner of the job does not have write access to the execution queue. | Use SET ENTRY/REQUEUE to move the job to another queue, or change the access to the queue as explained in Section 13.6.1. |
The print job is in a logical queue that is assigned to a stopped execution queue. | Use SET ENTRY/REQUEUE to requeue the job to another queue or start the execution queue to which the logical queue is assigned. |
An output job requires an output device that is enabled for lowercase printing. | If the printer supports lowercase printing, use the /LOWERCASE qualifier with SET PRINTER or SET TERMINAL. Otherwise, use SET ENTRY/REQUEUE to move the job to an execution queue that sends its output to a printer with lowercase printing enabled. |
Previous | Next | Contents | Index |
Copyright © Compaq Computer Corporation 1998. All rights reserved. Legal |
6017PRO_063.HTML
|