Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
just-man-pages/condor_historGeneral Commands Mjust-man-pages/condor_history(1)

       condor_history View log of HTCondor jobs	completed to date

       condor_history [	-help ]

       condor_history  [ -name name ] [	-pool centralmanagerhostname[:portnum-
       ber] ] [	-backwards ] [ -forwards ] [ -constraint expr ]	[ -file	 file-
       name  ]	[ -userlog filename ] [	-format	formatString AttributeName ] [
       -autoformat[:lhVr,tng] attr1 [attr2 ...]	 ] [ -l	| -long	 |  -xml  ]  [
       -match |	-limit 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 config-
       uration 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:


	  The cluster/process id of the	job.


	  The owner of the job.


	  The month, day, hour,	and minute the job was submitted to the	queue.


	  Remote wall clock time accumulated by	 the  job  to  date  in	 days,
	  hours, minutes, and seconds, given as	the job	ClassAd	attribute  Re-
	  moteWallClockTime .


	  Completion status of the job (C = completed and X = removed).


	  The time the job was completed.


	  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 en-
       tries are appended at the end of	the file.


	  Display usage	information and	exit.

       -name name

	  Query	the named condor_schedd	daemon.

       -pool centralmanagerhostname[:portnumber]

	  Use the centralmanagerhostname as the	central	manager	to locate con-
	  dor_schedd  daemons.	The default is the  COLLECTOR_HOST , as	speci-
	  fied in the configuration.


	  List jobs in reverse chronological  order.  The  job	most  recently
	  added	to the history file is first. This is the default ordering.


	  List jobs in chronological order. The	job most recently added	to the
	  history file is last.	At least 4 characters must be given to distin-
	  guish	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 job	event log, in-
	  stead	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 formatString AttributeName

	  Display jobs with a custom format. See the condor_q man page -format
	  option for details.

       -autoformat[:lhVr,tng]  attr1  [attr2  ...]   or	 -af[:lhVr,tng]	 attr1
       [attr2 ...]

	  (output option) Display attribute(s) or expression(s)	formatted in a
	  default way according	to attribute types. This option	takes an arbi-
	  trary	number of attribute names as arguments,	and prints  out	 their
	  values,  with	a space	between	each value and a newline character af-
	  ter the last value. It is like the  -format  option  without	format

	  It  is  assumed that no attribute names begin	with a dash character,
	  so that the next word	that begins with dash is the start of the next
	  option.  The	autoformat option may be followed by a colon character
	  and formatting qualifiers to deviate the output formatting from  the

	  l label each field,

	  h print column headings before the first line	of output,

	  V use	%V rather than %v for formatting (string values	are quoted),

	  r print "raw", or unevaluated	values,

	  , add	a comma	character after	each field,

	  t add	a tab character	before each field instead of the default space

	  n add	a newline character after each field,

	  g add	a newline character between ClassAds, and suppress spaces  be-
	  fore each field.

	  Use -af:h to get tabular values with headings.

	  Use -af:lrng to get -long equivalent format.

	  The newline and comma	characters may not be used together. The l and
	  h characters may not be used together.

       -l or -long

	  Display job ClassAds in long format.

       -limit Number

	  Limit	the number of jobs displayed to	Number . Same option as	-match

       -match Number

	  Limit	the number of jobs displayed to	Number . Same option as	-limit


	  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

Exit Status
       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  (C) 1990-2015	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.

				     date     just-man-pages/condor_history(1)

Name | Synopsis | Description | Options | Exit Status | Author | Copyright

Want to link to this manual page? Use this URL:

home | help