condor_ history

View log of condor jobs completed to date

Synopsis

condor_ history [-help] [-l] [-f filename] [-completedsince postgrestimestamp] [-constraint expr | cluster | cluster.process | owner]

Description

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 ( condor/spool/history by default) is read. The default listing summarizes each job on a single line, and contains the following items:

ID

The cluster/process id of the condor 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.

Options

-help

Get a brief description of the supported options

-f filename

Use the specified file instead of the default history file

-constraint expr

Display jobs that satisfy the expression

-l

Display job ads in long format

-completedsince postgrestimestamp

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 postgres version 8.0.

Examples

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

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

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

Condor Team, University of Wisconsin-Madison

Copyright

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.7.16 Manual for additional notices.