Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
pbs_connect(3B)			      PBS		       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, 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 ad-
       ministrator 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 Spec-
       ification

DIAGNOSTICS
       When the	connection to batch server has been successfully created,  the
       routine	will return a connection identifier which is positive.	Other-
       wise, a negative	value is returned.  The	error number is	set in pbs_er-
       rno.

Local							       pbs_connect(3B)

NAME | SYNOPSIS | DESCRIPTION | SEE ALSO | DIAGNOSTICS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=pbs_connect&sektion=3b&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help