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
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
|
<HTML>
<BODY BGCOLOR=white>
<PRE>
<!-- Manpage converted by man2html 3.0.1 -->
NAME
qconf - Sun Grid Engine Queue Configuration
SYNTAX
qconf options
DESCRIPTION
<I>Qconf</I> allows the system administrator to add, delete, and
modify the current Sun Grid Engine configuration, including
queue management, host management, complex management and
user management. <I>Qconf</I> also allows you to examine the
current queue configuration for existing queues.
<I>Qconf</I> allows the use of the backslash, '\', character at the
end of a line to indicate that the next line is a continua-
tion of the current line. When displaying settings, such as
the output of one of the -s* options, <I>qconf</I> will break up
long lines (lines greater than 80 characters) into smaller
lines using backslash line continuation where possible.
Lines will only be broken up at commas or whitespace. This
feature can be disabled by setting the SGE_SINGLE_LINE
environment variable.
OPTIONS
Unless denoted otherwise, the following options and the
corresponding operations are available to all users with a
valid account.
-Aattr obj_spec fname obj_instance,...
<<I>add</I> <I>to</I> <I>object</I> <I>attributes</I>>
Similar to -aattr (see below) but takes specifications
for the object attributes to be enhanced from file
named fname. As opposed to -aattr, multiple attributes
can be enhanced. Their specification has to be enlisted
in fname following the file format of the corresponding
object (see <B><A HREF="../htmlman5/queue_conf.html?pathrev=V62u5_TAG">queue_conf(5)</A></B> for the queue, for example).
Requires root/manager privileges.
-Acal fname <<I>add</I> <I>calendar</I>>
Adds a new calendar definition to the Sun Grid Engine
environment. Calendars are used in Sun Grid Engine for
defining availability and unavailability schedules of
queues. The format of a calendar definition is
described in <B><A HREF="../htmlman5/calendar_conf.html?pathrev=V62u5_TAG">calendar_conf(5)</A></B>.
The calendar definition is taken from the file fname.
Requires root/ manager privileges.
-Ackpt fname <<I>add</I> <I>ckpt</I>. <I>environment</I>>
Add the checkpointing environment as defined in fname
(see <B><A HREF="../htmlman5/checkpoint.html?pathrev=V62u5_TAG">checkpoint(5)</A></B>) to the list of supported check-
pointing environments. Requires root or manager
privileges.
-Aconf file_list <<I>add</I> <I>configurations</I>>
Add the configurations (see <B><A HREF="../htmlman5/sge_conf.html?pathrev=V62u5_TAG">sge_conf(5)</A></B>) specified in
the files enlisted in the comma separated file_list.
The configuration is added for the host that is identi-
cal to the file name.
Requires root or manager privileges.
-Ae fname <<I>add</I> <I>execution</I> <I>host</I>>
Add the execution host defined in fname to the Sun Grid
Engine cluster. The format of the execution host
specification is described in <B><A HREF="../htmlman5/host_conf.html?pathrev=V62u5_TAG">host_conf(5)</A></B>. Requires
root or manager privileges.
-Ahgrp file <<I>add</I> <I>host</I> <I>group</I> <I>config</I>>
Add the host group configuration defined in file. The
file format of file must comply to the format specified
in <B><A HREF="../htmlman5/hostgroup.html?pathrev=V62u5_TAG">hostgroup(5)</A></B>. Requires root or manager privileges.
-Arqs fname <<I>add</I> <I>RQS</I> <I>configuration</I>>
Add the resource quota set (RQS) defined in the file
named fname to the Sun Grid Engine cluster. Requires
root or manager privileges.
-Ap fname <<I>add</I> <I>PE</I> <I>configuration</I>>
Add the parallel environment (PE) defined in fname to
the Sun Grid Engine cluster. Requires root or manager
privileges.
-Aprj fname <<I>add</I> <I>new</I> <I>project</I>>
Adds the project description defined in fname to the
list of registered projects (see <B><A HREF="../htmlman5/project.html?pathrev=V62u5_TAG">project(5)</A></B>). Requires
root or manager privileges.
-Aq fname <<I>add</I> <I>new</I> <I>queue</I>>
Add the queue defined in fname to the Sun Grid Engine
cluster. Requires root or manager privileges.
-Au fname <<I>add</I> <I>an</I> <I>ACL</I>>
Add the user access list (ACL) defined in fname to Sun
Grid Engine. User lists are used for queue usage
authentication. Requires root/manager/operator
privileges.
-cb This parameter can be used since Sun Grid Engine ver-
sion 6.2u5 in combination with the command line switch
-sep. In that case the output of the corresponding com-
mand will contain information about the added job to
core binding functionality.
If -cb switch is not used then -sep will behave as in
GE version 6.2u4 and below.
Please note that this command-line switch will be
removed from Sun Grid Engine with the next major
release.
-Dattr obj_spec fname obj_instance,...
<<I>del</I>. <I>from</I> <I>object</I> <I>attribs</I>>
Similar to -dattr (see below) but the definition of the
list attributes from which entries are to be deleted is
contained in the file named fname. As opposed to
-dattr, multiple attributes can be modified. Their
specification has to be enlisted in fname following the
file format of the corresponding object (see
<B><A HREF="../htmlman5/queue_conf.html?pathrev=V62u5_TAG">queue_conf(5)</A></B> for the queue, for example).
Requires root/manager privileges.
-Mattr obj_spec fname obj_instance,...
<<I>mod</I>. <I>object</I> <I>attributes</I>>
Similar to -mattr (see below) but takes specifications
for the object attributes to be modified from file
named fname. As opposed to -mattr, multiple attributes
can be modified. Their specification has to be enlisted
in fname following the file format of the corresponding
object (see <B><A HREF="../htmlman5/queue_conf.html?pathrev=V62u5_TAG">queue_conf(5)</A></B> for the queue, for example).
Requires root/manager privileges.
-Mc fname <<I>modify</I> <I>complex</I>>
Overwrites the complex configuration by the contents of
fname. The argument file must comply to the format
specified in <B><A HREF="../htmlman5/complex.html?pathrev=V62u5_TAG">complex(5)</A></B>. Requires root or manager
privilege.
-Mcal fname <<I>modify</I> <I>calendar</I>>
Overwrites the calendar definition as specified in
fname. The argument file must comply to the format
described in <B><A HREF="../htmlman5/calendar_conf.html?pathrev=V62u5_TAG">calendar_conf(5)</A></B>. Requires root or
manager privilege.
-Mckpt fname <<I>modify</I> <I>ckpt</I>. <I>environment</I>>
Overwrite an existing checkpointing environment with
the definitions in fname (see <B><A HREF="../htmlman5/checkpoint.html?pathrev=V62u5_TAG">checkpoint(5)</A></B>). The name
attribute in fname has to match an existing checkpoint-
ing environment. Requires root or manager privileges.
-Mconf file_list <<I>modify</I> <I>configurations</I>>
Modify the configurations (see <B><A HREF="../htmlman5/sge_conf.html?pathrev=V62u5_TAG">sge_conf(5)</A></B>) specified
in the files enlisted in the comma separated file_list.
The configuration is modified for the host that is
identical to the file name.
Requires root or manager privileges.
-Me fname <<I>modify</I> <I>execution</I> <I>host</I>>
Overwrites the execution host configuration for the
specified host with the contents of fname, which must
comply to the format defines in <B><A HREF="../htmlman5/host_conf.html?pathrev=V62u5_TAG">host_conf(5)</A></B>. Requires
root or manager privilege.
-Mhgrp file <<I>modify</I> <I>host</I> <I>group</I> <I>config</I>.>
Allows changing of host group configuration with a sin-
gle command. All host group configuration entries con-
tained in file will be applied. Configuration entries
not contained in file will be deleted. The file format
of file must comply to the format specified in <I>host-</I>
<B><A HREF="../htmlman5/group.html?pathrev=V62u5_TAG">group(5)</A></B>.
-Mrqs fname [mrqs_name] <<I>modify</I> <I>RQS</I> <I>configuration</I>>
Same as -mrqs (see below) but instead of invoking an
editor to modify the RQS configuration, the file fname
is considered to contain a changed configuration. The
name of the rule set in fname must be the same as
rqs_name. If rqs_name is not set, all rule sets are
overwritten by the rule sets in fname Refer to
<B><A HREF="../htmlman5/sge_resource_quota.html?pathrev=V62u5_TAG">sge_resource_quota(5)</A></B> for details on the RQS configura-
tion format. Requires root or manager privilege.
-Mp fname <<I>modify</I> <I>PE</I> <I>configuration</I>>
Same as -mp (see below) but instead of invoking an edi-
tor to modify the PE configuration the file fname is
considered to contain a changed configuration. Refer
to <B><A HREF="../htmlman5/sge_pe.html?pathrev=V62u5_TAG">sge_pe(5)</A></B> for details on the PE configuration for-
mat. Requires root or manager privilege.
-Mprj fname <<I>modify</I> <I>project</I> <I>config</I>.>
Same as -mprj (see below) but instead of invoking an
editor to modify the project configuration the file
fname is considered to contain a changed configuration.
Refer to <B><A HREF="../htmlman5/project.html?pathrev=V62u5_TAG">project(5)</A></B> for details on the project confi-
guration format. Requires root or manager privilege.
-Mq fname <<I>modify</I> <I>queue</I> <I>configuration</I>>
Same as -mq (see below) but instead of invoking an edi-
tor to modify the queue configuration the file fname is
considered to contain a changed configuration. Refer
to <B><A HREF="../htmlman5/queue_conf.html?pathrev=V62u5_TAG">queue_conf(5)</A></B> for details on the queue configuration
format. Requires root or manager privilege.
<I>from</I> <I>file</I>>
-Msconf fname <<I>modify</I> <I>scheduler</I> <I>configuration</I>
The current scheduler configuration (see <B><A HREF="../htmlman5/sched_conf.html?pathrev=V62u5_TAG">sched_conf(5)</A></B>)
is overridden with the configuration specified in the
file. Requires root or manager privilege.
-Mstree fname <<I>modify</I> <I>share</I> <I>tree</I>>
Modifies the definition of the share tree (see
<B><A HREF="../htmlman5/share_tree.html?pathrev=V62u5_TAG">share_tree(5)</A></B>). The modified sharetree is read from
file fname. Requires root or manager privileges.
-Mu fname <<I>modify</I> <I>ACL</I>>
Takes the user access list (ACL) defined in fname to
overwrite any existing ACL with the same name. See
<B><A HREF="../htmlman5/access_list.html?pathrev=V62u5_TAG">access_list(5)</A></B> for information on the ACL configuration
format. Requires root or manager privilege.
-Muser fname <<I>modify</I> <I>user</I>>
Modify the user defined in fname in the Sun Grid Engine
cluster. The format of the user specification is
described in <B><A HREF="../htmlman5/user.html?pathrev=V62u5_TAG">user(5)</A></B>. Requires root or manager
privileges.
-Rattr obj_spec fname obj_instance,...
<<I>replace</I> <I>object</I> <I>attribs</I>>
Similar to -rattr (see below) but the definition of the
list attributes whose content is to be replace is con-
tained in the file named fname. As opposed to -rattr,
multiple attributes can be modified. Their specifica-
tion has to be enlisted in fname following the file
format of the corresponding object (see <B><A HREF="../htmlman5/queue_conf.html?pathrev=V62u5_TAG">queue_conf(5)</A></B>
for the queue, for example).
Requires root/manager privileges.
-aattr obj_spec attr_name val obj_instance,...
<<I>add</I> <I>to</I> <I>object</I> <I>attributes</I>>
Allows adding specifications to a single configuration
list attribute in multiple instances of an object with
a single command. Currently supported objects are the
queue, the host, the host group, the parallel environ-
ment, the resource quota sets and the checkpointing
interface configuration being specified as <I>queue</I> , <I>exe-</I>
<I>chost</I> , <I>hostgroup</I> , <I>pe</I> , <I>rqs</I> or <I>ckpt</I> in obj_spec. For
the obj_spec <I>queue</I> the obj_instance can be a cluster
queue name, a queue domain name or a queue instance
name. Find more information concerning different queue
names in <B><A HREF="../htmlman1/sge_types.html?pathrev=V62u5_TAG">sge_types(1)</A></B>. Depending on the type of the
obj_instance this adds to the cluster queues attribute
sublist the cluster queues implicit default configura-
tion value or the queue domain configuration value or
queue instance configuration value. The queue
load_thresholds parameter is an example of a list
attribute. With the -aattr option, entries can be added
to such lists, while they can be deleted with -dattr,
modified with -mattr, and replaced with -rattr.
For the obj_spec <I>rqs</I> the obj_instance is a unique iden-
tifier for a specific rule. The identifier consists of
a rule-set name and either the number of the rule in
the list, or the name of the rule, separated by a /
The name of the configuration attribute to be enhanced
is specified with attr_name followed by val as a
<I>name</I>=<I>value</I> pair. The comma separated list of object
instances (e.g., the list of queues) to which the
changes have to be applied are specified at the end of
the command.
The following restriction applies: For the <I>exechost</I>
object the load_values attribute cannot be modified
(see <B><A HREF="../htmlman5/host_conf.html?pathrev=V62u5_TAG">host_conf(5)</A></B>).
Requires root or manager privileges.
-acal calendar_name <<I>add</I> <I>calendar</I>>
Adds a new calendar definition to the Sun Grid Engine
environment. Calendars are used in Sun Grid Engine for
defining availability and unavailability schedules of
queues. The format of a calendar definition is
described in <B><A HREF="../htmlman5/calendar_conf.html?pathrev=V62u5_TAG">calendar_conf(5)</A></B>.
With the calendar name given in the option argument
<I>qconf</I> will open a temporary file and start up the text
editor indicated by the environment variable EDITOR
(default editor is <B><A HREF="../htmlman1/vi.html?pathrev=V62u5_TAG">vi(1)</A></B> if EDITOR is not set). After
entering the calendar definition and closing the editor
the new calendar is checked and registered with
<B><A HREF="../htmlman8/sge_qmaster.html?pathrev=V62u5_TAG">sge_qmaster(8)</A></B>. Requires root/manager privileges.
-ackpt ckpt_name <<I>add</I> <I>ckpt</I>. <I>environment</I>>
Adds a checkpointing environment under the name
ckpt_name to the list of checkpointing environments
maintained by Sun Grid Engine and to be usable to sub-
mit checkpointing jobs (see <B><A HREF="../htmlman5/checkpoint.html?pathrev=V62u5_TAG">checkpoint(5)</A></B> for details
on the format of a checkpointing environment defini-
tion). <I>Qconf</I> retrieves a default checkpointing
environment configuration and executes <B><A HREF="../htmlman1/vi.html?pathrev=V62u5_TAG">vi(1)</A></B> (or $EDI-
TOR if the EDITOR environment variable is set) to allow
you to customize the checkpointing environment confi-
guration. Upon exit from the editor, the checkpointing
environment is registered with <B><A HREF="../htmlman8/sge_qmaster.html?pathrev=V62u5_TAG">sge_qmaster(8)</A></B>.
Requires root/manager privileges.
-aconf host,... <<I>add</I> <I>configuration</I>>
Successively adds configurations (see <B><A HREF="../htmlman5/sge_conf.html?pathrev=V62u5_TAG">sge_conf(5)</A></B>) For
the hosts in the comma separated <I>file</I>_<I>list</I>. For each
host, an editor ($EDITOR indicated or <B><A HREF="../htmlman1/vi.html?pathrev=V62u5_TAG">vi(1)</A></B>) is invoked
and the configuration for the host can be entered. The
configuration is registered with <B><A HREF="../htmlman8/sge_qmaster.html?pathrev=V62u5_TAG">sge_qmaster(8)</A></B> after
saving the file and quitting the editor.
Requires root or manager privileges.
-ae [host_template] <<I>add</I> <I>execution</I> <I>host</I>>
Adds a host to the list of Sun Grid Engine execution
hosts. If a queue is configured on a host this host is
automatically added to the Sun Grid Engine execution
host list. Adding execution hosts explicitly offers
the advantage to be able to specify parameters like
load scale values with the registration of the execu-
tion host. However, these parameters can be modified
(from their defaults) at any later time via the -me
option described below.
If the host_template argument is present, <I>qconf</I>
retrieves the configuration of the specified execution
host from <B><A HREF="../htmlman8/sge_qmaster.html?pathrev=V62u5_TAG">sge_qmaster(8)</A></B> or a generic template other-
wise. The template is then stored in a file and <I>qconf</I>
executes <B><A HREF="../htmlman1/vi.html?pathrev=V62u5_TAG">vi(1)</A></B> (or the editor indicated by $EDITOR if
the EDITOR environment variable is set) to change the
entries in the file. The format of the execution host
specification is described in <B><A HREF="../htmlman5/host_conf.html?pathrev=V62u5_TAG">host_conf(5)</A></B>. When the
changes are saved in the editor and the editor is quit
the new execution host is registered with
<B><A HREF="../htmlman8/sge_qmaster.html?pathrev=V62u5_TAG">sge_qmaster(8)</A></B>. Requires root/manager privileges.
-ah hostname,... <<I>add</I> <I>administrative</I> <I>host</I>>
Adds hosts hostname to the Sun Grid Engine trusted host
list (a host must be in this list to execute adminis-
trative Sun Grid Engine commands, the sole exception to
this being the execution of <I>qconf</I> on the <B><A HREF="../htmlman8/sge_qmaster.html?pathrev=V62u5_TAG">sge_qmaster(8)</A></B>
node). The default Sun Grid Engine installation pro-
cedures usually add all designated execution hosts (see
the -ae option above) to the Sun Grid Engine trusted
host list automatically. Requires root or manager
privileges.
-ahgrp group <<I>add</I> <I>host</I> <I>group</I> <I>config</I>.>
Adds a new host group with the name specified in group.
This command invokes an editor (either <B><A HREF="../htmlman1/vi.html?pathrev=V62u5_TAG">vi(1)</A></B> or the
editor indicated by the EDITOR environment variable).
The new host group entry is registered after changing
the entry and exiting the editor. Requires root or
manager privileges.
-arqs [rqs_name] <<I>add</I> <I>new</I> <I>RQS</I>>
Adds one or more <I>Resource</I> <I>Quota</I> <I>Set</I> (RQS) description
under the names rqs_name to the list of RQSs maintained
by Sun Grid Engine (see <B><A HREF="../htmlman5/sge_resource_quota.html?pathrev=V62u5_TAG">sge_resource_quota(5)</A></B> for
details on the format of a RQS definition). <I>Qconf</I>
retrieves a default RQS configuration and executes
<B><A HREF="../htmlman1/vi.html?pathrev=V62u5_TAG">vi(1)</A></B> (or $EDITOR if the EDITOR environment variable is
set) to allow you to customize the RQS configuration.
Upon exit from the editor, the RQS is registered with
<B><A HREF="../htmlman8/sge_qmaster.html?pathrev=V62u5_TAG">sge_qmaster(8)</A></B>. Requires root or manager privileges.
-am user,... <<I>add</I> <I>managers</I>>
Adds the indicated users to the Sun Grid Engine manager
list. Requires root or manager privileges.
-ao user,... <<I>add</I> <I>operators</I>>
Adds the indicated users to the Sun Grid Engine opera-
tor list. Requires root or manager privileges.
-ap pe_name <<I>add</I> <I>new</I> <I>PE</I>>
Adds a <I>Parallel</I> <I>Environment</I> (PE) description under the
name pe_name to the list of PEs maintained by Sun Grid
Engine and to be usable to submit parallel jobs (see
<B><A HREF="../htmlman5/sge_pe.html?pathrev=V62u5_TAG">sge_pe(5)</A></B> for details on the format of a PE defini-
tion). <I>Qconf</I> retrieves a default PE configuration and
executes <B><A HREF="../htmlman1/vi.html?pathrev=V62u5_TAG">vi(1)</A></B> (or $EDITOR if the EDITOR environment
variable is set) to allow you to customize the PE con-
figuration. Upon exit from the editor, the PE is
registered with <B><A HREF="../htmlman8/sge_qmaster.html?pathrev=V62u5_TAG">sge_qmaster(8)</A></B>. Requires root/manager
privileges.
-at thread_name <<I>activates</I> <I>thread</I> <I>in</I> <I>master</I>>
Activates an additional thread in the master process.
thread_name might be either "scheduler" or "jvm". The
corresponding thread is only started when it is not
already running. There might be only one scheduler and
only one jvm thread in the master process at the same
time.
-aprj <<I>add</I> <I>new</I> <I>project</I>>
Adds a project description to the list of registered
projects (see <B><A HREF="../htmlman5/project.html?pathrev=V62u5_TAG">project(5)</A></B>). <I>Qconf</I> retrieves a template
project configuration and executes <B><A HREF="../htmlman1/vi.html?pathrev=V62u5_TAG">vi(1)</A></B> (or $EDITOR if
the EDITOR environment variable is set) to allow you to
customize the new project. Upon exit from the editor,
the template is registered with <B><A HREF="../htmlman8/sge_qmaster.html?pathrev=V62u5_TAG">sge_qmaster(8)</A></B>.
Requires root or manager privileges.
-aq [queue_name] <<I>add</I> <I>new</I> <I>queue</I>>
<I>Qconf</I> retrieves the default queue configuration (see
<B><A HREF="../htmlman5/queue_conf.html?pathrev=V62u5_TAG">queue_conf(5)</A></B>) and executes <B><A HREF="../htmlman1/vi.html?pathrev=V62u5_TAG">vi(1)</A></B> (or $EDITOR if the
EDITOR environment variable is set) to allow you to
customize the queue configuration. Upon exit from the
editor, the queue is registered with <B><A HREF="../htmlman8/sge_qmaster.html?pathrev=V62u5_TAG">sge_qmaster(8)</A></B>. A
minimal configuration requires only that the queue name
and queue hostlist be set. Requires root or manager
privileges.
-as hostname,... <<I>add</I> <I>submit</I> <I>hosts</I>>
Add hosts hostname to the list of hosts allowed to sub-
mit Sun Grid Engine jobs and control their behavior
only. Requires root or manager privileges.
-astnode node_path=shares,... <<I>add</I> <I>share</I> <I>tree</I> <I>node</I>>
Adds the specified share tree node(s) to the share tree
(see <B><A HREF="../htmlman5/share_tree.html?pathrev=V62u5_TAG">share_tree(5)</A></B>). The node_path is a hierarchical
path ([/]node_name[[/.]node_name...]) specifying the
location of the new node in the share tree. The base
name of the node_path is the name of the new node. The
node is initialized to the number of specified shares.
Requires root or manager privileges.
-astree <<I>add</I> <I>share</I> <I>tree</I>>
Adds the definition of a share tree to the system (see
<B><A HREF="../htmlman5/share_tree.html?pathrev=V62u5_TAG">share_tree(5)</A></B>). A template share tree is retrieved and
an editor (either <B><A HREF="../htmlman1/vi.html?pathrev=V62u5_TAG">vi(1)</A></B> or the editor indicated by
$EDITOR) is invoked for modifying the share tree defin-
ition. Upon exiting the editor, the modified data is
registered with <B><A HREF="../htmlman8/sge_qmaster.html?pathrev=V62u5_TAG">sge_qmaster(8)</A></B>. Requires root or
manager privileges.
-Astree fname <<I>add</I> <I>share</I> <I>tree</I>>
Adds the definition of a share tree to the system (see
<B><A HREF="../htmlman5/share_tree.html?pathrev=V62u5_TAG">share_tree(5)</A></B>) from the file fname. Requires root or
manager privileges.
-au user,... acl_name,... <<I>add</I> <I>users</I> <I>to</I> <I>ACLs</I>>
Adds users to Sun Grid Engine user access lists (ACLs).
User lists are used for queue usage authentication.
Requires root/manager/operator privileges.
-Auser fname <<I>add</I> <I>user</I>>
Add the user defined in fname to the Sun Grid Engine
cluster. The format of the user specification is
described in <B><A HREF="../htmlman5/user.html?pathrev=V62u5_TAG">user(5)</A></B>. Requires root or manager
privileges.
-auser <<I>add</I> <I>user</I>>
Adds a user to the list of registered users (see
<B><A HREF="../htmlman5/user.html?pathrev=V62u5_TAG">user(5)</A></B>). This command invokes an editor (either <B><A HREF="../htmlman1/vi.html?pathrev=V62u5_TAG">vi(1)</A></B>
or the editor indicated by the EDITOR environment vari-
able) for a template user. The new user is registered
after changing the entry and exiting the editor.
Requires root or manager privileges.
-clearusage <<I>clear</I> <I>sharetree</I> <I>usage</I>>
Clears all user and project usage from the sharetree.
All usage will be initialized back to zero.
-cq wc_queue_list <<I>clean</I> <I>queue</I>>
Cleans queue from jobs which haven't been reaped. Pri-
marily a development tool. Requires
root/manager/operator privileges. Find a description
of wc_queue_list in <B><A HREF="../htmlman1/sge_types.html?pathrev=V62u5_TAG">sge_types(1)</A></B>.
-dattr obj_spec attr_name val obj_instance,...
<<I>delete</I> <I>in</I> <I>object</I> <I>attribs</I>>
Allows deleting specifications in a single configura-
tion list attribute in multiple instances of an object
with a single command. Find more information concerning
obj_spec and obj_instance in the description of -aattr
-dcal calendar_name,... <<I>delete</I> <I>calendar</I>>
Deletes the specified calendar definition from Sun Grid
Engine. Requires root/manager privileges.
-dckpt ckpt_name <<I>delete</I> <I>ckpt</I>. <I>environment</I>>
Deletes the specified checkpointing environment.
Requires root/manager privileges.
-dconf host,... <<I>delete</I> <I>local</I> <I>configuration</I>>
The local configuration entries for the specified hosts
are deleted from the configuration list. Requires root
or manager privilege.
-de host_name,... <<I>delete</I> <I>execution</I> <I>host</I>>
Deletes hosts from the Sun Grid Engine execution host
list. Requires root or manager privileges.
-dh host_name,... <<I>delete</I> <I>administrative</I> <I>host</I>>
Deletes hosts from the Sun Grid Engine trusted host
list. The host on which <B><A HREF="../htmlman8/sge_qmaster.html?pathrev=V62u5_TAG">sge_qmaster(8)</A></B> is currently
running cannot be removed from the list of administra-
tive hosts. Requires root or manager privileges.
-dhgrp group <<I>delete</I> <I>host</I> <I>group</I> <I>configuration</I>>
Deletes host group configuration with the name speci-
fied in group. Requires root or manager privileges.
-drqs rqs_name_list <<I>delete</I> <I>RQS</I>>
Deletes the specified resource quota sets (RQS).
Requires root or manager privileges.
-dm user[,user,...] <<I>delete</I> <I>managers</I>>
Deletes managers from the manager list. Requires root
or manager privileges. It is not possible to delete
the admin user or the user root from the manager list.
-do user[,user,...] <<I>delete</I> <I>operators</I>>
Deletes operators from the operator list. Requires root
or manager privileges. It is not possible to delete
the admin user or the user root from the operator list.
-dp pe_name <<I>delete</I> <I>parallel</I> <I>environment</I>>
Deletes the specified parallel environment (PE).
Requires root or manager privileges.
-dprj project,... <<I>delete</I> <I>projects</I>>
Deletes the specified project(s). Requires root/manager
privileges.
-dq queue_name,... <<I>delete</I> <I>queue</I>>
Removes the specified queue(s). Active jobs will be
allowed to run to completion. Requires root or manager
privileges.
-ds host_name,... <<I>delete</I> <I>submit</I> <I>host</I>>
Deletes hosts from the Sun Grid Engine submit host
list. Requires root or manager privileges.
-dstnode node_path,... <<I>delete</I> <I>share</I> <I>tree</I> <I>node</I>>
Deletes the specified share tree node(s). The
node_path is a hierarchical path
([/]node_name[[/.]node_name...]) specifying the loca-
tion of the node to be deleted in the share tree.
Requires root or manager privileges.
-dstree <<I>delete</I> <I>share</I> <I>tree</I>>
Deletes the current share tree. Requires root or
manager privileges.
-du user,... acl_name,... <<I>delete</I> <I>users</I> <I>from</I> <I>ACL</I>>
Deletes one or more users from one or more Sun Grid
Engine user access lists (ACLs). Requires
root/manager/operator privileges.
-dul acl_name,... <<I>delete</I> <I>user</I> <I>lists</I>>
Deletes one or more user lists from the system.
Requires root/manager/operator privileges.
-duser user,... <<I>delete</I> <I>users</I>>"
Deletes the specified user(s) from the list of
registered users. Requires root or manager privileges.
-help
Prints a listing of all options.
-k{m|s|e[j] {host,...|all}} <<I>shutdown</I> <I>Sun</I> <I>Grid</I> <I>Engine</I>>
Note: The -ks switch is deprecated, may be removed in
future release. Please use the -kt switch instead.
Used to shutdown Sun Grid Engine components (daemons).
In the form -km <B><A HREF="../htmlman8/sge_qmaster.html?pathrev=V62u5_TAG">sge_qmaster(8)</A></B> is forced to terminate
in a controlled fashion. In the same way the -ks switch
causes termination of the scheduler thread. Shutdown
of running <B><A HREF="../htmlman8/sge_execd.html?pathrev=V62u5_TAG">sge_execd(8)</A></B> processes currently registered
is initiated by the -ke option. If -kej is specified
instead, all jobs running on the execution hosts are
aborted prior to termination of the corresponding
<B><A HREF="../htmlman8/sge_execd.html?pathrev=V62u5_TAG">sge_execd(8)</A></B>. The comma separated host list specifies
the execution hosts to be addressed by the -ke and -kej
option. If the keyword all is specified instead of a
host list, all running <B><A HREF="../htmlman8/sge_execd.html?pathrev=V62u5_TAG">sge_execd(8)</A></B> processes are shut-
down. Job abortion, initiated by the -kej option will
result in dr state for all running jobs until
<B><A HREF="../htmlman8/sge_execd.html?pathrev=V62u5_TAG">sge_execd(8)</A></B> is running again.
Requires root or manager privileges.
-kt thread_name <<I>terminate</I> <I>master</I> <I>thread</I>>"
Terminates a thread in the master process. Currently it
is only supported to shutdown the "scheduler" and the
"jvm" thread. The command will only be successful if
the corresponding thread is running.
-kec {id,...|all} <<I>kill</I> <I>event</I> <I>client</I>>
Used to shutdown event clients registered at
<B><A HREF="../htmlman8/sge_qmaster.html?pathrev=V62u5_TAG">sge_qmaster(8)</A></B>. The comma separated event client list
specifies the event clients to be addressed by the -kec
option. If the keyword all is specified instead of an
event client list, all running event clients except
special clients like the scheduler thread are ter-
minated. Requires root or manager privilege.
-mattr obj_spec attr_name val obj_instance,...
<<I>modify</I> <I>object</I> <I>attributes</I>>
Allows changing a single configuration attribute in
multiple instances of an object with a single command.
Find more information concerning obj_spec and
obj_instance in the description of -aattr
-mc <<I>modify</I> <I>complex</I>>
The complex configuration (see <B><A HREF="../htmlman5/complex.html?pathrev=V62u5_TAG">complex(5)</A></B>) is
retrieved, an editor is executed (either <B><A HREF="../htmlman1/vi.html?pathrev=V62u5_TAG">vi(1)</A></B> or the
editor indicated by $EDITOR) and the changed complex
configuration is registered with <B><A HREF="../htmlman8/sge_qmaster.html?pathrev=V62u5_TAG">sge_qmaster(8)</A></B> upon
exit of the editor. Requires root or manager
privilege.
-mcal calendar_name <<I>modify</I> <I>calendar</I>>
The specified calendar definition (see
<B><A HREF="../htmlman5/calendar_conf.html?pathrev=V62u5_TAG">calendar_conf(5)</A></B>) is retrieved, an editor is executed
(either <B><A HREF="../htmlman1/vi.html?pathrev=V62u5_TAG">vi(1)</A></B> or the editor indicated by $EDITOR) and
the changed calendar definition is registered with
<B><A HREF="../htmlman8/sge_qmaster.html?pathrev=V62u5_TAG">sge_qmaster(8)</A></B> upon exit of the editor. Requires root
or manager privilege.
-mckpt ckpt_name <<I>modify</I> <I>ckpt</I>. <I>environment</I>>
Retrieves the current configuration for the specified
checkpointing environment, executes an editor (either
<B><A HREF="../htmlman1/vi.html?pathrev=V62u5_TAG">vi(1)</A></B> or the editor indicated by the EDITOR environment
variable) and registers the new configuration with the
<B><A HREF="../htmlman8/sge_qmaster.html?pathrev=V62u5_TAG">sge_qmaster(8)</A></B>. Refer to <B><A HREF="../htmlman5/checkpoint.html?pathrev=V62u5_TAG">checkpoint(5)</A></B> for details on
the checkpointing environment configuration format.
Requires root or manager privilege.
-mconf [host,...|global] <<I>modify</I> <I>configuration</I>>
The configuration for the specified host is retrieved,
an editor is executed (either <B><A HREF="../htmlman1/vi.html?pathrev=V62u5_TAG">vi(1)</A></B> or the editor indi-
cated by $EDITOR) and the changed configuration is
registered with <B><A HREF="../htmlman8/sge_qmaster.html?pathrev=V62u5_TAG">sge_qmaster(8)</A></B> upon exit of the editor.
If the optional host argument is omitted or if the spe-
cial host name global is specified, the global confi-
guration is modified. The format of the configuration
is described in <B><A HREF="../htmlman5/sge_conf.html?pathrev=V62u5_TAG">sge_conf(5)</A></B>.
Requires root or manager privilege.
-me hostname <<I>modify</I> <I>execution</I> <I>host</I>>
Retrieves the current configuration for the specified
execution host, executes an editor (either <B><A HREF="../htmlman1/vi.html?pathrev=V62u5_TAG">vi(1)</A></B> or the
editor indicated by the EDITOR environment variable)
and registers the changed configuration with
<B><A HREF="../htmlman8/sge_qmaster.html?pathrev=V62u5_TAG">sge_qmaster(8)</A></B> upon exit from the editor. The format
of the execution host configuration is described in
<B><A HREF="../htmlman5/host_conf.html?pathrev=V62u5_TAG">host_conf(5)</A></B>. Requires root or manager privilege.
-mhgrp group <<I>modify</I> <I>host</I> <I>group</I> <I>configuration</I>>
The host group entries for the host group specified in
group are retrieved and an editor (either <B><A HREF="../htmlman1/vi.html?pathrev=V62u5_TAG">vi(1)</A></B> or the
editor indicated by the EDITOR environment variable) is
invoked for modifying the host group configuration. By
closing the editor, the modified data is registered.
The format of the host group configuration is described
in <B><A HREF="../htmlman5/hostgroup.html?pathrev=V62u5_TAG">hostgroup(5)</A></B>. Requires root or manager privileges.
-mrqs [rqs_name] <<I>modify</I> <I>RQS</I> <I>configuration</I>>
Retrieves the resource quota set (RQS)configuration
defined in rqs_name, or if rqs_name is not given,
retrieves all resource quota sets, executes an editor
(either <B><A HREF="../htmlman1/vi.html?pathrev=V62u5_TAG">vi(1)</A></B> or the editor indicated by the EDITOR
environment variable) and registers the new configura-
tion with the <B><A HREF="../htmlman8/sge_qmaster.html?pathrev=V62u5_TAG">sge_qmaster(8)</A></B>. Refer to
<B><A HREF="../htmlman5/sge_resource_quota.html?pathrev=V62u5_TAG">sge_resource_quota(5)</A></B> for details on the RQS configura-
tion format. Requires root or manager privilege.
-mp pe_name <<I>modify</I> <I>PE</I> <I>configuration</I>>
Retrieves the current configuration for the specified
<I>parallel</I> <I>environment</I> (PE), executes an editor (either
<B><A HREF="../htmlman1/vi.html?pathrev=V62u5_TAG">vi(1)</A></B> or the editor indicated by the EDITOR environment
variable) and registers the new configuration with the
<B><A HREF="../htmlman8/sge_qmaster.html?pathrev=V62u5_TAG">sge_qmaster(8)</A></B>. Refer to <B><A HREF="../htmlman5/sge_pe.html?pathrev=V62u5_TAG">sge_pe(5)</A></B> for details on the
PE configuration format. Requires root or manager
privilege.
-mprj project <<I>modify</I> <I>project</I>>
Data for the specific project is retrieved (see <I>pro-</I>
<B><A HREF="../htmlman5/ject.html?pathrev=V62u5_TAG">ject(5)</A></B>) and an editor (either <B><A HREF="../htmlman1/vi.html?pathrev=V62u5_TAG">vi(1)</A></B> or the editor
indicated by $EDITOR) is invoked for modifying the pro-
ject definition. Upon exiting the editor, the modified
data is registered. Requires root or manager
privileges.
-mq queuename <<I>modify</I> <I>queue</I> <I>configuration</I>>
Retrieves the current configuration for the specified
queue, executes an editor (either <B><A HREF="../htmlman1/vi.html?pathrev=V62u5_TAG">vi(1)</A></B> or the editor
indicated by the EDITOR environment variable) and
registers the new configuration with the
<B><A HREF="../htmlman8/sge_qmaster.html?pathrev=V62u5_TAG">sge_qmaster(8)</A></B>. Refer to <B><A HREF="../htmlman5/queue_conf.html?pathrev=V62u5_TAG">queue_conf(5)</A></B> for details on
the queue configuration format. Requires root or
manager privilege.
-msconf <<I>modify</I> <I>scheduler</I> <I>configuration</I>>
The current scheduler configuration (see <B><A HREF="../htmlman5/sched_conf.html?pathrev=V62u5_TAG">sched_conf(5)</A></B>)
is retrieved, an editor is executed (either <B><A HREF="../htmlman1/vi.html?pathrev=V62u5_TAG">vi(1)</A></B> or
the editor indicated by $EDITOR) and the changed confi-
guration is registered with <B><A HREF="../htmlman8/sge_qmaster.html?pathrev=V62u5_TAG">sge_qmaster(8)</A></B> upon exit of
the editor. Requires root or manager privilege.
-mstnode node_path=shares,... <<I>modify</I> <I>share</I> <I>tree</I> <I>node</I>>
Modifies the specified share tree node(s) in the share
tree (see <B><A HREF="../htmlman5/share_tree.html?pathrev=V62u5_TAG">share_tree(5)</A></B>). The node_path is a hierarch-
ical path ([/]node_name[[/.]node_name...]) specifying
the location of an existing node in the share tree.
The node is set to the number of specified shares.
Requires root or manager privileges.
-mstree <<I>modify</I> <I>share</I> <I>tree</I>>
Modifies the definition of the share tree (see
<B><A HREF="../htmlman5/share_tree.html?pathrev=V62u5_TAG">share_tree(5)</A></B>). The present share tree is retrieved
and an editor (either <B><A HREF="../htmlman1/vi.html?pathrev=V62u5_TAG">vi(1)</A></B> or the editor indicated by
$EDITOR) is invoked for modifying the share tree defin-
ition. Upon exiting the editor, the modified data is
registered with <B><A HREF="../htmlman8/sge_qmaster.html?pathrev=V62u5_TAG">sge_qmaster(8)</A></B>. Requires root or
manager privileges.
-mu acl_name <<I>modify</I> <I>user</I> <I>access</I> <I>lists</I>>
Retrieves the current configuration for the specified
user access list, executes an editor (either <B><A HREF="../htmlman1/vi.html?pathrev=V62u5_TAG">vi(1)</A></B> or
the editor indicated by the EDITOR environment vari-
able) and registers the new configuration with the
<B><A HREF="../htmlman8/sge_qmaster.html?pathrev=V62u5_TAG">sge_qmaster(8)</A></B>. Requires root or manager privilege.
-muser user <<I>modify</I> <I>user</I>>
Data for the specific user is retrieved (see <B><A HREF="../htmlman5/user.html?pathrev=V62u5_TAG">user(5)</A></B>)
and an editor (either <B><A HREF="../htmlman1/vi.html?pathrev=V62u5_TAG">vi(1)</A></B> or the editor indicated by
the EDITOR environment variable) is invoked for modify-
ing the user definition. Upon exiting the editor, the
modified data is registered. Requires root or manager
privileges.
-purge queue attr_nm,... obj_spec
<<I>purge</I> <I>divergent</I> <I>attribute</I> <I>settings</I>>
Delete the values of the attributes defined in attr_nm
from the object defined in obj_spec. Obj_spec can be
"queue_instance" or "queue_domain". The names of the
attributes are described in <B><A HREF="../htmlman1/queue_conf.html?pathrev=V62u5_TAG">queue_conf(1)</A></B>.
This operation only works on a single queue instance or
domain. It cannot be used on a cluster queue. In the
case where the obj_spec is "queue@@hostgroup", the
attribute values defined in attr_nm which are set for
the indicated hostgroup are deleted, but not those
which are set for the hosts contained by that host-
group. If the attr_nm is '*', all attribute values set
for the given queue instance or domain are deleted.
The main difference between -dattr and -purge is that
-dattr removes a value from a single list attribute,
whereas -purge removes one or more overriding attribute
settings from a cluster queue configuration. With
-purge, the entire attribute is deleted for the given
queue instance or queue domain.
-rattr obj_spec attr_name val obj_instance,...
<<I>replace</I> <I>object</I> <I>attributes</I>>
Allows replacing a single configuration list attribute
in multiple instances of an object with a single com-
mand. Find more information concerning obj_spec and
obj_instance in the description of -aattr .
Requires root or manager privilege.
-rsstnode node_path,... <<I>show</I> <I>share</I> <I>tree</I> <I>node</I>>
Recursively shows the name and shares of the specified
share tree node(s) and the names and shares of its
child nodes. (see <B><A HREF="../htmlman5/share_tree.html?pathrev=V62u5_TAG">share_tree(5)</A></B>). The node_path is a
hierarchical path ([/]node_name[[/.]node_name...])
specifying the location of a node in the share tree.
-sc <<I>show</I> <I>complexes</I>>
Display the complex configuration.
-scal calendar_name <<I>show</I> <I>calendar</I>>
Display the configuration of the specified calendar.
-scall <<I>show</I> <I>calendar</I> <I>list</I>>
Show a list of all calendars currently defined.
-sckpt ckpt_name <<I>show</I> <I>ckpt</I>. <I>environment</I>>
Display the configuration of the specified checkpoint-
ing environment.
-sckptl <<I>show</I> <I>ckpt</I>. <I>environment</I> <I>list</I>>
Show a list of the names of all checkpointing environ-
ments currently configured.
-sconf [host,...|global] <<I>show</I> <I>configuration</I>>
Print the global or local (host specific) configura-
tion. If the optional comma separated host list argu-
ment is omitted or the special string global is given,
the global configuration is displayed. The configura-
tion in effect on a certain host is the merger of the
global configuration and the host specific local confi-
guration. The format of the configuration is
described in <B><A HREF="../htmlman5/sge_conf.html?pathrev=V62u5_TAG">sge_conf(5)</A></B>.
-sconfl <<I>show</I> <I>configuration</I> <I>list</I>>
Display a list of hosts for which configurations are
available. The special host name global refers to the
global configuration.
-sds <<I>show</I> <I>detached</I> <I>settings</I>>
Displays detached settings in the cluster configura-
tion.
-se hostname <<I>show</I> <I>execution</I> <I>host</I>>
Displays the definition of the specified execution
host.
-sel <<I>show</I> <I>execution</I> <I>hosts</I>>
Displays the Sun Grid Engine execution host list.
-secl <<I>show</I> <I>event</I> <I>clients</I>>
Displays the Sun Grid Engine event client list.
-sep <<I>show</I> <I>licensed</I> <I>processors</I>>
Note: Deprecated, may be removed in future release.
Displays a list of virtual processors. This value is
taken from the underlying OS and it depends on underly-
ing hardware and operating system whether this value
represents sockets, cores or supported threads.
If this option is used in combination with -cb parame-
ter then two additional columns will be shown in the
output for the number of sockets and number of cores.
Currently SGE will enlist these values only if the
corresponding operating system of execution host is
Linux under kernel >= 2.6.16, or Solaris 10. Other
operating systems or versions might be supported with
the future update releases. In case these values won't
be retrieved, '0' character will be displayed.
-sh <<I>show</I> <I>administrative</I> <I>hosts</I>>
Displays the Sun Grid Engine administrative host list.
-shgrp group <<I>show</I> <I>host</I> <I>group</I> <I>config</I>.>
Displays the host group entries for the group specified
in group.
-shgrpl <<I>show</I> <I>host</I> <I>group</I> <I>lists</I>>
Displays a name list of all currently defined host
groups which have a valid host group configuration.
-shgrp_tree group <<I>show</I> <I>host</I> <I>group</I> <I>tree</I>>
Shows a tree like structure of host group.
-shgrp_resolved group <<I>show</I> <I>host</I> <I>group</I> <I>hosts</I>>
Shows a list of all hosts which are part of the defini-
tion of host group. If the host group definition con-
tains sub host groups than also these groups are
resolved and the hostnames are printed.
-srqs [rqs_name_list] <<I>show</I> <I>RQS</I> <I>configuration</I>>
Show the definition of the <I>resource</I> <I>quota</I> <I>sets</I> (RQS)
specified by the argument.
-srqsl <<I>show</I> <I>RQS</I>-<I>list</I>>
Show a list of all currently defined <I>resource</I> <I>quota</I>
<I>sets</I>s (RQSs).
-sm <<I>show</I> <I>managers</I>>
Displays the managers list.
-so <<I>show</I> <I>operators</I>>
Displays the operator list.
-sobjl obj_spec attr_name val <<I>show</I> <I>object</I> <I>list</I>>
Shows a list of all configuration objects for which val
matches at least one configuration value of the attri-
butes whose name matches with attr_name.
Obj_spec can be "queue" or "queue_domain" or
"queue_instance" or "exechost". Note: When
"queue_domain" or "queue_instance" is specified as
obj_spec matching is only done with the attribute over-
ridings concerning the host group or the execution
host. In this case queue domain names resp. queue
instances are returned.
Attr_name can be any of the configuration file keywords
enlisted in <B><A HREF="../htmlman5/queue_conf.html?pathrev=V62u5_TAG">queue_conf(5)</A></B> or <B><A HREF="../htmlman5/host_conf.html?pathrev=V62u5_TAG">host_conf(5)</A></B>. Also wild-
cards can be used to match multiple attributes.
Val can be an arbitrary string or a wildcard expres-
sion.
-sp pe_name <<I>show</I> <I>PE</I> <I>configuration</I>>
Show the definition of the <I>parallel</I> <I>environment</I> (PE)
specified by the argument.
-spl <<I>show</I> <I>PE</I>-<I>list</I>>
Show a list of all currently defined <I>parallel</I> <I>environ-</I>
<I>ment</I>s (PEs).
-sprj project <<I>show</I> <I>project</I>>
Shows the definition of the specified project (see <I>pro-</I>
<B><A HREF="../htmlman5/ject.html?pathrev=V62u5_TAG">ject(5)</A></B>).
-sprjl <<I>show</I> <I>project</I> <I>list</I>>
Shows the list of all currently defined projects.
-sq wc_queue_list <show queues>
Displays one or multiple cluster queues or queue
instances. A description of wc_queue_list can be found
in <B><A HREF="../htmlman1/sge_types.html?pathrev=V62u5_TAG">sge_types(1)</A></B>.
-sql <<I>show</I> <I>queue</I> <I>list</I>>
Show a list of all currently defined cluster queues.
-ss <<I>show</I> <I>submit</I> <I>hosts</I>>
Displays the Sun Grid Engine submit host list.
-ssconf <<I>show</I> <I>scheduler</I> <I>configuration</I>>
Displays the current scheduler configuration in the
format explained in <B><A HREF="../htmlman5/sched_conf.html?pathrev=V62u5_TAG">sched_conf(5)</A></B>.
-sstnode node_path,... <<I>show</I> <I>share</I> <I>tree</I> <I>node</I>>
Shows the name and shares of the specified share tree
node(s) (see <B><A HREF="../htmlman5/share_tree.html?pathrev=V62u5_TAG">share_tree(5)</A></B>). The node_path is a
hierarchical path ([/]node_name[[/.]node_name...])
specifying the location of a node in the share tree.
-sstree <<I>show</I> <I>share</I> <I>tree</I>>
Shows the definition of the share tree (see
<B><A HREF="../htmlman5/share_tree.html?pathrev=V62u5_TAG">share_tree(5)</A></B>).
-sst <<I>show</I> <I>formatted</I> <I>share</I> <I>tree</I>>
Shows the definition of the share tree in a tree view
(see <B><A HREF="../htmlman5/share_tree.html?pathrev=V62u5_TAG">share_tree(5)</A></B>).
-sss <<I>show</I> <I>scheduler</I> <I>status</I>>
Currently displays the host on which the Sun Grid
Engine scheduler is active or an error message if no
scheduler is running.
-su acl_name <<I>show</I> <I>user</I> <I>ACL</I>>
Displays a Sun Grid Engine user access list (ACL).
-sul <<I>show</I> <I>user</I> <I>lists</I>>
Displays a list of names of all currently defined Sun
Grid Engine user access lists (ACLs).
-suser user,... <<I>show</I> <I>user</I>>
Shows the definition of the specified user(s) (see
<B><A HREF="../htmlman5/user.html?pathrev=V62u5_TAG">user(5)</A></B>).
-suserl <<I>show</I> <I>users</I>>
Shows the list of all currently defined users.
-tsm <<I>trigger</I> <I>scheduler</I> <I>monitoring</I>>
The Sun Grid Engine scheduler is forced by this option
to print trace messages of its next scheduling run to
the file <<I>sge</I>_<I>root</I>>/<<I>cell</I>>/<I>common</I>/<I>schedd</I>_<I>runlog</I>. The
messages indicate the reasons for jobs and queues not
being selected in that run. Requires root or manager
privileges.
Note, that the reasons for job requirements being
invalid with respect to resource availability of queues
are displayed using the format as described for the
<B><A HREF="../htmlman1/qstat.html?pathrev=V62u5_TAG">qstat(1)</A></B> -F option (see description of Full Format in
section OUTPUT FORMATS of the <B><A HREF="../htmlman1/qstat.html?pathrev=V62u5_TAG">qstat(1)</A></B> manual page.
ENVIRONMENTAL VARIABLES
SGE_ROOT Specifies the location of the Sun Grid Engine
standard configuration files.
SGE_CELL If set, specifies the default Sun Grid Engine
cell. To address a Sun Grid Engine cell <I>qconf</I>
uses (in the order of precedence):
The name of the cell specified in the
environment variable SGE_CELL, if it is
set.
The name of the default cell, i.e.
default.
SGE_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.
SGE_QMASTER_PORT
If set, specifies the tcp port on which
<B><A HREF="../htmlman8/sge_qmaster.html?pathrev=V62u5_TAG">sge_qmaster(8)</A></B> is expected to listen for com-
munication requests. Most installations will
use a services map entry instead to define
that port.
SGE_EXECD_PORT If set, specifies the tcp port on which
<B><A HREF="../htmlman8/sge_execd.html?pathrev=V62u5_TAG">sge_execd(8)</A></B> is expected to listen for
communication requests. Most installations
will use a services map entry instead to
define that port.
SGE_SINGLE_LINE
If set, indicates that long lines should not
be broken up using backslashes. This setting
is useful for scripts which expect one entry
per line.
RESTRICTIONS
Modifications to a queue configuration do not affect an
active queue, taking effect on next invocation of the queue
(i.e., the next job).
FILES
<<I>sge</I>_<I>root</I>>/<<I>cell</I>>/<I>common</I>/<I>act</I>_<I>qmaster</I>
Sun Grid Engine master host file
SEE ALSO
<B><A HREF="../htmlman1/sge_intro.html?pathrev=V62u5_TAG">sge_intro(1)</A></B>, <B><A HREF="../htmlman1/qstat.html?pathrev=V62u5_TAG">qstat(1)</A></B>, <B><A HREF="../htmlman5/checkpoint.html?pathrev=V62u5_TAG">checkpoint(5)</A></B>, <B><A HREF="../htmlman5/complex.html?pathrev=V62u5_TAG">complex(5)</A></B>,
<B><A HREF="../htmlman5/sge_conf.html?pathrev=V62u5_TAG">sge_conf(5)</A></B>, <B><A HREF="../htmlman5/host_conf.html?pathrev=V62u5_TAG">host_conf(5)</A></B>, <B><A HREF="../htmlman5/sge_pe.html?pathrev=V62u5_TAG">sge_pe(5)</A></B>, <B><A HREF="../htmlman5/queue_conf.html?pathrev=V62u5_TAG">queue_conf(5)</A></B>,
<B><A HREF="../htmlman8/sge_execd.html?pathrev=V62u5_TAG">sge_execd(8)</A></B>, <B><A HREF="../htmlman8/sge_qmaster.html?pathrev=V62u5_TAG">sge_qmaster(8)</A></B>, <B><A HREF="../htmlman5/sge_resource_quota.html?pathrev=V62u5_TAG">sge_resource_quota(5)</A></B>
COPYRIGHT
See <B><A HREF="../htmlman1/sge_intro.html?pathrev=V62u5_TAG">sge_intro(1)</A></B> for a full statement of rights and permis-
sions.
</PRE>
<HR>
<ADDRESS>
Man(1) output converted with
<a href="http://www.oac.uci.edu/indiv/ehood/man2html.html">man2html</a>
</ADDRESS>
</BODY>
</HTML>
|
