qterm - Man Page

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 type are:

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)

Info

Local PBS