|
HP OpenVMS System Manager's Manual, Volume 1:... |
Setting Up and Maintaining Queues |
|
|
| |
Also, setting up queues is not restricted to startup time. During normal operation, you can create and start queues as your needs dictate. If you decide to set up queues at a later time, refer to the instructions in Creating and Starting Queues.
If you create additional output queues at a later time, make sure to perform the following actions:
Using Queue Management Commands
Effects of Queue Commands lists commands for creating and controlling
queues and tells whether they have the same effect on all queues
or if they have different effects on autostart and nonautostart
queues.
The following sections describe these tasks for managing queues:
| Task | For More Information |
|---|---|
|
Monitoring
queue information
|
Monitoring Queue Information
|
|
Modifying a
queue
|
Modifying a Queue
|
|
Pausing a queue
|
Pausing a Queue
|
|
Closing a queue
|
Closing a Queue
|
|
Stopping a
queue
|
Stopping a Queue
|
|
Preventing
autostart queues from starting
|
Preventing Autostart Queues from Starting
|
|
Disabling autostart
on a node
|
Disabling Autostart on a Node
|
|
Stopping all
queues on a node
|
Stopping All Queues on a Node
|
|
Stopping queues
before shutting down a system
|
Stopping Queues Before Shutting Down a System
|
|
Assigning a
logical queue
|
Assigning a Logical Queue
|
|
Moving all
jobs from one queue to another
|
Moving All Jobs from One Queue to Another
|
|
Deleting a queue
|
Deleting a Queue
|
Monitoring Queue Information
Use the SHOW QUEUE command
to monitor the status of queues. To display queue information, enter SHOW
QUEUE in the following format:SHOW QUEUE [/qualifier,...] [queue-name]
If you do not specify a qualifier or a queue name, the system displays the status of all queues on the system and all jobs you own. The SHOW QUEUE qualifiers let you select the type of queue and the amount of information you want to display.
Use the following qualifiers to select the information you want to display:
| Qualifier | Description |
|---|---|
|
/BY_JOB_STATUS[=keyword-list]
|
Displays queues that contain
jobs of the specified status. You can specify one or more of the
following keywords:
If no keyword is specified, by default the jobs of all status are displayed. For more information about job status, see Job Statuses Returned by SHOW ENTRY. |
|
/BATCH
|
Displays batch execution
queues.
|
|
/DEVICE[=keyword-list]
|
Displays output execution
queues. You can select a specific type of execution queue by entering
one or more of the following keywords:
If no keywords are specified, all types of output queue are displayed. |
|
/GENERIC
|
Displays the status of generic queues.
|
Use the following qualifiers to select the amount of information you want to display:
You can also combine certain qualifiers to further delineate the queue information you want to display.
Queue Statuses Displayed in the SHOW QUEUE Command defines queue statuses returned by SHOW QUEUE.
| Queue Status | Description |
|---|---|
|
Aligning
|
Queue manager is processing
a START/QUEUE/ALIGN command.
|
|
Autostart inactive
|
Queue was stopped and needs
to be activated. For more information, see
Determining Why an Autostart Queue Does Not Start.
|
|
Available
|
Queue is processing at least
one job but is capable of processing additional concurrent jobs.
|
|
Busy
|
Queue cannot process additional
jobs because of one or more jobs in progress.
|
|
Closed
|
Queue is closed and will
not accept new jobs until it is set open. For more information, see
Closing a Queue.
|
|
Device unavailable
|
Device to which the queue
is assigned is not available.
|
|
Idle
|
Queue is not processing
any jobs and is capable of doing so.
|
|
Paused
|
A STOP/QUEUE command has
been executed.
|
|
Pausing
|
Queue manager is processing
a STOP/QUEUE command.
|
|
Remote
|
Queue is assigned to a physical
device that is not connected to the local system.
|
|
Resuming
|
Queue manager is processing
a START/QUEUE command on a paused queue.
|
|
Server
|
Queue processing is directed
to a server symbiont.
|
|
Stalled
|
Symbiont processing temporarily
halted due to device-related problem.
|
|
Starting
|
Queue has been started,
but the symbiont process is not yet active.
|
|
Stopped
|
Queue is stopped and will
not process work until started.
|
|
Stop pending
|
Queue will be in the stopped
state when current jobs have finished executing.
|
|
Stopping
|
Queue is being stopped.
|
To display the forms or characteristics available on a system, use the SHOW QUEUE/FORM or SHOW QUEUE/CHARACTERISTICS command.
You can further customize the type of queue information you want to monitor by writing a command procedure that uses the F$GETQUI lexical function. F$GETQUI invokes the $GETQUI system service to return information stored in the queue database.
You can use the F$GETQUI lexical function to obtain information about the following types of objects:
For example, you could write a command procedure to display the total number of blocks of jobs in a pending state in all printer queues. You must have read access to the job or SYSPRV or OPER privilege to obtain job and file information.
For more information about the system service invoked by the F$GETQUI lexical function, refer to the description of the $GETQUI system service in the HP OpenVMS System Services Reference Manual .
1. The following example displays summary information for all printer and terminal queues:
$SHOW QUEUE/SUMMARY/DEVICE=(PRINTER,TERMINAL)
Printer queue HERA_LPA0, busy, on HERA::LPA0, mounted form DEFAULT
<Printer queue on node HERA for a line printer>
Job summary: 1 executing
Printer queue HERA_LPB0, busy, on HERA::LPB0, mounted form DEFAULT
<Printer queue on node HERA for a line printer>
Job summary: 1 executing
Generic printer queue CLUSTER_PRINT
<Generic printer queue for LPA0: and LPB0:>
Job summary: 1 holding
Terminal queue LQ_PRINT, stopped, on HERA::TXA7:,
<Letter quality printer in Bob's office>
mounted form PORTRAIT_INDENTED (stock=DEFAULT)
Job summary: 2 pending (445 blocks), 1 holding2. The following example displays the full status and options
of all executing jobs:$ SHOW QUEUE/FULL/ALL/BY_JOB_STATUS=EXECUTING
Batch queue HERA_BATCH, available, on HERA::
/AUTOSTART_ON=(HERA::) /BASE_PRIORITY=3 /JOB_LIMIT=25 /OWNER=[SYSTEM]
/PROTECTION=(S:M,O:D,G:R,W:R)
Entry Jobname Username Status
----- ------- -------- ------
700 VUE SMITH Executing
Submitted 25-FEB-2000 14:46 /KEEP /NOLOG /NOPRINT /PRIORITY=100
File: _$333$DISK1:[SMITH.COM]VUE.COM;19 (executing)
Batch queue ZZ_BATCH, available, on ZZ::
/AUTOSTART_ON=(ZZ::) /BASE_PRIORITY=3 /JOB_LIMIT=25 /OWNER=[SYSTEM]
/PROTECTION=(S:M,O:D,G:R,W:R)
Entry Jobname Username Status
----- ------- -------- ------
874 PIPE FITZGERALD Executing
Submitted 26-FEB-2000 11:25 /KEEP /NOTIFY /NOPRINT /PRIORITY=100
/RESTART=CLUSTER_BATCH /RETAIN=UNTIL=0 01:00"
File: _$333$DISK1:[FITZGERALD]PIPE.COM;2 (executing)
Server queue NM$QUE01, available, on HERA::, mounted form DEFAULT
/BASE_PRIORITY=4 /DEFAULT=(FEED,FORM=DEFAULT) /OWNER=[DOC,SMITH]
/PROCESSOR=NM$DAEMON /PROTECTION=(S:M,O:D,G:R,W:R) /RETAIN=ERROR
Entry Jobname Username Status
----- ------- -------- ------
236 NM ROSENBERG Processing
Submitted 23-FEB-2000 08:42 /FORM=DEFAULT /PRIORITY=100
File: _$5$DISK3:[FOLK$.NM]NM$J1991072308340647.WRK;1
Modifying a Queue
You can use the INITIALIZE/QUEUE, START/QUEUE, and SET QUEUE
commands to change
queue options; as you change queue options, information about the
queue in the queue database is updated. You can use the INITIALIZE
and START commands only on stopped queues.
The SET QUEUE command lets you change many queue options without having to stop the queue, initialize it, and restart it. For example, the following command modifies the running batch queue, SYS$BATCH:
The command in this example changes the job limit for the queue and disables swapping for all jobs processed in SYS$BATCH. All other options of the queue remain the same. The changed options do not affect the execution of current jobs; however, all subsequent jobs are executed with the new options in effect.$SET QUEUE/JOB_LIMIT=4/DISABLE_SWAPPING SYS$BATCH
To change queue options that cannot be altered with SET QUEUE, use the following procedure:
Note that initializing an existing queue does not delete any current jobs in that queue. Any new queue settings established by the new INITIALIZE/QUEUE command affect all jobs waiting in the queue or subsequently entering the queue.
See Qualifiers for Specifying Queue Options for a list of the options that you can use for batch and output queues.
Pausing a Queue
The STOP/QUEUE command, when used without qualifiers, temporarily
suspends the execution of all current jobs in the queue and places
the queue in a paused state. Pausing
an output queue lets you enter print job positioning and alignment
commands to the print symbiont. (See
Pausing an Output Queue to Control Print Job Position and Alignment for more information about using STOP/QUEUE
to control print jobs.)
To resume the execution of a paused queue, enter START/QUEUE.
Closing
a Queue
When a queue is not available for an extended period of time
(for example, when a printer needs servicing), you can prevent new
jobs from entering the queue by specifying the /CLOSE qualifier
with SET QUEUE, INITIALIZE/QUEUE, or START/QUEUE. The /CLOSE qualifier
prevents users from entering jobs in the queue
with PRINT or SUBMIT commands. When a user attempts to print or
submit a job to a closed queue, the job is rejected, and the user
is notified that the queue is closed. For example:
Jobs currently in the queue are not affected.$PRINT/QUE=$PRINTER_1 REPORT.TXT;%PRINT-F-CREJOB, error creating job -JBC-E-QUE_CLOSED, queue closed, jobs not accepted
When the queue is available again, use the /OPEN qualifier to open the queue for incoming jobs.
Stopping a Queue
To stop a queue, enter one of the following commands:
For autostart queues, these commands deactivate a queue for autostart as explained in Preventing Autostart Queues from Starting. To restart a stopped nonautostart queue or to reactivate a deactivated autostart queue, enter START/QUEUE.
Preventing Autostart Queues from Starting
The STOP/QUEUE/NEXT
or STOP/QUEUE/RESET command stops an autostart queue and marks it inactive
for autostart until you enter START/QUEUE. This feature prevents
an autostart output queue from accidentally restarting when a printer
is being serviced.
Disabling Autostart on a Node
The DISABLE AUTOSTART/QUEUES command notifies the queue manager
to perform the following tasks on the affected node:
By default, DISABLE AUTOSTART/QUEUES affects the node from which it is entered. Specify the /ON_NODE qualifier to disable autostart on a different node.
Use DISABLE AUTOSTART/QUEUES prior to shutting down a node. For more information, see Stopping Queues Before Shutting Down a System.
Stopping All Queues on a Node
To stop all queues on a node without stopping the queue manager,
enter STOP/QUEUES/ON_NODE. By default, this command affects the
node on which the command is entered. To stop queues on a different
node, specify the name of the node on which queues are to be stopped
as follows:STOP/QUEUES/ON_NODE=node
When you enter STOP/QUEUES/ON_NODE, nonautostart queues and autostart queues without a failover list are stopped. Autostart queues created or started with a failover list fail over to the next available node in that list that has autostart enabled. In all cases, currently executing jobs are aborted.
However, you can allow jobs executing on autostart queues to complete by entering the DISABLE AUTOSTART/QUEUES command and waiting for jobs to complete before entering the STOP/QUEUES/ON_NODE command. For more information, see Stopping Queues Before Shutting Down a System.
Stopping Queues Before Shutting Down a System
The following commands are included in the shutdown command
procedure SYS$SYSTEM:SHUTDOWN.COM and are automatically executed
when you shut down a node using SHUTDOWN.COM:
Allowing Jobs to Complete Before Stopping Autostart
Queues
STOP/QUEUES/ON_NODE aborts jobs and stops all queues on a node; DISABLE AUTOSTART allows jobs on autostart queues to finish processing before failing over or stopping autostart queues. If your configuration uses autostart queues, you might want to allow jobs on those queues to complete before stopping your queues.
In SHUTDOWN.COM, STOP/QUEUES/ON_NODE is executed shortly before the node is shut down. When using SHUTDOWN.COM, you can ensure that jobs on autostart queues have time to complete before the queues are stopped by specifying the time interval between DISABLE AUTOSTART/QUEUES and the shutdown.
Use one of the following methods:
Determine an appropriate number of minutes for your configuration, based on the number and type of jobs in the autostart queues.
If you shut down a node without using SHUTDOWN.COM, you might want to enter DISABLE AUTOSTART/QUEUES and wait a few minutes to allow jobs on autostart queues to finish processing before you enter STOP/QUEUES/ON_NODE.
Assigning a Logical Queue
When a problem occurs with a print device, you can reroute
the queue associated with that device to another queue associated
with a functioning device. You do this by creating a logical queue.
Use the following procedure to create a logical queue that redirects
its jobs to another queue:
How to Deassign a Logical Queue
To deassign the logical queue, enter a command in the following format:DEASSIGN/QUEUE logical-queue-name[:]
Moving All Jobs from One Queue to Another
Before you delete a queue, you might want to requeue all jobs
in the queue to another queue. To do so, enter a command in the
following format:ASSIGN/MERGE target-queue source-queue
where target-queue is the queue to which you are moving the jobs; source-queue is the queue to be deleted.
The ASSIGN/MERGE command moves all jobs currently in the source queue. If new jobs are entered into the source queue before it is deleted, those new jobs remain in the source queue, and are not transferred to the target queue. You might want to close the queue to prevent new jobs from being entered in the queue, as explained in Closing a Queue, before entering ASSIGN/MERGE.
For ongoing redirection of jobs, use the ASSIGN/QUEUE command as explained in Assigning a Logical Queue.
Deleting a Queue
Perform the following steps to delete a queue:
Managing Jobs in Queues
Some routine tasks
for controlling the flow of batch and print jobs and for maintaining
efficient job processing performance include the following actions:
| Task | Reference |
|---|---|
|
Monitoring
jobs
|
Monitoring Jobs
|
|
Modifying job
processing options
|
Modifying Job Processing Options
|
|
Holding and
releasing a job
|
Holding and Releasing a Job
|
|
Requeuing an
executing job
|
Requeuing an Executing Job
|
|
Requeuing a
pending job
|
Requeuing a Pending Job
|
|
Deleting a
job
|
Deleting a Job
|
|
Pausing an output queue
to control print job position and alignment
|
Pausing an Output Queue to Control Print Job Position and Alignment
|
Monitoring Jobs
Use the SHOW ENTRY command
to monitor the status of batch and print jobs. (For information
about job status, see
Job Statuses Returned by SHOW ENTRY.)
Use the following format to specify the SHOW ENTRY command:SHOW ENTRY [entry-number[,...]], [job-name[,...]]
If you do not specify an entry number or job name, the system displays all jobs owned by you or by the user specified with the /USER_NAME qualifier. If you specify a job name, the system displays all jobs owned by you or by the user specified with /USER_NAME that match the specified character string. You can also display a group of jobs by entering a list of entry numbers or job names, or both, on the command line.
Specify qualifiers with the SHOW ENTRY command to specify the type of job information you want to display. For more information, refer to the HP OpenVMS DCL Dictionary.
Job Statuses Returned by SHOW ENTRY describes the job statuses returned by the SHOW ENTRY command.
| Status | Description |
|---|---|
|
Aborting
|
Executing job is halting
prior to normal completion and will not continue processing.
|
|
Executing
|
Job is executing from a
batch queue.
|
|
Holding
|
Job is being held in the
queue indefinitely. For more information, see
Holding and Releasing a Job.
|
|
Pending
|
Job is waiting its turn
to execute. For more information, see
Making Pending Jobs Eligible for Scheduling.
|
|
Printing
|
Job is executing from a
printer or terminal queue.
|
|
Processing
|
Job is executing from a
server queue.
|
|
Retained
|
Job remains in the queue
upon completion. For more information, see
Changing Job Retention.
|
|
Stalled or
Suspended
|
Job stopped during processing
but should continue when the cause is resolved.
|
|
Starting
|
Job is beginning to be processed.
|
|
Timed_release
|
Job is being held in the queue for execution
at a specified time.
|
1. The following command displays jobs owned by user GARDNER:
$ SHOW ENTRY/USER_NAME=GARDNER
Entry Jobname Username Blocks Status
----- ------- -------- ------ ------
4 TEST GARDNER Holding
On available batch queue OPAL_BATCH
611 SET GARDNER 140 Pending
On stopped printer queue LQPRINT2. In the following example, the /FULL qualifier displays
job status information, the time the job was submitted, the file
specification and the job processing options:$ SHOW ENTRY/FULL 4,611
Entry Jobname Username Blocks Status
----- ------- -------- ------ ------
4 TEST GARDNER Holding
On available batch queue OPAL_BATCH
Submitted 15-JAN-2000 16:12 /LOG=_$5$DUA1:[GARDNER]TEST.LOG;
/PRIORITY=100
File: _$5$DUA1:[GARDNER]TEST.COM;8
611 SET GARDNER 140 Pending
On stopped printer queue LQPRINT
Submitted 21-JAN-2000 16:23 /FORM=DEFAULT /PRIORITY=200
File: _$5$DUA1:[GARDNER]SET.TXT;5
File: _$5$DUA1:[GARDNER]WAIT.TXT;1
Modifying Job Processing Options
You can modify many job processing options by specifying qualifiers
with a command in the following format:SET ENTRY/qualifier[,...] entry-number
SET ENTRY Qualifiers for Changing Jobs lists some qualifiers that are frequently used to change jobs. For a list of all the job processing options you can change with the SET ENTRY command, refer to the HP OpenVMS DCL Dictionary.
| Qualifier | Description | For More Information |
|---|---|---|
|
/[NO]AFTER=time
|
Controls whether
a job is held until after a specified time.
|
Holding and Releasing a Job
|
|
/CHARACTERISTICS
=(characteristic[,...]) |
Specifies the
name or number of one or more characteristics associated with a
batch or print job.
|
Specifying Queue Characteristics
|
|
/FORM=form
|
Specifies the
name or number of the form to be associated with a print job.
|
Using and Creating Forms
|
|
/[NO]HOLD
|
Controls whether
a job is available for immediate processing or held until it is released
for processing.
|
Holding and Releasing a Job
|
|
/PRIORITY=n
|
Specifies the
scheduling priority of the job.
|
Changing the Scheduling Priority of a Job
|
|
/RELEASE
|
Releases a
previously held job.
|
Holding and Releasing a Job
|
|
/REQUEUE=queue-name[:]
|
Requests that
the job be moved from the original queue to the specified queue;
you can also do this by using the STOP/QUEUE/REQUEUE/ENTRY command.
|
Requeuing a Pending Job
|
|
/RESTART
|
Specifies whether a batch
or print job is restarted after a system failure or a STOP/QUEUE/REQUEUE
command. Print jobs are restartable by default. Batch jobs are restartable
only if submitted or modified with the /RESTART qualifier.
|
|
Holding and Releasing a Job
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-2000:17:30 $ SET ENTRY/NOAFTER
$ SET ENTRY 1121/AFTER=TODAY $ SET ENTRY/NOAFTER
$ SET ENTRY 1234/HOLD $ SET ENTRY 1234/RELEASE
Requeuing an Executing Job
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. |
The first command stops the executing print job on BETA_LPB0 and requeues it to BETA_LPA0. The second command stops queue BETA_LPB0.$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.
Requeuing a Pending Job
To requeue a job that is pending in a queue to a different
queue, enter SET ENTRY/REQUEUE. For example:
This command moves job 196 to the queue LN03$PRINT.$SET ENTRY/REQUEUE=LN03$PRINT 196
Deleting a Job
Follow
this procedure to delete either a pending or an executing batch
job:
$SHOW QUEUE/BATCH/ALL_JOBS/BY_JOB_STATUS=EXECUTING
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=EXECUTINGBatch 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 to Control Print
Job Position and Alignment
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. |
Specifying the Position of Print 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
Aligning Print Forms 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
|
|