CHGDIRAUT -- Change Director Authorizations

CHGDIRAUT CHANGE DIRECTORY AUTHORITY TAAIFTM
The Change Directory Authority command changes the authorization to a directory, its objects, and all subdirectories and their objects. The command is a front end to the system command CHGAUT and uses the same parameters. CHGDIRAUT simplifies making mass changes to IFS authorizations. Several TAA commands are used which require the user of CHGDIRAUT to be authorized to the TAACVTIFS authorization list. A user must be the owner of any objects to be changed or have ALLOBJ special authority. A typical command would be: CHGDIRAUT OBJ(/home/xxx/yyy) USER(USER1 USER2) DTAAUT(RX) The object named must be a directory. The authorizations to the directory, any objects in the directory, any subdirectories and their objects would be changed so USER1 and USER2 have RX rights. The completion message would contain the number of objects changed. Any errors will cause an escape message with the error messages retained in the job log. CHGDIRAUT escape messages you can monitor for --------------------------------------------- TAA9897 Some failure occurred. Escape messages from based on functions will be re-sent. Command parameters CMD ------------------ OBJ The path name of the directory and subdirectories to change authorities for. A directory must be named. USER The list of users to change authority for. For a complete discussion, see the CHGAUT command. PUBLIC may be entered as the only value to change authorities for the PUBLIC user. NTWIRF may be entered for the NetWare Inherited Rights Filter. A list of up to 50 user names may be entered. DTAAUT The data authorities given to the users specified in the USER parameter. For a complete discussion, see the CHGAUT command. SAME is the default to retain the current data authorities. NONE may be entered to remove any current data authorities. Or one of the following may be entered: RX, RW, WX, R, W, X, EXCLUDE, or AUTL. OBJAUT The data authorities given to the users specified in the USER parameter. For a complete discussion, see the CHGAUT command. SAME is the default to retain the current object authorities. NONE may be entered to remove any current object authorities. ALL may be entered for all object authorities or up to 4 values may be entered from: OBJEXIST, OBJMGT, OBJALTER, and OBJREF. AUTL The name of the authorization list whose users are given authority for the object specified in the OBJ parameter. For a complete discussion, see the CHGAUT command. The special value NONE removes the current authorization list. APPLYTO Whether to apply the changes to all, directory, or stream file objects. ALL is the default to apply to both DIR and STMF object types. DIR may be specified to apply only to directory objects. STMF may be specified to apply only to stream file objects. Restrictions ------------ Several TAA commands are used which require the user of CHGDIRAUT to be authorized to the TAACVTIFS authorization list. A user must be the owner of any objects to be changed or have ALLOBJ special authority. Prerequisites ------------- The following TAA Tools must be on your system: CHKIFSE Check IFS entry CVTIFS Convert IFS EDTVAR Edit variable EXTLST Extract list EXTLST2 Extract list 2 RSNLSTMSG Resend last message RTVIFSED Retrieve IFS entry description 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 ------ ---- --------- ---------- ---------- CHGDIRAUT CMD TAAIFTM QATTCMD TAAIFTMC *PGM CLP TAAIFTMC QATTCL

CHGDIRAUT       CHANGE DIRECTORY AUTHORITY             TAAIFTM


The Change Directory  Authority command changes the authorization  to a
directory,  its  objects, and  all  subdirectories  and their  objects.
The  command is a front  end to the system  command CHGAUT and uses the
same parameters.    CHGDIRAUT simplifies  making  mass changes  to  IFS
authorizations.

Several TAA  commands are used which  require the user  of CHGDIRAUT to
be authorized to the TAACVTIFS authorization list.

A user  must be the owner of any objects  to be changed or have *ALLOBJ
special authority.

A typical command would be:

             CHGDIRAUT    OBJ(/home/xxx/yyy) USER(USER1 USER2)
                            DTAAUT(*RX)

The object  named  must be  a directory.    The authorizations  to  the
directory, any objects  in the directory, any  subdirectories and their
objects would be changed so USER1 and USER2 have *RX rights.

The completion message would contain the number of objects changed.

Any  errors  will  cause an  escape  message  with  the error  messages
retained in the job log.

CHGDIRAUT escape messages you can monitor for
---------------------------------------------

      TAA9897    Some failure occurred.

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

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

   OBJ           The path name of  the directory and subdirectories  to
                 change authorities  for.  A  directory must  be named.

   USER          The  list of  users to  change authority  for.   For a
                 complete discussion, see the CHGAUT command.

                 *PUBLIC  may be  entered as  the only  value to change
                 authorities for the *PUBLIC user.

                 *NTWIRF  may  be entered  for  the  NetWare  Inherited
                 Rights Filter.

                 A list of up to 50 user names may be entered.

   DTAAUT        The data  authorities given to the  users specified in
                 the  USER parameter.   For a  complete discussion, see
                 the CHGAUT command.

                 *SAME is  the  default  to  retain  the  current  data
                 authorities.

                 *NONE  may  be  entered to  remove  any  current  data
                 authorities.

                 Or  one of  the following  may  be entered:  *RX, *RW,
                 *WX, *R, *W, *X, *EXCLUDE, or *AUTL.

   OBJAUT        The data authorities given  to the users specified  in
                 the USER  parameter.  For  a complete  discussion, see
                 the CHGAUT command.

                 *SAME  is the  default  to retain  the  current object
                 authorities.

                 *NONE  may  be entered  to  remove any  current object
                 authorities.

                 *ALL may be entered  for all object authorities or  up
                 to 4  values may be entered  from: *OBJEXIST, *OBJMGT,
                 *OBJALTER, and *OBJREF.

   AUTL          The  name of  the authorization  list whose  users are
                 given authority for  the object  specified in the  OBJ
                 parameter.    For  a   complete  discussion,  see  the
                 CHGAUT command.

                 The   special   value   *NONE   removes  the   current
                 authorization list.

   APPLYTO       Whether to  apply the  changes to  all, directory,  or
                 stream file objects.

                 *ALL is the  default to apply  to both *DIR  and *STMF
                 object types.

                 *DIR  may  be specified  to  apply  only to  directory
                 objects.

                 *STMF  may be specified  to apply only  to stream file
                 objects.

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

Several TAA commands  are used which require  the user of CHGDIRAUT  to
be authorized to the TAACVTIFS authorization list.

A user must be  the owner of any objects to be  changed or have *ALLOBJ
special authority.

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

The following TAA Tools must be on your system:

     CHKIFSE         Check IFS entry
     CVTIFS          Convert IFS
     EDTVAR          Edit variable
     EXTLST          Extract list
     EXTLST2         Extract list 2
     RSNLSTMSG       Resend last message
     RTVIFSED        Retrieve IFS entry description
     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
   ------        ----    ---------      ----------    ----------

   CHGDIRAUT     *CMD                   TAAIFTM       QATTCMD
   TAAIFTMC      *PGM       CLP         TAAIFTMC      QATTCL

Added to TAA Productivity tools June 1, 2005

Home Page

Up to Top