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 [wc_job] [22m] [  [1m-l[0m
       [1mattr=val,...   [22m]  [  [1m-o  [Owner] [22m] [ [1m-pe [PEname] [22m] [ [1m-q [wc_queue] [22m] [
       [1m-slots [SlotNumber] [22m] [ [1m-t task_id_range_list [22m] [ [1m-P [Project] [22m]  [  [1m-D[0m
       [1m[Department] [22m] [ [1m-f [4m[22mAcctFileName[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 category
       are permitted. Alternatively, all or specific jobs can be  listed  with
       the [1m-j [22mswitch.  For example the search criteria could include summariz-
       ing 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[[[1mwc_queue_name[22m]]
              The name, a expression for matching names, or ID of the job dur-
              ing  execution  for  which accounting information is printed. If
              neither a name nor an ID is given all jobs are listed.
              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[[1mwc_queue_name[22m]
              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.

       [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 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/$SGE_CELL/common/accounting[0m
                      Grid Engine default accounting file
       [4m$SGE_ROOT/$SGE_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.1                   $Date: 2007/06/26 22:21:09 $                 QACCT(1)
