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)