


      CCCChhhhaaaannnnggggeeeeMMMMooooddddeeee((((3333BBBB))))               ((((RRRRiiiiddddggggeeee))))               CCCChhhhaaaannnnggggeeeeMMMMooooddddeeee((((3333BBBB))))



      NNNNAAAAMMMMEEEE
           ChangeMode - change access mode of a file

      SSSSYYYYNNNNTTTTAAAAXXXX
           FUNCTION ChangeMode (name : String;
                                accessMode: Halfword) : Error;

      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
           _C_h_a_n_g_e_M_o_d_e changes the access mode (permission bits) of the
           file or directory nnnnaaaammmmeeee to the value aaaacccccccceeeessssssssMMMMooooddddeeee.  The bits
           are set to 1 to grant the access; to 0 to deny the access.
           The access mode can assume combinations of the following:

           100000000000  set user ID on execution
           010000000000  set group ID on execution
           001000000000  (not used)
           000100000000  read permission for owner
           000010000000  write permission for owner
           000001000000  execute (or search directory) permission for owner
           000000111000  read, write, and execute permission for group
           000000000111  read, write, and execute permission for others

           Only the owner of a file or directory, or the Super-User,
           can change its access mode.

      SSSSEEEEEEEE AAAALLLLSSSSOOOO
           Access (3B)

      NNNNOOOOTTTTEEEESSSS
           ErBadFileName is returned of the name is too long, or
           contains invalid characters.

           ErFileNotFound is returned if the file or directory cannot
           be found.

           ErNotOwner is returned if the caller is neither the owner
           not the Super-User.


















      Page 1                                                   (9010-E)



