SYNOPSIS
       qacct  [ -ar [ar_id] ] [ -A Account ] [ -b BeginTime ] [ -d Days ] [ -e
       EndTime ] [ -g [GroupId|GroupName] ] [ -h [HostName] ] [ -help ]  [  -j
       [job_id|job_name|pattern]  ]  [ -l attr=val,...  ] [ -o [Owner] ] [ -pe
       [PEname]  ]  [  -q  [wc_queue]  ]  [  -slots  [SlotNumber]   ]   [   -t
       task_id_range_list  ]  [  -P [Project] ] [ -D [Department] ] [ -f Acct-
       FileName ]

DESCRIPTION
       The qacct utility scans the accounting data  file  (see  accounting(5))
       and  produces  a  summary of information for wall-clock time, cpu-time,
       and system time for the categories of hostname, queue-name, group-name,
       owner-name,  job-name,  job-ID  and for the queues meeting the resource
       requirements as specified with the -l  switch.   Combinations  of  each
       category  are  permitted.  Alternatively,  all  or specific jobs can be
       listed with the -j switch.   For  example  the  search  criteria  could
       include summarizing for a queue and an owner, but not for two queues in
       the same request.

OPTIONS
       -ar [ar_id]
              The ID of the advance reservation for which usage is summarized.
              If  ar_id  is  not  given,  accounting  data  is listed for each
              advance reservation separately.

       -A Account
              The account for jobs to be summarized.

       -b BeginTime
              The earliest start time for jobs to be summarized, in the format
              [[CC]YY]MMDDhhmm[.SS].  See  also -d option. If CC is not speci-
              fied, a YY of < 70 means 20YY.

       -d Days
              The number of days to summarize and print accounting information
              on.  If  used together with the -b BeginTime option (see above),
              jobs started within BeginTime to BeginTime + Days  are  counted.
              If  used  together with the -e EndTime (see below) option, count
              starts at EndTime - Days.

       -e EndTime
              The latest start time for jobs to be summarized, in  the  format
              [[CC]YY]MMDDhhmm[.SS].  See  also -d option. If CC is not speci-
              fied, a YY of < 70 means 20YY.

       [-f AcctFileName]
              The accounting file to be used. If omitted, the  system  default
              accounting file is processed.

       -g [GroupId|GroupName]
              The  numeric  system  group id or the group alphanumeric name of
              the  job  owners  to  be  included   in   the   accounting.   If
              CPU times are no longer accumulated  but  the  "raw"  accounting
              information  is  printed  in  a  formatted  form  instead.   See
              accounting(5) for an explanation of the displayed information.

       -l attr=val,...
              A resource requirement specification which must be  met  by  the
              queues  in  which  the  jobs being accounted were executing. The
              resource request  is  very  similar  to  the  one  described  in
              qsub(1).

       -o [Owner]
              The  name  of the owner of the jobs for which accounting statis-
              tics are assembled. If the optional Owner argument is omitted, a
              listing  of  the  accounting  statistics of all job owners being
              present in the accounting file is produced.

       -pe [PEname]
              The name of the parallel environment for which usage  is  summa-
              rized.   If  PEname  is not given, accounting data is listed for
              each parallel environment separately.

       -q [wc_queue_name]
              A expression for queues for which usage is summarized. All queue
              instances  matching the expression will be listed. If no expres-
              sion is specified, a cluster queue summary will be given.

       -slots [SlotNumber]
              The number of queue slots for which  usage  is  summarized.   If
              SlotNumber is not given, accounting data is listed for each num-
              ber of queue slots separately.

       -t task_id_range_list
              Only available together with the -j option described above.

              The -t switch specifies the array  job  task  range,  for  which
              accounting  information  should be printed. Syntax and semantics
              of task_id_range_list are identical to that one described  under
              the  -t  option  to  qsub(1).  Please see there also for further
              information on array jobs.

       -P [Project]
              The name of the project  for  which  usage  is  summarized.   If
              Project  is not given, accounting data is listed for each owning
              project separately.

       -D [Department]
              The name of the department for which usage  is  summarized.   If
              Department is not given, accounting data is listed for each own-
              ing department separately.

ENVIRONMENTAL VARIABLES
       SGE_ROOT       Specifies the location of the Univa Grid Engine standard
                      ten  to stderr. In addition the level of detail in which
                      debug information is generated is defined.

       SGE_QMASTER_PORT
                      If set, specifies the tcp port on  which  sge_qmaster(8)
                      is  expected to listen for communication requests.  Most
                      installations will use a services map entry for the ser-
                      vice "sge_qmaster" instead to define that port.

       SGE_EXECD_PORT If  set, specifies the tcp port on which sge_execd(8) is
                      expected to listen  for  communication  requests.   Most
                      installations will use a services map entry for the ser-
                      vice "sge_execd" instead to define that port.

FILES
       <sge_root>/<cell>/common/accounting
                       Univa Grid Engine default accounting file
       <xxqs_nam_sexx_root>/<cell>/common/act_qmaster
                       Univa Grid Engine master host file

SEE ALSO
       sge_intro(1), qsub(1), accounting(5), sge_qmaster(8),

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



UGE 8.0.0                $Date: 2009/02/12 14:32:28 $                 QACCT(1)

Man(1) output converted with man2html