xenial (1) condor_history.1.gz
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)