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

FreeBSD Manual Pages

  
 
  

home | help
just-man-pages/condor_qsub(1General Commands Manujust-man-pages/condor_qsub(1)

Name
       condor_qsub Queue jobs that use PBS/SGE-style submission

Synopsis
       condor_qsub [ --	version	]

       condor_qsub  [ Specific options ] [ Directory options ] [ Environmental
       options ] [ File	options	] [ Notification options ] [ Resource  options
       ] [ Status options ] [ Submission options ] commandfile

Description
       condor_qsub  submits  an	 HTCondor  job.	 This  job  is	specified in a
       PBS/Torque style	or an SGE style.  condor_qsub permits  the  submission
       of dependent jobs without the need to specify the full dependency graph
       at submission time. Doing things	this way is neither  as	 efficient  as
       HTCondor's  DAGMan,  nor	 as functional as SGE's	qsub or	qalter .  con-
       dor_qsub	serves as a minimal translator to  be  able  to	 use  software
       originally written to interact with PBS,	Torque,	and SGE	in an HTCondor
       pool.

       condor_qsub attempts to behave like qsub	. Less than half of  the  qsub
       functionality  is implemented. Option descriptions describe the differ-
       ences between the behavior of qsub and condor_qsub .  qsub options  not
       listed  here are	not supported. Some concepts present in	PBS and	SGE do
       not apply to HTCondor, and so these options are not implemented.

       For a full listing of qsub options, please see

       POSIX

	  :		http://pubs.opengroup.org/onlinepubs/9699919799/utili-
	  ties/qsub.html

       SGE

	  : http://gridscheduler.sourceforge.net/htmlman/htmlman1/qsub.html

       PBS/Torque

	  : http://docs.adaptivecomputing.com/torque/4-1-3/Content/topics/com-
	  mands/qsub.htm

       condor_qsub accepts either command line options	or  the	 single	 file,
       commandfile , that contains all of the commands.

       condor_qsub  does  the  opposite	of job submission within the grid uni-
       verse batch grid	type, which takes HTCondor jobs	submitted with	HTCon-
       dor syntax and submits them to PBS, SGE,	or LSF.

Options
       -a date_time

	  (Submission  option) Specify a deferred execution date and time. The
	  PBS/Torque  syntax  of  date_time  is	  a   string   in   the	  form
	  [[[[CC]YY]MM]DD]hhmm[.SS]  .	The  portions of this string which are
	  optional are CC , YY , MM , DD , and SS . For	SGE, MM	and DD are not
	  optional.  For PBS, MM and DD	are optional.  condor_qsub follows the
	  PBS style.

       -A account_string

	  (Status  option)  Uses  group	 accounting  where  the	  string   ac-
	  count_string	is  the	accounting group associated with this job. Un-
	  like SGE, there is no	default	group of  "sge"	.

       -b y|n

	  (Submission option) Using the	SGE definition of  its	-b  option,  a
	  value	 of  y causes condor_qsub to not parse the file	for additional
	  condor_qsub commands.	The default value is n . If the	 command  line
	  argument -f filename is also specified, it negates a value of	y .

       -c checkpoint_option

	  (Submission  option)	For  standard universe jobs only, controls the
	  how HTCondor produces	checkpoints.  checkpoint_options may be	one of

	  n or N

	     Do	not produce checkpoints.

	  s or S

	     Do	not produce periodic checkpoints. A job	will  only  produce  a
	     checkpoint	when the job is	evicted.

	     More options may be implemented in	the future.

       --condor-keep-files

	  (Specific  option)  Directs  HTCondor	 to not	remove temporary files
	  generated by condor_qsub , such as HTCondor submit  files  and  sen-
	  tinel	jobs. These temporary files may	be important for debugging.

       -cwd

	  (Directory  option) Specifies	the initial directory in which the job
	  will run to be the current directory from which the job was  submit-
	  ted. This sets initialdir for	condor_submit .

       -d path or -wd path

	  (Directory  option) Specifies	the initial directory in which the job
	  will run to be path .	This sets initialdir for condor_submit .

       -e filename

	  (File	option)	Specifies the condor_submit command error ,  the  file
	  where	  stderr is written. If	not specified, set to the default name
	  of  <commandfile>.e<ClusterId> , where  <commandfile>	 is  the  con-
	  dor_qsub  argument, and  <ClusterId> is the job attribute  ClusterId
	  assigned for the job.

       --f qsub_file

	  (Specific option) Parse qsub_file to search for and  set  additional
	  condor_submit	 commands.  Within  the	 file, commands	will appear as
	  #PBS or  #SGE	.  condor_qsub will parse the  batch  file  listed  as
	  qsub_file .

       -h

	  (Status option) Placed submitted job directly	into the hold state.

       --help

	  (Specific option) Print usage	information and	exit.

       -hold_jid _jid_

	  (Status  option)  Submits  a	job in the hold	state. This job	is re-
	  leased only when a previously	submitted job, identified by its clus-
	  ter  ID  as _jid_ , exits successfully. Successful completion	is de-
	  fined	as not exiting with exit code 100.  In	implementation,	 there
	  are  three  jobs  that define	this SGE feature. The first job	is the
	  previously submitted job. The	second job is the newly	submitted  one
	  that	is waiting for the first to finish successfully. The third job
	  is what SGE calls a sentinel job; this is an HTCondor	local universe
	  job  that  watches  the  history for the first job's exit code. This
	  third	job will exit once it has seen the exit	code and, for  a  suc-
	  cessful termination of the first job,	run condor_release on the sec-
	  ond job. If the first	job is an array	job, the second	job will  only
	  be  released	after  all  individual jobs of the first job have com-
	  pleted.

       -i [hostname:]filename

	  (File	option)	Specifies the condor_submit command input ,  the  file
	  from which  stdin is read.

       -j characters

	  (File	 option)  Acceptable  characters for this option are  e	,  o ,
	  and  n . The only sequence that is relevant is  eo  ;	 it  specifies
	  that	both  standard output and standard error are to	be sent	to the
	  same file. The file will be the one specified	by the -o  option,  if
	  both the -o and -e options exist. The	file will be the one specified
	  by the -e option, if only the	-e option is provided. If neither  the
	  -o  nor  the	-e  options are	provided, the file will	be the default
	  used for the -o option.

       -l resource_spec

	  (Resource option) Specifies requirements for the job,	 such  as  the
	  amount  of  RAM  and the number of CPUs. Only	PBS-style resource re-
	  quests are supported.	 resource_spec is a comma  separated  list  of
	  key/value  pairs.  Each  pair	 is of the form	 resource_name=value .
	  resource_name	and  value may be

	   resource_name  value	DescriptionarchstringSets  Arch	machine	attri-
	  bute.	 Enclose  in  double quotes.filesizeDisk space requested.host-
	  stringHost machine on	which the job must run.memsizeAmount of	memory
	  requested.nodes    {<node_count>    |	   <hostname>}	  [:ppn=<ppn>]
	  [:gpus=<gpu>]	[:<property> [:<property>] ...]	[+ ...]	Number	and/or
	  properties   of   nodes   to	be  used.  For	examples,  please  see
	  http://docs.adaptivecomputing.com/torque/4-1-3/Content/top-
	  ics/2-jobs/requestingRes.htm#qsubopsysstringSets   OpSys machine at-
	  tribute. Enclose in double  quotes.procsintegerNumber	 of  CPUs  re-
	  quested.A size value is an integer specified in bytes, following the
	  PBS/Torque default. Append  Kb ,  Mb ,  Gb , or  Tb to  specify  the
	  value	in powers of two quantities greater than bytes.

       -m a|e|n

	  (Notification	 option)  Identify when	HTCondor sends notification e-
	  mail.	If a , send e-mail when	the job	terminates abnormally. If e  ,
	  send e-mail when the job terminates. If n , never send e-mail.

       -M e-mail_address

	  (Notification	 option)  Sets the destination address for HTCondor e-
	  mail.

       -o filename

	  (File	option)	Specifies the condor_submit command output , the  file
	  where	  stdout is written. If	not specified, set to the default name
	  of  <commandfile>.o<ClusterId> , where  <commandfile>	 is  the  con-
	  dor_qsub  argument, and  <ClusterId> is the job attribute  ClusterId
	  assigned for the job.

       -p integer

	  (Status option) Sets the priority submit command for the job,	with 0
	  being	 the default. Jobs with	higher numerical priority will run be-
	  fore jobs with lower numerical priority.

       --print

	  (Specific option) Send to  stdout the	contents of the	HTCondor  sub-
	  mit description file that condor_qsub	generates.

       -r y|n

	  (Status option) The default value of y implements the	default	HTCon-
	  dor policy of	assuming that jobs that	do  not	 complete  are	placed
	  back	in  the	 queue to be run again.	When n , job submission	is re-
	  stricted to only running  the	 job  if  the  job  ClassAd  attribute
	  NumJobStarts	is  currently  0.  This	 identifies the	job as not re-
	  runnable, limiting it	to start once.

       -S shell

	  (Submission option) Specifies	the path  and  executable  name	 of  a
	  shell.  Alters  the  HTCondor	submit description file	produced, such
	  that the executable becomes a	wrapper	script.	Within the submit  de-
	  scription  file will be  executable =	<shell>	and  arguments = <com-
	  mandfile> .

       -t start	[-stop:step]

	  (Submission option) Queues a set of nearly identical jobs. The  SGE-
	  style	 syntax	 is  supported.	 start , stop ,	and step are all inte-
	  gers.	 start is the starting index of	the jobs, stop is  the	ending
	  index	(inclusive) of the jobs, and step is the step size through the
	  indices. Note	that using more	than one processor or node  in	a  job
	  will not work	with this option.

       --test

	  (Specific option) With the intention of testing a potential job sub-
	  mission, parse files and commands to	generate  error	 output.  Pro-
	  duces,  but then removes the HTCondor	submit description file. Never
	  submits the job, even	if no errors are encountered.

       -v variable list

	  (Environmental option) Used to set the  submit  command  environment
	  for  the  job.  variable list	is as that defined for the submit com-
	  mand.	Note that the syntax needed is specialized to deal with	 quote
	  marks	and white space	characters.

       -V

	  (Environmental option) Sets  getenv =	True in	the submit description
	  file.

       -W attr_name=attr_value[,attr_name=attr_value...]

	  (File	option)	PBS/Torque supports a number of	 attributes.  However,
	  condor_qsub  only  supports  the  names  stagein  and	 stageout  for
	  attr_name . The format of attr_value for  stagein  and  stageout  is
	  local_file@hostname:remote_file[,...]	  and  we  strip  it  to   re-
	  mote_file[,...] . HTCondor's file transfer mechanism is then used if
	  needed.

       --version

	  (Specific option) Print version information for the condor_qsub pro-
	  gram and exit. Note that condor_qsub has  its	 own  version  numbers
	  which	are separate from those	of HTCondor.

Exit Status
       condor_qsub will	exit with a status value of 0 (zero) upon success, and
       it will exit with the value 1 (one) upon	failure	to submit a job.

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_qsub(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_qsub&sektion=1&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help