ALTSPOOLFILE

Generated from C.65.00 /SYSADMIN/PUB/MYCICAT last modified on Sun Aug 29 15:08:37 2004

Back to Main Index


ALTSPOOLFILE


     Alters the characteristics of an output spoolfile. (CM)

SYNTAX


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


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      Specifies the output priority of the designated
                    device file ( 0 = lowest; 14 = highest).

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

ldev2 or devclass   Specifies 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


     The operator uses ALTSPOOLFILE 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 will be made, however, until the
     output device is returned online.

     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 OP or SM
     capability, and it may be distributed to users with the ALLOW
     or ASSOCIATE commands.

NOTE


If you are altering ;PRI or ;COPIES in 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 will stop immediately.  In
     both of these cases, the entire file will be 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.


EXAMPLE(S)


     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

ADDITIONAL INFORMATION


Commands:  OUTFENCE

Manuals :  Performing System Operation Tasks (32650-90137)

Back to Main Index