xxQS_NAME_Sxx_TYPES(1)

NAME
sge_types - xxQS_NAMExx type descriptions

DESCRIPTION
The xxQS_NAMExx 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 xxQS_NAMExx 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.