condor_history(1)					      General Commands Manual						 condor_history(1)

Name
       condor_history View - log of Condor jobs completed to date

Synopsis
       condor_history [-help]

       condor_history[-backwards]  [-forwards]	[-constraint  expr] [-f filename] [-format formatString AttributeName] [-l | -long | -xml] [-match
       number] [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
       -foption,  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_idor cluster_id.proc_id) or an owneris provided, output will be restricted to jobs with the specified
       IDs and/or submitted by the specified owner. The -constraintoption 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_historymanual 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.

       -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_qman page -formatoption for details.

       -lor -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/.

Exit Status
       condor_historywill 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  (C)  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.2 Manualor http://www.condorproject.org/licensefor additional notices. condor-admin@cs.wisc.edu

								  September 2012						 condor_history(1)