OUTFENCE



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)