.\"Man page for condor_history .\"Generated by makeman on Thu Jan 26 17:33:07 2017 .TH condor_history 1 "January 2017" .SH Name .P condor_history View \- log of HTCondor jobs completed to date .P .SH Synopsis condor_history [-help] .P condor_history[-name name] [-pool centralmanagerhostname[:portnumber]] [-backwards] [-forwards] [-constraint expr] [-file filename] [-userlog filename] [-format formatString AttributeName] [-autoformat[:lhVr,tng] attr1 [attr2 ...]] [-l | -long | -xml] [-match | -limit number] [cluster | cluster.process | owner] .P .SH 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: .P .B ID .IP "" 3 The cluster/process id of the job. .IP "" 3 .P .B OWNER .IP "" 3 The owner of the job. .IP "" 3 .P .B SUBMITTED .IP "" 3 The month, day, hour, and minute the job was submitted to the queue. .IP "" 3 .P .B RUN_TIME .IP "" 3 Remote wall clock time accumulated by the job to date in days, hours, minutes, and seconds, given as the job ClassAd attribute RemoteWallClockTime . .IP "" 3 .P .B ST .IP "" 3 Completion status of the job (C = completed and X = removed). .IP "" 3 .P .B COMPLETED .IP "" 3 The time the job was completed. .IP "" 3 .P .B CMD .IP "" 3 The name of the executable. .IP "" 3 .P 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. .P The history file is kept in chronological order, implying that new entries are appended at the end of the file. .P .SH Options .P .B -help .IP "" 3 Display usage information and exit. .IP "" 3 .P .B -name name .IP "" 3 Query the named condor_schedddaemon. .IP "" 3 .P .B -pool centralmanagerhostname[:portnumber] .IP "" 3 Use the centralmanagerhostnameas the central manager to locate condor_schedddaemons. The default is the COLLECTOR_HOST , as specified in the configuration. .IP "" 3 .P .B -backwards .IP "" 3 List jobs in reverse chronological order. The job most recently added to the history file is first. This is the default ordering. .IP "" 3 .P .B -forwards .IP "" 3 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. .IP "" 3 .P .B -constraint expr .IP "" 3 Display jobs that satisfy the expression. .IP "" 3 .P .B -file filename .IP "" 3 Use the specified file instead of the default history file. .IP "" 3 .P .B -userlog filename .IP "" 3 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. .IP "" 3 .P .B -format formatStringAttributeName .IP "" 3 Display jobs with a custom format. See the condor_qman page -formatoption for details. .IP "" 3 .P .B -autoformat[:lhVr,tng] attr1 [attr2 ...]or -af[:lhVr,tng] attr1 [attr2 ...] .IP "" 3 (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. .IP "" 3 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: .IP "" 3 llabel each field, .IP "" 3 hprint column headings before the first line of output, .IP "" 3 Vuse %V rather than %v for formatting (string values are quoted), .IP "" 3 rprint "raw", or unevaluated values, .IP "" 3 ,add a comma character after each field, .IP "" 3 tadd a tab character before each field instead of the default space character, .IP "" 3 nadd a newline character after each field, .IP "" 3 gadd a newline character between ClassAds, and suppress spaces before each field. .IP "" 3 Use -af:hto get tabular values with headings. .IP "" 3 Use -af:lrngto get -long equivalent format. .IP "" 3 The newline and comma characters may notbe used together. The land hcharacters may notbe used together. .IP "" 3 .P .B -lor -long .IP "" 3 Display job ClassAds in long format. .IP "" 3 .P .B -limit Number .IP "" 3 Limit the number of jobs displayed to Number. Same option as -match. .IP "" 3 .P .B -match Number .IP "" 3 Limit the number of jobs displayed to Number. Same option as -limit. .IP "" 3 .P .B -xml .IP "" 3 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. .IP "" 3 .P .SH Exit Status .P condor_historywill exit with a status value of 0 (zero) upon success, and it will exit with the value 1 (one) upon failure. .P .SH Author Center for High Throughput Computing, University of Wisconsin-Madison .SH 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.