NAME
accounting - Sun Grid Engine accounting file format
DESCRIPTION
An accounting record is written to the Sun Grid Engine accounting file
for each job having finished. The accounting file is processed by
qacct(1) to derive accounting statistics.
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:
qname
Name of the cluster queue in which the job has run.
hostname
Name of the execution host.
group
The effective group id of the job owner when executing the job.
owner
Owner of the Sun Grid Engine job.
job_name
Job name.
job_number
Job identifier - job number.
account
An account string as specified by the qsub(1) or qalter(1) -A option.
priority
Priority value assigned to the job corresponding to the priority
parameter in the queue configuration (see queue_conf(5)).
submission_time
Submission time (GMT unix time stamp).
start_time
Start time (GMT unix time stamp).
end_time
End time (GMT unix time stamp).
failed
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 Sun Grid Engine tries to start a job
multiple times, this may lead to multiple entries in the accounting
file corresponding to the same job ID.
exit_status
Exit status of the job script (or Sun Grid Engine 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.
For example: If a job dies through signal 9 (SIGKILL) then the
exit status becomes 128 + 9 = 137.
ru_wallclock
Difference between end_time and start_time (see above).
The remainder of the accounting entries follows the contents of the
standard UNIX rusage structure as described in getrusage(2). Depending
on the operating system where the job was executed some of the fields
may be 0. The following entries are provided:
ru_utime
ru_stime
ru_maxrss
ru_ixrss
ru_ismrss
ru_idrss
ru_isrss
ru_minflt
ru_majflt
ru_nswap
ru_inblock
ru_oublock
ru_msgsnd
ru_msgrcv
ru_nsignals
ru_nvcsw
ru_nivcsw
project
The project which was assigned to the job.
department
The department which was assigned to the job.
granted_pe
The parallel environment which was selected for that job.
slots
The number of slots which were dispatched to the job by the scheduler.
task_number
Array job task index number.
cpu
The cpu time usage in seconds.
mem
The integral memory usage in Gbytes cpu seconds.
io
The amount of data transferred in input/output operations.
category
A string specifying the job category.
iow
The io wait time in seconds.
pe_taskid
If this identifier is set the task was part of a parallel job and was
passed to Sun Grid Engine via the qrsh -inherit interface.
maxvmem
The maximum vmem size in bytes.
arid
Advance reservation identifier. If the job used resources of an advance
reservation then this field contains a positive integer identifier
otherwise the value is "0" .
ar_submission_time
If the job used resources of an advance reservation then this field
contains the submission time (GMT unix time stamp) of the advance
reservation, otherwise the value is "0" .
SEE ALSO
sge_intro(1), qacct(1), qalter(1), qsub(1), getrusage(2),
queue_conf(5).
COPYRIGHT
See sge_intro(1) for a full statement of rights and permissions.