DESCRIPTION
The Univa 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.
OBJECT TYPES
These types are used for defining Univa Grid Engine configuration:
calendar_name
A calendar name is the name of a Univa Grid Engine calendar described
in calendar_conf(5).
calendar_name := object_name
ckpt_name
A "ckpt_name" is the name of a Univa Grid Engine checkpointing inter-
face described in checkpoint(5).
ckpt_name := object_name
complex_name
A complex name is the name of a Univa Grid Engine resource attribute
described in complex(5).
complex_name := object_name
host_identifier
A host identifier can be either a host name or a host group name.
host_identifier := host_name | hostgroup_name
hostgroup_name
A host group name is the name of a Univa Grid Engine host group
described in hostgroup(5). Note, to allow host group names easily be
differed from host names a "@" prefix is used.
hostgroup_name := @object_name
host_name
A host name is the official name of a host node. Host names with a
domain specification such as "gridmaster.sun.com" are called fully-
qualified host names, whereas host names like "gridmaster" are called
short host names. Note, there are the install time parameters
default_domain and ignore_fqdn (see bootstrap(5)) which affect how
Univa Grid Engine deals with host names in general.
jsv_url
The jsv_url has following format:
jsv_url := jsv_client_url | jsv_server_url
automatically be started as submit user and server JSV's as admin user
if not other specified.
The path has always to be the absolute path to a binary or application.
memory_specifier
Memory specifiers are positive decimal, hexadecimal or octal integer
constants which may be followed by a multiplier letter. Valid mul-
tiplier letters are k, K, m, M, g and G, where k means multiply
the value by 1000, K multiply by 1024, m multiply by 1000*1000, M mul-
tiply by 1024*1024, g multiply by 1000*1000*1000 and G multiply by
1024*1024*1024. If no multiplier is present, the value is just
counted in bytes.
pe_name
A "pe_name" is the name of a Univa Grid Engine parallel environment
described in sge_pe(5).
pe_name := object_name
project_name
A project name is the name of a Univa Grid Engine project described in
project(5).
project_name := object_name
queue_name
A queue name is the name of a Univa Grid Engine queue described in
queue_conf(5).
queue_name := object_name
time_specifier
A time specifier either consists of a positive decimal, hexadecimal or
octal integer constant, in which case the value is interpreted to be in
seconds, or is built by 3 decimal integer numbers separated by colon
signs where the first number counts the hours, the second the minutes
and the third the seconds. If a number would be zero it can be left out
but the separating colon must remain (e.g. 1:0:1 = 1::1 means 1 hours
and 1 second).
user_name
A user name can be the name of a login(1) user or of the Univa Grid
Engine user object described in user(5).
user_name := object_name
userset_name
A user set name is the name of an Univa Grid Engine access list or
department described in access_list(5).
expression= ["!"] ["("] valExp [")"] [ AND_OR expression ]*
valExp = pattern | expression
AND_OR = "&" | "|"
where:
"!" not operator -- negate the following pattern or expression
"&" and operator -- logically and with the following expression
"|" or operator -- logically or with the following expression
"(" open bracket -- begin an inner expression.
")" close bracket -- end an inner expression.
"pattern" see the pattern definition that's follow
The expression itself should be put inside quotes ('"') to ensure that
clients receive the complete expression.
e.g.
"(lx*|sol*)&*64*" any string beginning with either "lx" or
"sol" and containing "64"
"rh_3*&!rh_3.1" any string beginning with "rh_3", except
"rh_3.1"
pattern
When patterns are used the following definitions apply:
"*" 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 interpreted literally.
For more details please see
fnmatch(5)
The pattern itself should be put inside quotes ('"') to ensure that
clients receive the complete pattern.
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 speci-
fiers n[-m[:s]]. The ranges are concatenated to the complete task id
The wildcard advance reservation (AR) list specification allows to ref-
erence multiple ARs with one command.
wc_ar_list := wc_ar [ , wc_ar , ...]
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 expres-
sion 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 hostgroup(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
including job name patterns. A job id always references one job, while
the name 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 multiple 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 multiple 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
an at-character '@' and a wildcard 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) fol-
lowed 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
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 specifica-
tion 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 spec-
ification 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
parallel_env n[-[m]]|[-]m,...
Parallel programming environment (PE) to select for an AR. The range
descriptor behind the PE name specifies the number of parallel pro-
cesses to be run. Univa Grid Engine will allocate the appropriate
resources as available. The sge_pe(5) manual page contains information
about the definition of PEs and about how to obtain a list of currently
valid PEs.
You can specify a PE name which uses the wildcard character, "*". Thus
the request "pvm*" will match any parallel environment with a name
starting with the string "pvm". In the case of multiple parallel envi-
ronments whose names match the name string, the parallel environment
with the most available slots is chosen.
The range specification is a list of range expressions of the form "n-
m", where n and m are positive, non-zero integers. The form "n" is
equivalent to "n-n". The form "-m" is equivalent to "1-m". The form
"n-" is equivalent to "n-infinity". The range specification is pro-
cessed as follows: The largest number of queues requested is checked
mm denotes the minute in 2 digits.
ss denotes the seconds in 2 digits (default 00).
time
The time value must conform to hh:mm:ss, or seconds where:
e.g.
hh denotes the hour in 2 digits.
mm denotes the minute in 2 digits.
ss denotes the seconds in 2 digits (default 00).
seconds is a number of seconds (is used for duration values)
If any of the optional date fields are omitted, the correspond-
ing value of the current date is assumed. If CC is not speci-
fied, a YY of < 70 means 20YY.
Use of this option may cause unexpected results if the clocks of
the hosts in the Univa Grid Engine pool are out of sync. Also,
the proper behavior of this option very much depends on the cor-
rect setting of the appropriate timezone, e.g. in the TZ envi-
ronment variable (see date(1) for details), when the Univa Grid
Engine daemons sge_qmaster(8) and sge_execd(8) are invoked.
name
The name may be any arbitrary alphanumeric ASCII string, but may not
contain "\n", "\t", "\r", "/", ":", "@", "\", "*", or "?".
SEE ALSO
qacct(1), qconf(1), qquota(1), qsub(1), qrsub(1)
COPYRIGHT
Copyright: 2004-2007 by Sun Microsystems, Inc.
UGE 8.0.0 $Date: 2009/05/28 16:56:18 $ SGE_TYPES(1)
Man(1) output converted with
man2html