NAME

       access_list - Sun Grid Engine access list file format

DESCRIPTION

       Access  lists  are  used  in  Sun  Grid  Engine  to  define  access  permissions  of users to queues (see
       queue_conf(5)) or parallel environments (see sge_pe(5)).  A list of currently configured access lists can
       be displayed via the qconf(1) -sul option. The contents of each enlisted access list can  shown  via  the
       -su  switch.  The  output follows the access_list format description. New access lists can be created and
       existing can be modified via the -au and -du options to qconf(1).

       Departments are a special form of access list that additionally allow assignment of functional shares and
       override tickets.

       Note, Sun Grid Engine allows backslashes (\)  be  used  to  escape  newline  (\newline)  characters.  The
       backslash and the newline are replaced with a space (" ") character before any interpretation.

FORMAT

       The following list of access_list parameters specifies the access_list content:

   name
       The name of the access list as defined for userset_name in sge_types(1).

   type
       The  type  of  the  access  list,  currently   one   of ACL, or DEPT or a  combination of both in a comma
       separated list. Depending on this parameter the access list can be used as  access  list  only  or  as  a
       department.

   oticket
       The amount of override tickets currently assigned to the department.

   fshare
       The current functional share of the department.

   entries
       The  entries  parameter  contains  the  comma  separated  list  of  those  UNIX  users  (see user_name in
       sge_types(1)) or those primary UNIX groups that are assigned to the access list or the department. Only a
       user's primary UNIX group is used; secondary groups are ignored. Only  symbolic  names  are  allowed.   A
       group  is differentiated from a user name by prefixing the group name with a '@' sign.  Pure access lists
       allow enlisting any user or group in any access list.

       When using departments, each user or group enlisted may only be enlisted in one department, in  order  to
       ensure  a  unique  assignment  of  jobs to departments.  To jobs whose users do not match with any of the
       users or groups enlisted under entries the defaultdepartment is assigned, if existing.

SEE ALSO

       sge_intro(1), sge_types(1), qconf(1), sge_pe(5), queue_conf(5).

COPYRIGHT

       See sge_intro(1) for a full statement of rights and permissions.

SGE 6.2u5                                            $Date$                                       ACCESS_LIST(5)