SGE_TYPES(1)               Grid Engine User Commands              SGE_TYPES(1)



[1mNAME[0m
       sge_types - Grid Engine type descriptions

[1mDESCRIPTION[0m
       The  Grid Engine user interface consists of several programs and files.
       Some command-line switches and several file attributes are  types.  The
       syntax for these types is explained in this page.


[1mTYPES[0m
       The syntax of Grid Engine types in alphabetic order:

   [1mpattern[0m
       When ever patterns are used the following definition applies:

       "*"     matches any character and any number of characters
               (between 0 and inv).
       "?"     matches any character. It cannot be no character
       "."     is the character ".". It has no other meaning
       "\"     escape character. "\\" = "\", "\*" = "*", "\?" = "?"
       "[xx]"  specifies an array or a range of allowed
               characters for one character at a specific position

       The  pattern  itself should be put into '"' to ensure, that the clients
       get the pattern. The or '|' operator is not supported.


   [1mrange[0m
       The task range specifier has the form

       n[-m[:s]][,n[-m[:s]], ...]  or n[-m[:s]][ n[-m[:s]] ...]

       and thus consists of a comma or blank separated list  of  range  speci-
       fiers  n[-m[:s]].  The  ranges are concatenated to the complete task id
       range. Each range may be a single number, a simple range of the form n-
       m or a range with a step size.


   [1mwc_host[0m
       A  wildcard host specification ([4mwc_host[24m) is a wildcard expression which
       might match one or more hosts used in the cluster.  The first character
       of  that  string  never  begins with an at-character ('@'), even if the
       expression begins with a wildcard character.

       e.g.
              *            all hosts
              a*           all host beginning with an 'a'

   [1mwc_hostgroup[0m
       A wildcard hostgroup specification ([4mwc_hostgroup[24m) is a wildcard expres-
       sion  which might match one or more hostgroups.  The first character of
       that string is always a at-character ('@').

       More information concerning hostgroups can be found in [4mhostgroup[24m(5)

       e.g.
              @*           all hostgroups in the cluster
              @solaris     the @solaris hostgroup

   [1mwc_job[0m
       The wildcard job specification is a placeholder for job ids, job  names
       include  job  name wildcard expressions. A job id always references one
       job, while the names and patterns might reference multiple jobs.

       wc_job := job-id | job-name | pattern


   [1mwc_job_range[0m
       The wildcard job range specification allows to reference specific array
       tasks  for one or multipe jobs. The job is referenced via wc_job and in
       addition gets a range specifier for the array tasks.

       wc_job_range := wc_job [ -t range]


   [1mwc_job_list[0m
       The wildcard job list specification allows to reference  multiple  jobs
       with one command.

       wc_job_list := wc_job [ , wc_job , ...]


   [1mwc_job_range_list[0m
       The  wildcard job range list ([4mwc_job_range_list[24m) is specified by one of
       the following forms:

           [4mwc_job[[24m [4m-t[24m [4mrange][{,[24m [4m}wc_job[[24m [4m-t[24m [4mrange]{,[24m [4m}...][0m

       If present, the [4mtask_range[24m restricts the effect of the  [4mqmod[24m  operation
       to  the array job task range specified as suffix to the job id (see the
       [1m-t [22moption to [4mqsub[24m(1) for further details on array jobs).


   [1mwc_qdomain[0m
       [4mwc_qdomain[24m := [4mwc_cqueue[24m "@" [4mwc_hostgroup[0m

       A wildcard queue domain specification ([4mwc_qdomain[24m) starts with a  wild-
       card cluster queue name ([4mwc_cqueue[24m) followed by an at-character '@' and
       a wildcard hostgroup specification ([4mwc_hostgroup[24m).

       [4mwc_qdomain[24m are used to address a group of queue instances.   All  queue
       instances residing on a hosts which is part of matching hostgroups will
       be addressed. Please note, that [4mwc_hostgroup[24m always begins with an  at-
       character.

       e.g.
              *@@*         all queue instances whose underlaying
                           host is part of at least one hostgroup
              *@@solaris   all queue instances on hosts part of
                           the @solaris hostgroup

   [1mwc_cqueue[0m
       A  wildcard  cluster  queue  specification  ([4mwc_cqueue[24m)  is  a wildcard
       expression which might match one or more cluster  queues  used  in  the
       cluster.  That string never contains an at-character ('@'), even if the
       expression begins with a wildcard character.

       e.g.
              *            all cluster queues
              a*           all cluster queues beginning with an 'a'

   [1mwc_qinstance[0m
       [4mwc_qinstance[24m := [4mwc_cqueue[24m "@" [4mwc_host[0m

       A wildcard queue instance specification ([4mwc_qinstance[24m)  starts  with  a
       wildcard cluster queue name ([4mwc_cqueue[24m) followed by an at-character '@'
       and a wildcard hostname ([4mwc_host[24m).

       [4mwc_qinstance[24m expressions are used to address a group of queue instances
       whose underlaying hostname matches the given pattern.  Please note that
       the first character of [4mwc_host[24m does never match the at-character '@'.

       e.g.
              *@*          all queue instances in the cluster
              *@b*         all queue instances whose
                           hostname begins with a 'b'

   [1mwc_queue[0m
       [4mwc_queue[24m := [4mwc_cqueue[24m | [4mwc_qdomain[24m | [4mwc_qinstance[0m

       A wildcard queue expression ([4mwc_queue[24m) might either be a wildcard clus-
       ter queue specification ([4mwc_cqueue[24m) or a wildcard queue domain specifi-
       cation ([4mwc_qdomain[24m) or a wildcard queue instance specification ([4mwc_qin-[0m
       [4mstance[24m).

       e.g.
              big_*1           cluster queues which begin with
                               "big_" and end with "1"
              big_11@@solaris  @solaris queue domain
              *@fangorn        all qinstances residing on host
                               fangorn

   [1mwc_queue_list[0m
       [4mwc_queue_list[24m := [4mwc_queue[24m ["," [4mwc_queue[24m "," ...]

       Comma separated list of wildcard queue expressions.

       e.g.
              big, medium_*@@sol*, *@fangorn.sun.com


   [1mwc_user[0m
       A wildcard user name expression is either a wildcard user name specifi-
       cation or a full user name.

       wc_user := user_name | pattern



   [1mwc_user_list[0m
       A list of user names.

       wc_user_list := wc_user [ , wc_user , ...]


[1mSEE ALSO[0m
       [4mqacct[24m(1), [4mqconf[24m(1)

[1mCOPYRIGHT[0m
       Copyright: 2004 by Sun Microsystems, Inc.



GE 6.0                   $Date: 2007/01/05 20:31:03 $             SGE_TYPES(1)
