HP 3000 Manuals

ALTSPOOLFILE [ MPE/iX Commands Reference Manual Volume I ] MPE/iX 5.0 Documentation


MPE/iX Commands Reference Manual Volume I

ALTSPOOLFILE 

Alters the characteristics of an output spoolfile.

Syntax 

                     {;PRI=outputpriority}
                     {;COPIES=numcopies  }
ALTSPOOLFILE {#Onnn} {;DEV={ldev2   }    } [;...]
             {ldev1} {     {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 (32650-90166)


MPE/iX 5.0 Documentation