Provided by: gridengine-client_6.2~beta2-2_i386 bug

NAME

       qacct - report and account for Grid Engine usage

SYNOPSIS

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

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
              specified, 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
              specified, 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
              GroupId/GroupName is omitted, all groups are accounted.

       -h [HostName]
              The case-insensitive name of  the  host  upon  which  accounting
              information  is  requested.  If  the name is omitted, totals for
              each host are listed separately.

       -help  Display help information for the qacct command.

       -j [[wc_queue_name]]
              The name, a expression for matching names,  or  ID  of  the  job
              during execution for which accounting information is printed. If
              neither a name nor an ID is given all jobs are enlisted.
              This option changes the output format of  qacct.  If  activated,
              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
              statistics  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
              summarized.  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
              expression  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
              number 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
              owning department separately.

ENVIRONMENTAL VARIABLES

       GE_ROOT        Specifies the  location  of  the  Grid  Engine  standard
                      configuration files.

       GE_CELL        If  set,  specifies  the  default  Grid  Engine cell. To
                      address a Grid Engine cell qacct uses (in the  order  of
                      precedence):

                             The name of the cell specified in the environment
                             variable GE_CELL, if it is set.

                             The name of the default cell, i.e. default.

       GE_DEBUG_LEVEL If set,  specifies  that  debug  information  should  be
                      written  to  stderr.  In addition the level of detail in
                      which debug information is generated is defined.

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

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

FILES

       <ge_root>/<cell>/common/accounting
                      Grid Engine default accounting file
       <xxqs_nam_sexx_root>/<cell>/common/act_qmaster
                      Grid Engine master host file

SEE ALSO

       ge_intro(1), qsub(1), accounting(5), ge_qmaster(8),

COPYRIGHT

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