1pbs_resources_unicos(7B)              PBS             pbs_resources_unicos(7B)
2
3
4

NAME

6       pbs_resources_unicos - pbs resources under Unicos
7

DESCRIPTION

9       This  page  summarizes  the resources and special features supported by
10       PBS for Cray Research computers running Unicos versions 8 and 9.  These
11       resources  are specified by including them in the -l option argument on
12       the qsub or qalter command or in the PBS job script.
13

RESOURCES

15       ncpus     Maximum number of multitask processes in the job.  If this is
16                 set  the  environment variable NCPUS will be set to the given
17                 value.  Units: unitary.
18
19       cput      Maximum amount of CPU time used by all processes in the  job.
20                 Root processes are not limited, see limit(2).  Units: time.
21
22       mem       Maximum amount of physical memory used by all concurrent pro‐
23                 cesses in the job.  Units: size.
24
25       mppe      The number of processing elements used by a single process in
26                 the job.  Units: unitary.
27
28       mppt      Maximum amount of wall clock time used on the MPP in the job.
29                 Units: time.
30
31       mta, mtb, mtc, ..., mth
32                 Maximum number of magnetic tape drives required in the corre‐
33                 sponding device class of a, b, c, ..., h.  Units: unitary.
34
35       nice      The nice value under which the job is to be run.  Units: uni‐
36                 tary.
37
38       pncpus    Maximum number of processors used by any  single  process  in
39                 the job.  Units: unitary.
40
41       pcput     Maximum  amount of CPU time used by any single process in the
42                 job.  Units: time.
43
44       pf        Maximum number of file system blocks that can be used by  all
45                 process in the job.  Units: size.
46
47       pmem      Maximum  amount of physical memory used by any single process
48                 in the job.  Units: size.
49
50       pmppt     Maximum amount of wall clock time used on the MPP by a single
51                 process in the job.  Units: time.
52
53       ppf       Maximum  number  of  file system blocks that can be used by a
54                 single process in the job.  Units: size.
55
56       procs     Maximum number of processes in the job.  Units: unitary.
57
58       psds      Maximum number of data blocks  on  the  SDS  (secondary  data
59                 storage) for any process in the job.
60
61       sds       Maximum  number  of  data  blocks  on the SDS (secondary data
62                 storage) for the job.
63
64       srfs_tmp  Session Reservable File System (SRFS) space in TMPDIR.  Note,
65                 SRFS is not supported by Cray.  Units: size.
66
67       srfs_wrk  SRFS space in WRKDIR.  Units: size.
68
69       srfs_big  SRFS space in BIGDIR.  Units: size.
70
71       srfs_fast SRFS space in FASTDIR.  Units: size.
72
73       walltime  Maximum  amount  of  real time during which the job can be in
74                 the running state.  Units: time.
75
76       arch      Specifies  the  administrator  defined  system   architecture
77                 requried.   This  defaults to whatever the PBS_MACH string is
78                 set to in "local.mk".  Units: string.
79
80       host      Name of host on which job should be run.   This  resource  is
81                 provided  for  use  by  the  site's  scheduling policy.   The
82                 allowable values and effect on job placement is  site  depen‐
83                 dent.  Units: string.
84
85       nodes     Number  and/or type of nodes to be reserved for exclusive use
86                 by the job.  The value is one or more node_specs joined  with
87                 the '+' character, "node_spec[+node_spec...].  Each node_spec
88                 is an number of nodes required of the type  declared  in  the
89                 node_spec  and a name or one or more properity or properities
90                 desired for the  nodes.   The  number,  the  name,  and  each
91                 properity  in the node_spec are separated by a colon ':'.  If
92                 no number is specified, one (1) is assumed.  Units: string.
93
94                 The name of a node is its hostname.  The properities of nodes
95                 are:
96
97                 . ppn=#   specifying   the  number  of  processors  per  node
98                   requested.  Defaults to 1.
99
100                 . arbitrary string  assigned  by  the  system  administrator,
101                   please  check  with your administrator as to the node names
102                   and properities available to you.
103
104                 Examples:
105
106                 . To ask for 12 nodes of any type: -l nodes=12
107
108                 . To ask for 2 "server" nodes and 14 other nodes (a total  of
109                   16): -l nodes=2:server+14
110                   The above consist of two node_specs "2:server" and "14".
111
112                 . To  ask for (a) 1 node that is a "server" and has a "hippi"
113                   interface, (b) 10 nodes that are not  servers,  and  (c)  3
114                   nodes that have a large amount of memory an have hippi:
115                   -l nodes=server:hippi+10:noserver+3:bigmem:hippi
116
117                 . To ask for three nodes by name:
118                   -l nodes=b2005+b1803+b1813
119
120                 . To ask for 2 processors on each of four nodes:
121                   -l nodes=4:ppn=2
122
123                 . To ask for 4 processors on one node:
124                   -l nodes=1:ppn=4
125
126                 . To ask for 2 processors on each of two blue nodes and three
127                   processors on one red node:
128                   -l nodes=2:blue:ppn=2+red:ppn=3
129
130       host      Allows a user to  specify  the  desired  execution  location.
131                 This  resource  is  provided for use by the site's scheduling
132                 policy.  The allowable values and effect on job placement  is
133                 site dependent.  Units: string.
134
135       other     Allows  a  user  to  specify site specific information.  This
136                 resource is provided for use by the site's scheduling policy.
137                 The  allowable  values  and  effect  on job placement is site
138                 dependent.  Units: string.
139
140       software  Allows a user to specify software required by the job.   This
141                 is  useful if certain software packages are only available on
142                 certain systems in the site.  This resource is  provided  for
143                 use  by  the  site's scheduling policy.  The allowable values
144                 and effect  on  job  placement  is  site  dependent.   Units:
145                 string.
146

