Provided by:
torque-client-x11_2.4.15+dfsg-1_i386 
NAME
pbs_resources_unicosmk2 - pbs resources under Unicos MK2
DESCRIPTION
This page summarizes the resources and special features supported by
PBS for Cray Research computers running Unicos MK version 2. These
resources are specified by including them in the -l option argument on
the qsub or qalter command or in the PBS job script.
RESOURCES
cput Maximum amount of CPU time used by all processes in the job.
Root processes are not limited, see limit(2). Units: time.
mem Maximum amount of physical memory used by all concurrent
processes in the job. Units: size.
mppe The number of processing elements used by a single process in
the job. Units: unitary.
mppt Maximum amount of wall clock time used on the MPP in the job.
Units: time.
mta, mtb, mtc, ..., mth
Maximum number of magnetic tape drives required in the
corresponding device class of a, b, c, ..., h. Units: unitary.
nice The nice value under which the job is to be run. Units:
unitary.
pncpus Maximum number of processors used by any single process in the
job. Units: unitary.
pcput Maximum amount of CPU time used by any single process in the
job. Units: time.
pf Maximum number of file system blocks that can be used by all
process in the job. Units: size.
pmem Maximum amount of physical memory used by any single process in
the job. Units: size.
pmppt Maximum amount of wall clock time used on the MPP by a single
process in the job. Units: time.
ppf Maximum number of file system blocks that can be used by a
single process in the job. Units: size.
procs Maximum number of processes in the job. Units: unitary.
psds Maximum number of data blocks on the SDS (secondary data
storage) for any process in the job.
sds Maximum number of data blocks on the SDS (secondary data
storage) for the job.
srfs_tmp
Session Reservable File System (SRFS) space in TMPDIR. Note,
SRFS is not supported by Cray. Units: size.
srfs_wrk
SRFS space in WRKDIR. Units: size.
srfs_big
SRFS space in BIGDIR. Units: size.
srfs_fast
SRFS space in FASTDIR. Units: size.
walltime
Maximum amount of real time during which the job can be in the
running state. Units: time.
arch Specifies the administrator defined system architecture
requried. This defaults to whatever the PBS_MACH string is set
to in "local.mk". Units: string.
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.
nodes Number and/or type of nodes to be reserved for exclusive use by
the job. The value is one or more node_specs joined with the
'+' character, "node_spec[+node_spec...]. Each node_spec is an
number of nodes required of the type declared in the node_spec
and a name or one or more properity or properities desired for
the nodes. The number, the name, and each properity in the
node_spec are separated by a colon ':'. If no number is
specified, one (1) is assumed. Units: string.
The name of a node is its hostname. The properities of nodes
are:
. ppn=# specifying the number of processors per node requested.
Defaults to 1.
. arbitrary string assigned by the system administrator, please
check with your administrator as to the node names and
properities available to you.
Examples:
. To ask for 12 nodes of any type: -l nodes=12
. To ask for 2 "server" nodes and 14 other nodes (a total of
16): -l nodes=2:server+14
The above consist of two node_specs "2:server" and "14".
. 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:
-l nodes=server:hippi+10:noserver+3:bigmem:hippi
. To ask for three nodes by name:
-l nodes=b2005+b1803+b1813
. To ask for 2 processors on each of four nodes:
-l nodes=4:ppn=2
. To ask for 4 processors on one node:
-l nodes=1:ppn=4
. To ask for 2 processors on each of two blue nodes and three
processors on one red node:
-l nodes=2:blue:ppn=2+red:ppn=3
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.
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.
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.
EXAMPLES
qsub -l nodes=15,walltime=2:00:00 script
or in a qsub script as a directive:
#PBS -l nodes=15,walltime=2:00:00
qsub -l cput=1:00:00,pcput=20:00,file=50gb,mem=15mb,mta=2 script
qalter -lcput=30:00,pmem=8mb 123.jobid
qsub -lsrfs_tmp=50mb,srfs_big=2gw script
or in a qsub script as directives:
#PBS -l cput=1:00:00,pcput=20:00,file=50gb,mem=15mb,mta=2
#PBS -lsrfs_tmp=50mb,srfs_big=2gw
SPECIAL FEATURES
Cray Unicos MK supports checkpoint and restart. Any description of
checkpoint features in PBS are applicable to Unicos MK.
RESOURCE UNITS
The resource values take the following units:
time specifies a maximum time period the resource can be used. Time
is expressed in seconds as an integer, or in the form:
[[hours:]minutes:]seconds[.milliseconds]
size specifies the maximum amount in terms of bytes or words. It is
expressed in the form integer[suffix] The suffix is a
multiplier defined in the following table, The size of a word
is the word size on the execution host.
b or w bytes or words.
kb or kw Kilo (1024) bytes or words.
mb or mw Mega (1,048,576) bytes or words.
gb or gw Giga (1,073,741,824) bytes or words.
unitary The maximum amount of a resource which is expressed as a simple
integer.
SEE ALSO
the PBS ERS, qsub(1B), qalter(1B), pbs_submit(3B), pbs_alterjob(3B),
pbs_statjob(3b) pbs_resources_aix4(7B), pbs_resources_irix5(7B)
pbs_resources_sp2(7B), pbs_resources_sunos4(7B)