NAME

       qterm - 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 types are:

                 immediate
                        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 rerunable 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.

                 delay  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.

                 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)

Local                                                                                                  qterm(8B)