QACCT(1)                   Grid Engine User Commands                  QACCT(1)



[1mNAME[0m
       qacct - report and account for Grid Engine usage

[1mSYNOPSIS[0m
       [1mqacct  [22m[  [1m-A Account [22m] [ [1m-b BeginTime [22m] [ [1m-d Days [22m] [ [1m-e EndTime [22m] [ [1m-g[0m
       [1m[GroupId|GroupName] [22m] [ [1m-h [HostName] [22m] [  [1m-help  [22m]  [  [1m-j  [JobId|Job-[0m
       [1mName|pattern]  [22m] [ [1m-l attr=val,...  [22m] [ [1m-o [Owner] [22m] [ [1m-pe [PEname] [22m] [
       [1m-q [CQ_name|QI_name|Q_domain|pattern] [22m] [ [1m-slots [SlotNumber]  [22m]  [  [1m-t[0m
       [1mtask_id_range_list  [22m]  [  [1m-P [Project] [22m] [ [1m-D [Department] [22m] [ [1m-f [4m[22mAcct-[0m
       [4mFileName[24m ]

[1mDESCRIPTION[0m
       The [4mqacct[24m utility scans the accounting data  file  (see  [4maccounting[24m(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 [1m-l  [22mswitch.   Combinations  of  each
       category  are  permitted.  Alternatively,  all  or specific jobs can be
       listed with the [1m-j [22mswitch.   For  example  the  search  criteria  could
       include summarizing for a queue and an owner, but not for two queues in
       the same request.

[1mOPTIONS[0m
       [1m-A Account[0m
              The account for jobs to be summarized.

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

       [1m-d Days[0m
              The number of days to summarize and print accounting information
              on.  If  used together with the [1m-b BeginTime [22moption (see above),
              jobs started within [1mBeginTime [22mto [1mBeginTime [22m+ [1mDays  [22mare  counted.
              If  used  together with the [1m-e EndTime [22m(see below) option, count
              starts at [1mEndTime [22m- [1mDays[22m.

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

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

       [1m-g [22m[[1mGroupId[22m|[1mGroupName[22m]
              The  numeric  system  group id or the group alphanumeric name of
              the  job  owners  to  be  included   in   the   accounting.   If
              [1mGroupId[22m/[1mGroupName [22mis omitted, all groups are accounted.

       [1m-h [22m[[1mHostName[22m]
              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.

       [1m-help  [22mDisplay help information for the [4mqacct[24m command.

       [1m-j [22m[[[1mJobName[22m|[1mJobId[22m|[1mpattern[22m]]
              The  name, a pattern for matching names, or ID of the job during
              execution for which accounting information is printed.  If  nei-
              ther a name nor an ID is given all jobs are enlisted.
              This  option  changes  the output format of [4mqacct[24m. If activated,
              CPU times are no longer accumulated  but  the  "raw"  accounting
              information  is  printed  in  a  formatted  form  instead.   See
              [4maccounting[24m(5) for an explanation of the displayed information.

       [1m-l attr=val,...[0m
              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
              [4mqsub[24m(1).

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

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

       [1m-q [22m[[1mCQ_name|QI_name|Q_domain|pattern[22m]
              A pattern for queues for which usage is  summarized.  All  queue
              instances  matching the pattern will be listed. If no pattern is
              specified, a cluster queue summary will be given.

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

       [1m-t task_id_range_list[0m
              Only available together with the [1m-j [22moption described above.

              The [1m-t [22mswitch specifies the array  job  task  range,  for  which
              accounting  information  should be printed. Syntax and semantics
              of [1mtask_id_range_list [22mare identical to that one described  under
              the  [1m-t  [22moption  to  [4mqsub[24m(1).  Please see there also for further
              information on array jobs.

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

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

[1mENVIRONMENTAL VARIABLES[0m
       [1mSGE_ROOT       [22mSpecifies the location of the Grid Engine standard  con-
                      figuration files.

       [1mSGE_CELL       [22mIf  set,  specifies  the  default  Grid  Engine cell. To
                      address a Grid Engine cell [4mqacct[24m uses (in the  order  of
                      precedence):

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

                             The name of the default cell, i.e. [1mdefault[22m.


       [1mSGE_DEBUG_LEVEL[0m
                      If set, specifies that debug information should be writ-
                      ten  to stderr. In addition the level of detail in which
                      debug information is generated is defined.

       [1mSGE_QMASTER_PORT[0m
                      If set, specifies the tcp port on  which  [4msge_qmaster[24m(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.

       [1mSGE_EXECD_PORT [22mIf  set, specifies the tcp port on which [4msge_execd[24m(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.

[1mFILES[0m
       [4m<sge_root>/<cell>/common/accounting[0m
                       Grid Engine default accounting file
       [4m<xxqs_nam_sexx_root>/<cell>/common/act_qmaster[0m
                       Grid Engine master host file

[1mSEE ALSO[0m
       [4msge_intro[24m(1), [4mqsub[24m(1), [4maccounting[24m(5), [4msge_qmaster[24m(8),

[1mCOPYRIGHT[0m
       See [4msge_intro[24m(1) for a full statement of rights and permissions.



GE 6.0                   $Date: 2007/01/05 20:31:03 $                 QACCT(1)
