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

FreeBSD Manual Pages

  
 
  

home | help
qrls(1B)			      PBS			      qrls(1B)

NAME
       qrls - release hold on pbs batch	jobs

SYNOPSIS
       qrls [-h	hold_list] [-t array_range] job_identifier ...

DESCRIPTION
       The qrls	command	removes	or releases holds which	exist on batch jobs.

       A job may have one or more types	of holds which make the	job ineligible
       for execution.  The types of holds are USER, OTHER,  and	 SYSTEM.   The
       different  types	 of  holds  may	require	that the user issuing the qrls
       command have special privilege.	Typically, the owner of	the  job  will
       be able to remove a USER	hold, but not an OTHER or SYSTEM hold.	An At-
       tempt to	release	a hold for which the user does not  have  the  correct
       privilege is an error and no holds will be released for that job.

       If no -h	option is specified, the USER hold will	be released.

       If  the	job  has no execution_time pending, the	job will change	to the
       queued state.  If an execution_time is  still  pending,	the  job  will
       change to the waiting state.

OPTIONS
       -h hold_list   Defines  the types of hold to be released	from the jobs.
		      The hold_list option argument is a string	consisting  of
		      one  or more of the letters "u", "o", an "s" in any com-
		      bination.	 The hold type associated with each letter is:

		      u	- USER

		      o	- OTHER

		      s	- SYSTEM

       -t array_range The array_range argument is an integer id	or a range  of
		      integers.	Multiple ids or	id ranges can be combined in a
		      comma  delimted  list.  Examples:	  -t   1-100   or   -t
		      1,10,50-100

		      If  an array range isn't specified, the command tries to
		      operate on the entire array. The command acts on the ar-
		      ray  (or	specified range	of the array) just as it would
		      on an individual job.

OPERANDS
       The qrls	command	accepts	one or more  job_identifier  operands  of  the
       form:
	   sequence_number[.server_name][@server]

STANDARD ERROR
       The  qrls command will write a diagnostic message to standard error for
       each error occurrence.

EXIT STATUS
       Upon successful processing of all the operands presented	 to  the  qrls
       command,	the exit status	will be	a value	of zero.

       If  the	qrls  command  fails to	process	any operand, the command exits
       with a value greater than zero.

SEE ALSO
       qsub(1B), qalter(1B), qhold(1B),	pbs_alterjob(3B), pbs_holdjob(3B), and
       pbs_rlsjob(3B).

Local								      qrls(1B)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | OPERANDS | STANDARD ERROR | EXIT STATUS | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=qrls&sektion=1b&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help