1just-man-pages/condor_historyG(e1n)eral Commands Majnuusatl-man-pages/condor_history(1)
2
3
4

Name

6       condor_history View log of Condor jobs completed to date
7

Synopsis

9       condor_history [ -help ]
10
11       condor_history  [  -backwards ] [ -completedsince postgrestimestamp ] [
12       -constraint expr ] [ -f filename ] [ -format formatString AttributeName
13       ] [ -l | -long | -xml ] [ -match number ] [ -name schedd-name ] [ clus‐
14       ter | cluster.process | owner ]
15

Description

17       condor_history displays a summary of all  Condor  jobs  listed  in  the
18       specified  history  files,  or  in  the  Quill  database, when Quill is
19       enabled. If no history files are specified (with  the  -f  option)  and
20       Quill  is  not enabled, the local history file as specified in Condor's
21       configuration file ($(SPOOL)/historyby default) is  read.  The  default
22       listing  summarizes (in chronological order) each job on a single line,
23       and contains the following items:
24
25       ID
26
27          The cluster/process id of the job.
28
29
30
31       OWNER
32
33          The owner of the job.
34
35
36
37       SUBMITTED
38
39          The month, day, hour, and minute the job was submitted to the queue.
40
41
42
43       RUN_TIME
44
45          Remote wall clock time accumulated by  the  job  to  date  in  days,
46          hours,  minutes, and seconds. See the definition of RemoteWallClock‐
47          Timeon page .
48
49
50
51       ST
52
53          Completion status of the job (C = completed and X = removed).
54
55
56
57       COMPLETED
58
59          The time the job was completed.
60
61
62
63       CMD
64
65          The name of the executable.
66
67
68
69       If a job ID (in the form of cluster_id or cluster_id.proc_id  )  or  an
70       owner is provided, output will be restricted to jobs with the specified
71       IDs and/or submitted by the specified owner. The -constraint option can
72       be used to display jobs that satisfy a specified boolean expression.
73
74       The  history  file  is  kept  in chronological order, implying that new
75       entries are appended at the end of  the  file.  As  of  Condor  version
76       6.7.19,  the  format  of  the  history file is altered to enable faster
77       reading of the history file backwards (most recent job first).  History
78       files  written  with  earlier versions of Condor, as well as those that
79       have entries of both the older and newer format need to be converted to
80       the  new format. See the condor_convert_history manual page on page for
81       details on converting history files to the new format.
82

Options

84       -help
85
86          Display usage information and exit.
87
88
89
90       -backwards
91
92          List jobs in reverse chronological  order.  The  job  most  recently
93          added to the history file is first.
94
95
96
97       -completedsince postgrestimestamp
98
99          When  Quill  is  enabled, display only job ads that were in the Com‐
100          pleted job state on or after the date and time given  by  the  post‐
101          grestimestamp  .  The  postgrestimestamp follows the syntax as given
102          for PostgreSQL version 8.0. The behavior of this option is undefined
103          when Quill is not enabled.
104
105
106
107       -constraint expr
108
109          Display jobs that satisfy the expression.
110
111
112
113       -f filename
114
115          Use  the  specified  file  instead of the default history file. When
116          Quill is enabled, this option will force the query to read from  the
117          history file, and not the database.
118
119
120
121       -format formatString AttributeName
122
123          Display jobs with a custom format. See the condor_q man page -format
124          option for details.
125
126
127
128       -l or -long
129
130          Display job ads in long format.
131
132
133
134       -match number
135
136          Limit the number of jobs displayed to number .
137
138
139
140       -name schedd-name
141
142          When Quill is enabled,  query  job  ClassAds  from  the  named  con‐
143          dor_schedd daemon, not the default condor_schedd daemon.
144
145
146
147       -xml
148
149          Display  job ClassAds in xml format. The xml format is fully defined
150          at http://www.cs.wisc.edu/condor/classad/refman/.
151
152
153

Examples

155       To see all historical jobs since April 1, 2005 at 1pm,
156
157       %condor_history -completedsince '04/01/2005 13:00'
158

Exit Status

160       condor_history will exit with a status value of 0 (zero) upon  success,
161       and it will exit with the value 1 (one) upon failure.
162

Author

164       Condor Team, University of Wisconsin-Madison
165

167       Copyright (C) 1990-2009 Condor Team, Computer Sciences Department, Uni‐
168       versity  of  Wisconsin-Madison,  Madison,  WI.  All  Rights   Reserved.
169       Licensed under the Apache License, Version 2.0.
170
171       See   the   Condor   Version   7.4.2  Manual  or  http://www.condorpro‐
172       ject.org/licensefor additional notices. condor-admin@cs.wisc.edu
173
174
175
176                                     date     just-man-pages/condor_history(1)
Impressum