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



NNAAMMEE
       sge_types - Grid Engine type descriptions

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


TTYYPPEESS
       The syntax of Grid Engine types in alphabetic order:

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


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


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

   wwcc__hhoossttggrroouupp
       A wildcard hostgroup specification (_w_c___h_o_s_t_g_r_o_u_p) 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 _h_o_s_t_g_r_o_u_p(5)

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

   wwcc__jjoobb
       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


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


   wwcc__jjoobb__lliisstt
       The wildcard job list specification allows to reference  multiple  jobs
       with one command.

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


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

           _w_c___j_o_b_[ _-_t _r_a_n_g_e_]_[_{_, _}_w_c___j_o_b_[ _-_t _r_a_n_g_e_]_{_, _}_._._._]

       If present, the _t_a_s_k___r_a_n_g_e restricts the effect of the  _q_m_o_d  operation
       to  the array job task range specified as suffix to the job id (see the
       --tt option to _q_s_u_b(1) for further details on array jobs).


   wwcc__qqddoommaaiinn
       _w_c___q_d_o_m_a_i_n := _w_c___c_q_u_e_u_e "@" _w_c___h_o_s_t_g_r_o_u_p

       A wildcard queue domain specification (_w_c___q_d_o_m_a_i_n) starts with a  wild-
       card cluster queue name (_w_c___c_q_u_e_u_e) followed by an at-character '@' and
       a wildcard hostgroup specification (_w_c___h_o_s_t_g_r_o_u_p).

       _w_c___q_d_o_m_a_i_n 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 _w_c___h_o_s_t_g_r_o_u_p 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

   wwcc__ccqquueeuuee
       A  wildcard  cluster  queue  specification  (_w_c___c_q_u_e_u_e)  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'

   wwcc__qqiinnssttaannccee
       _w_c___q_i_n_s_t_a_n_c_e := _w_c___c_q_u_e_u_e "@" _w_c___h_o_s_t

       A wildcard queue instance specification (_w_c___q_i_n_s_t_a_n_c_e)  starts  with  a
       wildcard cluster queue name (_w_c___c_q_u_e_u_e) followed by an at-character '@'
       and a wildcard hostname (_w_c___h_o_s_t).

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

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

   wwcc__qquueeuuee
       _w_c___q_u_e_u_e := _w_c___c_q_u_e_u_e | _w_c___q_d_o_m_a_i_n | _w_c___q_i_n_s_t_a_n_c_e

       A wildcard queue expression (_w_c___q_u_e_u_e) might either be a wildcard clus-
       ter queue specification (_w_c___c_q_u_e_u_e) or a wildcard queue domain specifi-
       cation (_w_c___q_d_o_m_a_i_n) or a wildcard queue instance specification (_w_c___q_i_n_-
       _s_t_a_n_c_e).

       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

   wwcc__qquueeuuee__lliisstt
       _w_c___q_u_e_u_e___l_i_s_t := _w_c___q_u_e_u_e ["," _w_c___q_u_e_u_e "," ...]

       Comma separated list of wildcard queue expressions.

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


   wwcc__uusseerr
       A wildcard user name expression is either a wildcard user name specifi-
       cation or a full user name.

       wc_user := user_name | pattern



   wwcc__uusseerr__lliisstt
       A list of user names.

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


SSEEEE AALLSSOO
       _q_a_c_c_t(1), _q_c_o_n_f(1)

CCOOPPYYRRIIGGHHTT
       Copyright: 2004 by Sun Microsystems, Inc.



GE 6.0                   $Date: 2004/11/12 15:40:03 $             SGE_TYPES(1)
