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 receives 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,  terminated,  and
			requeued.   If	checkpoint  is not supported or the job cannot be checkpointed, running jobs are requeued if the rerunable
			attribute is true.  Otherwise, 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,  terminated,  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  run-
			ning 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 desired.  Upon restart of the server, jobs that continue to run are shown  as  running;
			jobs that terminated during the server's absence will be placed into the exiting 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_resources_irix5(7B),   pbs_resources_sp2(7B),   pbs_resources_sunos4(7B),   and
       pbs_resources_unicos8(7B)

Local																	 qterm(8B)