QCONF(1)                   Grid Engine User Commands                  QCONF(1)



NNAAMMEE
       qconf - Grid Engine Queue Configuration

SSYYNNTTAAXX
       qqccoonnff ooppttiioonnss

DDEESSCCRRIIPPTTIIOONN
       _Q_c_o_n_f  allows  the  system administrator to add, delete, and modify the
       current Grid Engine configuration,  including  queue  management,  host
       management,  complex management and user management.  _Q_c_o_n_f also allows
       you to examine the current queue configuration for existing queues.

       _Q_c_o_n_f allows the use of the backslash, '\', character at the end  of  a
       line  to  indicate  that the next line is a continuation of the current
       line.  When displaying settings, such as the output of one of  the  -s*
       options,  _q_c_o_n_f will break up long lines (lines greater than 80 charac-
       ters) into smaller lines using backslash line continuation where possi-
       ble.   Lines will only be broken up at commas or whitespace.  This fea-
       ture can be disabled by setting the SGE_SINGLE_LINE  environment  vari-
       able.

OOPPTTIIOONNSS
       Unless  denoted  otherwise, the following options and the corresponding
       operations are available to all users with a valid account.


       --AAaattttrr oobbjj__ssppeecc ffnnaammee oobbjj__iinnssttaannccee,,......
                                     _<_a_d_d _t_o _o_b_j_e_c_t _a_t_t_r_i_b_u_t_e_s_>
              Similar to --aaaattttrr (see below) but takes specifications  for  the
              object  attributes  to  be  enhanced  from  file named ffnnaammee. As
              opposed to --aaaattttrr, multiple attributes can  be  enhanced.  Their
              specification  has  to  be  enlisted in ffnnaammee following the file
              format of the corresponding object (see  _q_u_e_u_e___c_o_n_f(5)  for  the
              queue, for example).
              Requires root/manager privileges.

       --AAccaall ffnnaammee                   _<_a_d_d _c_a_l_e_n_d_a_r_>
              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 _c_a_l_e_n_d_a_r___c_o_n_f(5).

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

       --AAcckkpptt ffnnaammee                  _<_a_d_d _c_k_p_t_. _e_n_v_i_r_o_n_m_e_n_t_>
              Add  the  checkpointing  environment  as  defined  in ffnnaammee (see
              _c_h_e_c_k_p_o_i_n_t(5)) to the list of supported  checkpointing  environ-
              ments.  Requires root or manager privileges.

       --AAccoonnff ffiillee__lliisstt              _<_a_d_d _c_o_n_f_i_g_u_r_a_t_i_o_n_s_>
              Add  the  configurations (see _g_e___c_o_n_f(5)) specified in the files
              enlisted in the comma separated ffiillee__lliisstt. The configuration  is
              added for the host that is identical to the file name.
              Requires root or manager privileges.

       --AAee ffnnaammee                     _<_a_d_d _e_x_e_c_u_t_i_o_n _h_o_s_t_>
              Add the execution host defined in ffnnaammee to the Grid Engine clus-
              ter. The format of the execution host specification is described
              in _h_o_s_t___c_o_n_f(5).  Requires root or manager privileges.

       --AAhhggrrpp ffiillee                   _<_a_d_d _h_o_s_t _g_r_o_u_p _c_o_n_f_i_g_>
              Add the host group configuration defined in ffiillee.  The file for-
              mat of ffiillee must comply to the format specified in _h_o_s_t_g_r_o_u_p(5).
              Requires root or manager privileges.

       --AArrqqss ffnnaammee _<_a_d_d _R_Q_S _c_o_n_f_i_g_u_r_a_t_i_o_n_>
              Add the resource quota set (RQS) defined in the file named ffnnaammee
              to the Grid Engine cluster. Requires root or manager privileges.

       --AApp ffnnaammee                     _<_a_d_d _P_E _c_o_n_f_i_g_u_r_a_t_i_o_n_>
              Add  the  parallel environment (PE) defined in ffnnaammee to the Grid
              Engine cluster. Requires root or manager privileges.

       --AApprrjj ffnnaammee                   _<_a_d_d _n_e_w _p_r_o_j_e_c_t_>
              Adds the project description defined in ffnnaammee  to  the  list  of
              registered  projects (see _p_r_o_j_e_c_t(5)).  Requires root or manager
              privileges.

       --AAqq ffnnaammee                     _<_a_d_d _n_e_w _q_u_e_u_e_>
              Add the queue defined in  ffnnaammee  to  the  Grid  Engine  cluster.
              Requires root or manager privileges.

       --AAuu ffnnaammee                     _<_a_d_d _a_n _A_C_L_>
              Add  the user access list (ACL) defined in ffnnaammee to Grid Engine.
              User lists are used for  queue  usage  authentication.  Requires
              root/manager/operator privileges.

       --DDaattttrr oobbjj__ssppeecc ffnnaammee oobbjj__iinnssttaannccee,,......
                                     _<_d_e_l_. _f_r_o_m _o_b_j_e_c_t _a_t_t_r_i_b_s_>
              Similar  to  --ddaattttrr  (see  below) but the definition of the list
              attributes from which entries are to be deleted is contained  in
              the  file named ffnnaammee. As opposed to --ddaattttrr, multiple attributes
              can be modified. Their specification has to be enlisted in ffnnaammee
              following  the  file  format  of  the  corresponding object (see
              _q_u_e_u_e___c_o_n_f(5) for the queue, for example).
              Requires root/manager privileges.

       --MMaattttrr oobbjj__ssppeecc ffnnaammee oobbjj__iinnssttaannccee,,......
                                     _<_m_o_d_. _o_b_j_e_c_t _a_t_t_r_i_b_u_t_e_s_>
              Similar to --mmaattttrr (see below) but takes specifications  for  the
              object  attributes  to  be  modified  from  file named ffnnaammee. As
              opposed to --mmaattttrr, multiple attributes can  be  modified.  Their
              specification  has  to  be  enlisted in ffnnaammee following the file
              format of the corresponding object (see  _q_u_e_u_e___c_o_n_f(5)  for  the
              queue, for example).
              Requires root/manager privileges.

       --MMcc ffnnaammee                     _<_m_o_d_i_f_y _c_o_m_p_l_e_x_>
              Overwrites  the  complex configuration by the contents of ffnnaammee.
              The argument file must comply to the format  specified  in  _c_o_m_-
              _p_l_e_x(5).  Requires root or manager privilege.

       --MMccaall ffnnaammee                   _<_m_o_d_i_f_y _c_a_l_e_n_d_a_r_>
              Overwrites  the  calendar  definition as specified in ffnnaammee. The
              argument file must comply to  the  format  described  in  _c_a_l_e_n_-
              _d_a_r___c_o_n_f(5).  Requires root or manager privilege.

       --MMcckkpptt ffnnaammee                  _<_m_o_d_i_f_y _c_k_p_t_. _e_n_v_i_r_o_n_m_e_n_t_>
              Overwrite an existing checkpointing environment with the defini-
              tions in ffnnaammee (see _c_h_e_c_k_p_o_i_n_t(5)).  The name attribute in ffnnaammee
              has  to  match  an  existing checkpointing environment. Requires
              root or manager privileges.

       --MMccoonnff ffiillee__lliisstt              _<_m_o_d_i_f_y _c_o_n_f_i_g_u_r_a_t_i_o_n_s_>
              Modify the configurations  (see  _g_e___c_o_n_f(5))  specified  in  the
              files  enlisted in the comma separated ffiillee__lliisstt. The configura-
              tion is modified for the host that  is  identical  to  the  file
              name.
              Requires root or manager privileges.

       --MMee ffnnaammee                     _<_m_o_d_i_f_y _e_x_e_c_u_t_i_o_n _h_o_s_t_>
              Overwrites  the  execution  host configuration for the specified
              host with the contents of ffnnaammee, which must comply to the format
              defines in _h_o_s_t___c_o_n_f(5).  Requires root or manager privilege.

       --MMhhggrrpp ffiillee                   _<_m_o_d_i_f_y _h_o_s_t _g_r_o_u_p _c_o_n_f_i_g_._>
              Allows  changing  of host group configuration with a single com-
              mand.  All host group configuration entries  contained  in  ffiillee
              will  be  applied.  Configuration  entries not contained in ffiillee
              will be deleted. The file format of ffiillee must comply to the for-
              mat specified in _h_o_s_t_g_r_o_u_p(5).

       --MMrrqqss ffnnaammee [[mmrrqqss__nnaammee]]       _<_m_o_d_i_f_y _R_Q_S _c_o_n_f_i_g_u_r_a_t_i_o_n_>
              Same  as  --mmrrqqss (see below) but instead of invoking an editor to
              modify the RQS configuration, the file ffnnaammee  is  considered  to
              contain  a  changed  configuration.  The name of the rule set in
              ffnnaammee must be the same as rqs_name. If rqs_name is not set,  all
              rule  sets  are  overwritten  by the rule sets in ffnnaammee Refer to
              _g_e___r_e_s_o_u_r_c_e___q_u_o_t_a(5) for details on the RQS  configuration  for-
              mat.  Requires root or manager privilege.

       --MMpp ffnnaammee                     _<_m_o_d_i_f_y _P_E _c_o_n_f_i_g_u_r_a_t_i_o_n_>
              Same  as  --mmpp  (see  below) but instead of invoking an editor to
              modify the PE configuration the file ffnnaammee is considered to con-
              tain  a changed configuration.  Refer to _g_e___p_e(5) for details on
              the PE configuration format.  Requires root  or  manager  privi-
              lege.

       --MMpprrjj ffnnaammee                   _<_m_o_d_i_f_y _p_r_o_j_e_c_t _c_o_n_f_i_g_._>
              Same  as  --mmpprrjj (see below) but instead of invoking an editor to
              modify the project configuration the file ffnnaammee is considered to
              contain  a  changed  configuration.   Refer  to  _p_r_o_j_e_c_t(5)  for
              details on the project configuration format.  Requires  root  or
              manager privilege.

       --MMqq ffnnaammee                     _<_m_o_d_i_f_y _q_u_e_u_e _c_o_n_f_i_g_u_r_a_t_i_o_n_>
              Same  as  --mmqq  (see  below) but instead of invoking an editor to
              modify the queue configuration the file ffnnaammee is  considered  to
              contain  a  changed  configuration.   Refer to _q_u_e_u_e___c_o_n_f(5) for
              details on the queue configuration  format.   Requires  root  or
              manager privilege.

       --MMssccoonnff   ffnnaammee                 _<_m_o_d_i_f_y  _s_c_h_e_d_u_l_e_r  _c_o_n_f_i_g_u_r_a_t_i_o_n  _f_r_o_m
       _f_i_l_e_>
              The current scheduler configuration (see _s_c_h_e_d___c_o_n_f(5)) is over-
              ridden with the configuration specified in the  file.   Requires
              root or manager privilege.

       --MMssttrreeee ffnnaammee                 _<_m_o_d_i_f_y _s_h_a_r_e _t_r_e_e_>
              Modifies  the  definition of the share tree (see _s_h_a_r_e___t_r_e_e(5)).
              The modified sharetree is read from file fname.   Requires  root
              or manager privileges.

       --MMuu ffnnaammee                     _<_m_o_d_i_f_y _A_C_L_>
              Takes  the  user access list (ACL) defined in ffnnaammee to overwrite
              any existing ACL with the  same  name.  See  _a_c_c_e_s_s___l_i_s_t(5)  for
              information  on  the  ACL configuration format. Requires root or
              manager privilege.

       --MMuusseerr ffnnaammee                  _<_m_o_d_i_f_y _u_s_e_r_>
              Modify the user defined in ffnnaammee in the Grid Engine cluster. The
              format  of  the  user  specification  is  described  in _u_s_e_r(5).
              Requires root or manager privileges.

       --RRaattttrr oobbjj__ssppeecc ffnnaammee oobbjj__iinnssttaannccee,,......
                                     _<_r_e_p_l_a_c_e _o_b_j_e_c_t _a_t_t_r_i_b_s_>
              Similar to --rraattttrr (see below) but the  definition  of  the  list
              attributes  whose  content  is to be replace is contained in the
              file named ffnnaammee. As opposed to --rraattttrr, multiple attributes  can
              be  modified.  Their  specification  has to be enlisted in ffnnaammee
              following the file  format  of  the  corresponding  object  (see
              _q_u_e_u_e___c_o_n_f(5) for the queue, for example).
              Requires root/manager privileges.

       --aaaattttrr oobbjj__ssppeecc aattttrr__nnaammee vvaall oobbjj__iinnssttaannccee,,......
                 _<_a_d_d _t_o _o_b_j_e_c_t _a_t_t_r_i_b_u_t_e_s_>
              Allows  adding  specifications  to  a  single configuration list
              attribute in multiple instances of an object with a single  com-
              mand.  Currently  supported objects are the queue, the host, the
              host group, the parallel environment, the  resource  quota  sets
              and the checkpointing interface configuration being specified as
              _q_u_e_u_e , _e_x_e_c_h_o_s_t , _h_o_s_t_g_r_o_u_p , _p_e , _r_q_s  or  _c_k_p_t  in  oobbjj__ssppeecc.
              For  the  obj_spec _q_u_e_u_e 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 _s_g_e___t_y_p_e_s(1).
              Depending on the type of the obj_instance this adds to the clus-
              ter queues attribute sublist the cluster queues implicit default
              configuration value or the queue domain configuration  value  or
              queue  instance  configuration  value.  The queue llooaadd__tthheesshhoollddss
              parameter is an example of a list  attribute.  With  the  --aaaattttrr
              option,  entries  can  be added to such lists, while they can be
              deleted with --ddaattttrr, modified with  --mmaattttrr,  and  replaced  with
              --rraattttrr.
              For the obj_spec _r_q_s the obj_instance is a unique identifier 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 speci-
              fied  with  aattttrr__nnaammee  followed by vvaall as a _n_a_m_e_=_v_a_l_u_e 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 _e_x_e_c_h_o_s_t  object  the
              llooaadd__vvaalluueess attribute cannot be modified (see _h_o_s_t___c_o_n_f(5)).
              Requires root or manager privileges.

       --aaccaall ccaalleennddaarr__nnaammee           _<_a_d_d _c_a_l_e_n_d_a_r_>
              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 _c_a_l_e_n_d_a_r___c_o_n_f(5).

              With the calendar name given in the option argument  _q_c_o_n_f  will
              open  a temporary file and start up the text editor indicated by
              the environment variable EDITOR (default editor is _v_i(1) if EDI-
              TOR  is  not  set).  After  entering the calendar definition and
              closing the editor the new calendar is  checked  and  registered
              with _g_e___q_m_a_s_t_e_r(8).  Requires root/manager privileges.

       --aacckkpptt cckkpptt__nnaammee              _<_a_d_d _c_k_p_t_. _e_n_v_i_r_o_n_m_e_n_t_>
              Adds a checkpointing environment under the name cckkpptt__nnaammee to the
              list of checkpointing environments maintained by Grid Engine and
              to be usable to submit checkpointing jobs (see _c_h_e_c_k_p_o_i_n_t(5) for
              details on the format of  a  checkpointing  environment  defini-
              tion).  _Q_c_o_n_f retrieves a default checkpointing environment con-
              figuration and executes _v_i(1) (or $EDITOR if the EDITOR environ-
              ment  variable is set) to allow you to customize the checkpoint-
              ing environment configuration. Upon exit from  the  editor,  the
              checkpointing  environment  is  registered  with  _g_e___q_m_a_s_t_e_r(8).
              Requires root/manager privileges.

       --aaccoonnff hhoosstt,,......               _<_a_d_d _c_o_n_f_i_g_u_r_a_t_i_o_n_>
              Successively adds configurations (see _g_e___c_o_n_f(5)) For the  hosts
              in  the  comma  separated  _f_i_l_e___l_i_s_t.   For each host, an editor
              ($EDITOR indicated or _v_i(1)) is invoked  and  the  configuration
              for  the  host  can  be entered. The configuration is registered
              with _g_e___q_m_a_s_t_e_r(8) after saving the file and quitting  the  edi-
              tor.
              Requires root or manager privileges.

       --aaee [[hhoosstt__tteemmppllaattee]]           _<_a_d_d _e_x_e_c_u_t_i_o_n _h_o_s_t_>
              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 --mmee option described below.
              If the hhoosstt__tteemmppllaattee argument is present,  _q_c_o_n_f  retrieves  the
              configuration of the specified execution host from _g_e___q_m_a_s_t_e_r(8)
              or a generic template otherwise.  The template is then stored in
              a  file  and  _q_c_o_n_f  executes  _v_i(1) (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 specifi-
              cation is described in _h_o_s_t___c_o_n_f(5).  When the changes are saved
              in  the  editor and the editor is quit the new execution host is
              registered with  _g_e___q_m_a_s_t_e_r(8).   Requires  root/manager  privi-
              leges.

       --aahh hhoossttnnaammee,,......              _<_a_d_d _a_d_m_i_n_i_s_t_r_a_t_i_v_e _h_o_s_t_>
              Adds hosts hhoossttnnaammee to the Grid Engine trusted host list (a host
              must be in this list to execute administrative Grid Engine  com-
              mands,  the  sole exception to this being the execution of _q_c_o_n_f
              on the _g_e___q_m_a_s_t_e_r(8) node). The default Grid Engine installation
              procedures  usually  add all designated execution hosts (see the
              --aaee option above) to the Grid Engine trusted host list automati-
              cally.  Requires root or manager privileges.

       --aahhggrrpp ggrroouupp                  _<_a_d_d _h_o_s_t _g_r_o_u_p _c_o_n_f_i_g_._>
              Adds  a  new  host group with the name specified in ggrroouupp..  This
              command invokes an editor (either _v_i(1) 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.

       --aarrqqss [[rrqqss__nnaammee]]              _<_a_d_d _n_e_w _R_Q_S_>
              Adds  one or more _R_e_s_o_u_r_c_e _Q_u_o_t_a _S_e_t (RQS) description under the
              names rrqqss__nnaammee to the list of RQSs  maintained  by  Grid  Engine
              (see  _g_e___r_e_s_o_u_r_c_e___q_u_o_t_a(5)  for  details  on the format of a RQS
              definition).  _Q_c_o_n_f retrieves a default  RQS  configuration  and
              executes _v_i(1) (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 _g_e___q_m_a_s_t_e_r(8).
              Requires root or manager privileges.

       --aamm uusseerr,,......                  _<_a_d_d _m_a_n_a_g_e_r_s_>
              Adds the indicated  users  to  the  Grid  Engine  manager  list.
              Requires root or manager privileges.

       --aaoo uusseerr,,......                  _<_a_d_d _o_p_e_r_a_t_o_r_s_>
              Adds  the  indicated  users  to  the  Grid Engine operator list.
              Requires root or manager privileges.

       --aapp ppee__nnaammee                   _<_a_d_d _n_e_w _P_E_>
              Adds a _P_a_r_a_l_l_e_l _E_n_v_i_r_o_n_m_e_n_t  (PE)  description  under  the  name
              ppee__nnaammee  to  the list of PEs maintained by Grid Engine and to be
              usable to submit parallel jobs (see _g_e___p_e(5) for details on  the
              format  of  a PE definition).  _Q_c_o_n_f retrieves a default PE con-
              figuration and executes _v_i(1) (or $EDITOR if the EDITOR environ-
              ment  variable is set) to allow you to customize the PE configu-
              ration. Upon exit from the editor, the  PE  is  registered  with
              _g_e___q_m_a_s_t_e_r(8).  Requires root/manager privileges.

       --aatt tthhrreeaadd__nnaammee _<_a_c_t_i_v_a_t_e_s _t_h_r_e_a_d _i_n _m_a_s_t_e_r_>
              Activates   an   additional   thread   in  the  master  process.
              tthhrreeaadd__nnaammee might be either "scheduler"  or  "jvm".  The  corre-
              sponding  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.

       --aapprrjj                         _<_a_d_d _n_e_w _p_r_o_j_e_c_t_>
              Adds  a  project  description to the list of registered projects
              (see _p_r_o_j_e_c_t(5)).  _Q_c_o_n_f retrieves a template project configura-
              tion  and  executes  _v_i(1) (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 _g_e___q_m_a_s_-
              _t_e_r(8).  Requires root or manager privileges.

       --aaqq [[qquueeuuee__nnaammee]]              _<_a_d_d _n_e_w _q_u_e_u_e_>
              _Q_c_o_n_f   retrieves   the   default   queue   configuration   (see
              _q_u_e_u_e___c_o_n_f(5))  and  executes  _v_i(1)  (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 regis-
              tered with _g_e___q_m_a_s_t_e_r(8).  A minimal configuration requires only
              that the queue name and queue hostlist be set.  Requires root or
              manager privileges.

       --aass hhoossttnnaammee,,......              _<_a_d_d _s_u_b_m_i_t _h_o_s_t_s_>
              Add hosts hhoossttnnaammee to the list of hosts allowed to  submit  Grid
              Engine  jobs  and control their behavior only.  Requires root or
              manager privileges.

       --aassttnnooddee nnooddee__ppaatthh==sshhaarreess,,...... _<_a_d_d _s_h_a_r_e _t_r_e_e _n_o_d_e_>
              Adds the specified share tree node(s) to  the  share  tree  (see
              _s_h_a_r_e___t_r_e_e(5)).    The   nnooddee__ppaatthh   is   a   hierarchical  path
              ([[//]]nnooddee__nnaammee[[[[//..]]nnooddee__nnaammee......]])  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.

       --aassttrreeee                       _<_a_d_d _s_h_a_r_e _t_r_e_e_>
              Adds  the  definition  of  a  share  tree  to  the  system  (see
              _s_h_a_r_e___t_r_e_e(5)).  A template share tree is retrieved and an  edi-
              tor (either _v_i(1) or the editor indicated by $EDITOR) is invoked
              for modifying the share tree definition. Upon exiting  the  edi-
              tor,   the  modified  data  is  registered  with  _g_e___q_m_a_s_t_e_r(8).
              Requires root or manager privileges.

       --AAssttrreeee ffnnaammee                 _<_a_d_d _s_h_a_r_e _t_r_e_e_>
              Adds  the  definition  of  a  share  tree  to  the  system  (see
              _s_h_a_r_e___t_r_e_e(5))  from  the  file fname.  Requires root or manager
              privileges.

       --aauu uusseerr,,...... aaccll__nnaammee,,......     _<_a_d_d _u_s_e_r_s _t_o _A_C_L_s_>
              Adds users to Grid Engine user access lists (ACLs).  User  lists
              are  used  for  queue  usage  authentication. Requires root/man-
              ager/operator privileges.

       --AAuusseerr ffnnaammee                  _<_a_d_d _u_s_e_r_>
              Add the user defined in ffnnaammee to the Grid  Engine  cluster.  The
              format  of  the  user  specification  is  described  in _u_s_e_r(5).
              Requires root or manager privileges.

       --aauusseerr                        _<_a_d_d _u_s_e_r_>
              Adds a user to the list of registered users (see _u_s_e_r(5)).  This
              command  invokes an editor (either _v_i(1) or the editor indicated
              by the EDITOR environment variable) for a template user. The new
              user is registered after changing the entry and exiting the edi-
              tor. Requires root or manager privileges.

       --cclleeaarruussaaggee                   _<_c_l_e_a_r _s_h_a_r_e_t_r_e_e _u_s_a_g_e_>
              Clears all user and project usage from the sharetree.  All usage
              will be initialized back to zero.

       --ccqq wwcc__qquueeuuee__lliisstt             _<_c_l_e_a_n _q_u_e_u_e_>
              Cleans  queue  from  jobs which haven't been reaped. Primarily a
              development  tool.  Requires  root/manager/operator  privileges.
              Find a description of wc_queue_list in _s_g_e___t_y_p_e_s(1).

       --ddaattttrr oobbjj__ssppeecc aattttrr__nnaammee vvaall oobbjj__iinnssttaannccee,,......
                                     _<_d_e_l_e_t_e _i_n _o_b_j_e_c_t _a_t_t_r_i_b_s_>
              Allows  deleting  specifications  in 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 --aaaattttrr

       --ddccaall ccaalleennddaarr__nnaammee,,......       _<_d_e_l_e_t_e _c_a_l_e_n_d_a_r_>
              Deletes the specified  calendar  definition  from  Grid  Engine.
              Requires root/manager privileges.

       --ddcckkpptt cckkpptt__nnaammee              _<_d_e_l_e_t_e _c_k_p_t_. _e_n_v_i_r_o_n_m_e_n_t_>
              Deletes   the   specified  checkpointing  environment.  Requires
              root/manager privileges.

       --ddccoonnff hhoosstt,,......               _<_d_e_l_e_t_e _l_o_c_a_l _c_o_n_f_i_g_u_r_a_t_i_o_n_>
              The local configuration entries  for  the  specified  hosts  are
              deleted  from  the configuration list.  Requires root or manager
              privilege.

       --ddee hhoosstt__nnaammee,,......             _<_d_e_l_e_t_e _e_x_e_c_u_t_i_o_n _h_o_s_t_>
              Deletes  hosts  from  the  Grid  Engine  execution  host   list.
              Requires root or manager privileges.

       --ddhh hhoosstt__nnaammee,,......             _<_d_e_l_e_t_e _a_d_m_i_n_i_s_t_r_a_t_i_v_e _h_o_s_t_>
              Deletes  hosts from the Grid Engine trusted host list.  The host
              on which _g_e___q_m_a_s_t_e_r(8) is currently running  cannot  be  removed
              from the list of administrative hosts.  Requires root or manager
              privileges.

       --ddrrqqss rrqqss__nnaammee__lliisstt           _<_d_e_l_e_t_e _R_Q_S_>
              Deletes the specified resource quota sets (RQS).  Requires  root
              or manager privileges.

       --ddmm uusseerr[[,,uusseerr,,......]]           _<_d_e_l_e_t_e _m_a_n_a_g_e_r_s_>
              Deletes  managers  from the manager list.  Requires root or man-
              ager privileges.

       --ddoo uusseerr[[,,uusseerr,,......]]           _<_d_e_l_e_t_e _o_p_e_r_a_t_o_r_s_>
              Deletes operators from the operator list.  Requires root or man-
              ager privileges.

       --ddpp ppee__nnaammee                   _<_d_e_l_e_t_e _p_a_r_a_l_l_e_l _e_n_v_i_r_o_n_m_e_n_t_>
              Deletes  the specified parallel environment (PE).  Requires root
              or manager privileges.

       --ddpprrjj pprroojjeecctt,,......             _<_d_e_l_e_t_e _p_r_o_j_e_c_t_s_>
              Deletes the specified project(s). Requires  root/manager  privi-
              leges.

       --ddqq qquueeuuee__nnaammee,,......            _<_d_e_l_e_t_e _q_u_e_u_e_>
              Removes  the specified queue(s).  Active jobs will be allowed to
              run to completion.  Requires root or manager privileges.

       --ddss hhoosstt__nnaammee,,......             _<_d_e_l_e_t_e _s_u_b_m_i_t _h_o_s_t_>
              Deletes hosts from the Grid Engine submit host  list.   Requires
              root or manager privileges.

       --ddssttnnooddee nnooddee__ppaatthh,,......        _<_d_e_l_e_t_e _s_h_a_r_e _t_r_e_e _n_o_d_e_>
              Deletes  the  specified  share tree node(s).  The nnooddee__ppaatthh is a
              hierarchical path  ([[//]]nnooddee__nnaammee[[[[//..]]nnooddee__nnaammee......]])   specifying
              the  location  of  the  node  to  be  deleted in the share tree.
              Requires root or manager privileges.

       --ddssttrreeee                       _<_d_e_l_e_t_e _s_h_a_r_e _t_r_e_e_>
              Deletes the current share tree. Requires root or manager  privi-
              leges.

       --dduu uusseerr,,...... aaccll__nnaammee,,......     _<_d_e_l_e_t_e _u_s_e_r_s _f_r_o_m _A_C_L_>
              Deletes  one  or  more  users  from one or more Grid Engine user
              access lists (ACLs). Requires root/manager/operator  privileges.

       --dduull aaccll__nnaammee,,......             _<_d_e_l_e_t_e _u_s_e_r _l_i_s_t_s_>
              Deletes  one  or  more  user  lists  from  the system.  Requires
              root/manager/operator privileges.

       --dduusseerr uusseerr,,......               _<_d_e_l_e_t_e _u_s_e_r_s_>"
              Deletes the specified user(s) from the list of registered users.
              Requires root or manager privileges.

       --hheellpp  Prints a listing of all options.

       --kk{{mm||ss||ee[[jj]] {{hhoosstt,,......||aallll}}}}   _<_s_h_u_t_d_o_w_n _G_r_i_d _E_n_g_i_n_e_>
              NNoottee::  The  --kkss  switch  is deprecated, may be removed in future
              release.  Please use the --kktt switch instead.
              Used to shutdown Grid Engine components (daemons).  In the  form
              --kkmm  _g_e___q_m_a_s_t_e_r(8)  is forced to terminate in a controlled fash-
              ion. In the same way the --kkss switch causes  termination  of  the
              scheduler  thread.   Shutdown  of  running _g_e___e_x_e_c_d(8) processes
              currently registered is initiated by the --kkee option. If --kkeejj  is
              specified  instead,  all jobs running on the execution hosts are
              aborted prior to termination of the  corresponding  _g_e___e_x_e_c_d(8).
              The  comma  separated host list specifies the execution hosts to
              be addressed by the --kkee and --kkeejj option. If the keyword  aallll  is
              specified  instead  of a host list, all running _g_e___e_x_e_c_d(8) pro-
              cesses are shutdown. Job abortion, initiated by the --kkeejj  option
              will  result  in ddrr state for all running jobs until _g_e___e_x_e_c_d(8)
              is running again.
              Requires root or manager privileges.

       --kktt tthhrreeaadd__nnaammee   _<_t_e_r_m_i_n_a_t_e _m_a_s_t_e_r _t_h_r_e_a_d_>"
              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.

       --kkeecc {{iidd,,......||aallll}}             _<_k_i_l_l _e_v_e_n_t _c_l_i_e_n_t_>
              Used to shutdown event clients registered at _g_e___q_m_a_s_t_e_r(8).  The
              comma separated event client list specifies the event clients to
              be  addressed  by the --kkeecc option.  If the keyword aallll is speci-
              fied instead of an event client list, all running event  clients
              except special clients like the scheduler thread are terminated.
              Requires root or manager privilege.

       --mmaattttrr oobbjj__ssppeecc aattttrr__nnaammee vvaall oobbjj__iinnssttaannccee,,......
                                     _<_m_o_d_i_f_y _o_b_j_e_c_t _a_t_t_r_i_b_u_t_e_s_>
              Allows changing a single  configuration  attribute  in  multiple
              instances  of an object with a single command.  Find more infor-
              mation concerning obj_spec and obj_instance in  the  description
              of --aaaattttrr

       --mmcc                           _<_m_o_d_i_f_y _c_o_m_p_l_e_x_>
              The complex configuration (see _c_o_m_p_l_e_x(5)) is retrieved, an edi-
              tor is executed (either _v_i(1) or the editor indicated  by  $EDI-
              TOR)  and  the  changed complex configuration is registered with
              _g_e___q_m_a_s_t_e_r(8) upon exit of the editor.  Requires root or manager
              privilege.

       --mmccaall ccaalleennddaarr__nnaammee           _<_m_o_d_i_f_y _c_a_l_e_n_d_a_r_>
              The  specified  calendar  definition  (see  _c_a_l_e_n_d_a_r___c_o_n_f(5)) is
              retrieved, an editor is executed (either  _v_i(1)  or  the  editor
              indicated  by  $EDITOR)  and  the changed calendar definition is
              registered with _g_e___q_m_a_s_t_e_r(8) upon exit of the editor.  Requires
              root or manager privilege.

       --mmcckkpptt cckkpptt__nnaammee              _<_m_o_d_i_f_y _c_k_p_t_. _e_n_v_i_r_o_n_m_e_n_t_>
              Retrieves  the  current  configuration  for the specified check-
              pointing environment, executes an editor (either  _v_i(1)  or  the
              editor  indicated by the EDITOR environment variable) and regis-
              ters the new configuration with  the  _g_e___q_m_a_s_t_e_r(8).   Refer  to
              _c_h_e_c_k_p_o_i_n_t(5)  for details on the checkpointing environment con-
              figuration format.  Requires root or manager privilege.

       --mmccoonnff [[hhoosstt,,......||gglloobbaall]]      _<_m_o_d_i_f_y _c_o_n_f_i_g_u_r_a_t_i_o_n_>
              The configuration for the specified host is retrieved, an editor
              is  executed  (either  _v_i(1) or the editor indicated by $EDITOR)
              and the changed configuration is registered  with  _g_e___q_m_a_s_t_e_r(8)
              upon exit of the editor.  If the optional host argument is omit-
              ted or if the special host name gglloobbaall iiss ssppeecciiffiieedd,, tthhee  gglloobbaall
              ccoonnffiigguurraattiioonn  iiss mmooddiiffiieedd..  TThhee  ffoorrmmaatt ooff tthhee ccoonnffiigguurraattiioonn iiss
              ddeessccrriibbeedd iinn _g_e___c_o_n_f(5).
              Requires root or manager privilege.

       --mmee hhoossttnnaammee                  _<_m_o_d_i_f_y _e_x_e_c_u_t_i_o_n _h_o_s_t_>
              Retrieves the current configuration for the specified  execution
              host,  executes  an editor (either _v_i(1) or the editor indicated
              by the EDITOR environment variable) and  registers  the  changed
              configuration with _g_e___q_m_a_s_t_e_r(8) upon exit from the editor.  The
              format of the  execution  host  configuration  is  described  in
              _h_o_s_t___c_o_n_f(5).  Requires root or manager privilege.

       --mmhhggrrpp ggrroouupp _<_m_o_d_i_f_y _h_o_s_t _g_r_o_u_p _c_o_n_f_i_g_u_r_a_t_i_o_n_>
              The host group entries for the host group specified in ggrroouupp are
              retrieved and an editor (either _v_i(1) 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 _h_o_s_t_g_r_o_u_p(5).  Requires root or  manager  privi-
              leges.

       --mmrrqqss [[rrqqss__nnaammee]]              _<_m_o_d_i_f_y _R_Q_S _c_o_n_f_i_g_u_r_a_t_i_o_n_>
              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 _v_i(1) or the editor indi-
              cated by the EDITOR environment variable) and registers the  new
              configuration     with     the    _g_e___q_m_a_s_t_e_r(8).     Refer    to
              _g_e___r_e_s_o_u_r_c_e___q_u_o_t_a(5) for details on the RQS  configuration  for-
              mat.  Requires root or manager privilege.

       --mmpp ppee__nnaammee                   _<_m_o_d_i_f_y _P_E _c_o_n_f_i_g_u_r_a_t_i_o_n_>
              Retrieves  the  current configuration for the specified _p_a_r_a_l_l_e_l
              _e_n_v_i_r_o_n_m_e_n_t (PE), executes an editor (either _v_i(1) or the editor
              indicated  by the EDITOR environment variable) and registers the
              new configuration with the _g_e___q_m_a_s_t_e_r(8).  Refer to _g_e___p_e(5) for
              details  on  the PE configuration format.  Requires root or man-
              ager privilege.

       --mmpprrjj pprroojjeecctt                 _<_m_o_d_i_f_y _p_r_o_j_e_c_t_>
              Data for the specific project is retrieved (see _p_r_o_j_e_c_t(5))  and
              an  editor  (either _v_i(1) or the editor indicated by $EDITOR) is
              invoked for modifying the project definition. Upon  exiting  the
              editor,  the modified data is registered.  Requires root or man-
              ager privileges.

       --mmqq qquueeuueennaammee                 _<_m_o_d_i_f_y _q_u_e_u_e _c_o_n_f_i_g_u_r_a_t_i_o_n_>
              Retrieves the current configuration  for  the  specified  queue,
              executes  an editor (either _v_i(1) or the editor indicated by the
              EDITOR environment variable) and registers the new configuration
              with  the  _g_e___q_m_a_s_t_e_r(8).  Refer to _q_u_e_u_e___c_o_n_f(5) for details on
              the queue configuration format.  Requires root or manager privi-
              lege.

       --mmssccoonnff                       _<_m_o_d_i_f_y _s_c_h_e_d_u_l_e_r _c_o_n_f_i_g_u_r_a_t_i_o_n_>
              The  current  scheduler  configuration  (see  _s_c_h_e_d___c_o_n_f(5))  is
              retrieved, an editor is executed (either  _v_i(1)  or  the  editor
              indicated  by  $EDITOR)  and the changed configuration is regis-
              tered with _g_e___q_m_a_s_t_e_r(8) upon exit of the editor.  Requires root
              or manager privilege.

       --mmssttnnooddee nnooddee__ppaatthh==sshhaarreess,,...... _<_m_o_d_i_f_y _s_h_a_r_e _t_r_e_e _n_o_d_e_>
              Modifies the specified share tree node(s) in the share tree (see
              _s_h_a_r_e___t_r_e_e(5)).   The   nnooddee__ppaatthh   is   a   hierarchical   path
              ([[//]]nnooddee__nnaammee[[[[//..]]nnooddee__nnaammee......]])   specifying the location of an
              existing node in the share tree.  The node is set to the  number
              of specified sshhaarreess.  Requires root or manager privileges.

       --mmssttrreeee                       _<_m_o_d_i_f_y _s_h_a_r_e _t_r_e_e_>
              Modifies  the  definition of the share tree (see _s_h_a_r_e___t_r_e_e(5)).
              The present share tree is retrieved and an editor (either  _v_i(1)
              or the editor indicated by $EDITOR) is invoked for modifying the
              share tree definition. Upon exiting  the  editor,  the  modified
              data is registered with _g_e___q_m_a_s_t_e_r(8).  Requires root or manager
              privileges.

       --mmuu aaccll__nnaammee                  _<_m_o_d_i_f_y _u_s_e_r _a_c_c_e_s_s _l_i_s_t_s_>
              Retrieves the  current  configuration  for  the  specified  user
              access  list,  executes  an  editor  (either _v_i(1) or the editor
              indicated by the EDITOR environment variable) and registers  the
              new configuration with the _g_e___q_m_a_s_t_e_r(8).  Requires root or man-
              ager privilege.

       --mmuusseerr uusseerr                   _<_m_o_d_i_f_y _u_s_e_r_>
              Data for the specific user is retrieved  (see  _u_s_e_r(5))  and  an
              editor (either _v_i(1) or the editor indicated by the EDITOR envi-
              ronment variable) is invoked for modifying the user  definition.
              Upon  exiting  the  editor,  the  modified  data  is registered.
              Requires root or manager privileges.

       --ppuurrggee qquueeuuee aattttrr__nnmm,,...... oobbjj__ssppeecc
                 _<_p_u_r_g_e _d_i_v_e_r_g_e_n_t _a_t_t_r_i_b_u_t_e _s_e_t_t_i_n_g_s_>
              Delete the values of the attributes defined in aattttrr__nnmm from  the
              object  defined in oobbjj__ssppeecc. Obj_spec can be "queue_instance" or
              "queue_domain".  The names of the attributes  are  described  in
              _q_u_e_u_e___c_o_n_f(1).
              This  operation only works on a single queue instance or domain.
              It cannot be used on a cluster queue.  In  the  case  where  the
              oobbjj__ssppeecc  is "queue@@hostgroup", the attribute values defined in
              aattttrr__nnmm which are set for the indicated hostgroup  are  deleted,
              but  not  those  which  are  set for the hosts contained by that
              hostgroup.  If the aattttrr__nnmm 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.

       --rraattttrr oobbjj__ssppeecc aattttrr__nnaammee vvaall oobbjj__iinnssttaannccee,,......
                                     _<_r_e_p_l_a_c_e _o_b_j_e_c_t _a_t_t_r_i_b_u_t_e_s_>
              Allows replacing a single configuration list attribute in multi-
              ple instances of an object with a  single  command.   Find  more
              information concerning obj_spec and obj_instance in the descrip-
              tion of --aaaattttrr ..
              Requires root or manager privilege.

       --rrssssttnnooddee nnooddee__ppaatthh,,......       _<_s_h_o_w _s_h_a_r_e _t_r_e_e _n_o_d_e_>
              Recursively shows the name and shares  of  the  specified  share
              tree  node(s)  and the names and shares of its child nodes. (see
              _s_h_a_r_e___t_r_e_e(5)).   The   nnooddee__ppaatthh   is   a   hierarchical   path
              ([[//]]nnooddee__nnaammee[[[[//..]]nnooddee__nnaammee......]])   specifying  the location of a
              node in the share tree.

       --sscc                           _<_s_h_o_w _c_o_m_p_l_e_x_e_s_>
              Display the complex configuration.

       --ssccaall ccaalleennddaarr__nnaammee           _<_s_h_o_w _c_a_l_e_n_d_a_r_>
              Display the configuration of the specified calendar.

       --ssccaallll                        _<_s_h_o_w _c_a_l_e_n_d_a_r _l_i_s_t_>
              Show a list of all calendars currently defined.

       --sscckkpptt cckkpptt__nnaammee              _<_s_h_o_w _c_k_p_t_. _e_n_v_i_r_o_n_m_e_n_t_>
              Display the configuration of the specified  checkpointing  envi-
              ronment.

       --sscckkppttll                       _<_s_h_o_w _c_k_p_t_. _e_n_v_i_r_o_n_m_e_n_t _l_i_s_t_>
              Show  a list of the names of all checkpointing environments cur-
              rently configured.

       --ssccoonnff [[hhoosstt,,......||gglloobbaall]]      _<_s_h_o_w _c_o_n_f_i_g_u_r_a_t_i_o_n_>
              Print the global or local (host specific) configuration.  If the
              optional  comma  separated  host list argument is omitted or the
              special string gglloobbaall is given, the global configuration is dis-
              played.   The  configuration  in effect on a certain host is the
              merger of the global configuration and the host  specific  local
              configuration.  The  format of the configuration is described in
              _g_e___c_o_n_f(5).

       --ssccoonnffll                       _<_s_h_o_w _c_o_n_f_i_g_u_r_a_t_i_o_n _l_i_s_t_>
              Display a list of hosts for which configurations are  available.
              The special host name gglloobbaall rreeffeerrss ttoo tthhee gglloobbaall ccoonnffiigguurraattiioonn..

       --ssddss                          _<_s_h_o_w _d_e_t_a_c_h_e_d _s_e_t_t_i_n_g_s_>
              Displays detached settings in the cluster configuration.

       --ssee hhoossttnnaammee                  _<_s_h_o_w _e_x_e_c_u_t_i_o_n _h_o_s_t_>
              Displays the definition of the specified execution host.

       --sseell                          _<_s_h_o_w _e_x_e_c_u_t_i_o_n _h_o_s_t_s_>
              Displays the Grid Engine execution host list.

       --sseeccll                         _<_s_h_o_w _e_v_e_n_t _c_l_i_e_n_t_s_>
              Displays the Grid Engine event client list.

       --sseepp                          _<_s_h_o_w _l_i_c_e_n_s_e_d _p_r_o_c_e_s_s_o_r_s_>
              NNoottee:: Deprecated, may be removed in future release.
              Displays a list of number of processors which are  licensed  per
              execution host and in total.

       --sshh                           _<_s_h_o_w _a_d_m_i_n_i_s_t_r_a_t_i_v_e _h_o_s_t_s_>
              Displays the Grid Engine administrative host list.

       --sshhggrrpp ggrroouupp                  _<_s_h_o_w _h_o_s_t _g_r_o_u_p _c_o_n_f_i_g_._>
              Displays  the  host  group  entries  for  the group specified in
              ggrroouupp..

       --sshhggrrppll                       _<_s_h_o_w _h_o_s_t _g_r_o_u_p _l_i_s_t_s_>
              Displays a name list of all currently defined host groups  which
              have a valid host group configuration.

       --sshhggrrpp__ttrreeee ggrroouupp     _<_s_h_o_w _h_o_s_t _g_r_o_u_p _t_r_e_e_>
              Shows a tree like structure of host group.

       --sshhggrrpp__rreessoollvveedd ggrroouupp       _<_s_h_o_w _h_o_s_t _g_r_o_u_p _h_o_s_t_s_>
              Shows  a  list  of all hosts which are part of the definition of
              host group. If the  host  group  definition  contains  sub  host
              groups than also these groups are resolved and the hostnames are
              printed.

       --ssrrqqss [[rrqqss__nnaammee__lliisstt]]         _<_s_h_o_w _R_Q_S _c_o_n_f_i_g_u_r_a_t_i_o_n_>
              Show the definition of the _r_e_s_o_u_r_c_e _q_u_o_t_a _s_e_t_s  (RQS)  specified
              by the argument.

       --ssrrqqssll                        _<_s_h_o_w _R_Q_S_-_l_i_s_t_>
              Show  a  list  of  all  currently  defined  _r_e_s_o_u_r_c_e _q_u_o_t_a _s_e_t_ss
              (RQSs).

       --ssmm                           _<_s_h_o_w _m_a_n_a_g_e_r_s_>
              Displays the managers list.

       --ssoo                           _<_s_h_o_w _o_p_e_r_a_t_o_r_s_>
              Displays the operator list.

       --ssoobbjjll oobbjj__ssppeecc aattttrr__nnaammee vvaall _<_s_h_o_w _o_b_j_e_c_t _l_i_s_t_>
              Shows a list of all configuration objects for which val  matches
              at  least  one  configuration value of the attributes 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
              overridings  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 _q_u_e_u_e___c_o_n_f(5) or _h_o_s_t___c_o_n_f(5).  Also wildcards can be used to
              match multiple attributes.

              Val can be an arbitrary string or a wildcard expression.

       --sspp ppee__nnaammee                   _<_s_h_o_w _P_E _c_o_n_f_i_g_u_r_a_t_i_o_n_>
              Show  the  definition of the _p_a_r_a_l_l_e_l _e_n_v_i_r_o_n_m_e_n_t (PE) specified
              by the argument.

       --ssppll                          _<_s_h_o_w _P_E_-_l_i_s_t_>
              Show a list  of  all  currently  defined  _p_a_r_a_l_l_e_l  _e_n_v_i_r_o_n_m_e_n_ts
              (PEs).

       --sspprrjj pprroojjeecctt                 _<_s_h_o_w _p_r_o_j_e_c_t_>
              Shows  the definition of the specified project (see _p_r_o_j_e_c_t(5)).

       --sspprrjjll                        _<_s_h_o_w _p_r_o_j_e_c_t _l_i_s_t_>
              Shows the list of all currently defined projects.

       --ssqq wwcc__qquueeuuee__lliisstt             <show queues>
              Displays one or multiple cluster queues or  queue  instances.  A
              description of wc_queue_list can be found in _s_g_e___t_y_p_e_s(1).

       --ssqqll                          _<_s_h_o_w _q_u_e_u_e _l_i_s_t_>
              Show a list of all currently defined cluster queues.

       --ssss                           _<_s_h_o_w _s_u_b_m_i_t _h_o_s_t_s_>
              Displays the Grid Engine submit host list.

       --ssssccoonnff                       _<_s_h_o_w _s_c_h_e_d_u_l_e_r _c_o_n_f_i_g_u_r_a_t_i_o_n_>
              Displays  the  current  scheduler  configuration  in  the format
              explained in _s_c_h_e_d___c_o_n_f(5).

       --ssssttnnooddee nnooddee__ppaatthh,,......        _<_s_h_o_w _s_h_a_r_e _t_r_e_e _n_o_d_e_>
              Shows the name and shares of the specified  share  tree  node(s)
              (see  _s_h_a_r_e___t_r_e_e(5)).   The  nnooddee__ppaatthh  is  a  hierarchical path
              ([[//]]nnooddee__nnaammee[[[[//..]]nnooddee__nnaammee......]])  specifying the location  of  a
              node in the share tree.

       --ssssttrreeee                       _<_s_h_o_w _s_h_a_r_e _t_r_e_e_>
              Shows the definition of the share tree (see _s_h_a_r_e___t_r_e_e(5)).

       --sssstt                          _<_s_h_o_w _f_o_r_m_a_t_e_d _s_h_a_r_e _t_r_e_e_>
              Shows  the  definition  of  the  share  tree in a tree view (see
              _s_h_a_r_e___t_r_e_e(5)).

       --ssssss                          _<_s_h_o_w _s_c_h_e_d_u_l_e_r _s_t_a_t_u_s_>
              Currently displays the host on which the Grid  Engine  scheduler
              is active or an error message if no scheduler is running.

       --ssuu aaccll__nnaammee                  _<_s_h_o_w _u_s_e_r _A_C_L_>
              Displays a Grid Engine user access list (ACL).

       --ssuull                          _<_s_h_o_w _u_s_e_r _l_i_s_t_s_>
              Displays  a  list  of names of all currently defined Grid Engine
              user access lists (ACLs).

       --ssuusseerr uusseerr,,......               _<_s_h_o_w _u_s_e_r_>
              Shows the definition of the specified user(s) (see _u_s_e_r(5)).

       --ssuusseerrll                       _<_s_h_o_w _u_s_e_r_s_>
              Shows the list of all currently defined users.

       --ttssmm                          _<_t_r_i_g_g_e_r _s_c_h_e_d_u_l_e_r _m_o_n_i_t_o_r_i_n_g_>
              The Grid Engine scheduler is forced  by  this  option  to  print
              trace   messages   of  its  next  scheduling  run  to  the  file
              _<_g_e___r_o_o_t_>_/_<_c_e_l_l_>_/_c_o_m_m_o_n_/_s_c_h_e_d_d___r_u_n_l_o_g.   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 _q_s_t_a_t(1) --FF option (see descrip-
              tion  of  FFuullll  FFoorrmmaatt in section OOUUTTPPUUTT FFOORRMMAATTSS of the _q_s_t_a_t(1)
              manual page.

EENNVVIIRROONNMMEENNTTAALL VVAARRIIAABBLLEESS
       GGEE__RROOOOTT        Specifies the location of the Grid Engine standard  con-
                      figuration files.

       GGEE__CCEELLLL        If  set,  specifies  the  default  Grid  Engine cell. To
                      address a Grid Engine cell _q_c_o_n_f uses (in the  order  of
                      precedence):

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

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


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

       GGEE__QQMMAASSTTEERR__PPOORRTT
                      If set, specifies the tcp port on which _g_e___q_m_a_s_t_e_r(8) is
                      expected  to  listen  for  communication requests.  Most
                      installations will use a services map entry  instead  to
                      define that port.

       GGEE__EEXXEECCDD__PPOORRTT  If  set,  specifies the tcp port on which _g_e___e_x_e_c_d(8) is
                      expected to listen  for  communication  requests.   Most
                      installations  will  use a services map entry instead to
                      define that port.

       SSGGEE__SSIINNGGLLEE__LLIINNEE
                      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.

RREESSTTRRIICCTTIIOONNSS
       Modifications to a queue configuration do not affect an  active  queue,
       taking effect on next invocation of the queue (i.e., the next job).

FFIILLEESS
       _<_g_e___r_o_o_t_>_/_<_c_e_l_l_>_/_c_o_m_m_o_n_/_a_c_t___q_m_a_s_t_e_r
                      Grid Engine master host file

SSEEEE AALLSSOO
       _g_e___i_n_t_r_o(1),    _q_s_t_a_t(1),    _c_h_e_c_k_p_o_i_n_t(5),   _c_o_m_p_l_e_x(5),   _g_e___c_o_n_f(5),
       _h_o_s_t___c_o_n_f(5),  _g_e___p_e(5),  _q_u_e_u_e___c_o_n_f(5),  _g_e___e_x_e_c_d(8),   _g_e___q_m_a_s_t_e_r(8),
       _g_e___r_e_s_o_u_r_c_e___q_u_o_t_a(5)

CCOOPPYYRRIIGGHHTT
       See _g_e___i_n_t_r_o(1) for a full statement of rights and permissions.



GE 6.2u2                 $Date: 2008/12/23 16:56:44 $                 QCONF(1)
