TORQUE Resource Manager

qterm

terminate processing by a pbs batch server

Synopsis

Description

The qterm command terminates a batch server. When a server receives a terminate command, The server will go into Terminating state. No new jobs will be allowed to be started into execution nor enqueued into the server. The impact on jobs currently being run by the server depends on the type of shut down requested as described below. The qterm com- mand will not exit until the server has completed it shutdown proce- dure.

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 can be checkpointed 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.

• delay - If checkpoint is supported, running jobs that can be checkpointed 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 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 desired. Upon restart of the server, jobs that con- tinue to run are shown as running; jobs that termi- nated during the server’s absence will be placed into the exiting state.

  This is the default action if the -t option is not specified.

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(8B),            pbs_resources_aix4(7B),
pbs_resources_irix5(7B),                         pbs_resources_sp2(7B),
pbs_resources_sunos4(7B), and  pbs_resources_unicos8(7B)