next up previous contents index
Next: condor_hold Up: 11. Command Reference Manual Previous: condor_gather_info   Contents   Index

Subsections


condor_history

View log of HTCondor jobs completed to date

Synopsis

condor_history [-help]

condor_history [-backwards] [-forwards] [-constraint expr] [-file filename] [-userlog filename] [-format formatString AttributeName] [-l | -long | -xml] [-match number] [cluster | cluster.process | owner]

Description

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:

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.

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. 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 user log, instead of from the default history file. A user log does not contain all of the job information, so some fields in the normal output of condor_history will be blank.
-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 in the reference manual, obtained from the ClassAds web page, with a link at http://research.cs.wisc.edu/htcondor/research.html.

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.

Author

Center for High Throughput Computing, University of Wisconsin-Madison

Copyright

Copyright © 1990-2013 Center for High Throughput Computing, Computer Sciences Department, University of Wisconsin-Madison, Madison, WI. All Rights Reserved. Licensed under the Apache License, Version 2.0.

See the HTCondor Version 7.9.6 Manual or http://research.cs.wisc.edu/htcondor/ for additional notices.


next up previous contents index
Next: condor_hold Up: 11. Command Reference Manual Previous: condor_gather_info   Contents   Index
htcondor-admin@cs.wisc.edu