TAA Tools
DSPLIBSIZ       DISPLAY LIBRARY SIZE                   TAALIDH

The Display  Library  Size command  displays or  lists a  summary of  a
library  with  size  and count  information.    One,  generic, or  many
libraries  may be requested to be  included.  The library object record
is included in the size and  count of objects.  An outfile may  also be
requested.   The  outfile  model file  in  TAATOOL is  TAALIDHP with  a
format name of LIBSIZR.

The  outfile  includes many  more fields  than  appear on  the listing.
This allows you to write a  simple query to include the fields you  are
interested in.

You must  have *ALLOBJ authority  to specify  a library value  of *ALL,
*ALLUSR, *ALLUSR2, *ALLNONQ, or *IBM.

For  libraries with a large  number of objects, the  conversion time to
access the  information can  be long.   You  may prefer  to submit  the
command to batch.

A typical command would be:

             DSPLIBSIZ  LIB(ABC* DEF)

One line per library  would be listed for all  libraries beginning with
ABC and the DEF library.

To create an outfile of the information, specify:

             DSPLIBSIZ  LIB(ABC* DEF) OUTPUT(*OUTFILE)
                          OUTLIB(QTEMP)

The same  summary information would  be written to the  LIBSIZP file in
QTEMP.  Additional fields in the output file would contain:

        -  the library create date
        -  the library save date
        -  the library restore date
        -  the most current create date of an object in the library
        -  the most current change date of an object in the library
        -  the most current use date of an object in the library
        -  the number of data members by type
        -  the number of logical files and size
        -  the number of physical data files and size
        -  the number of physical source files and size

and many more

Authorization
-------------

If  a user is not authorized to an object  the object may or may not be
counted (depending on the  object type), but not the  size information.

DSPLIBSIZ escape messages you can monitor for
---------------------------------------------

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

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

   LIB           The list  of libraries  to be summarized.   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 of  the library 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 defaults.

   QSYSLIB       The name  of the QSYS  library.  QSYS is  the default.

                 A value such as QSYSnn may be specified.

   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.

                 *OUTFILE may  be entered to  write summary  records to
                 the LIBSIZP file.  No printed output will occur.

   OUTLIB        The  library  to  output the  LIBSIZP  file  to.   The
                 default  is  *LIBL  which  may  only  be  used  if the
                 LIBSIZP file  may be found  on the  library list.   If
                 the file does not exist, a library must be named.

   OUTMBR        The  member  to  be   written  to.    The  default  is
                 LIBSIZP.

   REPLACE       A  *YES/*NO parameter for whether  to replace the data
                 in the  outfile.  The  default is  *YES.   *NO may  be
                 specified to add to the existing data.

   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.   If this parameter
                 is used when  the library qualifier specified  for the
                 Object prompt  (OBJ parameter)  is *CURLIB,  *LIBL, or
                 *USRLIBL, ASPDEV(*) is the only valid value.

                 This  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 to  locate the library.   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.


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

You must  have *ALLOBJ  authority to specify  a library value  of *ALL,
*ALLUSR, *ALLUSR2, *ALLNONQ, or *IBM.

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

The following TAA Tools must be on your system:

     CHKALLOBJ       Check *ALLOBJ special authority
     CHKGENERC       Check generic
     CHKGENOBJ       Check generic object
     CVTLIBOBJD      Convert library object description
     DUPTAADBF       Duplicate TAA data base file
     EDTVAR          Edit variable
     EXTLST          Extract list
     EXTLST2         Extract list 2
     RTVDBFA         Retrieve data base file attributes
     RTVSYSVAL3      Retrieve system value 3
     SNDCOMPMSG      Send completion message
     SNDESCINF       Send escape information
     SNDESCMSG       Send escape message
     SNDSTSMSG       Send status message

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

None, the tool is ready to use.

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

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

   DSPLIBSIZ     *CMD                   TAALIDH       QATTCMD
   TAALIDHC      *PGM       CLP         TAALIDHC      QATTCL
   TAALIDHC2     *PGM       CLP         TAALIDHC2     QATTCL
   TAALIDHR      *PGM       RPG         TAALIDHR      QATTRPG
   TAALIDHR2     *PGM       RPG         TAALIDHR2     QATTRPG
   TAALIDHP      *FILE      PF          TAALIDHP      QATTDDS
					

Added to TAA Productivity tools January 15, 2009


Home Page Up to Top