pbs_terminate(3B)

NAME
pbs_terminate - terminate a PBS batch server

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 connect which is the return value of pbs_connect().

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

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

The parameter, extend , is reserved for implementation-defined extensions.

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.