    NAME
         sge_types - Grid Engine type descriptions

    DESCRIPTION
         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.

    TYPES
         The syntax of Grid Engine types in alphabetic order:

      expression
         The wildcard expression is a regular boolean expression that
         consists  of  a couple of pattern's joined by boolean opera-
         tors and priority brackets. When ever  expression  are  used
         the following definition applies:

         expression= ["!"] ["("] valExp [")"] [ AND_OR expression  ]*
         valExp  = pattern | expression AND_OR  = "&" | "|"

         where:

         "!"     not operator negate the following pattern or expresion
         "&"     and operator logically and with the following expression
         "|"     or operator logically or with the following expression
         "("     open bracket begin the priority evaluated expression. The close bracket is required
         ")"     close bracket ends the priority evaluated expression.
         "pattern"see the pattern definition

         The wildcard expresion itself should  be  put  into  '"'  to
         ensure, that the clients get the expression.

         e.g.
              "!(lx*|sol*)&*64*"not begin with lx or sol, but contain
              64 "(rh_3*|suse_[89]*)&!rh_3.1"attribute rh_3*, suse_8*
              or suse_9*, but do not on a rh_3.1

      pattern
         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. "\\" = "\", "\*" = "*", "\?" = "?"
         "[...]" specifies an array or a range of allowed
                 characters for one character at a specific position.
                 Character ranges may be specified using the a-z notation.
                 The caret symbol (^) is not interpreted as a logical
                 not; it is intrepreted literally.

         For more details please see
         fnmatch(5)

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

      range
         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  specifiers  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.

      wc_host
         A  wildcard  host  specification  (wc_host)  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'

      wc_hostgroup
         A wildcard hostgroup specification (wc_hostgroup) is a wild-
         card  expression  which  might match one or more hostgroups.
         The first character of that string is always an at-character
         ('@').

         More information concerning hostgroups can be found in host-
         group(5)

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

      wc_job
         The wildcard job specification is a placeholder for job ids,
         job  names  include job name pattern. A job id always refer-
         ences one job, while the names and pattern  might  reference
         multiple jobs.

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

      wc_job_range
         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]

      wc_job_list
         The wildcard job list specification allows to reference mul-
         tiple jobs with one command.

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

      wc_job_range_list
         The wildcard job range list (wc_job_range_list) is specified
         by one of the following forms:

             wc_job[ -t range][{, }wc_job[ -t range]{, }...]

         If present, the task_range restricts the effect of the  qmod
         operation to the array job task range specified as suffix to
         the job id (see the -t option to qsub(1) for further details
         on array jobs).

      wc_qdomain
         wc_qdomain := wc_cqueue "@" wc_hostgroup

         A   wildcard   expression   queue    domain    specification
         (wc_qdomain) starts with a wildcard expression cluster queue
         name (wc_cqueue) followed by an at-character '@' and a wild-
         card expression hostgroup specification (wc_hostgroup).

         wc_qdomain 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
         wc_hostgroup always begins with an at-character.

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

      wc_cqueue
         A   wildcard   expression   cluster   queue    specification
         (wc_cqueue)  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'
              a*&!adam     all cluster queues beginning with an 'a',but not adam

      wc_qinstance
         wc_qinstance := wc_cqueue "@" wc_host

         A   wildcard   expression   queue   instance   specification
         (wc_qinstance)  starts  with  a  wildcard expression cluster
         queue name (wc_cqueue) followed by an at-character '@' and a
         wildcard expression hostname (wc_host).

         wc_qinstance expressions are used  to  address  a  group  of
         queue instances whose underlaying hostname matches the given
         expression.  Please note that the first character of wc_host
         does never match the at-character '@'.

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

      wc_queue
         wc_queue := wc_cqueue | wc_qdomain | wc_qinstance

         A wildcard queue expression (wc_queue)  might  either  be  a
         wildcard  expression cluster queue specification (wc_cqueue)
         or  a  wildcard  expression   queue   domain   specification
         (wc_qdomain) or a wildcard expression queue instance specif-
         ication (wc_qinstance).

         e.g.
              big_*1           cluster queues which begin with
                               "big_" and end with "1"
              big_*&!*1        cluster queues which begin with
                               "big_" ,but does not end with "1"
              *@fangorn        all qinstances residing on host
                               fangorn

      wc_queue_list
         wc_queue_list := wc_queue ["," wc_queue "," ...]

         Comma separated list of wc_queue elements.

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

      wc_user
         A wildcard user name pattern is either a wildcard user  name
         specification or a full user name.

         wc_user := user_name | pattern

      wc_user_list
         A list of user names.

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

      wc_project
         A wildcard project name pattern is either a wildcard project
         name specification or a full project name.

         wc_project := project | pattern

      wc_pe_name
         A wildcard parallel environment name  pattern  is  either  a
         wildcard pe name specification or a full pe name.

         wc_pe_name := pe_name | pattern

    SEE ALSO
         qacct(1), qconf(1), qquota(1)

    COPYRIGHT
         Copyright: 2004-2007 by Sun Microsystems, Inc.