Name

       condor_history View - log of HTCondor jobs completed to date

Synopsis

       condor_history [-help]

       condor_history[-name   name]   [-pool   centralmanagerhostname[:portnumber]]  [-backwards]
       [-forwards] [-constraint expr] [-file filename] [-userlog filename] [-format  formatString
       AttributeName]  [-autoformat[:tn,lVh]  attr1  [attr2  ...]]  [-l | -long | -xml] [-match |
       -limit 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.

       -name name

          Query the named condor_schedddaemon.

       -pool centralmanagerhostname[:portnumber]

          Use  the  centralmanagerhostnameas  the central manager to locate condor_schedddaemons.
          The default is the  COLLECTOR_HOST , as specified in the configuration.

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

       -autoformat[:tn,lVh] attr1 [attr2 ...]or -af[:tn,lVh] attr1 [attr2 ...]

          Display attribute(s) or expression(s) formatted in a default way according to attribute
          types. See the condor_qman page -autoformatoption for details.

       -lor -long

          Display job ClassAds in long format.

       -limit Number

          Limit the number of jobs displayed to Number. Same option as -match.

       -match Number

          Limit the number of jobs displayed to Number. Same option as -limit.

       -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-2015  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.

                                          February 2016                         condor_history(1)