NAME

       user - Sun Grid Engine user entry file format

DESCRIPTION

       A  user  entry  is  used  to  store  ticket  and  usage  information  on a per user basis.
       Maintaining user entries for all users participating  in  a  Sun  Grid  Engine  system  is
       required if Sun Grid Engine is operated under a user share tree policy.

       If  the enforce_user cluster configuration parameter is set to auto, a user object for the
       submitting user will be created automatically during  job  submission,  if  one  does  not
       already  exist.  The  auto_user_oticket,  auto_user_fshare, auto_user_default_project, and
       auto_user_delete_time cluster configuration parameters will be used as default  attributes
       of the new user object.

       A  list  of  currently  configured  user entries can be displayed via the qconf(1) -suserl
       option. The contents of each enlisted user entry can be shown via the -suser  switch.  The
       output  follows  the user format description. New user entries can be created and existing
       can be modified via the -auser, -muser and -duser options to qconf(1).

       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

       A user entry contains four parameters:

   name
       The user name as defined for user_name in sge_types(1).

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

   fshare
       The current functional share of the user.

   default_project
       The default project of the user.

   delete_time
       Note: Deprecated, may be removed in future release.
       The wall-clock time when this user will be deleted, expressed as  the  number  of  seconds
       elapsed  since  January 1, 1970. If set to zero, the affected user is a permanent user. If
       set to one, the  user  currently  has  active  jobs.   For  additional  information  about
       automatically  created users, see the enforce_user and auto_user_delete_time parameters in
       sge_conf(5).

SEE ALSO

       sge_intro(1), sge_types(1), qconf(1).  sge_conf(5).

COPYRIGHT

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