# pbs_connect

NAME
SYNOPSIS
DESCRIPTION
SEE ALSO
DIAGNOSTICS

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

## SEE ALSO

| 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

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