condor_history man page

condor_history View log of HTCondor jobs completed to date


condor_history [ -help ]

condor_history [ -name name ] [ -pool centralmanagerhostname[:portnumber] ] [ -backwards ] [ -forwards ] [ -constraint expr ] [ -file filename ] [ -userlog filename ] [ -format formatString AttributeName ] [ -autoformat[:tn,lVh] attr1 [attr2 ...] ] [ -l | -long | -xml ] [ -match | -limit number ] [ cluster | cluster.process | owner ]


condor_history displays a summary of all HTCondor jobs listed in the specified history files. If no history files are specified with the -file option, the local history file as specified in HTCondor'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:


The cluster/process id of the job.


The owner of the job.


The month, day, hour, and minute the job was submitted to the queue.


Remote wall clock time accumulated by the job to date in days, hours, minutes, and seconds, given as the job ClassAd attribute RemoteWallClockTime .


Completion status of the job (C = completed and X = removed).


The time the job was completed.


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.


Display usage information and exit.
-name name
Query the named condor_schedd daemon.
-pool centralmanagerhostname[:portnumber]
Use the centralmanagerhostname as the central manager to locate condor_schedd daemons. The default is the COLLECTOR_HOST , as specified in the configuration.
List jobs in reverse chronological order. The job most recently added to the history file is first. This is the default ordering.
List jobs in chronological order. The job most recently added to the history file is last. At least 4 characters must be given to distinguish this option from the -file and -format options.
-constraint expr
Display jobs that satisfy the expression.
-file filename
Use the specified file instead of the default history file.
-userlog filename
Display jobs, with job information coming from a job event log, instead of from the default history file. A job event log does not contain all of the job information, so some fields in the normal output of condor_history will be blank.
-format formatString AttributeName
Display jobs with a custom format. See the condor_q man page -format option for details.
-autoformat[:tn,lVh] attr1 [attr2 ...] or -af[:tn,lVh] attr1 [attr2 ...]
Display attribute(s) or expression(s) formatted in a default way according to attribute types. See the condor_q man page -autoformat option for details.
-l or -long
Display job ClassAds in long format.
-limit Number
Limit the number of jobs displayed to Number . Same option as -match .
-match Number
Limit the number of jobs displayed to Number . Same option as -limit .
Display job ClassAds in XML format. The XML format is fully defined in the reference manual, obtained from the ClassAds web page, with a link at http://research.cs.wisc.edu/htcondor/re….

Exit Status

condor_history will exit with a status value of 0 (zero) upon success, and it will exit with the value 1 (one) upon failure.


Center for High Throughput Computing, University of Wisconsin-Madison