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)