Langue: en

Autres versions - même langue

Version: 376765 (fedora - 01/12/10)

Section: 3 (Bibliothèques de fonctions)


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 see section 2.7.9. If 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

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.