Provided by: torque-client-x11_2.4.15+dfsg-1_i386 bug

NAME

       pbs_resources_unicos - pbs resources under Unicos

DESCRIPTION

       This  page  summarizes  the resources and special features supported by
       PBS for Cray Research computers running Unicos versions 8 and 9.  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

       ncpus     Maximum number of multitask processes in the job.  If this is
                 set  the  environment variable NCPUS will be set to the given
                 value.  Units: unitary.

       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 supports  checkpoint  and  restart.    Any  description  of
       checkpoint features in PBS are applicable to Unicos.

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)