Name¶
condor_history View - log of Condor jobs completed to date
Synopsis¶
condor_history [-help]
condor_history[-backwards] [-forwards] [-constraint expr] [-f filename] [-format
formatString AttributeName] [-l | -long | -xml] [-match number] [cluster |
cluster.process | owner]
Description¶
condor_history displays a summary of all Condor jobs listed in the specified
history files. If no history files are specified with the -foption, the local
history file as specified in Condor'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 .
-
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.
-
-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.
-
-constraint expr
-
- Display jobs that satisfy the expression.
-
-f filename
-
- Use the specified file instead of the default history
file.
-
-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 at http://www.cs.wisc.edu/condor/classad/refman/.
-
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¶
Condor Team, University of Wisconsin-Madison
Copyright¶
Copyright (C) 1990-2012 Condor Team, Computer Sciences Department, University of
Wisconsin-Madison, Madison, WI. All Rights Reserved. Licensed under the Apache
License, Version 2.0.
See the Condor Version 7.8.2 Manualor
http://www.condorproject.org/licensefor
additional notices. condor-admin@cs.wisc.edu