Subsections
condor_history
View log of Condor jobs completed to date
condor_history
[-help]
condor_history
[-backwards]
[-forwards]
[-constraint expr]
[-f filename]
[-format formatString AttributeName]
[-l | -long | -xml]
[-match number]
[cluster | cluster.process | owner]
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 reverse 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.
- RUN_TIME
- Remote wall clock time accumulated by the job to date in days, hours, minutes, and seconds. See the definition of
RemoteWallClockTime on page
.
- ST
- Completion status of the job (C = completed and X = removed).
- COMPLETED
- The time the job was completed.
- 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.
- -backwards
- List jobs in reverse chronological
order. The job most recently added to the history file is first.
This is the default ordering.
- -forwards
- List jobs in chronological
order. The job most recently added to the history file is last.
- -constraint expr
- Display jobs that satisfy the
expression.
- -f filename
- Use the specified file instead of the
default history file.
- -format formatStringAttributeName
- Display jobs
with a custom format. See the condor_q man page -format option
for details.
- -l or -long
- Display job ClassAds in long format.
- -match number
- Limit the number of jobs displayed
to number.
- -xml
- Display job ClassAds in xml format.
The xml format is fully defined at
http://www.cs.wisc.edu/condor/classad/refman/.
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-2012 Condor Team, Computer Sciences Department,
University of Wisconsin-Madison, Madison, WI. All Rights Reserved.
Licensed under the Apache License, Version 2.0.
See the Condor Version 7.8.1 Manual or
http://www.condorproject.org/license
for
additional notices.
condor-admin@cs.wisc.edu