File: accounting.5

package info (click to toggle)
gridengine 6.2-4
  • links: PTS, VCS
  • area: main
  • in suites: lenny
  • size: 51,532 kB
  • ctags: 51,172
  • sloc: ansic: 418,155; java: 37,080; sh: 22,593; jsp: 7,699; makefile: 5,292; csh: 4,244; xml: 2,901; cpp: 2,086; perl: 1,895; tcl: 1,188; lisp: 669; ruby: 642; yacc: 393; lex: 266
file content (172 lines) | stat: -rw-r--r-- 4,702 bytes parent folder | download
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
'\" t
.\"___INFO__MARK_BEGIN__
.\"
.\" Copyright: 2004 by Sun Microsystems, Inc.
.\"
.\"___INFO__MARK_END__
.\" $RCSfile$     Last Update: $Date$     Revision: $Revision$
.\"
.\"
.\" Some handy macro definitions [from Tom Christensen's man(1) manual page].
.\"
.de SB		\" small and bold
.if !"\\$1"" \\s-2\\fB\&\\$1\\s0\\fR\\$2 \\$3 \\$4 \\$5
..
.\"
.de T		\" switch to typewriter font
.ft CW		\" probably want CW if you don't have TA font
..
.\"
.de TY		\" put $1 in typewriter font
.if t .T
.if n ``\c
\\$1\c
.if t .ft P
.if n \&''\c
\\$2
..
.\"
.de M		\" man page reference
\\fI\\$1\\fR\\|(\\$2)\\$3
..
.TH ACCOUNTING 5 "$Date$" "xxRELxx" "xxQS_NAMExx File Formats"
.\"
.SH NAME
accounting \- xxQS_NAMExx accounting file format
.\"
.SH DESCRIPTION
An accounting record is written to the xxQS_NAMExx
accounting file for each job having finished. The accounting file is
processed by
.M qacct 1
to derive accounting statistics.
.\"
.\"
.SH FORMAT
Each job is represented by a line in the accounting file. Empty lines
and lines which contain one character or less are ignored.
Accounting record entries are
separated by colon (':') signs. The entries denote in their order
of appearance:
.SS "\fBqname\fP"
Name of the cluster queue in which the job has run.
.SS "\fBhostname\fP"
Name of the execution host.
.SS "\fBgroup\fP"
The effective group id of the job owner when executing the job.
.SS "\fBowner\fP"
Owner of the xxQS_NAMExx job.
.SS "\fBjob_name\fP"
Job name.
.SS "\fBjob_number\fP"
Job identifier - job number.
.SS "\fBaccount\fP"
An account string as specified by the
.M qsub 1
or
.M qalter 1
\fB\-A\fP option.
.IP "\fBpriority\fP"
Priority value assigned to the job corresponding to the \fBpriority\fP
parameter in the queue configuration (see
.M queue_conf 5 ).
.SS "\fBsubmission_time\fP"
Submission time (GMT unix time stamp).
.SS "\fBstart_time\fP"
Start time (GMT unix time stamp).
.SS "\fBend_time\fP"
End time (GMT unix time stamp).
.SS "\fBfailed\fP"
Indicates the problem which occurred in case a job could not be started on 
the execution host (e.g. because the owner of the job did not have a valid 
account on that machine). If xxQS_NAMExx tries to start a job multiple times, 
this may lead to multiple entries in the accounting file corresponding to 
the same job ID.
.SS "\fBexit_status\fP"
Exit status of the job script (or xxQS_NAMExx specific status in case
of certain error conditions).
The exit status is determined by following the normal shell conventions.
If the command terminates normally the value of the command is its exit status.
However, in the case that the command exits abnormally, a value of 0200 (octal), 
128 (decimal) is added to the value of the command to make up the exit status.
.P
.RS
For example: If a job dies through signal 9 (SIGKILL) then the exit status 
becomes 128 + 9 = 137.
.RE
.SS "\fBru_wallclock\fP"
Difference between \fBend_time\fP and \fBstart_time\fP (see above).
.PP
The remainder of the accounting entries follows the contents of the
standard UNIX rusage structure as described in
.M getrusage 2 .
Depending on the operating system where the job was executed some of the
fields may be 0.  The following entries are provided:
.PP
.nf
.RS
.B ru_utime
.B ru_stime
.B ru_maxrss
.B ru_ixrss
.B ru_ismrss
.B ru_idrss
.B ru_isrss
.B ru_minflt
.B ru_majflt
.B ru_nswap
.B ru_inblock
.B ru_oublock
.B ru_msgsnd
.B ru_msgrcv
.B ru_nsignals
.B ru_nvcsw
.B ru_nivcsw
.RE
.fi
.PP

.SS "\fBproject\fP"
The project which was assigned to the job.
.SS "\fBdepartment\fP"
The department which was assigned to the job.
.SS "\fBgranted_pe\fP"
The parallel environment which was selected for that job.
.SS "\fBslots\fP"
The number of slots which were dispatched to the job by the scheduler.
.SS "\fBtask_number\fP"
Array job task index number.
.SS "\fBcpu\fP"
The cpu time usage in seconds. 
.SS "\fBmem\fP"
The integral memory usage in Gbytes cpu seconds. 
.SS "\fBio\fP"
The amount of data transferred in input/output operations.
.SS "\fBcategory\fP"
A string specifying the job category.
.SS "\fBiow\fP"
The io wait time in seconds.
.SS "\fBpe_taskid\fP"
If this identifier is set the task was part of a parallel job and was 
passed to xxQS_NAMExx via the qrsh -inherit interface.
.SS "\fBmaxvmem\fP"
The maximum vmem size in bytes.
.SS "\fBarid\fP"
Advance reservation identifier. If the job used resources of an advance
reservation then this field contains a positive integer identifier otherwise the
value is "\fB0\fP" .
.fi
.\"
.\"
.SH "SEE ALSO"
.M xxqs_name_sxx_intro 1 ,
.M qacct 1 ,
.M qalter 1 ,
.M qsub 1 ,
.M getrusage 2 ,
.M queue_conf 5 .
.\"
.SH "COPYRIGHT"
See
.M xxqs_name_sxx_intro 1
for a full statement of rights and permissions.