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] [-l | -long | -xml] [-match
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.
-
-lor -long
-
- Display job ClassAds in long format.
-
-match number
-
- Limit the number of jobs displayed to number.
-
-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-2014 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.