| pbs_connect - connect to a pbs batch server |
|
#include <pbs_error.h> #include <pbs_ifl.h> |
int pbs_connect(char *server) extern char *pbs_server; |
| A virtual stream (TCP/IP) connection is established with the server specified by server. |
| This function must be called before any of the other pbs_ functions. They will transmit their batch requests over the connection established by this function. Multiple requests may be issued over the connection before it is closed. |
| The connection should be closed by a call to pbs_disconnect() when all requests have been sent to the server. |
| The parameter, server, is of the form host_name[:port], see section 2.7.9. If port is not specified, the standard PBS port number will be used. |
| If the parameter, server, is either the null string or a null pointer, a connection will be opened to the default server. The default server is defined by (a) the setting of the environment variable PBS_DEFAULT which contains a destination, or (b) the destination in the batch administrator established file {PBS_DIR}/default_destn . |
| The variable pbs_server, declared in pbs_ifl.h, is set on return to point to the server name to which pbs_connect() connected or attempted to connect. |
| qsub(1B) , pbs_alterjob(3B) , pbs_deljob(3B) , pbs_disconnect(3B) , pbs_geterrmsg(3B) , pbs_holdjob(3B) , pbs_locate(3B), pbs_manager(3B) , pbs_movejob(3B) , pbs_msgjob(3B) , pbs_rerunjob(3B) , pbs_rlsjob(3B) , pbs_runjob(3B) , pbs_selectjob(3B) , pbs_selstat(3B), pbs_sigjob(3B) , pbs_statjob(3B) , pbs_statque(3B) , pbs_statserver(3B) , pbs_submit(3B) , pbs_terminate(3B) , pbs_server(8B) , and the PBS External Reference Specification |
| When the connection to batch server has been successfully created, the routine will return a connection identifier which is positive. Otherwise, a negative value is returned. The error number is set in pbs_errno. |