TAA Tools
RNMGENOBJ       RENAME GENERIC OBJECT                  TAAOBMN

The Rename Generic  Object command allows  a rename of  generic objects
in a  named library.  The new  generic name value must be  less than or
equal  to the length of  the existing generic name.   Any characters in
the name of an  object after the generic  name are carried over to  the
new name.  A listing is produced including any errors found.

A typical command would be:

             RNMGENOBJ  GENOBJ(ABC) LIB(xxx) NEWGEN(DEF)

Any objects  beginning with ABC  would be renamed  to DEF in  the named
library  by use  of the  system RNMOBJ  command.   The following  is an
example:

           Current name   New name
           ------------   --------
           ABC            DEF
           ABC2           DEF2
           ABCXYZ         DEFXYZ

A listing  would be  displayed describing  the changes  and any  errors
such as  the object is locked  or is of  a type that cannot  be renamed
(such as a *JRNRCV type).

While  the RNMGENOBJ  command  allows *PUBLIC  usage, the  user  of the
command must have *OBJMGT to the objects to be renamed.

RNMGENOBJ escape messages you can monitor for
---------------------------------------------

      TAA9893    RNMGENOBJ failed.  See listing.
                  Only occurs if a printed listing is output

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

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

   GENOBJ        The generic name  of the  objects to be  renamed.   Up
                 to 9 characters may be entered.

   LIB           The  library where  the  objects  exist.   A  specific
                 library name must be entered.

   NEWGEN        The new  generic name to be used.   The length must be
                 less  than or equal to the  length of the GENOBJ name.

   OBJTYPE       The object type to  be renamed.  *ALL is  the default.
                 Use  the  prompter for  the  supported  values.   Some
                 object  types  are not  supported by  RNMOBJ  (such as
                 *JRNRCV) and will cause an  error which will be  noted
                 on the listing.

   OUTPUT        How  to output  the  results.   *  is  the default  to
                 display  the spooled  file if  the command  is entered
                 interactively.  If  the display is  ended with  F3/F12
                 or the  Enter key, the  spooled file is  deleted after
                 it  is displayed.   To  retain  the spooled  file, you
                 may  use the the System  Request 'Cancel' function and
                 the spooled file will exist in a HLD status.

                 If the  command  is  entered  in batch  or  *PRINT  is
                 specified,  the spooled file  is output  and retained.


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

*OBJMGT is required to any objects to be renamed.

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

The following TAA Tools must be on your system:

     CHKOBJ3         Check object 3
     CVTOBJD4        Convert object description 4
     EDTVAR          Edit variable
     RSNLSTMSG       Resend last message
     RTVSYSVAL3      Retrieve system value 3
     RTVVALA         Retrieve value attributes
     SNDCOMPMSG      Send completion 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
   ------        ----    ---------      ----------    ----------

   RNMGENOBJ     *CMD                   TAAOBMN       QATTCMD
   TAAOBMNC      *PGM       CLP         TAAOBMNC      QATTCL
   TAAOBMNR      *PGM       RPG         TAAOBMNR      QATTRPG
					

Added to TAA Productivity tools July 15, 2013


Home Page Up to Top