pbs_connect - Man Page

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