TAA Tools
CHGALLSPLF      CHANGE ALL SPOOLED FILES               TAASPMJ

The Change  All Spooled Files  command allows all  spooled files in  an
output  queue to be  changed for such  values as OUTQ,  FORMTYPE, SAVE,
and  ALIGN.   This provides  a command  interface instead of  using the
'2' option on WRKOUTQ.  A Hold/Release option also exists.

You must have *JOBCTL special authority to use CHGALLSPLF.

The command is intended for printer spooled files.

A typical command would be:

             CHGALLSPLF    OUTQ(xxx) SAVE(*YES)

All spooled files in the  output queue would be changed  to SAVE(*YES).
No error occurs if a spooled file is already SAVE(*YES).

The default  for the attribute  parameters is *SAME.   At least  one of
the parameters must be other than *SAME.

CHGALLSPLF escape messages you can monitor for
----------------------------------------------

      TAA9892    All values are specified as *SAME.

Escape messages from system commands will be re-sent.

Command parameters                                    *CMD
------------------

   OUTQ          The   qualified  name  of  the   output  queue  to  be
                 processed.   The  library  value  defaults  to  *LIBL.
                 *CURLIB may also be used.

   TOOUTQ        The output  queue to move the  spooled files to.   The
                 default  is *SAME.   A different  output queue  may be
                 named.   If  a  library is  not  specified,  *LIBL  is
                 assumed.  *CURLIB may be specified.

   CURSTS        The current status  of spooled files to  be considered
                 for changes.

                 *ALL  is  the default  meaning  all status  conditions
                 are considered.

                 *RDY  may be  specified to  change only  those spooled
                 files in a RDY status.

                 *HLD may  be specified  to change  only those  spooled
                 files in a HLD status.

   STATUS        Whether  to Hold or  Release the  spooled files.   The
                 default is *SAME.

                 If  *HOLD  is specified,  the  existing  spooled files
                 are held  and then  changed by  the other  parameters.
                 If one  or more of the  spooled files is  already held
                 or  cannot be put in  a held status,  no error occurs.
                 The completion message  contains the  number of  files
                 held.

                 If *RELEASE is  specified, the existing  spooled files
                 are changed  and then released.  If  the spooled files
                 are  moved  to a  new output  queue, only  the spooled
                 files  that  were  in   the  From  output  queue   are
                 released.   If  one or  more  of the  files cannot  be
                 released,  no error  occurs.   The  completion message
                 contains the number of files released.

   FORMTYPE      The form type to  be used.  The  default is *SAME.   A
                 name or *STD may be entered.

   COPIES        The number  of copies to be  printed.  The  default is
                 *SAME.  A number between 1 and 255 may be entered.

   FILESEP       The  number of  file separators  to  be printed.   The
                 default is *SAME.   A number  between 0 and  9 may  be
                 entered.

   SCHEDULE      The  schedule   for  when   the  file  should   become
                 available.    The   default  is  *SAME.    The  values
                 *JOBEND, *FILEEND, or *IMMED may be entered.

   SAVE          Whether   to  save  the  file  after  printing.    The
                 default is  *SAME.   The  values *YES  or  *NO may  be
                 entered.

   OUTPTY        The  output  priority  of   the  spooled  file.    The
                 default is *SAME.  Values 0-9 may be entered.

   USRDTA        The  user data  attribute  of the  spooled file.   The
                 default is *SAME.

   ALIGN         Whether  to   cause   an  alignment   message   before
                 printing  the  file.    The default  is  *SAME.    The
                 values *YES or *NO may be entered.

   EXPDATE       The  expiration  date of  the  file.   The  default is
                 *SAME.  A date may be  entered in job format to  cause
                 the spooled file  to be deleted  by the system  at the
                 end of the date specified.

   PRTQLTY       The  type of print  quality to  be used.   The default
                 is  *SAME.  The  values *STD, *DEVD,  *DRAFT, *NLQ, or
                 *FASTDRAFT may be entered.

   FORMFEED      The type of form feeding  to be used.  The  default is
                 *SAME.   The values  *DEVD, *CONT, *CUT,  *AUTOCUT, or
                 *CONT2 may be entered.

   DRAWER        The  drawer to be  used.   The default is  *SAME.  The
                 values *E1 or *FORMDF may be entered.

   FIDELITY      The type of  print fidelity to be  used.  The  default
                 is *SAME.   The  values *ABSOLUTE  or *CONTENT  may be
                 entered.

   DUPLEX        Whether  to  print  on both  sides.    The default  is
                 *SAME.   The values  *YES,  *NO, *TUMBLE,  or  *FORMDF
                 may be entered.

   MULTIUP       Whether multiple  pages  should be  printed per  side.
                 The  default  is  *SAME.     The  values  1-4  may  be
                 entered.

Restrictions
------------

*JOBCTL special authority is required.

Prerequisites
-------------

The following TAA Tools must be on your system:

     CHKJOBCTL       Check *JOBCTL special authority
     CHKOBJ3         Check object 3
     CVTOUTQ         Convert output queue
     EDTVAR          Edit variable
     SNDCOMPMSG      Send completion message
     SNDESCMSG       Send escape message

Implementation
--------------

None, the tool is ready to use.

Objects used by the tool
------------------------

   Object        Type    Attribute      Src member    Src file
   ------        ----    ---------      ----------    ----------

   CHGALLSPLF    *CMD                   TAASPMJ       QATTCMD
   TAASPMJC      *PGM       CLP         TAASPMJC      QATTCL
					

Added to TAA Productivity tools March 1, 1999


Home Page Up to Top