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)

Name
       condor_history View log of HTCondor jobs	completed to date

Synopsis
       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 ]

Description
       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:

       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, given as	the job	ClassAd	attribute  Re-
	  moteWallClockTime .

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

Options
       -help

	  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.

       -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 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
	  strings.

	  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
	  default:

	  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
	  character,

	  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
	  .

       -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.

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.

Author
       Center for High Throughput Computing, University	of Wisconsin-Madison

Copyright
       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:
<https://www.freebsd.org/cgi/man.cgi?query=condor_history&sektion=1&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help