The  Rename  Object   Primary  Group  Profile  command  sets   the  PGP
attribute  of one  or more  objects to  a new  user  profile.   The PGP
attribute  is set by the CHGOBJPGP  command.  The default for RNMOBJPGP
is  for  ACTION(*CHECK)  which  causes  a  listing  of  what  would  be
changed.   ACTION(*CHANGE) should be specified to  change the attribute
(set  it to  the new user  profile).   The new  user profile  must be a
'group profile'.

To set the primary group  profile to *NONE, see the RVKOBJPGP  command.

You must have *ALLOBJ special authority to use RNMOBJPGP.

The To user profile must be a group profile.

A typical command would be:

             RNMOBJPGP  OBJ(xxx/*ALL) FROMUSRPRF(USER1)
                          TOUSRPRF(USER2)

All objects  in the named  library that have  the PGP attribute  set to
the  user profile name USER1  would be listed.   Because ACTION(*CHECK)
is the default, no changes would occur.

If ACTION(*CHANGE) had  been specified,  the same  listing would  occur
and the objects would have the PGP attribute set to USER2.

The PGPAUT  and RVKOLDAUT parameters  of RNMOBJPGP  are passed thru  to
the  CHGOBJPGP command.    The CHGOBJPGP  command submits  a  batch job
QHXHDLTU to the QSYSNOMAX job queue which performs the change.

Accessing primary group profile objects
---------------------------------------

The  DSPUSRPRF  OUTFILE function  for TYPE(*OBJPGP)  is used  to access
the  objects.   This  does  not  include  the IFS  objects.    See  the
RNMIFSPGP command for similar handling of IFS objects.

RNMOBJPGP escape messages you can monitor for
----------------------------------------------

      TAA9893    The To user profile must be a group profile

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

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

   FROMUSRPRF    The  From  user  profile  that is  the  named  Primary
                 Group  Profile   of  the  objects  to  be  checked  or
                 changed.

   TOUSRPRF      The To  user profile  that is  to be  the new  Primary
                 Group Profile of  the objects to be changed.   It must
                 be a group profile.

   OBJ           The  qualified name  of the  object  or objects.   The
                 object name defaults to *ALL.   A generic or  specific
                 object name  may also be  entered.  The  library value
                 defaults  to *ALL.   A  specific  library may  also be
                 named.

   OBJTYPE       The  object  type  of  the objects  to  be  checked or
                 changed.  Use the  prompter for the supported  values.

   PGPAUT        The  authority   granted  to  the   To  user  profile.
                 *OLDPGP  is the default  for the  authorities that the
                 From user  profile  had.    *PRIVATE,  *ALL,  *CHANGE,
                 *USE, or *EXCLUDE may be specified.

                 This value  is passed  thru to  the CHGOBJPGP  command
                 PGPAUT  parameter.   For  a full  discussion,  see the
                 help text for CHGOBJPGP.

   RVKOLDAUT     Whether the  authorities  for the  From  user  profile
                 should be  revoked.   *YES  is the  default to  revoke
                 the authorities.   *NO may be specified  to retain the
                 authorities.

                 This  value is  passed thru  to the  CHGOBJPGP command
                 RVKOLDAUT parameter.   For a full discussion,  see the
                 help text for CHGOBJPGP.

   ACTION        The action to be taken.

                 *CHECK  is the  default  which produces  a listing  of
                 the  objects  that  would be  changed  if  *CHANGE had
                 been specified.  No objects are changed.

                 *CHANGE may be specified to  set the attribute of  the
                 listed objects to the To user profile.

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

You must have *ALLOBJ special authority to use RNM

The new user profile must be a group profile.

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

The following TAA Tools must be on your system:

     CHKALLOBJ       Check *ALLOBJ special authority
     CHKGENERC       Check generic
     CHKGRPPRF       Check group profile
     RSNLSTMSG       Resend last message
     RTVSYSVAL3      Retrieve system value 3
     SNDCOMPMSG      Send completion message
     SNDESCINF       Send escape information

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

None, the tool is ready to use.

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

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

   RNMOBJPGP     *CMD                   TAASEIM       QATTCMD
   TAASEIMC      *PGM       CLP         TAASEIMC      QATTCL
   TAASEIMC2     *PGM       CLP         TAASEIMC2     QATTCL
   TAASEIMR      *PGM       RPG         TAASEIMR      QATTRPG