Next: condor_ hold
Up: 9. Command Reference Manual
Previous: condor_ glidein
Contents
Index
Subsections
condor_ history
View log of Condor jobs completed to date
condor_ history
[-help]
condor_ history
[-l]
[-f filename]
[-format formatString AttributeName]
[-backwards]
[-constraint expr | cluster | cluster.process | owner |
-completedsince postgrestimestamp]
condor_ history displays a summary of all Condor jobs listed in the
specified history files.
If no history files are specified (with the -f option), the local
history file as specified in Condor's configuration file
($(SPOOL)/history by default) is read.
The default listing
summarizes (in chronological order)
each job on a single line, and contains the following items:
- ID
- The cluster/process id of the job.
- OWNER
- The owner of the job.
- SUBMITTED
- The month, day, hour, and minute the job was submitted to the queue.
- CPU_USAGE
- Remote user CPU time accumulated by the job to date in days, hours, minutes, and seconds.
- ST
- Completion status of the job (C = completed and X = removed).
- COMPLETED
- The time the job was completed.
- PRI
- User specified priority of the job, ranges from -20 to +20, with higher numbers corresponding to greater priority.
- SIZE
- The virtual image size of the executable in Megabytes.
- CMD
- The name of the executable.
If a job ID (in the form of cluster_id or cluster_id.proc_id) or an
owner is provided, output will be restricted to jobs with the
specified IDs and/or submitted by the specified owner.
The -constraint option can be used to display jobs that satisfy a
specified boolean expression.
The history file is kept in chronological order,
implying that new entries are appended at the end of the
file.
As of Condor version 6.7.19,
the format of the history file is altered to enable faster
reading of the history file backwards (most recent job first).
History files written with earlier versions of Condor,
as well as those that have entries of both
the older and newer format
need to be converted to the new format.
See the condor_ convert_history manual page
on page
for details on converting history files to the new format.
- -help
- Display usage information and exit.
- -f filename
- Use the specified file instead of the default history file.
- -backwards
- List jobs in reverse chronological
order. The job most recently added to the history file is first.
- -match number
- Limit the number of jobs displayed
to number.
- -name quill-name
- Utilize the given Quill database
for history information, instead of the history file.
- -constraint expr
- Display jobs that satisfy the
expression.
- -format formatSpecAttributeName
- Display jobs
with a custom format. See condor_ q man page for details.
- -l
- Display job ads in long format.
- -completedsince postgrestimestamp
- When Quill
is enabled, display only job
ads that were in the Completed job state on or after the date and
time given by the postgrestimestamp.
The postgrestimestamp follows the syntax as given for
PostgreSQL version 8.0. The behavior of this option
is undefined when Quill is not enabled.
To see all historical jobs since April 1, 2005 at 1pm,
%condor_history -completedsince '04/01/2005 13:00'
condor_ history will exit with a status value of 0 (zero) upon success,
and it will exit with the value 1 (one) upon failure.
Condor Team, University of Wisconsin-Madison
Copyright © 1990-2006 Condor Team, Computer Sciences Department,
University of Wisconsin-Madison, Madison, WI. All Rights Reserved.
No use of the Condor Software Program is authorized
without the express consent of the Condor Team. For more information
contact: Condor Team, Attention: Professor Miron Livny,
7367 Computer Sciences, 1210 W. Dayton St., Madison, WI 53706-1685,
(608) 262-0856 or miron@cs.wisc.edu.
U.S. Government Rights Restrictions: Use, duplication, or disclosure
by the U.S. Government is subject to restrictions as set forth in
subparagraph (c)(1)(ii) of The Rights in Technical Data and Computer
Software clause at DFARS 252.227-7013 or subparagraphs (c)(1) and
(2) of Commercial Computer Software-Restricted Rights at 48 CFR
52.227-19, as applicable, Condor Team, Attention: Professor Miron
Livny, 7367 Computer Sciences, 1210 W. Dayton St., Madison,
WI 53706-1685, (608) 262-0856 or miron@cs.wisc.edu.
See the Condor Version 6.8.3 Manual for
additional notices.
Next: condor_ hold
Up: 9. Command Reference Manual
Previous: condor_ glidein
Contents
Index
condor-admin@cs.wisc.edu