1pbs(1B) PBS pbs(1B)
2
6 pbs - general information on pbs
7
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 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 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 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 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 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 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 Other commands of interest which have man pages of their own are:
65 qalter Alter a job's attributes.
67 qdel Delete a job.
69 qhold Place a hold on a job to keep it from being scheduled for run‐
71 ning.
72 qmove Move a job to a different queue or server.
74 qmsg Append a message to the output of an executing job.
76 qrerun Terminate an executing job and return it to a queue.
78 qrls Remove a hold from a job.
80 qselect Obtain a list of jobs that met certain criteria.
82 qsig Send a signal to an executing job.
84
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.
90Local pbs(1B)