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[:jlhVr,tng]  attr1  [attr2  ...]]  [-l |-long |-xml |-json] [-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)/historyby 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.  As of Condor version 6.7.19, the format of the history file is altered to enable faster reading of
       the history file backwards (most recent job first).  History  files  written  with  earlier  versions  of
       Condor, as well as those that have entries of both the older and newer format need to be converted to the
       new format. See the condor_convert_historymanual page on page for details on converting history files  to
       the new format.

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.

       -attributes attrs

          Display only the given attributes when the -long option is used.

       -since jobid or expr

          Stop scanning when the given jobid is found or when the expression becomes true.

       -local #80032#>

          Read from local history files even if there is a SCHEDD_HOSTconfigured.

       -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[:jlhVr,tng] attr1 [attr2 ...]or -af[:jlhVr,tng] attr1 [attr2 ...]

          (output option) Display attribute(s)  or  expression(s)  formatted  in  a  default  way  according  to
          attribute types. This option takes an arbitrary number of attribute names as arguments, and prints out
          their values, with a space between each value and a newline character after the last value. It is like
          the -formatoption without format strings.

          It  is  assumed that no attribute names begin with a dash character, so that the next word that begins
          with dash is the start of the next option. The autoformatoption may be followed by a  colon  character
          and formatting qualifiers to deviate the output formatting from the default:

          jprint the job ID as the first field,

          llabel each field,

          hprint column headings before the first line of output,

          Vuse %V rather than %v for formatting (string values are quoted),

          rprint "raw", or unevaluated values,

          ,add a comma character after each field,

          tadd a tab character before each field instead of the default space character,

          nadd a newline character after each field,

          gadd a newline character between ClassAds, and suppress spaces before each field.

          Use -af:hto get tabular values with headings.

          Use -af:lrngto get -long equivalent format.

          The  newline  and  comma  characters  may  notbe  used  together.  The land hcharacters may notbe used
          together.

       -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://htcondor.org/classad/classad.html.

       -json

          Display job ClassAds in JSON format.

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 © 1990-2016 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 2020                                 condor_history(1)