pbs_terminate man page
pbs_terminate — terminate a pbs batch server
int pbs_terminate(int connect, int manner, char *extend)
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 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, extend, is reserved for implementation defined extensions.
This call requires PBS Operator or Manager privilege.
qterm(8B) and pbs_connect(3B)
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.