GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  QTERM (8)


.Ig
.Iq

NAME

qterm - terminate processing by a PBS batch server

CONTENTS

Synopsis
Description
Options
Operands
Standard Error
Exit Status
See Also

SYNOPSIS

qterm [-t type] [server...]

DESCRIPTION

The qterm command terminates a PBS batch server. The command sends a Server Shutdown batch request to the server.
.Ig When a server receives a terminate command,
.Ig Shutdown request,
.Ig 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. The value passed in the Shutdown request is {SHUT_IMMEDIATE}.
.Ig
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.
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. The value passed in the Shutdown request is {SHUT_DELAY}.
.Ig
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. The value passed in the Shutdown request is
.Ig

OPERANDS

The 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)
Search for    or go to Top of page |  Section 8 |  Main Index


Local QTERM (8B)

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.