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)