    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 paral-
         lel environments (see sge_pe(5)).  A list of currently  con-
         figured  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 for-
         mat description. New access lists can be created and  exist-
         ing can be modified via the -au and -du options to qconf(1).

         Departments are a special form of access list that addition-
         ally  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. Depend-
         ing 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 pre-
         fixing 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  permis-
         sions.