pbs_connect(3B)

NAME
pbs_connect - connect to a PBS batch server

SYNOPSIS
#include <pbs_error.h>
#include <pbs_ifl.h>

int pbs_connect(char *server)
    extern char *pbs_server;

DESCRIPTION
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 called server is of the form:
    host_name[:port].
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) by adding the parameter PBS_SERVER to the global configuration file /etc/pbs.conf.

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. pbs_connect() determines whether or not the complex has a failover server configured. It also determines which server is the primary and which is the secondary. pbs_connect() is called by client commands, and directs traffic to the correct server. In order to use pbs_connect with Windows, initialize the network library and link with winsock2. To do this, call winsock_init() before calling pbs_connect(), and link against the ws2_32.lib library.

SEE ALSO
qsub(1B), pbs_alterjob(3B), pbs_deljob(3B), pbs_disconnect(3B), pbs_geterrmsg(3B), pbs_holdjob(3B), pbs_locjob(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 Professional Programmer's Guide

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