HP 3000 Manuals

ALTFILE [ HP 3000 Series 9X8LX Computer Systems Commands Reference ] MPE/iX 5.0 Documentation


HP 3000 Series 9X8LX Computer Systems Commands Reference

ALTFILE 

This command changes the attributes of an existing file or directory.

SYNTAX 

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

PARAMETERS 

filename         The file name of the object to be altered.  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 cannot use
                 wildcarding to specify file names, nor can you use
                 back-referenced file equations.  This parameter cannot
                 name a system-defined file (such as $NULL). You can
                 specify file names using both MPE and HFS syntaxes.
                 MPE-syntax names may not include lockwords; the lockword
                 for a lockworded file is not needed for this command to
                 succeed, and if included in the filename results in 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.  This name will be
                 upshifted if it is NOT quoted.  [Optional]

POSIXgroupname   The name of the group (GID) that this file will belong
                 to.  This POSIXgroupname must already exist on the
                 system.  This parameter cannot be used to change the GID
                 of an MPE group or account.  The default is for the file
                 to retain its previous GID. This name is upshifted when
                 you enclose it in quotes.

Operation Notes 

   *   Usage 

       You use the ALTFILE command to alter a file's characteristics.
       You can modify the owner (UID) and POSIX group (GID) for a file,
       hierarchical directory, MPE group or account.  You cannot alter
       the GID of MPE groups or accounts.

   *   Required Capabilities 

       The user must have the appropriate privilege to change the
       requested attribute.  To change the UID of a file, you must be one
       of the following:

          *   The file's account manager whose logon account matches the
              GID of the file and who has the MPE/iX account manager
              capability.  In this case, ownername must specify a user
              belonging to the account manager's logon account.

          *   A system manager who has the MPE/iX system manager user
              capability.  In this case, ownername may specify any user
              existing in the user database.

       To change the GID of a file, you must be one of the following:

          *   The file owner (a user whose logon name matches the UID of
              the file).  In this case, POSIXgroupname must specify the
              user's logon account.

          *   The file's account manager whose logon account matches the
              GID of the file and who has the MPE/iX account manager (AM)
              user capability.  In this case, POSIXgroupname must specify
              the account manager's logon account.

          *   A system manager who has the MPE/iX system manager user
              capability.  In this case, POSIXgroupname may specify any
              GID existing in the group database.

You can use ALTFILE to modify multiple attributes at the same time.  If
you try modifying multiple attributes, all changes must succeed for any
to take effect.  If you do not specify any attributes, the command has no
effect on the file specified.

Related Commands 

     ALTSEC



MPE/iX 5.0 Documentation