File: qconf.html

package info (click to toggle)
gridengine 6.2-4
  • links: PTS, VCS
  • area: main
  • in suites: lenny
  • size: 51,532 kB
  • ctags: 51,172
  • sloc: ansic: 418,155; java: 37,080; sh: 22,593; jsp: 7,699; makefile: 5,292; csh: 4,244; xml: 2,901; cpp: 2,086; perl: 1,895; tcl: 1,188; lisp: 669; ruby: 642; yacc: 393; lex: 266
file content (1001 lines) | stat: -rw-r--r-- 57,503 bytes parent folder | download
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
<HTML>
<BODY BGCOLOR=white>
<PRE>
<!-- Manpage converted by man2html 3.0.1 -->
NAME
     qconf - Grid Engine Queue Configuration

SYNTAX
     qconf options

DESCRIPTION
     <I>Qconf</I> allows the system administrator to  add,  delete,  and
     modify  the  current  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,...
                                 &lt;<I>add</I> <I>to</I> <I>object</I> <I>attributes</I>&gt;
          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">queue_conf(5)</A></B> for the queue, for example).
          Requires root/manager privileges.

     -Acal fname                   &lt;<I>add</I> <I>calendar</I>&gt;
          Adds a new  calendar  definition  to  the  Grid  Engine
          environment.  Calendars  are  used  in  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">calendar_conf(5)</A></B>.

          The calendar definition is taken from the  file  fname.
          Requires root/ manager privileges.

     -Ackpt fname                  &lt;<I>add</I> <I>ckpt</I>. <I>environment</I>&gt;
          Add the checkpointing environment as defined  in  fname
          (see  <B><A HREF="../htmlman5/checkpoint.html">checkpoint(5)</A></B>)  to  the  list of supported check-
          pointing  environments.  Requires   root   or   manager
          privileges.

     -Aconf file_list              &lt;<I>add</I> <I>configurations</I>&gt;
          Add the configurations (see <B><A HREF="../htmlman5/sge_conf.html">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                     &lt;<I>add</I> <I>execution</I> <I>host</I>&gt;
          Add the execution host defined in  fname  to  the  Grid
          Engine  cluster.  The  format  of  the  execution  host
          specification is described in  <B><A HREF="../htmlman5/host_conf.html">host_conf(5)</A></B>.   Requires
          root or manager privileges.

     -Ahgrp file                   &lt;<I>add</I> <I>host</I> <I>group</I> <I>config</I>&gt;
          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">hostgroup(5)</A></B>.  Requires root or manager privileges.

     -Arqs fname &lt;<I>add</I> <I>RQS</I> <I>configuration</I>&gt;
          Add the resource quota set (RQS) defined  in  the  file
          named  fname  to the Grid Engine cluster. Requires root
          or manager privileges.

     -Ap fname                     &lt;<I>add</I> <I>PE</I> <I>configuration</I>&gt;
          Add the parallel environment (PE) defined in  fname  to
          the  Grid  Engine  cluster.  Requires  root  or manager
          privileges.

     -Aprj fname                   &lt;<I>add</I> <I>new</I> <I>project</I>&gt;
          Adds the project description defined in  fname  to  the
          list of registered projects (see <B><A HREF="../htmlman5/project.html">project(5)</A></B>).  Requires
          root or manager privileges.

     -Aq fname                     &lt;<I>add</I> <I>new</I> <I>queue</I>&gt;
          Add the queue defined in fname to the Grid Engine clus-
          ter. Requires root or manager privileges.

     -Au fname                     &lt;<I>add</I> <I>an</I> <I>ACL</I>&gt;
          Add the user access list (ACL) defined in fname to Grid
          Engine. User lists are used for queue usage authentica-
          tion. Requires root/manager/operator privileges.

     -Dattr obj_spec fname obj_instance,...
                                 &lt;<I>del</I>. <I>from</I> <I>object</I> <I>attribs</I>&gt;
          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">queue_conf(5)</A></B> for the queue, for example).
          Requires root/manager privileges.

     -Mattr obj_spec fname obj_instance,...
                                 &lt;<I>mod</I>. <I>object</I> <I>attributes</I>&gt;
          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">queue_conf(5)</A></B> for the queue, for example).
          Requires root/manager privileges.

     -Mc fname                     &lt;<I>modify</I> <I>complex</I>&gt;
          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">complex(5)</A></B>.   Requires  root  or  manager
          privilege.

     -Mcal fname                   &lt;<I>modify</I> <I>calendar</I>&gt;
          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">calendar_conf(5)</A></B>.   Requires   root   or
          manager privilege.

     -Mckpt fname                  &lt;<I>modify</I> <I>ckpt</I>. <I>environment</I>&gt;
          Overwrite an existing  checkpointing  environment  with
          the definitions in fname (see <B><A HREF="../htmlman5/checkpoint.html">checkpoint(5)</A></B>).  The name
          attribute in fname has to match an existing checkpoint-
          ing environment. Requires root or manager privileges.

     -Me fname                     &lt;<I>modify</I> <I>execution</I> <I>host</I>&gt;
          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">host_conf(5)</A></B>.  Requires
          root or manager privilege.

     -Mhgrp file                   &lt;<I>modify</I> <I>host</I> <I>group</I> <I>config</I>.&gt;
          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">group(5)</A></B>.

     -Mrqs fname [mrqs_name]       &lt;<I>modify</I> <I>RQS</I> <I>configuration</I>&gt;
          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">sge_resource_quota(5)</A></B> for details on the RQS configura-
          tion format.  Requires root or manager privilege.

     -Mp fname                     &lt;<I>modify</I> <I>PE</I> <I>configuration</I>&gt;
          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">sge_pe(5)</A></B>  for details on the PE configuration for-
          mat.  Requires root or manager privilege.

     -Mprj fname                   &lt;<I>modify</I> <I>project</I> <I>config</I>.&gt;
          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">project(5)</A></B> for details on the project confi-
          guration format.  Requires root or manager privilege.

     -Mq fname                     &lt;<I>modify</I> <I>queue</I> <I>configuration</I>&gt;
          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">queue_conf(5)</A></B> for details on the queue configuration
          format.  Requires root or manager privilege.

     -Mstree fname                 &lt;<I>modify</I> <I>share</I> <I>tree</I>&gt;
          Modifies  the  definition  of  the  share   tree   (see
          <B><A HREF="../htmlman5/share_tree.html">share_tree(5)</A></B>).   The  modified  sharetree is read from
          file fname.  Requires root or manager privileges.

     -Mu fname                     &lt;<I>modify</I> <I>ACL</I>&gt;
          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">access_list(5)</A></B> for information on the ACL configuration
          format. Requires root or manager privilege.

     -Muser fname                  &lt;<I>modify</I> <I>user</I>&gt;
          Modify the user defined in fname  in  the  Grid  Engine
          cluster.  The  format  of  the  user  specification  is
          described  in  <B><A HREF="../htmlman5/user.html">user(5)</A></B>.   Requires  root   or   manager
          privileges.

     -Rattr obj_spec fname obj_instance,...
                                 &lt;<I>replace</I> <I>object</I> <I>attribs</I>&gt;
          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">queue_conf(5)</A></B>
          for the queue, for example).
          Requires root/manager privileges.

     -aattr obj_spec attr_name val obj_instance,...
             &lt;<I>add</I> <I>to</I> <I>object</I> <I>attributes</I>&gt;
          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">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_thesholds parameter is an example of a list attri-
          bute. 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 consisists
          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">host_conf(5)</A></B>).
          Requires root or manager privileges.

     -acal calendar_name           &lt;<I>add</I> <I>calendar</I>&gt;
          Adds a new  calendar  definition  to  the  Grid  Engine
          environment.  Calendars  are  used  in  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">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">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">sge_qmaster(8)</A></B>.  Requires root/manager privileges.

     -ackpt ckpt_name              &lt;<I>add</I> <I>ckpt</I>. <I>environment</I>&gt;
          Adds  a  checkpointing  environment  under   the   name
          ckpt_name  to  the  list  of checkpointing environments
          maintained by Grid Engine and to be  usable  to  submit
          checkpointing  jobs  (see  <B><A HREF="../htmlman5/checkpoint.html">checkpoint(5)</A></B> for details on
          the format of a checkpointing environment  definition).
          <I>Qconf</I>  retrieves  a  default  checkpointing environment
          configuration and executes <B><A HREF="../htmlman1/vi.html">vi(1)</A></B>  (or  $EDITOR  if  the
          EDITOR  environment  variable  is  set) to allow you to
          customize the checkpointing environment  configuration.
          Upon  exit  from the editor, the checkpointing environ-
          ment  is  registered  with  <B><A HREF="../htmlman8/sge_qmaster.html">sge_qmaster(8)</A></B>.    Requires
          root/manager privileges.

     -aconf host,...               &lt;<I>add</I> <I>configuration</I>&gt;
          Successively adds configurations (see <B><A HREF="../htmlman5/sge_conf.html">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">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">sge_qmaster(8)</A></B>  after
          saving the file and quitting the editor.
          Requires root or manager privileges.

     -ae [host_template]           &lt;<I>add</I> <I>execution</I> <I>host</I>&gt;
          Adds a host to the list of Grid Engine execution hosts.
          If  a  queue  is  configured  on  a  host  this host is
          automatically added to the 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 execution
          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">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">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">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">sge_qmaster(8)</A></B>.  Requires root/manager privileges.

     -ah hostname,...              &lt;<I>add</I> <I>administrative</I> <I>host</I>&gt;
          Adds hosts hostname to the  Grid  Engine  trusted  host
          list  (a  host must be in this list to execute adminis-
          trative Grid Engine commands,  the  sole  exception  to
          this being the execution of <I>qconf</I> on the <B><A HREF="../htmlman8/sge_qmaster.html">sge_qmaster(8)</A></B>
          node). The default Grid Engine installation  procedures
          usually add all designated execution hosts (see the -ae
          option above) to the  Grid  Engine  trusted  host  list
          automatically.  Requires root or manager privileges.

     -ahgrp group                  &lt;<I>add</I> <I>host</I> <I>group</I> <I>config</I>.&gt;
          Adds a new host group with the name specified in group.
          This  command  invokes  an  editor (either <B><A HREF="../htmlman1/vi.html">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]              &lt;<I>add</I> <I>new</I> <I>RQS</I>&gt;
          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 Grid Engine (see <B><A HREF="../htmlman5/sge_resource_quota.html">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">vi(1)</A></B> (or  $EDI-
          TOR 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">sge_qmaster(8)</A></B>.
          Requires root or manager privileges.

     -am user,...                  &lt;<I>add</I> <I>managers</I>&gt;
          Adds the indicated users to  the  Grid  Engine  manager
          list. Requires root or manager privileges.

     -ao user,...                  &lt;<I>add</I> <I>operators</I>&gt;
          Adds the indicated users to the  Grid  Engine  operator
          list.  Requires root or manager privileges.

     -ap pe_name                   &lt;<I>add</I> <I>new</I> <I>PE</I>&gt;
          Adds a <I>Parallel</I> <I>Environment</I> (PE) description under  the
          name  pe_name  to  the  list  of PEs maintained by Grid
          Engine and to be usable to submit  parallel  jobs  (see
          <B><A HREF="../htmlman5/sge_pe.html">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">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">sge_qmaster(8)</A></B>.  Requires  root/manager
          privileges.

     -aprj                         &lt;<I>add</I> <I>new</I> <I>project</I>&gt;
          Adds a project description to the  list  of  registered
          projects  (see <B><A HREF="../htmlman5/project.html">project(5)</A></B>).  <I>Qconf</I> retrieves a template
          project configuration and executes <B><A HREF="../htmlman1/vi.html">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">sge_qmaster(8)</A></B>.
          Requires root or manager privileges.

     -aq [queue_name]              &lt;<I>add</I> <I>new</I> <I>queue</I>&gt;
          <I>Qconf</I> retrieves the default  queue  configuration  (see
          <B><A HREF="../htmlman5/queue_conf.html">queue_conf(5)</A></B>)  and  executes  <B><A HREF="../htmlman1/vi.html">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">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,...              &lt;<I>add</I> <I>submit</I> <I>hosts</I>&gt;
          Add hosts hostname to the list of hosts allowed to sub-
          mit  Grid  Engine jobs and control their behavior only.
          Requires root or manager privileges.

     -astnode node_path=shares,... &lt;<I>add</I> <I>share</I> <I>tree</I> <I>node</I>&gt;
          Adds the specified share tree node(s) to the share tree
          (see  <B><A HREF="../htmlman5/share_tree.html">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                       &lt;<I>add</I> <I>share</I> <I>tree</I>&gt;
          Adds the definition of a share tree to the system  (see
          <B><A HREF="../htmlman5/share_tree.html">share_tree(5)</A></B>).  A template share tree is retrieved and
          an editor (either <B><A HREF="../htmlman1/vi.html">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">sge_qmaster(8)</A></B>.   Requires  root  or
          manager privileges.

     -Astree fname                 &lt;<I>add</I> <I>share</I> <I>tree</I>&gt;
          Adds the definition of a share tree to the system  (see
          <B><A HREF="../htmlman5/share_tree.html">share_tree(5)</A></B>)  from  the file fname.  Requires root or
          manager privileges.

     -au user,... acl_name,...     &lt;<I>add</I> <I>users</I> <I>to</I> <I>ACLs</I>&gt;
          Adds users to Grid Engine  user  access  lists  (ACLs).
          User  lists  are  used  for queue usage authentication.
          Requires root/manager/operator privileges.

     -Auser fname                  &lt;<I>add</I> <I>user</I>&gt;
          Add the user defined in fname to the Grid Engine  clus-
          ter.  The format of the user specification is described
          in <B><A HREF="../htmlman5/user.html">user(5)</A></B>.  Requires root or manager privileges.

     -auser                        &lt;<I>add</I> <I>user</I>&gt;
          Adds a user  to  the  list  of  registered  users  (see
          <B><A HREF="../htmlman5/user.html">user(5)</A></B>).  This command invokes an editor (either <B><A HREF="../htmlman1/vi.html">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                   &lt;<I>clear</I> <I>sharetree</I> <I>usage</I>&gt;
          Clears all user and project usage from  the  sharetree.
          All usage will be initialized back to zero.

     -cq wc_queue_list             &lt;<I>clean</I> <I>queue</I>&gt;
          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">sge_types(1)</A></B>.

     -dattr obj_spec attr_name val obj_instance,...
                                 &lt;<I>delete</I> <I>in</I> <I>object</I> <I>attribs</I>&gt;
          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,...       &lt;<I>delete</I> <I>calendar</I>&gt;
          Deletes the specified  calendar  definition  from  Grid
          Engine. Requires root/manager privileges.

     -dckpt ckpt_name              &lt;<I>delete</I> <I>ckpt</I>. <I>environment</I>&gt;
          Deletes  the   specified   checkpointing   environment.
          Requires root/manager privileges.

     -dconf host,...               &lt;<I>delete</I> <I>local</I> <I>configuration</I>&gt;
          The local configuration entries for the specified hosts
          are deleted from the configuration list.  Requires root
          or manager privilege.

     -de host_name,...             &lt;<I>delete</I> <I>execution</I> <I>host</I>&gt;
          Deletes hosts from the Grid Engine execution host list.
          Requires root or manager privileges.

     -dh host_name,...             &lt;<I>delete</I> <I>administrative</I> <I>host</I>&gt;
          Deletes hosts from the Grid Engine trusted  host  list.
          The  host  on which <B><A HREF="../htmlman8/sge_qmaster.html">sge_qmaster(8)</A></B> is currently running
          cannot be  removed  from  the  list  of  administrative
          hosts.  Requires root or manager privileges.

     -drqs rqs_name_list           &lt;<I>delete</I> <I>RQS</I>&gt;
          Deletes  the  specified  resource  quota  sets   (RQS).
          Requires root or manager privileges.

     -dm user[,user,...]           &lt;<I>delete</I> <I>managers</I>&gt;
          Deletes managers from the manager list.  Requires  root
          or manager privileges.

     -do user[,user,...]           &lt;<I>delete</I> <I>operators</I>&gt;
          Deletes operators from the operator list. Requires root
          or manager privileges.

     -dp pe_name                   &lt;<I>delete</I> <I>parallel</I> <I>environment</I>&gt;
          Deletes  the  specified  parallel   environment   (PE).
          Requires root or manager privileges.

     -dprj project,...             &lt;<I>delete</I> <I>projects</I>&gt;
          Deletes the specified project(s). Requires root/manager
          privileges.

     -dq queue_name,...            &lt;<I>delete</I> <I>queue</I>&gt;
          Removes the specified queue(s).  Active  jobs  will  be
          allowed to run to completion.  Requires root or manager
          privileges.

     -ds host_name,...             &lt;<I>delete</I> <I>submit</I> <I>host</I>&gt;
          Deletes hosts from the Grid Engine  submit  host  list.
          Requires root or manager privileges.

     -dstnode node_path,...        &lt;<I>delete</I> <I>share</I> <I>tree</I> <I>node</I>&gt;
          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                       &lt;<I>delete</I> <I>share</I> <I>tree</I>&gt;
          Deletes  the  current  share  tree.  Requires  root  or
          manager privileges.

     -du user,... acl_name,...     &lt;<I>delete</I> <I>users</I> <I>from</I> <I>ACL</I>&gt;
          Deletes one or more users from one or more Grid  Engine
          user       access      lists      (ACLs).      Requires
          root/manager/operator privileges.

     -dul acl_name,...             &lt;<I>delete</I> <I>user</I> <I>lists</I>&gt;
          Deletes  one  or  more  user  lists  from  the  system.
          Requires root/manager/operator privileges.

     -duser user,...               &lt;<I>delete</I> <I>users</I>&gt;"
          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}}   &lt;<I>shutdown</I> <I>Grid</I> <I>Engine</I>&gt;
          Used to shutdown Grid Engine components (daemons).   In
          the form -km <B><A HREF="../htmlman8/sge_qmaster.html">sge_qmaster(8)</A></B> is forced to terminate in a
          controlled fashion. In the  same  way  the  -ks  switch
          causes  termination of <B><A HREF="../htmlman8/sge_schedd.html">sge_schedd(8)</A></B>.  Shutdown of run-
          ning <B><A HREF="../htmlman8/sge_execd.html">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">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">sge_execd(8)</A></B> processes are shut-
          down.
          Requires root or manager privileges.

     -kec {id,...|all}             &lt;<I>kill</I> <I>event</I> <I>client</I>&gt;
          Used  to   shutdown   event   clients   registered   at
          <B><A HREF="../htmlman8/sge_qmaster.html">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 <B><A HREF="../htmlman8/sge_schedd.html">sge_schedd(8)</A></B> are terminated.
          Requires root or manager privilege.

     -mattr obj_spec attr_name val obj_instance,...
                                 &lt;<I>modify</I> <I>object</I> <I>attributes</I>&gt;
          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                           &lt;<I>modify</I> <I>complex</I>&gt;
          The   complex   configuration   (see   <B><A HREF="../htmlman5/complex.html">complex(5)</A></B>)   is
          retrieved,  an  editor is executed (either <B><A HREF="../htmlman1/vi.html">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">sge_qmaster(8)</A></B> upon
          exit  of  the  editor.   Requires   root   or   manager
          privilege.

     -mcal calendar_name           &lt;<I>modify</I> <I>calendar</I>&gt;
          The     specified     calendar     definition      (see
          <B><A HREF="../htmlman5/calendar_conf.html">calendar_conf(5)</A></B>)  is  retrieved, an editor is executed
          (either <B><A HREF="../htmlman1/vi.html">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">sge_qmaster(8)</A></B> upon exit of the editor.  Requires  root
          or manager privilege.

     -mckpt ckpt_name              &lt;<I>modify</I> <I>ckpt</I>. <I>environment</I>&gt;
          Retrieves the current configuration for  the  specified
          checkpointing  environment,  executes an editor (either
          <B><A HREF="../htmlman1/vi.html">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">sge_qmaster(8)</A></B>.  Refer to <B><A HREF="../htmlman5/checkpoint.html">checkpoint(5)</A></B> for details  on
          the  checkpointing  environment  configuration  format.
          Requires root or manager privilege.

     -mconf [host,...|global]      &lt;<I>modify</I> <I>configuration</I>&gt;
          The configuration for the specified host is  retrieved,
          an editor is executed (either <B><A HREF="../htmlman1/vi.html">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">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">sge_conf(5)</A></B>.
          Requires root or manager privilege.

     -me hostname                  &lt;<I>modify</I> <I>execution</I> <I>host</I>&gt;
          Retrieves the current configuration for  the  specified
          execution host, executes an editor (either <B><A HREF="../htmlman1/vi.html">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">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">host_conf(5)</A></B>.  Requires root or manager privilege.

     -mhgrp group &lt;<I>modify</I> <I>host</I> <I>group</I> <I>configuration</I>&gt;
          The host group entries for the host group specified  in
          group  are retrieved and an editor (either <B><A HREF="../htmlman1/vi.html">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">hostgroup(5)</A></B>.  Requires root or manager privileges.

     -mrqs [rqs_name]              &lt;<I>modify</I> <I>RQS</I> <I>configuration</I>&gt;
          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">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">sge_qmaster(8)</A></B>.     Refer    to
          <B><A HREF="../htmlman5/sge_resource_quota.html">sge_resource_quota(5)</A></B> for details on the RQS configura-
          tion format.  Requires root or manager privilege.

     -mp pe_name                   &lt;<I>modify</I> <I>PE</I> <I>configuration</I>&gt;
          Retrieves the current configuration for  the  specified
          <I>parallel</I>  <I>environment</I>  (PE), executes an editor (either
          <B><A HREF="../htmlman1/vi.html">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">sge_qmaster(8)</A></B>.  Refer to <B><A HREF="../htmlman5/sge_pe.html">sge_pe(5)</A></B> for details on  the
          PE  configuration  format.   Requires  root  or manager
          privilege.

     -mprj project                 &lt;<I>modify</I> <I>project</I>&gt;
          Data for the specific project is  retrieved  (see  <I>pro-</I>
          <B><A HREF="../htmlman5/ject.html">ject(5)</A></B>)  and  an  editor  (either  <B><A HREF="../htmlman1/vi.html">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                 &lt;<I>modify</I> <I>queue</I> <I>configuration</I>&gt;
          Retrieves the current configuration for  the  specified
          queue,  executes  an editor (either <B><A HREF="../htmlman1/vi.html">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">sge_qmaster(8)</A></B>.  Refer to <B><A HREF="../htmlman5/queue_conf.html">queue_conf(5)</A></B> for details  on
          the  queue  configuration  format.   Requires  root  or
          manager privilege.

     -msconf                       &lt;<I>modify</I> <I>scheduler</I> <I>configuration</I>&gt;
          The current scheduler configuration (see <B><A HREF="../htmlman5/sched_conf.html">sched_conf(5)</A></B>)
          is retrieved, an editor is executed  (either  <B><A HREF="../htmlman1/vi.html">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">sge_qmaster(8)</A></B> upon exit of
          the editor.  Requires root or manager privilege.

<I>from</I> <I>file</I>&gt;
     -Msconf  fname                 &lt;<I>modify</I>  <I>scheduler</I>   <I>configuration</I>
          The current scheduler configuration (see <B><A HREF="../htmlman5/sched_conf.html">sched_conf(5)</A></B>)
          is overridden with the configuration specified  in  the
          file. Requires root or manager privilege.

     -mstnode node_path=shares,... &lt;<I>modify</I> <I>share</I> <I>tree</I> <I>node</I>&gt;
          Modifies the specified share tree node(s) in the  share
          tree (see <B><A HREF="../htmlman5/share_tree.html">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                       &lt;<I>modify</I> <I>share</I> <I>tree</I>&gt;
          Modifies  the  definition  of  the  share   tree   (see
          <B><A HREF="../htmlman5/share_tree.html">share_tree(5)</A></B>).   The  present  share tree is retrieved
          and an editor (either <B><A HREF="../htmlman1/vi.html">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">sge_qmaster(8)</A></B>.   Requires  root  or
          manager privileges.

     -mu acl_name                  &lt;<I>modify</I> <I>user</I> <I>access</I> <I>lists</I>&gt;
          Retrieves the current configuration for  the  specified
          user  access  list, executes an editor (either <B><A HREF="../htmlman1/vi.html">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">sge_qmaster(8)</A></B>.  Requires root or manager privilege.

     -muser user                   &lt;<I>modify</I> <I>user</I>&gt;
          Data for the specific user is retrieved  (see  <B><A HREF="../htmlman5/user.html">user(5)</A></B>)
          and  an editor (either <B><A HREF="../htmlman1/vi.html">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
             &lt;<I>purge</I> <I>divergent</I> <I>attribute</I> <I>settings</I>&gt;
          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">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,...
                                 &lt;<I>replace</I> <I>object</I> <I>attributes</I>&gt;
          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,...       &lt;<I>show</I> <I>share</I> <I>tree</I> <I>node</I>&gt;
          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">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                           &lt;<I>show</I> <I>complexes</I>&gt;
          Display the complex configuration.

     -scal calendar_name           &lt;<I>show</I> <I>calendar</I>&gt;
          Display the configuration of the specified calendar.

     -scall                        &lt;<I>show</I> <I>calendar</I> <I>list</I>&gt;
          Show a list of all calendars currently defined.

     -sckpt ckpt_name              &lt;<I>show</I> <I>ckpt</I>. <I>environment</I>&gt;
          Display   the   configuration    of    the    specified
          checkpointing environment.

     -sckptl                       &lt;<I>show</I> <I>ckpt</I>. <I>environment</I> <I>list</I>&gt;
          Show a list of the names of all checkpointing  environ-
          ments currently configured.

     -sconf [host,...|global]      &lt;<I>show</I> <I>configuration</I>&gt;
          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">sge_conf(5)</A></B>.

     -sconfl                       &lt;<I>show</I> <I>configuration</I> <I>list</I>&gt;
          Display a list of hosts for  which  configurations  are
          available.  The  special host name global refers to the
          global configuration.

     -sds                          &lt;<I>show</I> <I>detached</I> <I>settings</I>&gt;
          Displays detached settings in  the  cluster  configura-
          tion.

     -se hostname                  &lt;<I>show</I> <I>execution</I> <I>host</I>&gt;
          Displays the  definition  of  the  specified  execution
          host.

     -sel                          &lt;<I>show</I> <I>execution</I> <I>hosts</I>&gt;
          Displays the Grid Engine execution host list.

     -secl                         &lt;<I>show</I> <I>event</I> <I>clients</I>&gt;
          Displays the Grid Engine event client list.

     -sep                          &lt;<I>show</I> <I>licensed</I> <I>processors</I>&gt;
          Displays a list  of  number  of  processors  which  are
          licensed per execution host and in total.

     -sh                           &lt;<I>show</I> <I>administrative</I> <I>hosts</I>&gt;
          Displays the Grid Engine administrative host list.

     -shgrp group                  &lt;<I>show</I> <I>host</I> <I>group</I> <I>config</I>.&gt;
          Displays the host group entries for the group specified
          in group.

     -shgrpl                       &lt;<I>show</I> <I>host</I> <I>group</I> <I>lists</I>&gt;
          Displays a name list  of  all  currently  defined  host
          groups which have a valid host group configuration.

     -shgrp_tree group     &lt;<I>show</I> <I>host</I> <I>group</I> <I>tree</I>&gt;
          Shows a tree like structure of host group.

     -shgrp_resolved       &lt;<I>show</I> <I>host</I> <I>group</I> <I>hosts</I>&gt;
          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]         &lt;<I>show</I> <I>RQS</I> <I>configuration</I>&gt;
          Show the definition of the <I>resource</I>  <I>quota</I>  <I>sets</I>  (RQS)
          specified by the argument.

     -srqsl                        &lt;<I>show</I> <I>RQS</I>-<I>list</I>&gt;
          Show a list of all  currently  defined  <I>resource</I>  <I>quota</I>
          <I>sets</I>s (RQSs).

     -sm                           &lt;<I>show</I> <I>managers</I>&gt;
          Displays the managers list.

     -so                           &lt;<I>show</I> <I>operators</I>&gt;
          Displays the operator list.

     -sobjl obj_spec attr_name val &lt;<I>show</I> <I>object</I> <I>list</I>&gt;
          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">queue_conf(5)</A></B> or <B><A HREF="../htmlman5/host_conf.html">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                   &lt;<I>show</I> <I>PE</I> <I>configuration</I>&gt;
          Show the definition of the  <I>parallel</I>  <I>environment</I>  (PE)
          specified by the argument.

     -spl                          &lt;<I>show</I> <I>PE</I>-<I>list</I>&gt;
          Show a list of all currently defined <I>parallel</I>  <I>environ-</I>
          <I>ment</I>s (PEs).

     -sprj project                 &lt;<I>show</I> <I>project</I>&gt;
          Shows the definition of the specified project (see <I>pro-</I>
          <B><A HREF="../htmlman5/ject.html">ject(5)</A></B>).

     -sprjl                        &lt;<I>show</I> <I>project</I> <I>list</I>&gt;
          Shows the list of all currently defined projects.

     -sq wc_queue_list             &lt;show queues&gt;
          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">sge_types(1)</A></B>.

     -sql                          &lt;<I>show</I> <I>queue</I> <I>list</I>&gt;
          Show a list of all currently defined cluster queues.

     -ss                           &lt;<I>show</I> <I>submit</I> <I>hosts</I>&gt;
          Displays the Grid Engine submit host list.

     -ssconf                       &lt;<I>show</I> <I>scheduler</I> <I>configuration</I>&gt;
          Displays the current  scheduler  configuration  in  the
          format explained in <B><A HREF="../htmlman5/sched_conf.html">sched_conf(5)</A></B>.

     -sstnode node_path,...        &lt;<I>show</I> <I>share</I> <I>tree</I> <I>node</I>&gt;
          Shows the name and shares of the specified  share  tree
          node(s)   (see  <B><A HREF="../htmlman5/share_tree.html">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                       &lt;<I>show</I> <I>share</I> <I>tree</I>&gt;
          Shows  the  definition   of   the   share   tree   (see
          <B><A HREF="../htmlman5/share_tree.html">share_tree(5)</A></B>).

     -sss                          &lt;<I>show</I> <I>scheduler</I> <I>status</I>&gt;
          Currently displays the host on which  the  Grid  Engine
          scheduler is active or an error message if no scheduler
          is running.

     -su acl_name                  &lt;<I>show</I> <I>user</I> <I>ACL</I>&gt;
          Displays a Grid Engine user access list (ACL).

     -sul                          &lt;<I>show</I> <I>user</I> <I>lists</I>&gt;
          Displays a list of names of all currently defined  Grid
          Engine user access lists (ACLs).

     -suser user,...               &lt;<I>show</I> <I>user</I>&gt;
          Shows the definition  of  the  specified  user(s)  (see
          <B><A HREF="../htmlman5/user.html">user(5)</A></B>).

     -suserl                       &lt;<I>show</I> <I>users</I>&gt;
          Shows the list of all currently defined users.

     -tsm                          &lt;<I>trigger</I> <I>scheduler</I> <I>monitoring</I>&gt;
          The Grid Engine scheduler <B><A HREF="../htmlman8/sge_schedd.html">sge_schedd(8)</A></B>  is  forced  by
          this  option  to  print  trace  messages  of  its  next
          scheduling        run        to        the         file
          &lt;<I>sge</I>_<I>root</I>&gt;/&lt;<I>cell</I>&gt;/<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">qstat(1)</A></B>  -F  option (see description of Full Format in
          section OUTPUT FORMATS of the <B><A HREF="../htmlman1/qstat.html">qstat(1)</A></B> manual page.

ENVIRONMENTAL VARIABLES
     SGE_ROOT       Specifies the location  of  the  Grid  Engine
                    standard configuration files.

     SGE_CELL       If set, specifies  the  default  Grid  Engine
                    cell.  To  address  a  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">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">sge_execd(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_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
     &lt;<I>sge</I>_<I>root</I>&gt;/&lt;<I>cell</I>&gt;/<I>common</I>/<I>act</I>_<I>qmaster</I>
                     Grid Engine master host file

SEE ALSO
     <B><A HREF="../htmlman1/sge_intro.html">sge_intro(1)</A></B>,    <B><A HREF="../htmlman1/qstat.html">qstat(1)</A></B>,    <B><A HREF="../htmlman5/checkpoint.html">checkpoint(5)</A></B>,     <B><A HREF="../htmlman5/complex.html">complex(5)</A></B>,
     <B><A HREF="../htmlman5/sge_conf.html">sge_conf(5)</A></B>,    <B><A HREF="../htmlman5/host_conf.html">host_conf(5)</A></B>,    <B><A HREF="../htmlman5/sge_pe.html">sge_pe(5)</A></B>,   <B><A HREF="../htmlman5/queue_conf.html">queue_conf(5)</A></B>,
     <B><A HREF="../htmlman8/sge_execd.html">sge_execd(8)</A></B>, <B><A HREF="../htmlman8/sge_qmaster.html">sge_qmaster(8)</A></B>, <B><A HREF="../htmlman8/sge_schedd.html">sge_schedd(8)</A></B>.

COPYRIGHT
     See <B><A HREF="../htmlman1/sge_intro.html">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>