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

NAME

6       pbs_resources_linux - pbs resources on Linux
7

DESCRIPTION

9       This page summarizes the resources supported by PBS for PC workstations
10       running Linux.  These resources are specified by including them in  the
11       -l  option  argument  on  the  qsub or qalter command or in the PBS job
12       script.
13

RESOURCES

15       cput      Maximum amount of CPU time used by all processes in the  job.
16                 Units: time.
17
18       file      The  largest  size  of any single file that may be created by
19                 the job.  Units: size.
20
21       nice      The nice value under which the job is to be run.  Units: uni‐
22                 tary.
23
24       pcput     Maximum  amount of CPU time used by any single process in the
25                 job.  Units: time.
26
27       pmem      Maximum amount of physical memory (workingset)  used  by  any
28                 single process of the job.  Units: size.
29
30       pvmem     Maximum  amount  of virtual memory used by any single process
31                 in the job.  Units: size.
32
33       vmem      Maximum amount of virtual memory used by all concurrent  pro‐
34                 cesses in the job.  Units: size.
35
36       walltime  Maximum  amount  of  real time during which the job can be in
37                 the running state.  Units: time.
38
39       arch      Specifies  the  administrator  defined  system   architecture
40                 requried.   This  defaults to whatever the PBS_MACH string is
41                 set to in "local.mk".  Units: string.
42
43       host      Name of host on which job should be run.   This  resource  is
44                 provided  for  use  by  the  site's  scheduling policy.   The
45                 allowable values and effect on job placement is  site  depen‐
46                 dent.  Units: string.
47
48       nodes     Number  and/or type of nodes to be reserved for exclusive use
49                 by the job.  The value is one or more node_specs joined  with
50                 the '+' character, "node_spec[+node_spec...].  Each node_spec
51                 is an number of nodes required of the type  declared  in  the
52                 node_spec  and a name or one or more properity or properities
53                 desired for the  nodes.   The  number,  the  name,  and  each
54                 properity  in the node_spec are separated by a colon ':'.  If
55                 no number is specified, one (1) is assumed.  Units: string.
56
57                 The name of a node is its hostname.  The properities of nodes
58                 are:
59
60                 . ppn=#   specifying   the  number  of  processors  per  node
61                   requested.  Defaults to 1.
62
63                 . arbitrary string  assigned  by  the  system  administrator,
64                   please  check  with your administrator as to the node names
65                   and properities available to you.
66
67                 Examples:
68
69                 . To ask for 12 nodes of any type: -l nodes=12
70
71                 . To ask for 2 "server" nodes and 14 other nodes (a total  of
72                   16): -l nodes=2:server+14
73                   The above consist of two node_specs "2:server" and "14".
74
75                 . To  ask for (a) 1 node that is a "server" and has a "hippi"
76                   interface, (b) 10 nodes that are not  servers,  and  (c)  3
77                   nodes that have a large amount of memory an have hippi:
78                   -l nodes=server:hippi+10:noserver+3:bigmem:hippi
79
80                 . To ask for three nodes by name:
81                   -l nodes=b2005+b1803+b1813
82
83                 . To ask for 2 processors on each of four nodes:
84                   -l nodes=4:ppn=2
85
86                 . To ask for 4 processors on one node:
87                   -l nodes=1:ppn=4
88
89                 . To ask for 2 processors on each of two blue nodes and three
90                   processors on one red node:
91                   -l nodes=2:blue:ppn=2+red:ppn=3
92
93       host      Allows a user to  specify  the  desired  execution  location.
94                 This  resource  is  provided for use by the site's scheduling
95                 policy.  The allowable values and effect on job placement  is
96                 site dependent.  Units: string.
97
98       other     Allows  a  user  to  specify site specific information.  This
99                 resource is provided for use by the site's scheduling policy.
100                 The  allowable  values  and  effect  on job placement is site
101                 dependent.  Units: string.
102
103       software  Allows a user to specify software required by the job.   This
104                 is  useful if certain software packages are only available on
105                 certain systems in the site.  This resource is  provided  for
106                 use  by  the  site's scheduling policy.  The allowable values
107                 and effect  on  job  placement  is  site  dependent.   Units:
108                 string.
109

EXAMPLES

111       qsub -l nodes=15,walltime=2:00:00 script
112
113       or in a qsub script as a directive:
114
115       #PBS -l nodes=15,walltime=2:00:00
116
117
118       qsub -l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb script
119       qalter -lcput=30:00,pmem=8mb 123.jobid
120
121       or in a qsub script as a directive:
122
123       #PBS -l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb
124

RESOURCE UNITS

126       The resource values take the following units:
127
128       time    specifies a maximum time period the resource can be used.  Time
129               is expressed in seconds as an integer, or in the form:
130               [[hours:]minutes:]seconds[.milliseconds]
131
132       size    specifies the maximum amount in terms of bytes or words.  It is
133               expressed  in  the  form integer[suffix] The suffix is a multi‐
134               plier defined in the following table, The size of a word is the
135               word size on the execution host.
136
137                b or  w    bytes or words.
138
139               kb or kw    Kilo (1024) bytes or words.
140
141               mb or mw    Mega (1,048,576) bytes or words.
142
143               gb or gw    Giga (1,073,741,824) bytes or words.
144
145       unitary The maximum amount of a resource which is expressed as a simple
146               integer.
147

SEE ALSO

149       the PBS ERS, qsub(1B),  qalter(1B),  pbs_submit(3B),  pbs_alterjob(3B),
150       pbs_statjob(3b)      pbs_resources_aix4(7B),     pbs_resources_sp2(7B),
151       pbs_resources_sunos4(7B), pbs_resources_unicos8(7B)
152
153
154
155Local                                                  pbs_resources_linux(7B)
Impressum