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

Name

6       condor_history View log of HTCondor jobs completed to date
7

Synopsis

9       condor_history [ -help ]
10
11       condor_history  [ -name name ] [ -pool centralmanagerhostname[:portnum‐
12       ber] ] [ -backwards ] [ -forwards ] [ -constraint expr ] [ -file  file‐
13       name  ]  [ -userlog filename ] [ -format formatString AttributeName ] [
14       -autoformat[:jlhVr,tng] attr1 [attr2 ...]  ] [ -l  |  -long  |  -xml  |
15       -json  ] [ -match | -limit number ] [ cluster | cluster.process | owner
16       ]
17

Description

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

Options

85       -help
86
87          Display usage information and exit.
88
89
90
91       -name name
92
93          Query the named condor_schedd daemon.
94
95
96
97       -pool centralmanagerhostname[:portnumber]
98
99          Use the centralmanagerhostname as the central manager to locate con‐
100          dor_schedd daemons. The default is the  COLLECTOR_HOST ,  as  speci‐
101          fied in the configuration.
102
103
104
105       -backwards
106
107          List  jobs  in  reverse  chronological  order. The job most recently
108          added to the history file is first. This is the default ordering.
109
110
111
112       -forwards
113
114          List jobs in chronological order. The job most recently added to the
115          history file is last. At least 4 characters must be given to distin‐
116          guish this option from the -file and -format options.
117
118
119
120       -constraint expr
121
122          Display jobs that satisfy the expression.
123
124
125
126       -attributes attrs
127
128          Display only the given attributes when the -long o ption is used.
129
130
131
132       -since jobid or expr
133
134          Stop scanning when the given jobid is found or when  the  expression
135          becomes true.
136
137
138
139       -local #10349#>
140
141          Read  from  local history files even if there is a  SCHEDD_HOST con‐
142          figured.
143
144
145
146       -file filename
147
148          Use the specified file instead of the default history file.
149
150
151
152       -userlog filename
153
154          Display jobs, with job information coming  from  a  job  event  log,
155          instead  of  from the default history file. A job event log does not
156          contain all of the job information, so some  fields  in  the  normal
157          output of condor_history will be blank.
158
159
160
161       -format formatString AttributeName
162
163          Display jobs with a custom format. See the condor_q man page -format
164          option for details.
165
166
167
168       -autoformat[:jlhVr,tng] attr1 [attr2  ...]   or  -af[:jlhVr,tng]  attr1
169       [attr2 ...]
170
171          (output option) Display attribute(s) or expression(s) formatted in a
172          default way according to attribute types. This option takes an arbi‐
173          trary  number  of attribute names as arguments, and prints out their
174          values, with a space between each  value  and  a  newline  character
175          after  the  last value. It is like the -format option without format
176          strings.
177
178          It is assumed that no attribute names begin with a  dash  character,
179          so that the next word that begins with dash is the start of the next
180          option. The autoformat option may be followed by a  colon  character
181          and  formatting qualifiers to deviate the output formatting from the
182          default:
183
184          j print the job ID as the first field,
185
186          l label each field,
187
188          h print column headings before the first line of output,
189
190          V use %V rather than %v for formatting (string values are quoted),
191
192          r print "raw", or unevaluated values,
193
194          , add a comma character after each field,
195
196          t add a tab character before each field instead of the default space
197          character,
198
199          n add a newline character after each field,
200
201          g  add  a  newline  character  between ClassAds, and suppress spaces
202          before each field.
203
204          Use -af:h to get tabular values with headings.
205
206          Use -af:lrng to get -long equivalent format.
207
208          The newline and comma characters may not be used together. The l and
209          h characters may not be used together.
210
211
212
213       -l or -long
214
215          Display job ClassAds in long format.
216
217
218
219       -limit Number
220
221          Limit the number of jobs displayed to Number . Same option as -match
222          .
223
224
225
226       -match Number
227
228          Limit the number of jobs displayed to Number . Same option as -limit
229          .
230
231
232
233       -xml
234
235          Display  job ClassAds in XML format. The XML format is fully defined
236          in the reference manual, obtained from the ClassAds web page, with a
237          link at http://htcondor.org/classad/classad.html.
238
239
240
241       -json
242
243          Display job ClassAds in JSON format.
244
245
246

Exit Status

248       condor_history  will exit with a status value of 0 (zero) upon success,
249       and it will exit with the value 1 (one) upon failure.
250

Author

252       Center for High Throughput Computing, University of Wisconsin-Madison
253

255       Copyright (C) 1990-2018 Center for High Throughput Computing,  Computer
256       Sciences  Department, University of Wisconsin-Madison, Madison, WI. All
257       Rights Reserved. Licensed under the Apache License, Version 2.0.
258
259
260
261                                     date     just-man-pages/condor_history(1)
Impressum