The Display  Storage  Pool command  displays or  prints the  attributes
and  performance statistics of  a main storage  pool.  Either  a shared
pool  name (such as *BASE) or  a system pool ID  may be specified.  The
display may be refreshed and the performance statistics reset.

A typical command would be:

             DSPSTGPOOL    POOLTYPE(*SHARED) SHRPOOL(*BASE)

The attributes and performance information would be displayed.

DSPSTGPOOL escape messages you can monitor for
----------------------------------------------

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

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

   POOLTYPE      The type  of pool  to be  displayed.   *SHARED is  the
                 default  in  which  case  the SHRPOOL  parameter  must
                 identify a shared pool.

                 *POOLID  may  be  entered  in  which  case  the POOLID
                 parameter must be entered.

   SHRPOOL       The  name   of  the   the  shared   pool  to   display
                 information  for.   The  default is  *NONE.   A  value
                 must  be  entered if  POOLTYPE(*SHARED)  is specified.
                 The  valid  values  are  *MACHINE,  *BASE,  *INTERACT,
                 *SPOOL, or *SHRPOOL1 - *SHRPOOL60.

   POOLID        The pool ID  to display information for.   The default
                 is *NONE.   A number between 1 and  64 must be entered
                 if POOLTYPE(*POOLID) is specified.

                 The  pool ID to  be entered is the  system pool ID and
                 not the subsystem pool ID.

                 The  pool  ID numbers  that  exist  on  WRKSYSSTS  are
                 system  pool  IDs.    When  a  subsystem  is  created,
                 subsystem  pool IDs  are assigned (1,2,3...)  or given
                 shared pool names.   When a subsystem becomes  active,
                 the system  assigns a system  pool ID to  the numbered
                 pools.    Use   WRKSBS  to  see  how  the  system  has
                 translated the subsystem  pool ID to  the system  pool
                 ID.

   RESET         A   *YES/*NO   value  for   whether   to   reset   the
                 statistics.   This is the  same value that  appears on
                 WRKSYSSTS.     The  default  is   *NO  to  retain  the
                 existing statistics.

                 *YES may be specified to reset the statistics.

                 There is  one set of  statistics kept  by the  system.
                 Resetting the  statistics using RTVSTGPOOL  resets the
                 values used by WRKSYSSTS and vice versa.

   OUTPUT        How  to  output the  results.    * is  the  default to
                 display  the  results  if   the  command  is   entered
                 interactively.

                 If  the  command is  entered  in  batch or  *PRINT  is
                 specified, a spooled file is output.

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

None.

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

The following TAA Tools must be on your system:

     EDTVAR          Edit variable
     RTVSTGPOOL      Retrieve storage pool
     SNDCOMPMSG      Send completion message
     SNDESCINF       Send escape information
     SNDESCMSG       Send escape message

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

None, the tool is ready to use.

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

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

   DSPSTGPOOL    *CMD                   TAAJODS       QATTCMD
   TAAJODSC      *PGM       CLP         TAAJODSC      QATTCL
   TAAJODSR      *PGM       RPG         TAAJODSR      QATTRPG
   TAAJODSD      *FILE      DSPF        TAAJODSD      QATTDDS