    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:

      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. "\\" = "\", "\*" = "*", "\?" = "?"
         "[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 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
         wildcard  expression  which  might  match  one or more host-
         groups.  The first character of that string is always a  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 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

      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 queue domain  specification  (wc_qdomain)  starts
         with  a  wildcard cluster queue name (wc_cqueue) followed by
         an at-character '@' and a wildcard  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
              *@@solaris   all queue instances on hosts part of
                           the @solaris hostgroup

      wc_cqueue
         A wildcard 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 wild-
         card character.

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

      wc_qinstance
         wc_qinstance := wc_cqueue "@" wc_host

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

         wc_qinstance expressions are used  to  address  a  group  of
         queue instances whose underlaying hostname matches the given
         pattern.  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'

      wc_queue
         wc_queue := wc_cqueue | wc_qdomain | wc_qinstance

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

         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

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

         Comma separated list of wildcard queue expressions.

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

      wc_user
         A wildcard user name expression 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 , ...]

    SEE ALSO
         qacct(1), qconf(1)

    COPYRIGHT
         Copyright: 2004 by Sun Microsystems, Inc.