1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
|
<HTML>
<BODY BGCOLOR=white>
<PRE>
<!-- Manpage converted by man2html 3.0.1 -->
NAME
qacct - report and account for Grid Engine usage
SYNOPSIS
qacct [ -A Account ] [ -b BeginTime ] [ -d Days ] [ -e End-
Time ] [ -g [GroupId|GroupName] ] [ -h [HostName] ] [ -help
] [ -j [wc_job] ] [ -l attr=val,... ] [ -o [Owner] ] [ -pe
[PEname] ] [ -q [wc_queue] ] [ -slots [SlotNumber] ] [ -t
task_id_range_list ] [ -P [Project] ] [ -D [Department] ] [
-f <I>AcctFileName</I> ]
DESCRIPTION
The <I>qacct</I> utility scans the accounting data file (see
<B><A HREF="../htmlman5/accounting.html">accounting(5)</A></B>) 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
-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 specified, 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 specified, 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 GroupId/GroupName is omitted, all groups
are accounted.
-h [HostName]
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.
-help
Display help information for the <I>qacct</I> command.
-j [[wc_queue_name]]
The name, a expression for matching names, or ID of the
job during execution for which accounting information
is printed. If neither a name nor an ID is given all
jobs are enlisted.
This option changes the output format of <I>qacct</I>. If
activated, CPU times are no longer accumulated but the
"raw" accounting information is printed in a formatted
form instead. See <B><A HREF="../htmlman5/accounting.html">accounting(5)</A></B> 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 <B><A HREF="../htmlman1/qsub.html">qsub(1)</A></B>.
-o [Owner]
The name of the owner of the jobs for which accounting
statistics are assembled. If the optional Owner argu-
ment 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
summarized. 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 expression is specified, a cluster queue
summary will be given.
-slots [SlotNumber]
The number of queue slots for which usage is summar-
ized. If SlotNumber is not given, accounting data is
listed for each number 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 <B><A HREF="../htmlman1/qsub.html">qsub(1)</A></B>.
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 summar-
ized. If Department is not given, accounting data is
listed for each owning department separately.
ENVIRONMENTAL VARIABLES
SGE_ROOT Specifies the location of the Grid Engine
standard configuration files.
SGE_CELL If set, specifies the default Grid Engine
cell. To address a Grid Engine cell <I>qacct</I>
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.
default.
SGE_DEBUG_LEVEL
If set, specifies that debug information
should be written 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
<B><A HREF="../htmlman8/sge_qmaster.html">sge_qmaster(8)</A></B> is expected to listen for com-
munication requests. Most installations will
use a services map entry for the service
"sge_qmaster" instead to define that port.
SGE_EXECD_PORT If set, specifies the tcp port on which
<B><A HREF="../htmlman8/sge_execd.html">sge_execd(8)</A></B> is expected to listen for com-
munication requests. Most installations will
use a services map entry for the service
"sge_execd" instead to define that port.
FILES
<<I>sge</I>_<I>root</I>>/<<I>cell</I>>/<I>common</I>/<I>accounting</I>
Grid Engine default accounting file
<<I>xxqs</I>_<I>nam</I>_<I>sexx</I>_<I>root</I>>/<<I>cell</I>>/<I>common</I>/<I>act</I>_<I>qmaster</I>
Grid Engine master host file
SEE ALSO
<B><A HREF="../htmlman1/sge_intro.html">sge_intro(1)</A></B>, <B><A HREF="../htmlman1/qsub.html">qsub(1)</A></B>, <B><A HREF="../htmlman5/accounting.html">accounting(5)</A></B>, <B><A HREF="../htmlman8/sge_qmaster.html">sge_qmaster(8)</A></B>,
COPYRIGHT
See <B><A HREF="../htmlman1/sge_intro.html">sge_intro(1)</A></B> for a full statement of rights and permis-
sions.
</PRE>
<HR>
<ADDRESS>
Man(1) output converted with
<a href="http://www.oac.uci.edu/indiv/ehood/man2html.html">man2html</a>
</ADDRESS>
</BODY>
</HTML>
|
