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.