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 [[wwcc__jjoobb]] ] [  --ll
       aattttrr==vvaall,,......   ]  [  --oo  [[OOwwnneerr]] ] [ --ppee [[PPEEnnaammee]] ] [ --qq [[wwcc__qquueeuuee]] ] [
       --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 category
       are permitted. Alternatively, all or specific jobs can be  listed  with
       the --jj switch.  For example the search criteria could include summariz-
       ing 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 [[wwcc__qquueeuuee__nnaammee]]
              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  _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 [wwcc__qquueeuuee__nnaammee]
              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.

       --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 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_/_$_S_G_E___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
       _$_S_G_E___R_O_O_T_/_$_S_G_E___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.1                   $Date: 2007/06/26 22:21:09 $                 QACCT(1)
