TAA Tools
DSPSAVSUM       DISPLAY SAVE SUMMARY                   TAASAWM

The Display Save Summary  command displays or lists a  summary from one
or  more libraries  of where  objects are  saved to.   The  objects are
separated  into  several  categories:  1) Not  saved  since  created or
changed 2)  Saved  to  a  save file  or  3)  Saved to  a  tape  device.
Separate summaries  appear for each save  file used and  each volume ID
(first volume only) used.  A detail listing of objects is optional.

You  must have *ALLOBJ  special authority to  use a LIB  value of *ALL,
*ALLUSR, *ALLUSR2, *ALLNONQ, or *IBM.

A typical command would be:

            DSPSAVSUM   LIB(ABC DEF GHI*)

The individual  object information  for the  named  libraries would  be
accessed and summarized.

DSPSAVSUM escape messages you can monitor for
---------------------------------------------

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

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

   LIB           The list  of libraries  to be  processed.   Up to  300
                 libraries  may  be entered  (including  generic names)
                 or  the  special  values  *LIBL,  *USRLIBL,   *CURLIB,
                 *ALLUSR, *ALLUSR2, *ALLNONQ, *IBM, or ALL.

                 For *LIBL and  *USRLIBL, if a current  library exists,
                 it  will be  written as  a  record before  the records
                 for  the user  portion of  the library  list.   If the
                 current library is  also part of  the user portion  of
                 the  library list,  it will  only appear  once  (it is
                 removed from the user portion list).

                 *ALLUSR  omits certain  #  libraries such  as #RPGLIB.
                 *ALLUSR  also  omits  all  Q  libraries  with  certain
                 exceptions such  as QGPL.  See  the help text  for the
                 SAVLIB  command for  a complete  list.   Note  that if
                 you have your own library  which begins with Q, it  is
                 omitted.

                 *IBM  causes all  libraries to  be  included based  on
                 the definition for DSPOBJD LIB(*IBM).

                 *ALLUSR2 is  similar to *ALLUSR.  It  omits the same #
                 libraries,  but also omits  any library beginning with
                 Q.   Note  that if  you have  your  own library  which
                 begins with Q, it is omitted.

                 *ALLNONQ means  any library  that does not  begin with
                 the  letter  Q.    If  *ALLNONQ  is  used, the  ASPDEV
                 parameter must use the default.

   ASPDEV        Specifies the  auxiliary  storage  pool  (ASP)  device
                 name  where storage  for  the  library containing  the
                 object  is allocated.   If the  library resides  in an
                 ASP that  is not  part of  the thread's  library  name
                 space,  this parameter  must  be specified  to  ensure
                 the correct library is searched.

                 The  parameter  can be  specified  as  a  list of  two
                 values   (elements)  or  as  a   single  value.    The
                 possible single values are:

                 * = The ASPs  that are currently part of  the thread's
                 library  name space  will  be searched  to locate  the
                 library.   This includes  the system ASP  (ASP 1), all
                 defined basic  user  ASPs  (ASPs 2-32),  and,  if  the
                 thread has  an ASP  group, the  primary and  secondary
                 ASPs in the thread's ASP group.

                 *ALLAVL =  All available ASPs will  be searched.  This
                 includes the  system ASP  (ASP 1),  all defined  basic
                 user ASPs (ASPs  2-32), and all available  primary and
                 secondary  ASPs,  (ASPs   33-255)  with  a  status  of
                 'Available'.

                 *CURASPGRP  =  If the  thread  has an  ASP  group, the
                 primary and secondary ASPs  in the thread's ASP  group
                 will  be  searched.    The  system  ASP  (ASP  1)  and
                 defined  basic  user  ASPs  (ASPs  2-32)  will  not be
                 searched.   If no  ASP group  is  associated with  the
                 thread, an error will be issued.

                 *SYSBAS  = The  system  ASP (ASP  1)  and all  defined
                 basic  user  ASPs  (ASPs  2-32)  will  be searched  to
                 locate the  library.   No  primary or  secondary  ASPs
                 will  be  searched  even if  the  thread  has  an  ASP
                 group.

                 Element 1: Device

                 The  device name of  the primary  or secondary  ASP to
                 be  searched.  The primary  or secondary ASP must have
                 been activated  (by  varying on  the  ASP device)  and
                 have  a status of  'Available'.   The system  ASP (ASP
                 1)  and defined user  basic ASPs (ASPs  2-32) will not
                 be searched.

                 Element 2: Search type

                 *ASP  =  Specifies  that  only  the  single  auxiliary
                 storage pool  (ASP) device  named in  element 1 is  to
                 be searched.

                 *ASPGRP  =  Specifies that  the  entire  group of  the
                 primary auxiliary storage pool  (ASP) device named  in
                 element 1 is to be searched.

   ASPNBR        The  ASP number  for  the  libraries  that are  to  be
                 converted.  The default is *ALL.

                 A  number  in the  range  of 1-99  may  be entered  to
                 subset  the libraries that  are output by  the LIB and
                 ASPDEV parameters.

   OMITLIB       A list  of  up to  300  libraries or  generic  library
                 names that  should be omitted.  *NONE  is the default.

                 An omit list may not be entered for LIB(*CURLIB).

                 If  ESCAPE(*YES) is specified,  any library entered is
                 checked for existence  unless a  non-default value  is
                 used for the ASPDEV parameter.

                 No check occurs  to see if an omit  library would have
                 been   selected.    For  example,   if  LIB(*LIBL)  is
                 entered with OMITLIB(ABC)  and library ABC  is not  on
                 the library list, no error occurs.

   LSTTYPE       The type of listing to be output.

                 *NOTSAV is the  default meaning one line  would appear
                 for each  object that has not been  saved since it was
                 created  or changed.   Only  summary information would
                 appear for the other categories.

                 *NONE may  be specified  to cause summary  information
                 only for each category.

                 *ALL may be  specified to to list each  object in each
                 category as well as summary information.

   OUTPUT        How  to  output the  results.    * is  the  default to
                 display the  spooled file  if the  command is  entered
                 interactively.  The  spooled file is deleted  after it
                 is displayed.

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


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

None.

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

The following TAA Tools must be on your system:

     CHKALLOBJ       Check *ALL object
     CVTLIBOBJD      Convert library object description
     EXTLST2         Extract list 2
     RTVSYSVAL2      Retrieve system value 3
     SNDCOMPMSG      Send completion message
     SNDESCINF       Send escape information
     SNDESCMSG       Send escape message
     SNDJLGMSG       Send job log message
     SNDSTSMSG       Send status message
     SORTDBF         Sort data base file

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

None, the tool is ready to use.

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

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

   DSPSAVSUM     *CMD                   TAASAWM       QATTCMD
   TAASAWMC      *PGM       CLP         TAASAWMC      QATTCL
   TAASAWMR      *PGM       RPG         TAASAWMR      QATTRPG
					

Added to TAA Productivity tools October 15, 2008


Home Page Up to Top