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

NAME

6       pbs - general information on pbs
7

DESCRIPTION

9       PBS  stands for Portable Batch System.  It is a networked subsystem for
10       submitting, monitoring, and controlling a work load of  batch  jobs  on
11       one  or  more  systems.  More information about PBS is available in the
12       PBS Users Guide.
13
14       Batch means that the job will be scheduled for execution at a time cho‐
15       sen by the subsystem according to a defined policy and the availability
16       of resources.  For a normal batch job, the standard output and standard
17       error  of  the job will be returned to files available to the user when
18       the job is complete.   This differs from an interactive  session  where
19       commands  are  executed  when  entered  via  the terminal and output is
20       returned directly to the terminal.   PBS also supports  an  interactive
21       batch mode where the input and output is connected to the user's termi‐
22       nal, but the scheduling of the job is still under control of the  batch
23       system.
24
25       A job is typically a shell script and a set of attributes which provide
26       resource and control information about the job.  A job does not have to
27       be  submitted  on  the system where it will run, tt can be submitted on
28       any system with the PBS commands and access to  the  execution  system,
29       see qsub(1B).  Output will be returned to the system from which the job
30       was submitted unless directed otherwise.
31
32       Attributes offer control over when a job is eligible to  be  run,  what
33       happens to the output when it is completed and how the user is notified
34       when it completes.  The attributes of the job may be specified  on  the
35       command  line  or  in  the  job  script when the job is submitted.  For
36       information    about    job    attributes,     see     qsub(1B)     and
37       pbs_job_attributes(7B).
38
39       One  important  attribute is the resource list.  The list specifies the
40       amount and type of resources needed by the job  in  order  to  execute.
41       The  list  also implies a hard upper limit on usage of those resources.
42       When the limit is  reached,  the  job  is  terminated.   The  types  of
43       resources  available to a job vary with the system architecture.  For a
44       list   of   resources   supported   on   the   default   system,    see
45       pbs_resources(7B).   There  are  man  pages  for other systems types as
46       well,    see     pbs_resources_aix4(7B),     pbs_resources_fujitsu(7B),
47       pbs_resources_irix5(7B),                    pbs_resources_solaris5(7B),
48       pbs_resources_sp2(7B), pbs_resources_sunos4(7B), or  pbs_resources_uni‐
49       cos8(7B).
50
51       Once  a  job  has  been  submitted,  it  may be monitored by use of the
52       qstat(1B) command.  Two forms of output are available  with  the  qstat
53       command.   The default form is the short display.   Information about a
54       job is limited to a single line.   Complete information about  the  job
55       or  jobs  is  available  through qstat with the -f option.  Information
56       will be given about all jobs in  the  system,  all  jobs  in  specified
57       queues, or only specified jobs.
58
59       When  displaying  status  of  jobs, you will see in which queue the job
60       resides.  In PBS a queue is just a collection point for jobs,  it  does
61       not  imply  any  execution  ordering.  That ordering is determined by a
62       scheduling policy implemented by the system administration.
63
64       Other commands of interest which have man pages of their own are:
65
66       qalter  Alter a job's attributes.
67
68       qdel    Delete a job.
69
70       qhold   Place a hold on a job to keep it from being scheduled for  run‐
71               ning.
72
73       qmove   Move a job to a different queue or server.
74
75       qmsg    Append a message to the output of an executing job.
76
77       qrerun  Terminate an executing job and return it to a queue.
78
79       qrls    Remove a hold from a job.
80
81       qselect Obtain a list of jobs that met certain criteria.
82
83       qsig    Send a signal to an executing job.
84

SEE ALSO

86       qalter(1B),   qdel(1B),  qhold(1B),  qmove(1B),  qmsg(1B),  qrerun(1B),
87       qrls(1B), qselect(1B), qsig(1B),  qsub(1B)  and  the  PBS  User  Guide.
88       Starting  with qsub(1B), you can find all other available PBS man pages
89       by following references in the "See Also" section.
90
91
92
93
94Local                                                                  pbs(1B)
Impressum