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)

Local                                                                                pbs_resources_unicosmk2(7B)