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)