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

NAME

6       pbs_stagein - request that files for a pbs batch job be staged in.
7

SYNOPSIS

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

DESCRIPTION

16       Issue  a  batch request to start the stage in of files specified in the
17       stagein attribute of a batch job.
18
19       A stage in 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       This request directs the server to begin the stage in of  files  speci‐
24       fied  in  the job's stage in attribute.  This request requires that the
25       issuing user have operator or administrator privilege.
26
27       The argument, job_id, identifies which job for which file staging is to
28       begin.  It is specified in the form: sequence_number.server
29
30       The  argument, location, if not the null pointer or null string, speci‐
31       fies the location where the job will  be run and  hence  to  where  the
32       files  will  be  staged.  The location is the name of a host in the the
33       cluster managed by the server.  If the job is then directed to  run  at
34       different location, the run request will be rejected.
35
36       The  argument,  extend,  is  reserved for implementation defined exten‐
37       sions.
38

SEE ALSO

40       qrun(8B), qsub(1B), and pbs_connect(3B)
41

DIAGNOSTICS

43       When the batch request generated by  pbs_stagein()  function  has  been
44       completed  successfully  by  a  batch server, the routine will return 0
45       (zero).  Otherwise, a non zero error is returned.  The error number  is
46       also set in pbs_errno.
47
48
49
50
51Local                                                          pbs_stagein(3B)