xenial (1) pbs.1B.gz

Provided by: torque-client-x11_2.4.16+dfsg-1.5_amd64 bug

NAME

       pbs - general information on pbs

DESCRIPTION

       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 chosen 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  returned  directly  to  the terminal.   PBS also supports an interactive batch mode where the
       input and output is connected to the user's terminal, but the  scheduling  of  the  job  is  still  under
       control of the batch system.

       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 information about  job  attributes,
       see qsub(1B) and pbs_job_attributes(7B).

       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 resources available to a job vary with
       the system architecture.  For a list of resources supported on the default system, see pbs_resources(7B).
       There    are    man    pages   for   other   systems   types   as   well,   see   pbs_resources_aix4(7B),
       pbs_resources_fujitsu(7B),  pbs_resources_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 qstat(1B) command.  Two forms of output
       are available with the qstat command.  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 resides.  In PBS a queue is just a
       collection point for jobs, it does not imply any execution ordering.  That ordering is  determined  by  a
       scheduling 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 running.

       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.

SEE ALSO

       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.