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 underlying
host is part of at least one hostgroup
a*@@e* all queue instances begins with a whose underlying
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 underlying 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.
Man(1) output converted with
man2html