Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
pbs(1B)				      PBS			       pbs(1B)

       pbs - general information on pbs

       PBS  stands for Portable	Batch System.  It is a networked subsystem for
       submitting, monitoring, and controlling a work load of  batch  jobs  on
       one  or	more  systems.	More information about PBS is available	in the
       PBS Users Guide.

       Batch means that	the job	will be	scheduled for execution	at a time cho-
       sen by the subsystem according to a defined policy and the availability
       of resources.  For a normal batch job, the standard output and standard
       error  of  the job will be returned to files available to the user when
       the job is complete.   This differs from	an interactive	session	 where
       commands	 are  executed when entered via	the terminal and output	is re-
       turned directly to the terminal.	  PBS  also  supports  an  interactive
       batch mode where	the input and output is	connected to the user's	termi-
       nal, but	the scheduling of the job is still under control of the	 batch

       A job is	typically a shell script and a set of attributes which provide
       resource	and control information	about the job.	A job does not have to
       be  submitted  on  the system where it will run,	tt can be submitted on
       any system with the PBS commands	and access to  the  execution  system,
       see qsub(1B).  Output will be returned to the system from which the job
       was submitted unless directed otherwise.

       Attributes offer	control	over when a job	is eligible to	be  run,  what
       happens to the output when it is	completed and how the user is notified
       when it completes.  The attributes of the job may be specified  on  the
       command	line  or in the	job script when	the job	is submitted.  For in-
       formation  about	 job  attributes,   see	  qsub(1B)   and   pbs_job_at-

       One  important  attribute is the	resource list.	The list specifies the
       amount and type of resources needed by the job  in  order  to  execute.
       The  list  also implies a hard upper limit on usage of those resources.
       When the	limit is reached, the job is terminated.   The	types  of  re-
       sources	available  to  a job vary with the system architecture.	 For a
       list  of	 resources  supported  on  the	default	 system,  see  pbs_re-
       sources(7B).   There are	man pages for other systems types as well, see
       pbs_resources_aix4(7B),	     pbs_resources_fujitsu(7B),	       pbs_re-
       sources_irix5(7B),  pbs_resources_solaris5(7B),	pbs_resources_sp2(7B),
       pbs_resources_sunos4(7B), or pbs_resources_unicos8(7B).

       Once a job has been submitted, it may be	monitored by use  of  the  qs-
       tat(1B) command.	 Two forms of output are available with	the qstat com-
       mand.  The default form is the short display.   Information about a job
       is  limited  to	a single line.	 Complete information about the	job or
       jobs is available through qstat with the	-f option.   Information  will
       be given	about all jobs in the system, all jobs in specified queues, or
       only specified jobs.

       When displaying status of jobs, you will	see in which queue the job re-
       sides.  In PBS a	queue is just a	collection point for jobs, it does not
       imply any execution ordering.  That ordering is determined by a	sched-
       uling policy implemented	by the system administration.

       Other commands of interest which	have man pages of their	own are:

       qalter  Alter a job's attributes.

       qdel    Delete a	job.

       qhold   Place  a	hold on	a job to keep it from being scheduled for run-

       qmove   Move a job to a different queue or server.

       qmsg    Append a	message	to the output of an executing job.

       qrerun  Terminate an executing job and return it	to a queue.

       qrls    Remove a	hold from a job.

       qselect Obtain a	list of	jobs that met certain criteria.

       qsig    Send a signal to	an executing job.

       qalter(1B),  qdel(1B),  qhold(1B),  qmove(1B),  qmsg(1B),   qrerun(1B),
       qrls(1B),  qselect(1B),	qsig(1B),  qsub(1B)  and  the  PBS User	Guide.
       Starting	with qsub(1B), you can find all	other available	PBS man	 pages
       by following references in the "See Also" section.

Local								       pbs(1B)


Want to link to this manual page? Use this URL:

home | help