This is an outdated version of the HTCondor Manual. You can find current documentation at http://htcondor.org/manual.

Next: condor_hold Up: 10. Command Reference Manual Previous: condor_glidein Contents Index

Subsections

condor_history

View log of Condor jobs completed to date

Synopsis

condor_history [-help]

condor_history [-backwards] [-forwards] [-completedsince postgrestimestamp] [-constraint expr] [-f filename] [-format formatString AttributeName] [-l | -long | -xml] [-match number] [-name schedd-name] [cluster | cluster.process | owner]

Description

condor_history displays a summary of all Condor jobs listed in the specified history files, or in the Quill database, when Quill is enabled. If no history files are specified (with the -f option) and Quill is not enabled, 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.

Options

-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.
-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.
-constraint expr: Display jobs that satisfy the expression.
-f filename: Use the specified file instead of the default history file. When Quill is enabled, this option will force the query to read from the history file, and not the database.
-format formatStringAttributeName: Display jobs with a custom format. See the condor_q man page -format option for details.
-l or -long: Display job ads in long format.
-match number: Limit the number of jobs displayed to number.
-name schedd-name: When Quill is enabled, query job ClassAds from the named condor_schedd daemon, not the default condor_schedd daemon.
-xml: Display job ClassAds in xml format. The xml format is fully defined at http://www.cs.wisc.edu/condor/classad/refman/.

Examples

To see all historical jobs since April 1, 2005 at 1pm,

%condor_history -completedsince '04/01/2005 13:00'

condor-admin@cs.wisc.edu

condor_history

Synopsis

Description

Options

Examples

Exit Status

Author

Copyright