HPlogo MPE/iX Commands Reference Manual: HP 3000 MPE/iX Computer Systems > Chapter 2 Command Definitions A-B

ALTSPOOLFILE

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

Alters the characteristics of an output spoolfile.

Syntax

ALTSPOOLFILE{ #Onnn  ldev1 } { ;PRI=outputpriority ;COPIES=numcopies ;DEV={ ldev2  devclass } ;DEFER } [ ;...]

Parameters

#Onnn

The output device file identification of a spoolfile.

ldev1

The logical device number of the device where an ACTIVE spoolfile currently resides.

outputpriority

The output priority of the designated device file (0 = lowest; 14 = highest).

numcopies

The number of copies to be produced from the designated device file. Range is 1 through 127; default is 1.

ldev2 or devclass

The logical device number or device class name of the spoolfile's destination device. If ACTIVE, the file is returned to the READY state. It may immediately become ACTIVE on ldev2 if all requirements are met.

DEFER

Immediately changes the output priority of an ACTIVE or READY spoolfile to 0. If ACTIVE, the file is returned to the READY state.

Operation Notes

The operator uses the ALTSPOOLFILE command to change the printing priority of a spoolfile, to increase or decrease the number of copies produced, and/or to change the destination device or class.

When altering an ACTIVE spoolfile, first take the output device offline. This gives you time to enter the command and determine that the ACTIVE spoolfile is the file being printed. When the ALTSPOOLFILE command has been sent to the spooler process, MPE/iX returns the colon prompt (:). No change to the spoolfile is made, however, until the output device is returned online.

NOTE: If you are altering the PRI or COPIES parameter for an ACTIVE spoolfile there is no need to take the output device offline. These two parameters can be altered while the device is online.

You may alter the outputpriority or the numcopies of an ACTIVE spoolfile without interrupting the printing process. If you alter the device or defer the ACTIVE spoolfile with the DEFER parameter, the printer stops immediately. In both cases, the entire file is printed when printing resumes. Deferring a spoolfile lowers its output priority to zero, the lowest priority possible. To print a deferred spoolfile, you must raise its priority above the current outfence using the ALTSPOOLFILE command.

If you intend to print a spoolfile on an HP 2680A Laser Page Printer, you may add an environment file to it before printing.

Use

This command may be issued from a session, job, program, or in BREAK. Pressing Break has no effect on this command. It is executable from the console by users with system supervisor (OP) or system manager (SM) capability. It may be distributed to other users with the ALLOW or ASSOCIATE command.

Examples

To defer the ACTIVE spoolfile (#O86) on LDEV 6 take device 6 offline, then enter:

  ALTSPOOLFILE #O86;DEFER

or

  ALTSPOOLFILE 6;DEFER

To change the priority of deferred spoolfile #O123 from 0 to 3 enter:

  ALTSPOOLFILE #O123;PRI=3

Related Information

Commands

OUTFENCE

Manuals

Native Mode Spooler Reference Manual

Feedback to webmaster