qterm (8) - Linux Man Pages
qterm: terminate processing by a PBS batch server
qterm - terminate processing by a PBS batch server
SYNOPSISqterm [-t type] [server...]
DESCRIPTIONThe 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.
- -t type
Specifies the type of shut down. The types are:
- 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
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.
- 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 running jobs.
- 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.