SYNOPSIS
qacct [ -ar [ar_id] ] [ -A Account ] [ -b BeginTime ] [ -d Days ] [ -e
EndTime ] [ -g [GroupId|GroupName] ] [ -h [HostName] ] [ -help ] [ -j
[job_id|job_name|pattern] ] [ -l attr=val,... ] [ -o [Owner] ] [ -pe
[PEname] ] [ -q [wc_queue] ] [ -slots [SlotNumber] ] [ -t
task_id_range_list ] [ -P [Project] ] [ -D [Department] ] [ -f Acct-
FileName ]
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 speci-
fied, 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 speci-
fied, 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
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 statis-
tics 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 summa-
rized. 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 expres-
sion 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 num-
ber 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 own-
ing department separately.
ENVIRONMENTAL VARIABLES
SGE_ROOT Specifies the location of the Univa Grid Engine standard
ten to stderr. In addition the level of detail in which
debug information is generated is defined.
SGE_QMASTER_PORT
If set, specifies the tcp port on which sge_qmaster(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.
SGE_EXECD_PORT If set, specifies the tcp port on which sge_execd(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.
FILES
<sge_root>/<cell>/common/accounting
Univa Grid Engine default accounting file
<xxqs_nam_sexx_root>/<cell>/common/act_qmaster
Univa Grid Engine master host file
SEE ALSO
sge_intro(1), qsub(1), accounting(5), sge_qmaster(8),
COPYRIGHT
See sge_intro(1) for a full statement of rights and permissions.
UGE 8.0.0 $Date: 2009/02/12 14:32:28 $ QACCT(1)
Man(1) output converted with
man2html