TAA Tools
CHGIFSOWN       CHANGE IFS OWNER                       TAAIFSW

The  Change IFS  Owner command  allows  a change  of  ownership of  IFS
objects.  The  list of IFS objects to operate on  is created as part of
the  command.   The objects  for a specific  owner or  the ownership of
all objects  found may  be changed.   An  option exists  to check  what
changes would occur.

If a  directory is changed, all  objects within the  directory are also
changed including sub directories and their objects.

You  must have *ALLOBJ special authority to  use CHGIFSOWN.  You cannot
change the owner  if the owner  is a system  name QSYS, QLPINSTALL,  or
QLPAUTO.

A typical command would be:

             CHGIFSOWN   OBJ(...) NEWOWN(xxx) CUROWN(yyy)
                           ACTION(*CHECK)

All objects on the  path would be found.  Only those  objects that were
owned  by  the CUROWN  name would  be  flagged in  a  generated spooled
file.  This allows you to review what would be changed.

If the  spooled file  describes the  objects you  want to  be  changed,
duplicate  the previous  command  and change  the  ACTION parameter  to
*CHANGE.

             CHGIFSOWN   OBJ(...) NEWOWN(xxx) CUROWN(yyy)
                           ACTION(*CHANGE)

The new spooled file will indicate those objects that were changed.

CHGIFSOWN  escape messages you can monitor for
----------------------------------------------

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

CHGIFSOWN Command parameters                          *CMD
----------------------------

   OBJ           The  path name  of the  object to  be converted.   The
                 object  path name  can be  either a  simple name  or a
                 name  that   is  qualified  with   the  name  of   the
                 directory  in  which  the  object  is  located.    The
                 default is *.

                 Specifying  * will  start the  convert process  at the
                 current directory  level.   If the  current  directory
                 level is at  the root ('/'), the  convert process will
                 start at the home directory ('/home').

   OBJNAM        The object name to select.  The default is *ALL.

                 The  IFS  object  name  is  translated  to upper  case
                 before making a comparison  using the translate  table
                 as  described  by the  TAA  RTVTRNTBL  tool  (provided
                 default is QSYSTRNTBL in QSYS).

                 A  specific name may  be entered  or a  generic* name.
                 The  generic  name can  be  any one  of  the following
                 types:

                      ABC* Select all names beginning with ABC.

                      A*C Select names like ABC ABBC AXYZC

                      A*C* Select names like ABC ABCD ABBCD

                      *AB* Select names like AAB AABC XAB XABC

                 however, if  an embedded *  exists (such  as A*C),  or
                 multiple  *s  (such  as   A*C*),  the  value  must  be
                 entered in quotes.

   NEWOWN        The name of the new owner.

   CUROWN        The  name of the current  owner of the  objects.  If a
                 specific name is entered,  only objects owned by  that
                 user profile will be changed.

                 A  special value  *ANY may  be entered  to change  the
                 ownership regardless of who the owner is.

   CUROWNAUT     Whether  to   revoke  or  retain  the  current  owners
                 authority to the  object.  The  default is *REVOKE  to
                 revoke the authority.

                 *SAME may  be specified to  retain the  current owners
                 authority.

   ACTION        The  action  to  take.    *CHANGE is  the  default  to
                 change the authority.

                 *CHECK   may  be  entered  to   check  what  would  be
                 changed.     Entering  *CHECK   does  not  cause   any
                 changes, but  allows you to review  the spooled output
                 before making any changes.


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

You must have *ALLOBJ special authority to use CHGIFSOWN.

You  cannot  change the  owner  if the  owner  is a  system  name QSYS,
QLPINSTALL, or QLPAUTO.

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

The following TAA Tools must be on your system:

     CHKALLOBJ       Check *ALLOBJ special authority
     CHKOBJ3         Check object 3
     CVTIFS          Convert IFS
     RSNLSTMSG       Resend last message
     RTVSYSVAL3      Retrieve system value 3
     SNDCOMPMSG      Send completion message
     SNDESCMSG       Send escape message
     SNDJLGMSG       Send job log message

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

None, the tool is ready to use.

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

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

   CHGIFSOWN     *CMD                   TAAIFSW       QATTCMD
   TAAIFSWC      *PGM       CLP         TAAIFSWC      QATTCL
   TAAIFSWC2     *PGM       CLP         TAAIFSWC2     QATTCL
   TAAIFSWR      *PGM       RPG         TAAIFSWR      QATTRPG
					

Added to TAA Productivity tools September 15, 2002


Home Page Up to Top