qalter | qdel | qhold | qmsg | qmove | qrls | qrerun | qselect | qsig | qstat | qsub
Back to xpbs and PBS Commands

qrls Manual Page

     NAME
	  qrls - release hold on batch jobs

     SYNOPSIS
	  qrls [-h hold_list] 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
	  Attempt 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 combination,
			 or one	or more	of the letters "n.  The	hold
			 type associated with each letter is:

			 u - USER

			 o - OTHER

			 s - SYSTEM

			 n - None

     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), and pbs_alterjob(3B)

qalter | qdel | qhold | qmsg | qmove | qrls | qrerun | qselect | qsig | qstat | qsub
Back to xpbs and PBS Commands