1pbs_connect(3B)                       PBS                      pbs_connect(3B)
2
3
4

NAME

6       pbs_connect - connect to a pbs batch server
7

SYNOPSIS

9       #include <pbs_error.h>
10       #include <pbs_ifl.h>
11
12       int pbs_connect(char *server)
13
14       extern char *pbs_server;
15

DESCRIPTION

17       A  virtual  stream  (TCP/IP)  connection is established with the server
18       specified by server.
19
20       This function must be called before any of the  other  pbs_  functions.
21       They will transmit their batch requests over the connection established
22       by this function.  Multiple requests may be issued over the  connection
23       before it is closed.
24
25       The  connection should be closed by a call to pbs_disconnect() when all
26       requests have been sent to the server.
27
28       The parameter, server, is of the  form  host_name[:port],  see  section
29       2.7.9.   If port is not specified, the standard PBS port number will be
30       used.
31
32       If the parameter, server, is either the null string or a null  pointer,
33       a  connection will be opened to the default server.  The default server
34       is defined by (a) the setting of the environment  variable  PBS_DEFAULT
35       which  contains  a  destination,  or  (b)  the destination in the batch
36       administrator established file {PBS_DIR}/default_destn.
37
38       The variable pbs_server, declared in pbs_ifl.h, is  set  on  return  to
39       point  to the server name to which pbs_connect() connected or attempted
40       to connect.
41

SEE ALSO

43       qsub(1B),   pbs_alterjob(3B),    pbs_deljob(3B),    pbs_disconnect(3B),
44       pbs_geterrmsg(3B),  pbs_holdjob(3B),  pbs_locate(3B),  pbs_manager(3B),
45       pbs_movejob(3B),  pbs_msgjob(3B),   pbs_rerunjob(3B),   pbs_rlsjob(3B),
46       pbs_runjob(3B),   pbs_selectjob(3B),  pbs_selstat(3B),  pbs_sigjob(3B),
47       pbs_statjob(3B), pbs_statque(3B),  pbs_statserver(3B),  pbs_submit(3B),
48       pbs_terminate(3B), pbs_server(8B), and the PBS External Reference Spec‐
49       ification
50

DIAGNOSTICS

52       When the connection to batch server has been successfully created,  the
53       routine  will return a connection identifier which is positive.  Other‐
54       wise, a negative value  is  returned.   The  error  number  is  set  in
55       pbs_errno.
56
57
58
59
60Local                                                          pbs_connect(3B)
Impressum