RNMGENSRC -- Rename Generic Source

RNMGENSRC RENAME GENERIC SOURCE TAASRFM
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: RNMGENSRC FROMGENNAM(ABC) TOGENNAM(DEFG) 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 file. An error can occur when the generated name is invalid such as: RNMGENSRC FROMGENNAM(ABC) TOGENNAM(DEFGHIJK) 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 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 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. Restrictions ------------ The generated member name must not exist in the source file. The generated member name may not exceed 10 characters. Prerequisites ------------- 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 Implementation -------------- 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

RNMGENSRC       RENAME GENERIC SOURCE                  TAASRFM


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:

             RNMGENSRC FROMGENNAM(ABC) TOGENNAM(DEFG)
                         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
file.

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

             RNMGENSRC FROMGENNAM(ABC) TOGENNAM(DEFGHIJK)

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


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

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

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

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

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

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

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