1QACCT(1) Grid Engine User Commands QACCT(1)
2
6 qacct - report and account for Grid Engine usage
7
9 qacct [ -A Account ] [ -b BeginTime ] [ -d Days ] [ -e EndTime ] [ -g
10 [GroupId|GroupName] ] [ -h [HostName] ] [ -help ] [ -j [wc_job] ] [ -l
11 attr=val,... ] [ -o [Owner] ] [ -pe [PEname] ] [ -q [wc_queue] ] [
12 -slots [SlotNumber] ] [ -t task_id_range_list ] [ -P [Project] ] [ -D
13 [Department] ] [ -f AcctFileName ]
14
16 The qacct utility scans the accounting data file (see accounting(5))
17 and produces a summary of information for wall-clock time, cpu-time,
18 and system time for the categories of hostname, queue-name, group-name,
19 owner-name, job-name, job-ID and for the queues meeting the resource
20 requirements as specified with the -l switch. Combinations of category
21 are permitted. Alternatively, all or specific jobs can be listed with
22 the -j switch. For example the search criteria could include summariz‐
23 ing for a queue and an owner, but not for two queues in the same
24 request.
25
27 -A Account
28 The account for jobs to be summarized.
29 -b BeginTime
31 The earliest start time for jobs to be summarized, in the format
32 [[CC]YY]MMDDhhmm[.SS]. See also -d option. If CC is not speci‐
33 fied, a YY of < 70 means 20YY.
34 -d Days
36 The number of days to summarize and print accounting information
37 on. If used together with the -b BeginTime option (see above),
38 jobs started within BeginTime to BeginTime + Days are counted.
39 If used together with the -e EndTime (see below) option, count
40 starts at EndTime - Days.
41 -e EndTime
43 The latest start time for jobs to be summarized, in the format
44 [[CC]YY]MMDDhhmm[.SS]. See also -d option. If CC is not speci‐
45 fied, a YY of < 70 means 20YY.
46 [-f AcctFileName]
48 The accounting file to be used. If omitted, the system default
49 accounting file is processed.
50 -g [GroupId|GroupName]
52 The numeric system group id or the group alphanumeric name of
53 the job owners to be included in the accounting. If
54 GroupId/GroupName is omitted, all groups are accounted.
55 -h [HostName]
57 The case-insensitive name of the host upon which accounting
58 information is requested. If the name is omitted, totals for
59 each host are listed separately.
60 -help Display help information for the qacct command.
62 -j [[wc_queue_name]]
64 The name, a expression for matching names, or ID of the job dur‐
65 ing execution for which accounting information is printed. If
66 neither a name nor an ID is given all jobs are listed.
67 This option changes the output format of qacct. If activated,
68 CPU times are no longer accumulated but the "raw" accounting
69 information is printed in a formatted form instead. See
70 accounting(5) for an explanation of the displayed information.
71 -l attr=val,...
73 A resource requirement specification which must be met by the
74 queues in which the jobs being accounted were executing. The
75 resource request is very similar to the one described in
76 qsub(1).
77 -o [Owner]
79 The name of the owner of the jobs for which accounting statis‐
80 tics are assembled. If the optional Owner argument is omitted, a
81 listing of the accounting statistics of all job owners being
82 present in the accounting file is produced.
83 -pe [PEname]
85 The name of the parallel environment for which usage is summa‐
86 rized. If PEname is not given, accounting data is listed for
87 each parallel environment separately.
88 -q [wc_queue_name]
90 A expression for queues for which usage is summarized. All queue
91 instances matching the expression will be listed. If no expres‐
92 sion is specified, a cluster queue summary will be given.
93 -slots [SlotNumber]
95 The number of queue slots for which usage is summarized. If
96 SlotNumber is not given, accounting data is listed for each num‐
97 ber of queue slots separately.
98 -t task_id_range_list
100 Only available together with the -j option described above.
101 The -t switch specifies the array job task range, for which
103 accounting information should be printed. Syntax and semantics
104 of task_id_range_list are identical to that one described under
105 the -t option to qsub(1). Please see there also for further
106 information on array jobs.
107 -P [Project]
109 The name of the project for which usage is summarized. If
110 Project is not given, accounting data is listed for each project
111 separately.
112 -D [Department]
114 The name of the department for which usage is summarized. If
115 Department is not given, accounting data is listed for each own‐
116 ing department separately.
117
119 SGE_ROOT Specifies the location of the Grid Engine standard con‐
120 figuration files.
121 SGE_CELL If set, specifies the default Grid Engine cell. To
123 address a Grid Engine cell qacct uses (in the order of
124 precedence):
125 The name of the cell specified in the environment
127 variable SGE_CELL, if it is set.
128 The name of the default cell, i.e. default.
130 SGE_DEBUG_LEVEL
133 If set, specifies that debug information should be writ‐
134 ten to stderr. In addition the level of detail in which
135 debug information is generated is defined.
136 SGE_QMASTER_PORT
138 If set, specifies the tcp port on which sge_qmaster(8)
139 is expected to listen for communication requests. Most
140 installations will use a services map entry for the ser‐
141 vice "sge_qmaster" instead to define that port.
142 SGE_EXECD_PORT If set, specifies the tcp port on which sge_execd(8) is
144 expected to listen for communication requests. Most
145 installations will use a services map entry for the ser‐
146 vice "sge_execd" instead to define that port.
147
149 $SGE_ROOT/$SGE_CELL/common/accounting
150 Grid Engine default accounting file
151 $SGE_ROOT/$SGE_CELL/common/act_qmaster
152 Grid Engine master host file
153
155 sge_intro(1), qsub(1), accounting(5), sge_qmaster(8),
156
158 See sge_intro(1) for a full statement of rights and permissions.
159GE 6.1 $Date: 2007/06/26 22:21:09 $ QACCT(1)