Next: condor_hold
Up: 11. Command Reference Manual
Previous: condor_gather_info
Contents
Index
Subsections
condor_history
View log of HTCondor jobs completed to date
condor_history
[-help]
condor_history
[-backwards]
[-forwards]
[-constraint expr]
[-file filename]
[-userlog filename]
[-format formatString AttributeName]
[-l | -long | -xml]
[-match number]
[cluster | cluster.process | owner]
condor_history displays a summary of all HTCondor jobs listed in the
specified history files.
If no history files are specified with the -file option,
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. See the definition of
RemoteWallClockTime on page
![[*]](crossref.png)
.
- 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_id or cluster_id.proc_id) or an
owner is provided, output will be restricted to jobs with the
specified IDs and/or submitted by the specified owner.
The -constraint option 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.
- -help
- Display usage information and exit.
- -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 -file and -format options.
- -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 user log,
instead of from the default history file.
A user 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_q man page -format option
for details.
- -l or -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.
condor_history will exit with a status value of 0 (zero) upon success,
and it will exit with the value 1 (one) upon failure.
Center for High Throughput Computing, University of Wisconsin-Madison
Copyright © 1990-2013 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.
See the HTCondor Version 7.9.6 Manual or
http://research.cs.wisc.edu/htcondor/
for
additional notices.
Next: condor_hold
Up: 11. Command Reference Manual
Previous: condor_gather_info
Contents
Index
htcondor-admin@cs.wisc.edu