TAA Tools

The Rename  Generic Source command  allows a rename  of one or  generic
members  in one or  more source files  in a  library.  A  single source
file,  all source files,  or special values for  source file names such
as *STD may be used.

A typical command would be:

                         SRCFILE(*STD) LIB(LIB1)

The *STD value  for source files  means the source  file names such  as
QCLSRC,  QDDSSRC etc.   See  the  parameter discussion  of the  special
values.    All member  names  beginning with  ABC would  be  renamed by
using the  new  generic name  and  the  characters following  the  From
generic name.  For example,

           Existing name    New name

           ABC              DEFG
           ABC1             DEFG1
           ABCXYZ           DEFGXYZ

The new  name to be used  may not have  an existing member in  the same

An error can occur when the generated name is invalid such as:


If  an existing member name  is ABCDEFGH, the new  member name assigned
(DEFGHIJKDEFGH) would exceed 10 characters.

Both the From  and To generic  names cannot be more  than 9  characters
excluding the * value.

If a member  error occurs, a diagnostic  message is sent and  an escape
message is sent when all source files have been processed.

RNMGENSRC escape messages you can monitor for

      TAA9892    Some member error occurred
      TAA9893    No members found for the From generic name

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

RNMGENSRC Command parameters                          *CMD

   FROMGENNAME   The From  generic member name.  If  the value does not
                 contain  an *  at the  end, generic  is assumed.   The
                 value cannot exceed 9 characters.

                 Note  that  there  is  no  method   of  specifying  an
                 individual member  unless there  is only  one matching
                 a generic name.

   TOGENNAM      The  To generic  member name.   If the  value does not
                 contain an  * at  the end,  generic is  assumed.   The
                 value cannot exceed 9 characters.

                 The  new  member   name  that  is  generated   uses  a
                 combination  of the  To generic  name plus  any excess
                 characters  after  the   From  generic   name.     For
                 example,  if changing  from the  generic  name ABC  to
                 DEF and  the member name to be  renamed is ABC123, the
                 new member name would be DEF123.

                 Note  that  if the  To name  is  longer than  the From
                 name, it is possible  that the generated new name  may
                 exceed 10 characters.

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

                 *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  such  as  QATTCMD,  QATTCL,  etc.
                 This  is  either  a short  or  long  list  of  QATTxxx
                 source  file names.   Use the  PRTQATTF command  for a
                 listing of the files.

   LIB           The  library  that  contains the  source  files.   The
                 default is *LIBL.

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


  **   The generated member name must not exist in the source file.

  **   The generated member name may not exceed 10 characters.


The following TAA Tools must be on your system:

     CHKGENERC       Check generic
     CHKOBJ3         Check object 3
     EDTVAR          Edit variable
     RSNALLMSG       Resend all messages
     RTVLIBSRCF      Retrieve library source files
     RTVMBRLST       Retrieve member list
     RTVVALA         Retrieve value attributes
     SNDCOMPMSG      Send completion message
     SNDDIAGMSG      Send diagnostic message
     SNDESCINF       Send escape information
     SNDESCMSG       Send escape message


None, the tool is ready to use.

Objects used by the tool

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

   RNMGENSRC     *CMD                   TAASRFM       QATTCMD
   TAASRFMC      *PGM       CLP         TAASRFMC      QATTCL

Added to TAA Productivity tools January 15, 2012

Home Page Up to Top