EXAMPLES

148       qsub -l nodes=15,walltime=2:00:00 script
149
150       or in a qsub script as a directive:
151
152       #PBS -l nodes=15,walltime=2:00:00
153
154
155       qsub -l cput=1:00:00,pcput=20:00,file=50gb,mem=15mb,mta=2 script
156       qalter -lcput=30:00,pmem=8mb 123.jobid
157       qsub -lsrfs_tmp=50mb,srfs_big=2gw script
158
159       or in a qsub script as directives:
160
161       #PBS -l cput=1:00:00,pcput=20:00,file=50gb,mem=15mb,mta=2
162       #PBS -lsrfs_tmp=50mb,srfs_big=2gw
163

SPECIAL FEATURES

165       Cray  Unicos  supports  checkpoint  and  restart.    Any description of
166       checkpoint features in PBS are applicable to Unicos.
167

RESOURCE UNITS

169       The resource values take the following units:
170
171       time    specifies a maximum time period the resource can be used.  Time
172               is expressed in seconds as an integer, or in the form:
173               [[hours:]minutes:]seconds[.milliseconds]
174
175       size    specifies the maximum amount in terms of bytes or words.  It is
176               expressed in the form integer[suffix] The suffix  is  a  multi‐
177               plier defined in the following table, The size of a word is the
178               word size on the execution host.
179
180                b or  w    bytes or words.
181
182               kb or kw    Kilo (1024) bytes or words.
183
184               mb or mw    Mega (1,048,576) bytes or words.
185
186               gb or gw    Giga (1,073,741,824) bytes or words.
187
188       unitary The maximum amount of a resource which is expressed as a simple
189               integer.
190

SEE ALSO

192       the  PBS  ERS,  qsub(1B), qalter(1B), pbs_submit(3B), pbs_alterjob(3B),
193       pbs_statjob(3b)     pbs_resources_aix4(7B),     pbs_resources_irix5(7B)
194       pbs_resources_sp2(7B), pbs_resources_sunos4(7B)
195
196
197
198Local                                                 pbs_resources_unicos(7B)
Impressum