1qterm(8B) PBS qterm(8B)
2
6 qterm - terminate processing by a PBS batch server
7
9 qterm [-t type] [server...]
10
12 The qterm command terminates a PBS batch server. When a server
13 receives a terminate command, the server will go into a terminating
14 state. While in this state, the server will not allow new jobs to be
15 started or enqueued. By default, qterm will request a "quick" shutdown
16 of the PBS server. Other ways of shutting down the server (specified
17 with the -t argument), and their impact on running jobs, are described
18 below. The qterm command will not exit until the server has completed
19 its shutdown procedure.
20 In order to execute qterm, the user must have PBS Operation or Manager
22 privilege.
23
25 -t type Specifies the type of shut down. The types are:
26 immediate
28 All running jobs are to immediately stop execution.
29 If checkpoint is supported, running jobs that were
31 submitted with "-c shutdown" are checkpointed, termi‐
32 nated, and requeued. If checkpoint is not supported
33 or the job cannot be checkpointed, running jobs are
34 requeued if the rerunable attribute is true. Other‐
35 wise, jobs are killed.
36 Normally the server will not shutdown until there are
38 no jobs in the running state. If the server is unable
39 to contact the MOM of running job, the job is still
40 listed as running. The server may be forced down by a
41 second qterm -t immediate command.
42 delay If checkpoint is supported, running jobs that were
44 submitted with "-c shutdown" are checkpointed, termi‐
45 nated, and requeued. If a job cannot be checkpointed,
46 but can be rerun, the job is terminated and requeued.
47 Otherwise, running jobs are allowed to continue to
48 run. Note, the operator or administrator may use the
49 qrerun and qdel commands to remove running jobs.
50 quick This option is used when you wish that running jobs be
52 left running when the server shuts down. The server
53 will cleanly shutdown and can be restarted when
54 desired. Upon restart of the server, jobs that con‐
55 tinue to run are shown as running; jobs that termi‐
56 nated during the server's absence will be placed into
57 the exiting state.
58
60 The server operand specifies which servers are to shutdown. If no
61 servers are given, then the default server will be terminated.
62
64 The qterm command will write a diagnostic message to standard error for
65 each error occurrence.
66
68 Upon successful processing of all the operands presented to the qterm
69 command, the exit status will be a value of zero.
70 If the qterm command fails to process any operand, the command exits
72 with a value greater than zero.
73
75 pbs_server(8B), qmgr(1B), pbs_resources_aix4(7B),
76 pbs_resources_irix5(7B), pbs_resources_sp2(7B),
77 pbs_resources_sunos4(7B), and pbs_resources_unicos8(7B)
78Local qterm(8B)