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

FreeBSD Manual Pages

  
 
  

home | help
qterm(8B)			      PBS			     qterm(8B)

NAME
       qterm - terminate processing by a PBS batch server

SYNOPSIS
       qterm [-t type] [server...]

DESCRIPTION
       The  qterm  command  terminates	a PBS batch server.  When a server re-
       ceives a	terminate command, the	server	will  go  into	a  terminating
       state.	While  in this state, the server will not allow	new jobs to be
       started or enqueued.  By	default, qterm will request a "quick" shutdown
       of  the	PBS server.  Other ways	of shutting down the server (specified
       with the	-t argument), and their	impact on running jobs,	are  described
       below.	The qterm command will not exit	until the server has completed
       its shutdown procedure.

       In order	to execute qterm, the user must	have PBS Operation or  Manager
       privilege.

OPTIONS
       -t type	 Specifies the type of shut down.  The types are:

		 immediate
			All running jobs are to	immediately stop execution.

			If  checkpoint	is  supported,	running	jobs that were
			submitted with "-c shutdown" are checkpointed,	termi-
			nated,	and  requeued.	If checkpoint is not supported
			or the job cannot be checkpointed,  running  jobs  are
			requeued  if  the rerunable attribute is true.	Other-
			wise, jobs are killed.

			Normally the server will not shutdown until there  are
			no jobs	in the running state.  If the server is	unable
			to contact the MOM of running job, the	job  is	 still
			listed as running.  The	server may be forced down by a
			second qterm -t	immediate command.

		 delay	If checkpoint is supported,  running  jobs  that  were
			submitted  with	"-c shutdown" are checkpointed,	termi-
			nated, and requeued.  If a job cannot be checkpointed,
			but  can be rerun, the job is terminated and requeued.
			Otherwise, running jobs	are  allowed  to  continue  to
			run.   Note, the operator or administrator may use the
			qrerun and qdel	commands to remove running jobs.

		 quick	This option is used when you wish that running jobs be
			left  running  when the	server shuts down.  The	server
			will cleanly shutdown and can be  restarted  when  de-
			sired.	Upon restart of	the server, jobs that continue
			to run are shown as running; jobs that terminated dur-
			ing the	server's absence will be placed	into the exit-
			ing state.

OPERANDS
       The server operand specifies which servers  are	to  shutdown.	If  no
       servers are given, then the default server will be terminated.

STANDARD ERROR
       The qterm 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	 qterm
       command,	the exit status	will be	a value	of zero.

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

SEE ALSO
       pbs_server(8B),	   qmgr(1B),	  pbs_resources_aix4(7B),      pbs_re-
       sources_irix5(7B), pbs_resources_sp2(7B), pbs_resources_sunos4(7B), and
       pbs_resources_unicos8(7B)

Local								     qterm(8B)

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=qterm&sektion=8b&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help