TAA Tools
DSPSRCMBRS      DISPLAY SOURCE MEMBERS                 TAADBKT

The Display  Source Members  command displays  or prints source  member
information  from  one  or more  source  files  with various  selection
criteria.   The selection  options include source  type, generic member
name, create date, change  date, last used date,  a scan of the  member
name  or  text,  and  the  number  of  existing  records.    DSPSRCMBRS
simplifies searching for source member information.

The  QUSLMBR API  is used  by a  sub tool to  provide faster  access to
source members than the DSPFD outfile function.

A typical command would be:

             DSPSRCMBRS   SRCFILE(*STD) LIB(xxx) CHGDATE(*TODAY)

All source members  in the named  library that had  been changed  today
in  the   standard  source  files   (QCMDSRC,  QCLSRC  ...)   would  be
displayed.

The  selection  criteria is  'anded'  together.   For  example,  if you
specified:

             DSPSRCMBRS   SRCFILE(*STD) LIB(xxx) MBR(ABC*)
                            CHGDATE(*TODAY)

Only the member names  beginning with ABC that  had been changed  today
would be displayed.

Note that only  the member level  information is accessed.   The source
data itself is not processed.

DSPSRCMBRS escape messages you can monitor for
----------------------------------------------

      TAA9894    No members were found to match the selections
      TAA9896    More than 999 source files exist in the library
      TAA9897    No source files exist in the library

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

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

   SRCFILE       The  source file to  be used.   If a name  is entered,
                 only that source file will be searched.

                 *ALL  may be entered  to mean all  source files in the
                 library.

                 *STD  may  be specified  to  mean  the  standard  file
                 names  associated  with   source  types  described  in
                 system  help  text.    Only  those  source files  that
                 exist and  match  those  described  by  the  PRTSRCTYP
                 tool  will  be  checked.    See  the  discussion  with
                 PRTSRCTYP.

                 *SRC1,  *SRC2, and  *SRC3 mean that  a data  area must
                 exist on the library  list by the corresponding  names
                 of SRCLST1,  SRCLST2, and SRCLST3.   These  data areas
                 must  contain  the  name of  the  source  files to  be
                 checked.   Only source files  that exist and match one
                 of those  found  in the  data  area will  be  checked.
                 See the discussion with the CRTSRCFLST tool.

                 *QATT  or *QATT2  may be  specified to  mean  the only
                 files  checked  must  match  those  described  in  the
                 RTVQATTF TAA Tool.   This  is either a  short or  long
                 list of QATTxxx  source file names.   Use the PRTQATTF
                 command for a listing of the files.

                 Using  *QATT requires that  you must know  the Tool ID
                 to specify as the  generic name.  The  Tool ID can  be
                 determined  using DSPTAA  and the  name  in the  upper
                 right  hand corner of  the first  page.   For example,
                 the  Tool ID for ADDDAT is  TAADATA.  The *QATT values
                 only work  against  normal source  files  and not  the
                 TAA Archive.

   LIB           The library for  the source files.  A  library must be
                 named or *LIBL.

                 If   a  special   value  is   used  for   the  SRCFILE
                 parameter, a specific library must be named.

   MBR           The member  or members  to display.    The default  is
                 *ALL for all members.

                 A specific  member name or  a generic member  name may
                 be entered.

   SRCTYPE       The  source type to select.   The default  is *ALL for
                 all source types.

                 A specific source  type may be  entered.  No  checking
                 occurs on the value.

   CRTDATE       The create date to  select.  The default is  to select
                 all dates.

                 *TODAY  may be  entered  to select  all  those created
                 today.

                 *LASTWEEK  may be entered to  select all those created
                 in the last week.

                 *LASTMTH may be  entered to  select all those  created
                 in the last month (last 30 days).

                 A specific date  may be entered in job  date format to
                 select  all   those  created  on  or  after  the  date
                 entered.

   CHGDATE       The change date to select.   The default is to  select
                 all dates.

                 *TODAY  may be  entered  to select  all those  changed
                 today.

                 *LASTWEEK  may be entered to  select all those changed
                 in the last week.

                 *LASTMTH may be  entered to select  all those  changed
                 in the last month (last 30 days).

                 A specific date may  be entered in job date  format to
                 select  all  those   changed  on  or  after  the  date
                 entered.

   USEDATE       The  last  used date  to select.    The default  is to
                 select all dates.

                 *TODAY  may  be  entered  to  select  all  those  used
                 today.

                 *LASTWEEK may  be entered to select all  those used in
                 the last week.

                 *LASTMTH  may be entered  to select all  those used in
                 the last month (last 30 days).

                 A specific date may be  entered in job date format  to
                 select  all  those last  used  on  or after  the  date
                 entered.

   SCANMBR       Whether  to scan  the member  name for  a value.   The
                 default is *NOSCAN meaning no scan occurs.

                 A value may entered  such XXX to  scan for all  member
                 names that contain the value XXX.

   SCANTEXT      Whether to  scan the  member text  for a  value.   The
                 default is *NOSCAN meaning no scan occurs.

                 A value  may entered such as 'update'  to scan for all
                 member   text  descriptions  that  contain  the  value
                 'update'.   Both  the  value entered  and  the  member
                 text description  are translated to  upper case before
                 the scan occurs.

   RCDCNT        A  two  part  parameter  that  determines  whether  to
                 select on  the  number  of  records that  exist  in  a
                 member.  The default is *NONE.

                 The parameter allows  you to do typical  searches such
                 as  1)  all members  with  no records  2)  all members
                 with more than 5000 records.

                 The  first  part   is  the   'record  operator'   that
                 determines the  type of  comparison.   The default  is
                 *NONE  meaning  no  select  occurs  on the  number  of
                 records.   The values *EQ, *NE,  *GE, *GT, *LE, or *LT
                 may be entered.

                 The second  part is the  number of records  associated
                 with  the 'record  operator'.   The  default is  *NONE
                 meaning  the number  of records  in a member  will not
                 be considered for selection.

   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:

     ADDDAT          Add date
     CHKGENERC       Check generic
     CHKOBJ3         Check object 3
     EDTVAR          Edit variable
     MOVCHRDEC       Move character to decimal
     RTVDAT          Retrieve date
     RTVLIBSRCF      Retrieve library source files
     RTVMBRLST2      Retrieve member list 2
     RTVSYSVAL3      Retrieve system value 3
     SCNVAR          Scan variable
     SNDCOMPMSG      Send completion message
     SNDESCINF       Send escape information
     SNDESCMSG       Send escape message
     SNDSTSMSG       Send status message
     TRNVAL          Translate value

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

None, the tool is ready to use.

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

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

   DSPSRCMBRS    *CMD                   TAADBKTC      QATTCMD
   TAADBKTC      *PGM       CLP         TAADBKTC      QATTCL
   TAADBKTR      *PGM       RPG         TAADBKTR      QATTRPG
					

Added to TAA Productivity tools February 1, 2005


Home Page Up to Top