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

NAME

6       pbs_movejob - move a pbs batch job to a new destination
7

SYNOPSIS

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

DESCRIPTION

16       Issue  a  batch request to move a job to a new destination.  The job is
17       removed from the present queue and instantiated in a new queue.
18
19       A Move 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 job_id parameter identifies which job is to be moved; it is  speci‐
24       fied in the form: sequence_number.server
25
26       The  destination  parameter  specifies the new destination for the job.
27       It is specified as: [queue][@server].  If destination is a null pointer
28       or a null string, the destination will be the default queue at the cur‐
29       rent server.  If destination specifies a queue but not  a  server,  the
30       destination will be the named queue at the current server.  If destina‐
31       tion specifies a server but not a queue, the destination  will  be  the
32       default  queue  at  the  named server.  If destination specifies both a
33       queue and a server, the destination is that queue at that server.
34
35       A job in the Running , Transiting , or Exiting state cannot be moved.
36
37       The parameter, extend, is reserved for  implementation  defined  exten‐
38       sions.
39

SEE ALSO

41       qmove(1B), qsub(1B), and pbs_connect(3B)
42

DIAGNOSTICS

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