170 lines
7.0 KiB
Plaintext
170 lines
7.0 KiB
Plaintext
.\" OpenPBS (Portable Batch System) v2.3 Software License
|
|
.\"
|
|
.\" Copyright (c) 1999-2000 Veridian Information Solutions, Inc.
|
|
.\" All rights reserved.
|
|
.\"
|
|
.\" ---------------------------------------------------------------------------
|
|
.\" For a license to use or redistribute the OpenPBS software under conditions
|
|
.\" other than those described below, or to purchase support for this software,
|
|
.\" please contact Veridian Systems, PBS Products Department ("Licensor") at:
|
|
.\"
|
|
.\" www.OpenPBS.org +1 650 967-4675 sales@OpenPBS.org
|
|
.\" 877 902-4PBS (US toll-free)
|
|
.\" ---------------------------------------------------------------------------
|
|
.\"
|
|
.\" This license covers use of the OpenPBS v2.3 software (the "Software") at
|
|
.\" your site or location, and, for certain users, redistribution of the
|
|
.\" Software to other sites and locations. Use and redistribution of
|
|
.\" OpenPBS v2.3 in source and binary forms, with or without modification,
|
|
.\" are permitted provided that all of the following conditions are met.
|
|
.\" After December 31, 2001, only conditions 3-6 must be met:
|
|
.\"
|
|
.\" 1. Commercial and/or non-commercial use of the Software is permitted
|
|
.\" provided a current software registration is on file at www.OpenPBS.org.
|
|
.\" If use of this software contributes to a publication, product, or service
|
|
.\" proper attribution must be given; see www.OpenPBS.org/credit.html
|
|
.\"
|
|
.\" 2. Redistribution in any form is only permitted for non-commercial,
|
|
.\" non-profit purposes. There can be no charge for the Software or any
|
|
.\" software incorporating the Software. Further, there can be no
|
|
.\" expectation of revenue generated as a consequence of redistributing
|
|
.\" the Software.
|
|
.\"
|
|
.\" 3. Any Redistribution of source code must retain the above copyright notice
|
|
.\" and the acknowledgment contained in paragraph 6, this list of conditions
|
|
.\" and the disclaimer contained in paragraph 7.
|
|
.\"
|
|
.\" 4. Any Redistribution in binary form must reproduce the above copyright
|
|
.\" notice and the acknowledgment contained in paragraph 6, this list of
|
|
.\" conditions and the disclaimer contained in paragraph 7 in the
|
|
.\" documentation and/or other materials provided with the distribution.
|
|
.\"
|
|
.\" 5. Redistributions in any form must be accompanied by information on how to
|
|
.\" obtain complete source code for the OpenPBS software and any
|
|
.\" modifications and/or additions to the OpenPBS software. The source code
|
|
.\" must either be included in the distribution or be available for no more
|
|
.\" than the cost of distribution plus a nominal fee, and all modifications
|
|
.\" and additions to the Software must be freely redistributable by any party
|
|
.\" (including Licensor) without restriction.
|
|
.\"
|
|
.\" 6. All advertising materials mentioning features or use of the Software must
|
|
.\" display the following acknowledgment:
|
|
.\"
|
|
.\" "This product includes software developed by NASA Ames Research Center,
|
|
.\" Lawrence Livermore National Laboratory, and Veridian Information
|
|
.\" Solutions, Inc.
|
|
.\" Visit www.OpenPBS.org for OpenPBS software support,
|
|
.\" products, and information."
|
|
.\"
|
|
.\" 7. DISCLAIMER OF WARRANTY
|
|
.\"
|
|
.\" THIS SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. ANY EXPRESS
|
|
.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
|
.\" OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT
|
|
.\" ARE EXPRESSLY DISCLAIMED.
|
|
.\"
|
|
.\" IN NO EVENT SHALL VERIDIAN CORPORATION, ITS AFFILIATED COMPANIES, OR THE
|
|
.\" U.S. GOVERNMENT OR ANY OF ITS AGENCIES BE LIABLE FOR ANY DIRECT OR INDIRECT,
|
|
.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
|
|
.\" LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
|
|
.\" OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
|
|
.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
|
|
.\" NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
|
|
.\" EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
.\"
|
|
.\" This license will be governed by the laws of the Commonwealth of Virginia,
|
|
.\" without reference to its choice of law rules.
|
|
.IP arch
|
|
Specifies the administrator defined system architecture requried.
|
|
This defaults to whatever the PBS_MACH string is set to in "local.mk".
|
|
Units: string.
|
|
.IP host
|
|
Name of host on which job should be run. This resource is provided for
|
|
use by the site's scheduling policy. The allowable values and effect
|
|
on job placement is site dependent.
|
|
Units: string.
|
|
.IP nodes
|
|
Number and/or type of nodes to be reserved for exclusive use by the job.
|
|
The value is one or more
|
|
.I node_specs
|
|
joined with the '+' character, "node_spec[+node_spec...].
|
|
Each node_spec is an
|
|
.I number
|
|
of nodes required of the type declared in the node_spec and a
|
|
.I name
|
|
or one or more
|
|
.I property
|
|
or properties desired for the nodes.
|
|
The number, the name, and each property in the node_spec are separated by
|
|
a colon ':'. If no number is specified, one (1) is assumed.
|
|
Units: string.
|
|
.IP
|
|
The name of a node is its hostname. The properties of nodes are:
|
|
.RS
|
|
.IP . 2
|
|
ppn=#
|
|
specifying the number of processors per node requested. Defaults to 1.
|
|
.IP . 2
|
|
arbitrary string assigned by the system
|
|
administrator, please check with your administrator as to the node names
|
|
and properties available to you.
|
|
.RE
|
|
.IP
|
|
Examples:
|
|
.RS
|
|
.IP . 2
|
|
To ask for 12 nodes of any type: \-l\ nodes=12
|
|
.IP . 2
|
|
To ask for 2 "server" nodes and 14 other nodes (a total of 16):
|
|
\-l\ nodes=2:server+14
|
|
.br
|
|
The above consist of two node_specs "2:server" and "14".
|
|
.IP . 2
|
|
To ask for (a) 1 node that is a "server" and has a "hippi" interface, (b) 10
|
|
nodes that are not servers, and (c) 3 nodes that have a large amount of memory
|
|
an have hippi:
|
|
.br
|
|
\-l\ nodes=server:hippi+10:noserver+3:bigmem:hippi
|
|
.IP . 2
|
|
To ask for three nodes by name:
|
|
.br
|
|
\-l\ nodes=b2005+b1803+b1813
|
|
.IP . 2
|
|
To ask for 2 processors on each of four nodes:
|
|
.br
|
|
\-l\ nodes=4:ppn=2
|
|
.IP . 2
|
|
To ask for 4 processors on one node:
|
|
.br
|
|
\-l\ nodes=1:ppn=4
|
|
.IP . 2
|
|
To ask for 2 processors on each of two blue nodes and three processors on
|
|
one red node:
|
|
.br
|
|
\-l\ nodes=2:blue:ppn=2+red:ppn=3
|
|
.RE
|
|
.IP host
|
|
Allows a user to specify the desired execution location.
|
|
This resource is provided for use by the site's scheduling policy.
|
|
The allowable values and effect on job placement is site dependent.
|
|
Units: string.
|
|
.IP other
|
|
Allows a user to specify site specific information.
|
|
This resource is provided for use by the site's scheduling policy.
|
|
The allowable values and effect on job placement is site dependent.
|
|
Units: string.
|
|
.IP software
|
|
Allows a user to specify software required by the job. This is useful
|
|
if certain software packages are only available on certain systems in the site.
|
|
This resource is provided for use by the site's scheduling policy.
|
|
The allowable values and effect on job placement is site dependent.
|
|
Units: string.
|
|
.LP
|
|
.Sh EXAMPLES
|
|
qsub \-l nodes=15,walltime=2:00:00 script
|
|
.LP
|
|
or in a qsub script as a directive:
|
|
.LP
|
|
#PBS \-l nodes=15,walltime=2:00:00
|
|
|