TAA Tools
CLRGENSRC       CLEAR GENERIC SOURCE                   TAADBNP

The Clear  Generic  Source command  clears generic  members  in one  or
more  source files  in a  specified library.    Special values  such as
*STD  may be  used for  the source file  name to  clear generic members
from  source  files such  as  QCLSRC  and  QCMDSRC.    The  default  is
ACTION(*CHECK) which  describes in messages  the members that  would be
cleared.

A typical command would be:

             CLRGENSRC GENNAME(ABC) SRCFILE(LIB1/*STD) ACTION(*CLEAR)

All  member  names  beginning  with  ABC  would  be  cleared  from  the
standard source files  in library LIB1.   See the  discussion with  the
PRTSRCTYP tool for the source file names that would be checked.

Messages  would be  sent for  each member  cleared or  any errors  that
occurred.

CLRGENSRC escape messages you can monitor for
---------------------------------------------

      TAA9891    No members or generic member names were found
      TAA9892    No source files exist of the named type
      TAA9893    Some members cleared but errors were found
      TAA9896    More than 999 source files exist
      TAA9897    No source files exist

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

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

   GENNAME       The   generic  name  of  the   source  members  to  be
                 cleared.  The name  would normally be entered  without
                 a trailing *, but  is limited to 9 characters  if this
                 format is used.  A trailing * may be entered.

                 Note  that a  single  member name  cannot  be cleared.
                 It is always a generic name.

   SRCFILE       The  source file to  be cleared.   A specific name may
                 be entered or  one of the  special values *ALL,  *STD,
                 *SRC1, *SRC2, *SRC3, *QATT, or *QATT2.

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

                 *STD  may  be specified  to mean  the  standard source
                 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.

                 The  library value  defaults  to  *LIBL.   A  specific
                 library or *CURLIB may also be used.

   ACTION        Whether  to clear  the  members or  only  report those
                 that would be cleared.

                 *CHECK  is  the  default  to  only  list  messages for
                 those members that would be cleared.

                 *CLEAR  may   be  specified   to  clear  the   generic
                 members.   A message is  sent for each member  that is
                 cleared.


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

If  SRCFILE(*ALL)  is  specified,  a maximum  of  999  source  file may
exist.  Exceeding the value causes a TAA9896 escape message.

A maximum of 900 members in  any one source file can match the  generic
name.  Only the first 900 are returned.

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

The following TAA Tools must be on your system:

     CHKGENERC       Check generic
     CHKOBJ3         Check object 3
     EDTVAR          Edit variable
     RSNLSTMSG       Resend last message
     RTVDBFA         Retrieve data base file attributes
     RTVLIBSRCF      Retrieve library source files
     RTVMBRLST       Retrieve member list
     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
   ------        ----    ---------      ----------    ----------

   CLRGENSRC     *CMD                   TAADBNP       QATTCMD
   TAADBNPC      *PGM       CLP         TAADBNPC      QATTCL
					

Added to TAA Productivity tools July 15, 2012


Home Page Up to Top