SGE_TYPES(1)

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

  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 hostgroups. The first character of that string is always a at-character ('@').

More information concerning hostgroups can be found in

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 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 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 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 wildcard 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) followed 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 wildcard 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

COPYRIGHT
Copyright: 2004 by Sun Microsystems, Inc.