OUTFENCE

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

Back to Main Index


OUTFENCE


     Defines the minimum priority an output spoolfile needs in
     order to be printed.

SYNTAX


     OUTFENCE outputpriority [;LDEV=ldev]
                             [;DEV={ldev    }]
                                   {devclass}
                                   {devname }


PARAMETERS


outputpriority      A number between 1 and 14, inclusive.  A larger
                    number is more limiting.

ldev                The logical device number of an output device.

devclass            The name of a class of spooled device(s) that are to
                    have their outfence value changed.  DEVCLASS must
                    begin with a letter and consist of eight of fewer
                    alphanumeric characters.  Device classes are treated
                    as a group of related devices.  When a device class
                    name is used, the command is applied to all devices
                    that belong to that device class.

devname             The name of the spooled device.  The devname must
                    begin with a letter and consist of eight or fewer
                    alphanumeric characters.  Users should note that it
                    is not possible to have a device class name and a
                    device name which are the same.  If the user enters
                    an alphanumeric character string, the command will
                    search the device class list first, and then the
                    device name list.




OPERATION


     This command controls the processing of all output
     spoolfiles by establishing a numerical limit, or fence,
     that, along with each spoolfile's outputpriority, determines
     whether a file will be printed or not.  Individual
     spoolfiles which are READY will be printed only if their
     outputpriority is higher than the current OUTFENCE.  To
     prevent any spoolfiles from being printed, set the OUTFENCE
     to 14.  To prevent a subset of spoolfiles from printing, set the
     OUTFENCE higher than the outputpriority of any spoolfile in the
     group.

     You may wish to alter the printing priority of a single file
     without affecting the entire system.  If that is the case,
     change the outputpriority of the specific spoolfile with the
     ALTSPOOLFILE command.  (Refer to the discussion of
     ALTSPOOLFILE or SPOOLF.)

     The ;DEV= parameter allows the user to specify device
     names (DEVNAME) in accordance with device naming
     conventions.

     ;DEV= also allows users to set the outfence for all
     devices in a device class (DEVCLASS).  At any given time,
     the outfence for a device is the last outfence assigned to
     it as the result of its membership in the set of devices
     selected by the OUTFENCE command parameters.
     If neither DEV nor LDEV is specified, the OUTFENCE command
     sets the outfence for every device on the system.

     This command may be issued from a session, job, program, or in
     BREAK.  Pressing [Break] has no effect on this command.  It is
     executable only from the console.  Unless distributed to users
     with the ALLOW command.


EXAMPLE(S)


     To prevent printing all output spoolfiles except those waiting
     to be printed by ldev 6, usually configured as the system line
     printer, set the global OUTFENCE to 14 and the OUTFENCE of
     ldev 6 to 7, as shown below

     OUTFENCE 14
     OUTFENCE 7;LDEV=6

     To display the new global outfence and the outfence of logical
     device 6, execute the SHOWOUT command, as in the example below or a
     LISTSPF command.  Note that the summary statistics at the bottom of
     the listing will immediately reflect the new OUTFENCE, but
     individual entries for each output spoolfile may not.  Once any
     currently ACTIVE spoolfile is finished, however, no files directed
     towards a device other than ldev 6 will become ACTIVE.

     SHOWOUT

     DEV/CL   DFID    JOBNUM  FNAME    STATE FRM SPACE RANK PRI #C
     6        #O999   #J19    $STDLIST OPENED       512       8  1
     6        #O1030  #S77    EDLIST   OPENED       512       8  1
     SLOWLP   #O1029  #S71    OUT      READY        232   D   7  1
     20       #O1001  #S60    $STDLIST OPENED
     11       #O1022  #S33    GALLIST  READY        768   D   7  1

     5 FILES
     0 ACTIVE
     2 READY; INCLUDING 2 SPOOFLES, 2 DEFERRED
     3 OPENED; INCLUDING 2 SPOOFLES
     0 LOCKED; INCLUDING 0 SPOOFLES
     4 SPOOFLES  2024 SECTORS
     OUTFENCE = 14
     OUTFENCE = 7    FOR LDEV 6

     To reset the OUTFENCE for all output spoolfiles, enter

     OUTFENCE 6

     To show how a device takes on the last assigned OUTFENCE
     (the result of a device's membership to a set of devices),
     the following example is given.  In the following, LDEV 6
     is a member of two device classes, EPOC and PP80.

          OUTFENCE 8;DEV=6

          OUTFENCE 4;DEV=EPOC

          OUTFENCE 5;DEV=PP80

     If the previous commands were executed in the order given,
     and the LDEV 6 is a member of class PP80, the outfence for
     LDEV 6 would be 5.  Since 5 is the last outfence assigned
     to a device that belongs to the same device class as LDEV
     6, it takes on the last outfence assignment, which is 5.

ADDITIONAL INFORMATION


Commands:   ALTSPOOLFILE, SPOOLF

Manuals :   Performing System Operation Tasks (32650-90137)

Back to Main Index