The Change Spooled  File Priority command  provides a simple  change of
the  output priority  for a spooled  file.   A prompt  override program
exists  so  the  user  can  see the  current  value  before  making the
change.  The intent  of the command is to  allow a user who should  not
have full CHGSPLFA  function to be able to  change the output priority.

The  user cannot  change the priority  to a  value lower  than the user
profile limit set by the PTYLMT parameter.

A typical command would be:

             CHGSPLFPTY  SPLF(xxx) OUTPTY(2)

The default for the JOB and SPLNBR parameter would be used.

The command can be used in conjunction with the WRKALLSPLF command.

CHGSPLFPTY escape messages you can monitor for
----------------------------------------------

None.  Escape messages from based on functions will be re-sent.

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

   FILE          The spooled file to display the attributes for.

   JOB           The qualified job  name of  the job  with the  spooled
                 file.  The default is * meaning the current job.

   SPLNBR        The file  number of the  spooled file.   This defaults
                 to  *ONLY.     *LAST  or  a  specific  number  may  be
                 specified.

   OUTPTY        The  output  priority  for  the  spooled  file.    The
                 default is *SAME.   If a value is entered,  it must be
                 between 1 and 9.

                 The   number   entered  cannot   be   less  than   the
                 scheduling  priority  assigned  to  the  user  profile
                 (PTYLMT parameter).

                 The special  value *JOB  may be entered  to reset  the
                 priority to  the current  output priority of  the job.
                 The  job's output  priority can  be changed  by CHGJOB
                 at any  time including  when the  spooled  file is  on
                 the output queue.

                 The  special value  *NEXT may  be  entered to  promote
                 the  spooled  file to  the  top of  the  output queue.
                 You must  have either  *JOBCTL or  *SPLCTL to  specify
                 *NEXT.   If using  the command  directly, *JOBCTL  may
                 be  adopted, but  *SPLCTL  must exist  in  the current
                 users  profile.   If using CHGSPLFPTY  as a WRKALLSPLF
                 option, either *JOBCTL  or *SPLCTL  must exist in  the
                 users profile.

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

None.

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

The following TAA Tools must be on your system:

     CHKJOBCTL       Check job control
     CHKSPLF         Check spooled file
     CVTSPLNBR       Convert spooled file number
     EDTVAR          Edit variable
     RTVSPCAUT       Retrieve special authority
     RTVSPLFA        Retrieve spooled file attributes
     SNDCOMPMSG      Send completion message

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

None, the tool is ready to use.

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

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

   CHGSPLFPTY    *CMD                   TAASPMV       QATTCMD
   TAASPMVC      *PGM       CLP         TAASPMVC      QATTCL
   TAASPMVC2     *PGM       CLP         TAASPMVC2     QATTCL

The TAASPMVC2 program is used for the Prompt override.