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

NAME

6       pbs_runjob - run a pbs batch job
7

SYNOPSIS

9       #include <pbs_error.h>
10       #include <pbs_ifl.h>
11
12       int pbs_runjob(int connect, char *job_id, char *location, char *extend)
13
14       int     pbs_asyrunjob(int connect,     char *job_id,    char *location,
15       char *extend)
16

DESCRIPTION

18       Issue a batch request to run a batch job.
19
20       For pbs_runjob() a "Run Job" batch request is generated and sent to the
21       server  over  the  connection  specified by connect which is the return
22       value of pbs_connect().  The server will reply when the job has started
23       execution unless file in-staging is required.  In that case, the server
24       will reply when the staging operations are started.
25
26       For pbs_asyrunjob() an "Asynchronous Run Job" request is generated  and
27       set  to  the  server over the connection.  The server will validate the
28       request and reply before initiating the execution of  the  job.    This
29       version  of the call can be used to reduce latency in scheduling, espe‐
30       cially when the scheduler must start a large number of jobs.
31
32       These requests requires that the issuing user have operator or adminis‐
33       trator privilege.
34
35       The argument, job_id, identifies which job is to be run it is specified
36       in the form: sequence_number.server
37
38       The argument, location, if not the null pointer or null string,  speci‐
39       fies  the  location  where  the job should be run.  The location is the
40       name of a host in the the cluster managed by the server.
41
42       The argument, extend, is reserved  for  implementation  defined  exten‐
43       sions.
44

SEE ALSO

46       qrun(8B), qsub(1B), and pbs_connect(3B)
47

DIAGNOSTICS

49       When the batch request generated by the pbs_runjob() or pbs_asyrunjob()
50       functions has been completed successfully by a batch server,  the  rou‐
51       tines  will  return 0 (zero).  Otherwise, a non zero error is returned.
52       The error number is also set in pbs_errno.
53
54
55
56
57Local                                                           pbs_runjob(3B)
Impressum