ALTFILE

Generated from C.60.01 /SYS/PUB/CICAT last modified on Thu Jan 11 09:18:52 2001

Back to Main Index


ALTFILE


     Changes the attributes of an existing file or directory.

SYNTAX


     ALTFILE [ FILE=] filename
     [[;OWNER=] ownername]
     [[;GROUPID=] POSIXgroupname]


PARAMETERS


filename       The filename of the object to be altered, specified in
               either MPE or HFS syntax. The filename may name a file,
               hierarchical directory, root, MPE group or account.
               Note that MPE groups or accounts can ONLY be named via
               HFS (Hierarchical File System) syntax. Temporary files
               are not recognized.

               This is a required parameter. You may not use wildcards,
               back-reference a file equation, or name a system-defined
               file such as $NULL.

               If you use MPE syntax to specify a file that has a
               lockword, do NOT include the lockword on the command
               line or you will get an error.

ownername      The name of the user who will become the owner (UID) of
               filename.  This ownername must already exist on the
               system.  Default is for the UID of the file to remain
               unchanged.  Note that no qualification is done on this
               name; it must be fully specified.  To have the
               ownername upshifted, enclose it in quotes.

POSIXgroupname The name of the POSIX group (GID) that this file will
               belong to. This POSIXgroupname must already exist on the
               system.  You cannot use this parameter to change the GID
               of an MPE group or account. Default is for the file to
               retain its previous GID.  To have POSIXgroupname
               upshifted, enclose it in quotes.


OPERATION


     You use the ALTFILE command to alter a file's characteristics.
     The attributes you may modify are the owner (UID) and POSIX group
     (GID) for a file, hierarchical directory, MPE group or account,
     with the restriction that you may not alter the GID for MPE groups
     or accounts.

     You may issue the ALTFILE command once to modify multiple
     attributes. If you specify multiple attributes, all modifications
     must succeed for any to take effect.  If you enter no attributes,
     the command has no effect on the specified file.

     You must have the appropriate privilege to change the requested
     attribute(s).  In order to change the UID of a file, you must be
     one of the following:

     o  The file's account manager (your logon account matches the GID
        of the file and you have account manager (AM) capability). In
        this case, ownername must specify a user belonging to your
        logon account.

     o  A system manager (a user who has the system manager (SM)
        capability).  In this case, ownername may specify any user
        existing in the user database.

     In order to change the GID of a file, the user must be one of the
     following:

     o  The file owner (your logon name matches the UID of the file).
        In this case, POSIXgroupname must specify your logon account.

     o  The file's account manager (your logon account matches the GID
        of the file and you have account manager (AM) capability).
        In this case, POSIXgroupname must specify your logon account.

     o  A system manager (a user who has system manager (SM)
        capability).  In this case, POSIX groupname may specify any
        GID existing in the group database.


ADDITIONAL INFORMATION


Commands:   ALTSEC, LISTFILE, RELEASE, SECURE

Manuals:    Performing System Management Tasks (32650-90004)

Back to Main Index