1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
|
'\" t
.\"___INFO__MARK_BEGIN__
.\"
.\" Copyright: 2004 by Sun Microsystems, Inc.
.\"
.\"___INFO__MARK_END__
.\"
.\"
.\" Some handy macro definitions [from Tom Christensen's man(1) manual page].
.\"
.de SB \" small and bold
.if !"\\$1"" \\s-2\\fB\&\\$1\\s0\\fR\\$2 \\$3 \\$4 \\$5
..
.\" "
.de T \" switch to typewriter font
.ft CW \" probably want CW if you don't have TA font
..
.\"
.de TY \" put $1 in typewriter font
.if t .T
.if n ``\c
\\$1\c
.if t .ft P
.if n \&''\c
\\$2
..
.\"
.de M \" man page reference
\\fI\\$1\\fR\\|(\\$2)\\$3
..
.TH QSELECT 1 "2012-01-04" "xxRELxx" "xxQS_NAMExx User Commands"
.SH NAME
qselect \- select queues.
.\"
.\"
.SH SYNTAX
.B qselect
[
.B \-help
] [
.B \-l resource=val,...
] [
.B \-pe pe_name,...
] [
.B \-q wc_queue,...
] [
.B \-s {r|p|s|z|hu|ho|hs|hj|ha|h}[+]
] [
.B \-U user,...
]
.\"
.SH DESCRIPTION
.I 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.
.\"
.\"
.SH OPTIONS
.\"
.IP "\fB\-help\fP"
Prints a listing of all options.
.\"
.IP "\fB\-l resource\fP[\fB=value\fP],..."
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
.M load_parameters 5 .
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.
.\"
.IP "\fB\-pe pe_name,...\fP"
Includes queue instances in the output to which are attached at least
one of the parallel environments listed in the comma-separated option
argument.
.\"
.IP "\fB\-q wc_queue,...\fP"
Directly specifies the wildcard expression queue list to be included in the output.
This option usually is only meaningful in conjunction with another
.I qselect
option to extract a subset of queue names from a list given by \fB\-q\fP.
Description of \fIwc_queue\fP can be found in
.M sge_types 5 .
.\"
.IP "\fB\-qs {a|c|d|o|s|u|A|C|D|E|S}\fP"
This option allows filtering by queue instances in certain states (see
.M qstat 1).
.\"
.IP "\fB\-U user,...\fP"
Includes the queues to which the specified users have access in the
.I qselect
output.
.\"
.\"
.SH "EXAMPLES"
.nf
=====================================================
% qselect \-l arch=linux
% qselect \-l arch=linux \-U andreas,shannon
% qconf \-mattr queue h_vmem=1GB `qselect \-l arch=linux`
=====================================================
.fi
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
\fIandreas\fP and \fIshannon\fP. The third command changes the queue
attribute \fIh_vmem\fP to 1 Gigabyte on queues residing on Linux machines
(see the
.M qconf 1
manual page for details on the \fI\-mattr\fP option and the
.M queue_conf 5
manual page on details of queue configuration entries).
.\"
.\"
.SH "ENVIRONMENT VARIABLES"
.\"
.IP "\fBxxQS_NAME_Sxx_ROOT\fP" 1.5i
Specifies the location of the xxQS_NAMExx standard configuration
files.
.\"
.IP "\fBxxQS_NAME_Sxx_CELL\fP" 1.5i
If set, specifies the default xxQS_NAMExx cell. To address a xxQS_NAMExx
cell
.I qselect
uses (in the order of precedence):
.sp 1
.RS
.RS
The name of the cell specified in the environment
variable xxQS_NAME_Sxx_CELL, if it is set.
.sp 1
The name of the default cell, i.e. \fBdefault\fP.
.sp 1
.RE
.RE
.\"
.IP "\fBxxQS_NAME_Sxx_DEBUG_LEVEL\fP" 1.5i
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.
.\"
.IP "\fBxxQS_NAME_Sxx_QMASTER_PORT\fP" 1.5i
If set, specifies the tcp port on which
.M xxqs_name_sxx_qmaster 8
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.
.\"
.\"
.SH FILES
.nf
.ta \w'<xxqs_name_sxx_root>/ 'u
\fI<xxqs_name_sxx_root>/<cell>/common/act_qmaster\fP
xxQS_NAMExx master host file
.fi
.\"
.\"
.SH "SEE ALSO"
.M xxqs_name_sxx_intro 1 ,
.M qconf 1 ,
.M qmod 1 ,
.M qstat 1 ,
.M queue_conf 5 ,
.\"
.\"
.SH "COPYRIGHT"
See
.M xxqs_name_sxx_intro 1
for a full statement of rights and permissions.
|
