Name

       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  -fileoption, 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, given as
          the job ClassAd attribute  RemoteWallClockTime .

       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.

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 -fileand -formatoptions.

       -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 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 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_historywill 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 (C) 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.

                                                  January 2014                                 condor_history(1)