Provided by: torque-client_2.3.6+dfsg-0ubuntu3_i386 bug

NAME

       pbs_resources_solaris - pbs resources on SUN Solaris

DESCRIPTION

       This   page   summarizes   the  resources  supported  by  PBS  for  Sun
       workstations running Solaris 2.x.  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.
                 Units: time.

       file      The  largest  size  of any single file that may be created by
                 the job.  Units: size.

       nice      The nice value under which the job  is  to  be  run.   Units:
                 unitary.

       pcput     Maximum  amount of CPU time used by any single process in the
                 job.  Units: time.

       pmem      Maximum amount of physical memory (workingset)  used  by  any
                 single process of the job.  Units: size.

       pvmem     Maximum  amount  of virtual memory used by any single process
                 in the job.  Units: size.

       vmem      Maximum amount of  virtual  memory  used  by  all  concurrent
                 processes in the job.  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,walltime=2:00:00,file=50gb,vmem=15mb script
       qalter -lcput=30:00 123.jobid

       or in a qsub script as a directive:

       #PBS -l cput=1:00:00,walltime=2:00:00,file=50gb,vmem=15mb

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_sp2(7B),
       pbs_resources_sunos4(7B), pbs_resources_unicos8(7B)