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

NAME

6       pbs_locjob - locate current location of a pbs batch job
7

SYNOPSIS

9       #include <pbs_error.h>
10       #include <pbs_ifl.h>
11
12       char *pbs_locjob(int connect, char *job_id, char *extend)
13

DESCRIPTION

15       Issue  a  batch request to locate a batch job.  If the server currently
16       manages the batch job, or knows which server does currently manage  the
17       job, it will reply with the location of the job.
18
19       A Locate Job batch request is generated and sent to the server over the
20       connection specified by connect which is the return value  of  pbs_con‐
21       nect().
22
23       The  argument,  job_id,  identifies  which  job is to be located, it is
24       specified in the form: sequence_number.server
25
26       The argument, extend, is reserved  for  implementation  defined  exten‐
27       sions.  It is not currently used by this function.
28
29       The  return  value is a pointer to a character sting which contains the
30       current location if known.  The  syntax  of  the  location  string  is:
31       queue@server_name.  If the location of the job is not known, the return
32       value is the NULL pointer.
33

SEE ALSO

35       qsub(1B) and pbs_connect(3B)
36

DIAGNOSTICS

38       When the batch request generated by the pbs_locjob() function has  been
39       completed successfully by a batch server, the routine will return a non
40       null  pointer  to  the  destination.   Otherwise,  a  null  pointer  is
41       returned.  The error number is set in pbs_errno.
42
43
44
45
46
47Local                                                           pbs_locjob(3B)