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 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.
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