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  -  PBS_TERMINATE (3)


.Ig
.Ig

NAME

pbs_terminate - terminate a pbs batch server

CONTENTS

Synopsis
Description
Diagnostics

SYNOPSIS

#include <pbs_error.h>
#include <pbs_ifl.h>


int pbs_terminate(int connect, int manner, char *extend)


DESCRIPTION

Issue a batch request to shut down a batch server. This request requires the privilege level usually reserved for batch operators and administrators.

A Server Shutdown batch request is generated and sent to the server over the connection specified by which is the return value of pbs_connect().

The parameter, specifies the manner in which the server is shut down. The available manners are defined in pbs_ifl.h as:

#define SHUT_IMMEDIATE 0 Shutdown is to be immediate, runnings jobs are checkpointed, requeued, or deleted as required.
#define SHUT_DELAY 1 Jobs which can be checkpointed are checkpointed, terminated, and requeued. Jobs which cannot be checkpointed but are rerunnable are terminated and requeued. Shutdown is delayed until the remaining running jobs complete. No new jobs will be started by the server.

The server will not respond to the batch request until the server has completed its termination procedure.

The parameter, is reserved for implementation defined extensions. It is not currently used by this function.
.Ig

This call requires PBS Operator or Manager privilege.

SEE ALSO

qterm(8B) and pbs_connect(3B)

DIAGNOSTICS

When the batch request generated by pbs_terminate() function has been completed successfully by a batch server, the routine will return 0 (zero). Otherwise, a non zero error is returned. The error number is also set in pbs_errno.

Search for    or go to Top of page |  Section 3 |  Main Index


Local PBS_TERMINATE (3B)

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