The Change ASP (Auxiliary  Storage Pool) Attributes 2 command  allows a
user  with  the  special authorities  *ALLOBJ  and  *SERVICE to  change
either an ASP threshold and/or the Compression Recovery Policy.

DST/SST  are  the traditional  methods to  change  the threshold.   The
system command  CHGASPA  is  the  traditional method  of  changing  the
Compression Recovery Policy.

Note  that this  tool requires  the use  of an  API that  was  added in
V4R5.  You must be at least on that release to use CHGASPA2.

A prompt override program exists so the typical command would be:

             CHGASPA2     ASP(nn)

and  press F4.   The current values  would be prompted for  and the new
value may  be keyed  over.   If the  system ASP  is  prompted for,  the
CPRRCVPCY value  appears as *SAME and  cannot be changed.   The command
may also be entered as:

             CHGASPA2     ASP(nn)  THDPCT(xx) CPRRCVPCY(*zzz)

The  API QSYASSDMO  is used  to change the  threshold percentage.   The
system ASP (ASP  = 1)  cannot be  changed for  the CPRRCVPCY  parameter
(it must be *SAME).

CHGASPA2 escape messages you can monitor for
--------------------------------------------

      TAA9891    The ASP number does not exist.

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

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

   ASP           The number  of  the ASP  to be  changed.   Basic  ASPs
                 must be  a value between 1  and 32.  If  a device name
                 is  requested, this  parameter must be  defaulted (a 0
                 value is passed).

                 Primary  or secondary  ASPs  are known  externally  by
                 their  name although a  number between  33 and  255 is
                 assigned  by the system.  If you  know the name of the
                 primary or secondary ASP,  you should use the  default
                 for this  parameter and enter  the name in  the ASPDEV
                 parameter.

                 If  the  number of  the  primary or  secondary  ASP is
                 known, but  the  ASP  device  name  is  not  known,  a
                 number between 33  and 255 may be entered  to retrieve
                 the  information  about  the  ASP.   This  allows  the
                 device  name of  the ASP  to be  accessed if  only the
                 number is known.

   ASPDEV        The ASP  device name to  retrieve.   If an ASP  number
                 is requested, this parameter must be blank.

   THDPCT        The  threshold percent  to be  assigned.   The default
                 is *SAME.  It must be a value between 1 and 99.

   CPRRCVPCY     The  Compression Recovery Policy to  be assigned.  The
                 default is *SAME.

                 If the system  ASP (ASP = 1)  is specified, the  value
                 must be *SAME.

                 For  a  more  complete   understanding  of  the  other
                 values, see the CHGASPA system command.

                 *OVERFLOW  may  be  specified  to  cause any  overflow
                 storage to be added to the system ASP immediately.

                 *RETRY may  be be  specified  to cause  an SRC  to  be
                 posted  and  the  system waits  for  space  to  become
                 available.     If   space  is   not  available   in  a
                 reasonable  time,  any  overflow storage  is  added to
                 the system ASP.

                 *WAIT may  be  be  specified to  cause  an SRC  to  be
                 posted  and the  system waits  indefinitely for  space
                 to become available.

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

Only  a user with the special authorities  *ALLOBJ and *SERVICE can use
the CHGASPA2 command.

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

The following TAA Tools must be on your system:

     EDTVAR          Edit variable
     RTVASPLST       Retrieve ASP list
     RTVASPSTS       Retrieve ASP status
     RTVSPCAUT       Retrieve special authority
     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
   ------        ----    ---------      ----------    ----------

   CHGASPA2      *CMD                   TAAASPC       QATTCMD
   TAAASPCC      *PGM       CLP         TAAASPCC      QATTCL
   TAAASPCC2     *PGM       CLP         TAAASPCC2     QATTCL

TAAASPCC2 is the prompt override program.