You are here: Appendices > Appendix A: Commands Overview > qterm

qterm

Terminate processing by a PBS batch server.

A.1.136 Synopsis

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

A.1.137 Description

The qterm command terminates a batch server. When a server receives a terminate command, the server will go into the "Terminating" state. No new jobs will be allowed to be started into execution or enqueued into the server. The impact on jobs currently being run by the server depends

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

A.1.138 Options

Option Name Description
-l local Terminate processing only if the active server is local to where qterm is being executed.
-t type

Specifies the type of shut down. The types are:

  • quick – This is the default action if the -t option is not specified. 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.

The immediate and delay types are deprecated.

A.1.139 Operands

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

A.1.140 Standard error

The qterm command will write a diagnostic message to standard error for each error occurrence.

A.1.141 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.

Related Topics (non-Adaptive Computing topics)

© 2017 Adaptive Computing