qselect (1) - Linux Manuals

qselect: select queues.

NAME

qselect - select queues.

SYNTAX

qselect [ -help ] [ -l resource=val,... ] [ -pe pe_name,... ] [ -q wc_queue,... ] [ -s {r|p|s|z|hu|ho|hs|hj|ha|h}[+] ] [ -U user,... ]

DESCRIPTION

qselect prints a list of xxQS_NAMExx queue instance names corresponding to selection criteria specified in the arguments described below. The output is of limited use since it comprises queue instances rather than cluster queues or hosts.

OPTIONS

-help

Prints a listing of all options.

-l resource[=value],...

Defines the resources to be granted by the queues which should be included in the queue list output. Matching is performed on queues based on non-mutable resource availability information only. That means load values are always ignored except the so-called static load values listed in Also consumable utilization is ignored. If there are multiple -l resource requests they will be concatenated by a logical AND: a queue needs to offer all resources to be displayed.

-pe pe_name,...

Includes queue instances in the output to which are attached at least one of the parallel environments listed in the comma-separated option argument.

-q wc_queue,...

Directly specifies the wildcard expression queue list to be included in the output. This option usually is only meaningful in conjunction with another qselect option to extract a subset of queue names from a list given by -q. Description of wc_queue can be found in

-qs {a|c|d|o|s|u|A|C|D|E|S}

This option allows filtering by queue instances in certain states (see

-U user,...

Includes the queues to which the specified users have access in the qselect output.

EXAMPLES

=====================================================

% qselect -l arch=linux
% qselect -l arch=linux -U andreas,shannon
% qconf -mattr queue h_vmem=1GB `qselect -l arch=linux`

=====================================================

The first example prints the names of those queues residing on Linux machines. The second command in addition restricts the output to those queues with access permission for the users andreas and shannon. The third command changes the queue attribute h_vmem to 1 Gigabyte on queues residing on Linux machines (see the manual page for details on the -mattr option and the manual page on details of queue configuration entries).

ENVIRONMENT VARIABLES

xxQS_NAME_Sxx_ROOT

Specifies the location of the xxQS_NAMExx standard configuration files.

xxQS_NAME_Sxx_CELL

If set, specifies the default xxQS_NAMExx cell. To address a xxQS_NAMExx cell qselect uses (in the order of precedence):

The name of the cell specified in the environment variable xxQS_NAME_Sxx_CELL, if it is set.

The name of the default cell, i.e. default.

xxQS_NAME_Sxx_DEBUG_LEVEL

If set, specifies that debug information should be written to stderr. In addition the level of detail in which debug information is generated is defined.

xxQS_NAME_Sxx_QMASTER_PORT

If set, specifies the tcp port on which is expected to listen for communication requests. Most installations will use a services map entry for the service "sge_qmaster" instead to define that port.

FILES

<xxqs_name_sxx_root>/<cell>/common/act_qmaster
                          xxQS_NAMExx master host file

COPYRIGHT

See for a full statement of rights and permissions.