TAA Tools
DSPMBRCPC       DISPLAY MEMBER CAPACITY                TAADBLZ

The Display  Member Capacity  command displays  or lists  one line  per
member  describing  the  current  number  of  records  and  the  record
capacity.   Multiple libraries and a generic file  name may be used.  A
specified percentage  causes  a flagging  of  those members  which  are
nearing  their record  capacity.   The  command defaults  to list  only
those members which are flagged.

The  system will post  an inquiry message when  another increment needs
to be added  to allow for  additional capacity in  a member.   However,
it can  be a  better approach  to determine ahead  of time  the members
that  are  nearing  capacity  and  make  appropriate changes  with  the
CHGPFM SIZE parameter.   CHGPFM will change all  existing members in  a
file.   The new value  will also  exist for any  new members which  are
added.

You must  have *ALLOBJ special authority to specify  a library value of
*ALL or *ALLUSR.

A typical command would be:

            DSPMBRCPC   LIB(ABC*)

All  data physical file  members in libraries with  a beginning name of
ABC would be checked.   The default of  10% would be used  to determine
if any  members would be flagged  and listed if their  remaining record
capacity is less than 10%.

An  option exists to name your own  value instead of the system default
for the number of records if the file is specified as *NOMAX.

An optional escape message may be sent if any members are flagged.

DSPMBRCPC escape messages you can monitor for
---------------------------------------------

      TAA9891    No members exist
      TAA9896    Members have been flagged (see ESCAPEMSG parm)

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

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

   LIB           The library  name containing  the logical  files.   Up
                 to 300  names may be  entered for single  libraries or
                 generic  library names.   A single  value for *CURLIB,
                 *USRLIBL, *ALL,  or *ALLUSR  may be  used.   See  also
                 the OMITLIB parameter.

   FILE          The file name to be processed.

                 *ALL is the  default for all physical  files specified
                 for  the  LIB parameter.    A single  file  name or  a
                 generic name may be entered.

   CHKPCT        The  percentage to check for  remaining capacity.  10%
                 is the  default.   It must be  a value  between 1  and
                 99.

                 The percentage  entered determines if  the member will
                 be  flagged based on  the remaining  number of records
                 that can be added to the file.

   FLAGONLY      A *YES/*NO  parameter  for whether  to flag  only  the
                 members that are at the percentage specified.

                 *YES is  the default to  list only those  members that
                 have  a remaining capacity  of equal or  less than the
                 percentage specified.

                 *NO may be specified to list all members.

   ESCAPEMSG     A *YES/*NO parameter  for whether  the TAA9896  escape
                 message is sent if any members are flagged.

                 *NO is the  default meaning no escape message  is sent
                 if any members are flagged.

                 *YES  may be  specified  to cause  the  TAA9896 escape
                 message  to be sent if any  members are flagged.  This
                 allows a program  to gain control  if any members  are
                 approaching their capacity.

   DATATYPE      The data type  to be processed.  *DATA  is the default
                 meaning source file members will not be processed.

                 *SRC  (for source members)  or *ALL for  both data and
                 source members may be specified.

   LIBTYPE       The library  type  to  be  processed.    *ALL  is  the
                 default.  *PROD or *TEST may be specified.

   NOMAXVAL      The value  for the  number of  records to  be used  if
                 the file  is specified as *NOMAX.   The default is 4GB
                 or 4,294,967,296.  The  value entered must be  between
                 1 and 4GB.

                 Using a  lower value  allows you  to flag large  files
                 based on your own definition of *NOMAX.

   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).

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

   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
------------

You must  have *ALLOBJ special authority to specify  a library value of
*ALL or *ALLUSR.

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

The following TAA Tools must be on your system:

     CHKALLOBJ       Check *ALLOBJ special authority
     CVTMBRD         Convert member description
     EDTVAR          Edit variable
     EXTLST2         Extract list 2
     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
   ------        ----    ---------      ----------    ----------

   DSPMBRCPC     *CMD                   TAADBLZ       QATTCMD
   TAADBLZC      *PGM       CLP         TAADBLZC      QATTCL
   TAADBLZR      *PGM       RPG         TAADBLZR      QATTRPG
					

Added to TAA Productivity tools October 15, 2008


Home Page Up to Top