Provided by: htcondor_8.4.2~dfsg.1-1build1_amd64 bug


       condor_history View - log of HTCondor jobs completed to date


       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]


       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:


          The cluster/process id of the job.


          The owner of the job.


          The month, day, hour, and minute the job was submitted to the queue.


          Remote wall clock time accumulated by the job to date  in  days,  hours,  minutes,  and
          seconds, given as the job ClassAd attribute  RemoteWallClockTime .


          Completion status of the job (C = completed and X = removed).


          The time the job was completed.


          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

       The history file is kept in chronological order, implying that new entries are appended at
       the end of the file.



          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.


          List jobs in reverse chronological order. The job most recently added  to  the  history
          file is first. This is the default ordering.


          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

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


          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

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.


       Center for High Throughput Computing, University of Wisconsin-Madison


       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)