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 batch server. When a server receives a
13 terminate command, The server will go into Terminating state. No new
14 jobs will be allowed to be started into execution nor enqueued into the
15 server. The impact on jobs currently being run by the server depends
16 on the type of shut down requested as described below. The qterm com‐
17 mand will not exit until the server has completed it shutdown proce‐
18 dure.
19 In order to execute qterm, the user must have PBS Operation or Manager
21 privilege.
22
24 -t type Specifies the type of shut down. The types are:
25 immediate
27 All running jobs are to immediately stop execution.
28 If checkpoint is supported, running jobs that can be
30 checkpointed are checkpointed, terminated, and
31 requeued. If checkpoint is not supported or the job
32 cannot be checkpointed, running jobs are requeued if
33 the rerunable attribute is true. Otherwise, jobs are
34 killed.
35 Normally the server will not shutdown until there are
37 no jobs in the running state. If the server is unable
38 to contact the MOM of running job, the job is still
39 listed as running. The server may be forced down by a
40 second qterm -t immediate command.
41 delay If checkpoint is supported, running jobs that can be
43 checkpointed are checkpointed, terminated, and
44 requeued. If a job cannot be checkpointed, but can be
45 rerun, the job is terminated and requeued. Otherwise,
46 running jobs are allowed to continue to run. Note,
47 the operator or administrator may use the qrerun and
48 qdel commands to remove running jobs.
49 quick This option is used when you wish that running jobs be
51 left running when the server shuts down. The server
52 will cleanly shutdown and can be restarted when
53 desired. Upon restart of the server, jobs that con‐
54 tinue to run are shown as running; jobs that termi‐
55 nated during the server's absence will be placed into
56 the exiting state.
57
59 The server operand specifies which servers are to shutdown. If no
60 servers are given, then the default server will be terminated.
61
63 The qterm command will write a diagnostic message to standard error for
64 each error occurrence.
65
67 Upon successful processing of all the operands presented to the qterm
68 command, the exit status will be a value of zero.
69 If the qterm command fails to process any operand, the command exits
71 with a value greater than zero.
72
74 pbs_server(8B), qmgr(1B), pbs_resources_aix4(7B),
75 pbs_resources_irix5(7B), pbs_resources_sp2(7B),
76 pbs_resources_sunos4(7B), and pbs_resources_unicos8(7B)
77Local qterm(8B)