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

NAME

       pbs_resources_unicosmk2 - pbs resources under Unicos MK2

DESCRIPTION

       This  page  summarizes  the resources and special features supported by
       PBS for Cray Research computers running Unicos  MK  version  2.   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.
              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 MK supports checkpoint and restart.    Any  description  of
       checkpoint features in PBS are applicable to Unicos MK.

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)