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



NNAAMMEE
       qacct - report and account for Grid Engine usage

SSYYNNOOPPSSIISS
       qqaacccctt  [  --AA AAccccoouunntt ] [ --bb BBeeggiinnTTiimmee ] [ --dd DDaayyss ] [ --ee EEnnddTTiimmee ] [ --gg
       [[GGrroouuppIIdd||GGrroouuppNNaammee]] ] [ --hh [[HHoossttNNaammee]] ] [  --hheellpp  ]  [  --jj  [[JJoobbIIdd||JJoobb--
       NNaammee||ppaatttteerrnn]]  ] [ --ll aattttrr==vvaall,,......  ] [ --oo [[OOwwnneerr]] ] [ --ppee [[PPEEnnaammee]] ] [
       --qq [[CCQQ__nnaammee||QQII__nnaammee||QQ__ddoommaaiinn||ppaatttteerrnn]] ] [ --sslloottss [[SSlloottNNuummbbeerr]]  ]  [  --tt
       ttaasskk__iidd__rraannggee__lliisstt  ]  [  --PP [[PPrroojjeecctt]] ] [ --DD [[DDeeppaarrttmmeenntt]] ] [ --ff _A_c_c_t_-
       _F_i_l_e_N_a_m_e ]

DDEESSCCRRIIPPTTIIOONN
       The _q_a_c_c_t utility scans the accounting data  file  (see  _a_c_c_o_u_n_t_i_n_g(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 --ll  switch.   Combinations  of  each
       category  are  permitted.  Alternatively,  all  or specific jobs can be
       listed with the --jj switch.   For  example  the  search  criteria  could
       include summarizing for a queue and an owner, but not for two queues in
       the same request.

OOPPTTIIOONNSS
       --AA AAccccoouunntt
              The account for jobs to be summarized.

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

       --dd DDaayyss
              The number of days to summarize and print accounting information
              on.  If  used together with the --bb BBeeggiinnTTiimmee option (see above),
              jobs started within BBeeggiinnTTiimmee to BBeeggiinnTTiimmee + DDaayyss  are  counted.
              If  used  together with the --ee EEnnddTTiimmee (see below) option, count
              starts at EEnnddTTiimmee - DDaayyss.

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

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

       --gg [GGrroouuppIIdd|GGrroouuppNNaammee]
              The  numeric  system  group id or the group alphanumeric name of
              the  job  owners  to  be  included   in   the   accounting.   If
              GGrroouuppIIdd/GGrroouuppNNaammee is omitted, all groups are accounted.

       --hh [HHoossttNNaammee]
              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.

       --hheellpp  Display help information for the _q_a_c_c_t command.

       --jj [[JJoobbNNaammee|JJoobbIIdd|ppaatttteerrnn]]
              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 _q_a_c_c_t. If activated,
              CPU times are no longer accumulated  but  the  "raw"  accounting
              information  is  printed  in  a  formatted  form  instead.   See
              _a_c_c_o_u_n_t_i_n_g(5) for an explanation of the displayed information.

       --ll aattttrr==vvaall,,......
              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
              _q_s_u_b(1).

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

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

       --qq [CCQQ__nnaammee||QQII__nnaammee||QQ__ddoommaaiinn||ppaatttteerrnn]
              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.

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

       --tt ttaasskk__iidd__rraannggee__lliisstt
              Only available together with the --jj option described above.

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

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

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

EENNVVIIRROONNMMEENNTTAALL VVAARRIIAABBLLEESS
       SSGGEE__RROOOOTT       Specifies the location of the Grid Engine standard  con-
                      figuration files.

       SSGGEE__CCEELLLL       If  set,  specifies  the  default  Grid  Engine cell. To
                      address a Grid Engine cell _q_a_c_c_t 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. ddeeffaauulltt.


       SSGGEE__DDEEBBUUGG__LLEEVVEELL
                      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.

       SSGGEE__QQMMAASSTTEERR__PPOORRTT
                      If set, specifies the tcp port on  which  _s_g_e___q_m_a_s_t_e_r(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.

       SSGGEE__EEXXEECCDD__PPOORRTT If  set, specifies the tcp port on which _s_g_e___e_x_e_c_d(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.

FFIILLEESS
       _<_s_g_e___r_o_o_t_>_/_<_c_e_l_l_>_/_c_o_m_m_o_n_/_a_c_c_o_u_n_t_i_n_g
                       Grid Engine default accounting file
       _<_x_x_q_s___n_a_m___s_e_x_x___r_o_o_t_>_/_<_c_e_l_l_>_/_c_o_m_m_o_n_/_a_c_t___q_m_a_s_t_e_r
                       Grid Engine master host file

SSEEEE AALLSSOO
       _s_g_e___i_n_t_r_o(1), _q_s_u_b(1), _a_c_c_o_u_n_t_i_n_g(5), _s_g_e___q_m_a_s_t_e_r(8),

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



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