pbs_locate - Man Page

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

char *pbs_locjob(int connect, char *job_id, char *extend)

Issue a batch request to locate a batch job. If the server currently manages the batch job, or knows which server does currently manage the job, it will reply with the location of the job.

A Locate Job batch request is generated and sent to the server over the connection specified by connect which is the return value of pbs_connect().

The argument, job_id, identifies which job is to be located, it is specified in the form: sequence_number.server

The argument, extend, is reserved for implementation defined extensions.  It is not currently  used by this function.

The return value is a pointer to a character sting which contains the current location if known. The syntax of the location string is: queue@server_name. If the location of the job is not known, the return value is the NULL pointer.

qsub(1B) and pbs_connect(3B)

When the batch request generated by the pbs_locjob() function has been completed successfully by a batch server, the routine will return a non null pointer to the destination. Otherwise, a null pointer is returned.  The error number is set in pbs_errno.