Provided by: gridengine-client_6.2u5-7.4_amd64 bug

NAME

       qconf - Sun Grid Engine Queue Configuration

SYNTAX

       qconf options

DESCRIPTION

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

       Qconf 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, qconf 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,...
                                     <add to object attributes>
              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 queue_conf(5) for the queue, for example).
              Requires root/manager privileges.

       -Acal fname                   <add calendar>
              Adds  a  new calendar definition to the Sun Grid Engine environment.  Calendars are
              used in Sun Grid Engine for defining availability and unavailability  schedules  of
              queues. The format of a calendar definition is described in calendar_conf(5).

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

       -Ackpt fname                  <add ckpt. environment>
              Add the checkpointing environment as defined in fname (see  checkpoint(5))  to  the
              list of supported checkpointing environments.  Requires root or manager privileges.

       -Aconf file_list              <add configurations>
              Add  the  configurations  (see  sge_conf(5)) specified in the files enlisted in the
              comma separated file_list.  The  configuration  is  added  for  the  host  that  is
              identical to the file name.
              Requires root or manager privileges.

       -Ae fname                     <add execution host>
              Add  the execution host defined in fname to the Sun Grid Engine cluster. The format
              of the execution host specification is described in host_conf(5).  Requires root or
              manager privileges.

       -Ahgrp file                   <add host group config>
              Add  the  host  group  configuration defined in file.  The file format of file must
              comply  to  the  format  specified  in  hostgroup(5).   Requires  root  or  manager
              privileges.

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

       -Ap fname                     <add PE configuration>
              Add the parallel environment (PE) defined in fname to the Sun Grid Engine  cluster.
              Requires root or manager privileges.

       -Aprj fname                   <add new project>
              Adds  the  project  description defined in fname to the list of registered projects
              (see project(5)).  Requires root or manager privileges.

       -Aq fname                     <add new queue>
              Add the queue defined in fname to the Sun Grid Engine  cluster.  Requires  root  or
              manager privileges.

       -Au fname                     <add an ACL>
              Add  the user access list (ACL) defined in fname to Sun Grid Engine. User lists are
              used for queue usage authentication. Requires root/manager/operator privileges.

       -cb    This parameter can be used since Sun Grid Engine version 6.2u5 in combination  with
              the  command line switch -sep. In that case the output of the corresponding command
              will contain information about the added job to core binding functionality.

              If -cb switch is not used then -sep will behave as in GE version 6.2u4 and below.

              Please note that this command-line switch will be removed from Sun Grid Engine with
              the next major release.

       -Dattr obj_spec fname obj_instance,...
                                     <del. from object attribs>
              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  queue_conf(5)
              for the queue, for example).
              Requires root/manager privileges.

       -Mattr obj_spec fname obj_instance,...
                                     <mod. object attributes>
              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 queue_conf(5) for the queue, for example).
              Requires root/manager privileges.

       -Mc fname                     <modify complex>
              Overwrites the complex configuration by the contents of fname.  The  argument  file
              must  comply  to  the  format  specified  in  complex(5).  Requires root or manager
              privilege.

       -Mcal fname                   <modify calendar>
              Overwrites the calendar definition as specified in fname. The  argument  file  must
              comply  to  the  format  described  in  calendar_conf(5).  Requires root or manager
              privilege.

       -Mckpt fname                  <modify ckpt. environment>
              Overwrite an existing checkpointing environment with the definitions in fname  (see
              checkpoint(5)).  The name attribute in fname has to match an existing checkpointing
              environment. Requires root or manager privileges.

       -Mconf file_list              <modify configurations>
              Modify the configurations (see sge_conf(5)) specified in the files enlisted in  the
              comma  separated  file_list.  The  configuration  is  modified for the host that is
              identical to the file name.
              Requires root or manager privileges.

       -Me fname                     <modify execution host>
              Overwrites the execution  host  configuration  for  the  specified  host  with  the
              contents  of  fname,  which  must  comply  to  the  format defines in host_conf(5).
              Requires root or manager privilege.

       -Mhgrp file                   <modify host group config.>
              Allows changing of host group configuration with a single command.  All host  group
              configuration  entries contained 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 hostgroup(5).

       -Mrqs fname [mrqs_name]       <modify RQS configuration>
              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
              sge_resource_quota(5)  for  details on the RQS configuration format.  Requires root
              or manager privilege.

       -Mp fname                     <modify PE configuration>
              Same as -mp (see below) but  instead  of  invoking  an  editor  to  modify  the  PE
              configuration  the  file  fname  is  considered to contain a changed configuration.
              Refer to sge_pe(5) for details on the PE configuration format.   Requires  root  or
              manager privilege.

       -Mprj fname                   <modify project config.>
              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 project(5) for details on the project configuration format.  Requires root
              or manager privilege.

       -Mq fname                     <modify queue configuration>
              Same as -mq (see below) but instead of invoking  an  editor  to  modify  the  queue
              configuration  the  file  fname  is  considered to contain a changed configuration.
              Refer to queue_conf(5) for details on the  queue  configuration  format.   Requires
              root or manager privilege.

       -Msconf fname                 <modify scheduler configuration from file>
              The  current  scheduler  configuration  (see  sched_conf(5)) is overridden with the
              configuration specified in the file.  Requires root or manager privilege.

       -Mstree fname                 <modify share tree>
              Modifies the definition of  the  share  tree  (see  share_tree(5)).   The  modified
              sharetree is read from file fname.  Requires root or manager privileges.

       -Mu fname                     <modify ACL>
              Takes  the  user  access  list (ACL) defined in fname to overwrite any existing ACL
              with the same name. See access_list(5) for information  on  the  ACL  configuration
              format. Requires root or manager privilege.

       -Muser fname                  <modify user>
              Modify  the user defined in fname in the Sun Grid Engine cluster. The format of the
              user specification is described in user(5).  Requires root or manager privileges.

       -Rattr obj_spec fname obj_instance,...
                                     <replace object attribs>
              Similar to -rattr (see below) but the  definition  of  the  list  attributes  whose
              content  is  to  be  replace  is  contained  in the file named fname. As opposed to
              -rattr, multiple attributes can be modified. Their specification has to be enlisted
              in  fname  following the file format of the corresponding object (see queue_conf(5)
              for the queue, for example).
              Requires root/manager privileges.

       -aattr obj_spec attr_name val obj_instance,...
                 <add to object attributes>
              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 environment, the resource quota  sets
              and the checkpointing interface configuration being specified as queue , exechost ,
              hostgroup , pe , rqs or ckpt in obj_spec.  For the obj_spec queue 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  sge_types(1).   Depending  on
              the  type of the obj_instance this adds to the cluster queues attribute sublist the
              cluster  queues  implicit  default  configuration  value  or   the   queue   domain
              configuration   value   or   queue   instance   configuration   value.   The  queue
              load_thresholds parameter is an example  of  a  list  attribute.  With  the  -aattr
              option,  entries can be added to such lists, while they can be deleted with -dattr,
              modified with -mattr, and replaced with -rattr.
              For the obj_spec rqs 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 specified with  attr_name
              followed  by val as a name=value 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  exechost  object  the  load_values
              attribute cannot be modified (see host_conf(5)).
              Requires root or manager privileges.

       -acal calendar_name           <add calendar>
              Adds a new calendar definition to the Sun Grid Engine environment.   Calendars  are
              used  in  Sun Grid Engine for defining availability and unavailability schedules of
              queues. The format of a calendar definition is described in calendar_conf(5).

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

       -ackpt ckpt_name              <add ckpt. environment>
              Adds  a  checkpointing  environment  under  the  name  ckpt_name  to  the  list  of
              checkpointing environments maintained by Sun Grid Engine and to be usable to submit
              checkpointing jobs (see checkpoint(5) for details on the format of a  checkpointing
              environment  definition).   Qconf  retrieves  a  default  checkpointing environment
              configuration and executes vi(1) (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   environment   is   registered   with
              sge_qmaster(8).  Requires root/manager privileges.

       -aconf host,...               <add configuration>
              Successively  adds  configurations  (see  sge_conf(5))  For  the hosts in the comma
              separated file_list.  For each host, an editor  ($EDITOR  indicated  or  vi(1))  is
              invoked  and  the  configuration  for the host can be entered. The configuration is
              registered with sge_qmaster(8) after saving the file and quitting the editor.
              Requires root or manager privileges.

       -ae [host_template]           <add execution host>
              Adds a host to the list  of  Sun  Grid  Engine  execution  hosts.  If  a  queue  is
              configured  on  a  host  this  host  is  automatically added to the Sun Grid Engine
              execution host list.  Adding execution hosts explicitly offers the advantage to  be
              able  to  specify  parameters  like  load scale values with the registration of the
              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, qconf retrieves the configuration of the
              specified execution host from sge_qmaster(8) or a generic template otherwise.   The
              template is then stored in a file and qconf executes vi(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 specification is described in host_conf(5).
              When the changes are saved in the editor and the editor is quit the  new  execution
              host is registered with sge_qmaster(8).  Requires root/manager privileges.

       -ah hostname,...              <add administrative host>
              Adds  hosts  hostname  to  the Sun Grid Engine trusted host list (a host must be in
              this list to execute administrative Sun Grid Engine commands, the sole exception to
              this being the execution of qconf on the sge_qmaster(8) node). The default Sun Grid
              Engine installation procedures usually add all designated execution hosts (see  the
              -ae option above) to the Sun Grid Engine trusted host list automatically.  Requires
              root or manager privileges.

       -ahgrp group                  <add host group config.>
              Adds a new host group with the name specified in group.  This  command  invokes  an
              editor  (either  vi(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.

       -arqs [rqs_name]              <add new RQS>
              Adds  one  or more Resource Quota Set (RQS) description under the names rqs_name to
              the list of RQSs maintained by  Sun  Grid  Engine  (see  sge_resource_quota(5)  for
              details  on  the  format  of  a  RQS  definition).   Qconf  retrieves a default RQS
              configuration and executes vi(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 sge_qmaster(8).  Requires root or manager privileges.

       -am user,...                  <add managers>
              Adds the indicated users to the Sun Grid Engine  manager  list.  Requires  root  or
              manager privileges.

       -ao user,...                  <add operators>
              Adds  the  indicated  users to the Sun Grid Engine operator list.  Requires root or
              manager privileges.

       -ap pe_name                   <add new PE>
              Adds a Parallel Environment (PE) description under the name pe_name to the list  of
              PEs  maintained  by  Sun  Grid Engine and to be usable to submit parallel jobs (see
              sge_pe(5) for details on the format of a PE definition).  Qconf retrieves a default
              PE  configuration and executes vi(1) (or $EDITOR if the EDITOR environment variable
              is set) to allow you to customize the PE configuration. Upon exit from the  editor,
              the PE is registered with sge_qmaster(8).  Requires root/manager privileges.

       -at thread_name <activates thread in master>
              Activates  an additional thread in the master process.  thread_name might be either
              "scheduler" or "jvm". The corresponding thread is  only  started  when  it  is  not
              already  running.  There might be only one scheduler and only one jvm thread in the
              master process at the same time.

       -aprj                         <add new project>
              Adds a project description to the list of  registered  projects  (see  project(5)).
              Qconf  retrieves a template project configuration and executes vi(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 sge_qmaster(8).
              Requires root or manager privileges.

       -aq [queue_name]              <add new queue>
              Qconf retrieves the default queue configuration (see  queue_conf(5))  and  executes
              vi(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
              registered  with  sge_qmaster(8).   A  minimal configuration requires only that the
              queue name and queue hostlist be set.  Requires root or manager privileges.

       -as hostname,...              <add submit hosts>
              Add hosts hostname to the list of hosts allowed to submit Sun Grid Engine jobs  and
              control their behavior only.  Requires root or manager privileges.

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

       -Astree fname                 <add share tree>
              Adds the definition of a share tree to the system (see share_tree(5)) from the file
              fname.  Requires root or manager privileges.

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

       -Auser fname                  <add user>
              Add  the  user  defined  in fname to the Sun Grid Engine cluster. The format of the
              user specification is described in user(5).  Requires root or manager privileges.

       -auser                        <add user>
              Adds a user to the list of registered users (see user(5)).  This command invokes an
              editor  (either  vi(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 editor. Requires root or manager privileges.

       -clearusage                   <clear sharetree usage>
              Clears  all  user  and  project  usage  from  the  sharetree.   All  usage  will be
              initialized back to zero.

       -cq wc_queue_list             <clean queue>
              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
              sge_types(1).

       -dattr obj_spec attr_name val obj_instance,...
                                     <delete in object attribs>
              Allows deleting specifications in a single configuration 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,...       <delete calendar>
              Deletes  the  specified  calendar  definition  from  Sun  Grid   Engine.   Requires
              root/manager privileges.

       -dckpt ckpt_name              <delete ckpt. environment>
              Deletes the specified checkpointing environment. Requires root/manager privileges.

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

       -de host_name,...             <delete execution host>
              Deletes hosts from the Sun Grid Engine  execution  host  list.   Requires  root  or
              manager privileges.

       -dh host_name,...             <delete administrative host>
              Deletes  hosts  from  the  Sun  Grid  Engine  trusted host list.  The host on which
              sge_qmaster(8)  is  currently  running  cannot  be  removed  from   the   list   of
              administrative hosts.  Requires root or manager privileges.

       -dhgrp group  <delete host group configuration>
              Deletes  host  group configuration with the name specified in group.  Requires root
              or manager privileges.

       -drqs rqs_name_list           <delete RQS>
              Deletes the  specified  resource  quota  sets  (RQS).   Requires  root  or  manager
              privileges.

       -dm user[,user,...]           <delete managers>
              Deletes  managers  from the manager list.  Requires root or manager privileges.  It
              is not possible to delete the admin user or the user root from the manager list.

       -do user[,user,...]           <delete operators>
              Deletes operators from the operator list.  Requires root or manager privileges.  It
              is not possible to delete the admin user or the user root from the operator list.

       -dp pe_name                   <delete parallel environment>
              Deletes  the  specified  parallel  environment  (PE).   Requires  root  or  manager
              privileges.

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

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

       -ds host_name,...             <delete submit host>
              Deletes  hosts from the Sun Grid Engine submit host list.  Requires root or manager
              privileges.

       -dstnode node_path,...        <delete share tree node>
              Deletes the specified share tree node(s).  The node_path  is  a  hierarchical  path
              ([/]node_name[[/.]node_name...])  specifying the location of the node to be deleted
              in the share tree.  Requires root or manager privileges.

       -dstree                       <delete share tree>
              Deletes the current share tree. Requires root or manager privileges.

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

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

       -duser user,...               <delete users>"
              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}}   <shutdown Sun Grid Engine>
              Note:  The  -ks switch is deprecated, may be removed in future release.  Please use
              the -kt switch instead.
              Used  to  shutdown  Sun  Grid  Engine  components  (daemons).   In  the  form   -km
              sge_qmaster(8)  is forced to terminate in a controlled fashion. In the same way the
              -ks switch causes  termination  of  the  scheduler  thread.   Shutdown  of  running
              sge_execd(8) 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  sge_execd(8).   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 sge_execd(8) processes
              are shutdown. Job abortion, initiated by the -kej option will result  in  dr  state
              for all running jobs until sge_execd(8) is running again.
              Requires root or manager privileges.

       -kt thread_name   <terminate master thread>"
              Terminates  a  thread  in  the  master  process.  Currently it is only supported to
              shutdown the "scheduler" and the "jvm" thread. The command will only be  successful
              if the corresponding thread is running.

       -kec {id,...|all}             <kill event client>
              Used  to  shutdown event clients registered at sge_qmaster(8).  The comma separated
              event client list specifies the event clients to be addressed by the  -kec  option.
              If  the keyword all is specified instead of an event client list, all running event
              clients except special clients like the scheduler thread are terminated.   Requires
              root or manager privilege.

       -mattr obj_spec attr_name val obj_instance,...
                                     <modify object attributes>
              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                           <modify complex>
              The  complex  configuration  (see  complex(5))  is retrieved, an editor is executed
              (either vi(1)  or  the  editor  indicated  by  $EDITOR)  and  the  changed  complex
              configuration  is registered with sge_qmaster(8) upon exit of the editor.  Requires
              root or manager privilege.

       -mcal calendar_name           <modify calendar>
              The specified calendar definition (see calendar_conf(5)) is retrieved, an editor is
              executed (either vi(1) or the editor indicated by $EDITOR) and the changed calendar
              definition is registered with sge_qmaster(8) upon exit of the editor. Requires root
              or manager privilege.

       -mckpt ckpt_name              <modify ckpt. environment>
              Retrieves  the  current  configuration for the specified checkpointing environment,
              executes an editor (either vi(1) or the editor indicated by the EDITOR  environment
              variable)  and  registers  the new configuration with the sge_qmaster(8).  Refer to
              checkpoint(5) for details on the checkpointing  environment  configuration  format.
              Requires root or manager privilege.

       -mconf [host,...|global]      <modify configuration>
              The  configuration  for  the  specified  host  is  retrieved, an editor is executed
              (either vi(1) or the editor indicated by $EDITOR) and the changed configuration  is
              registered  with  sge_qmaster(8)  upon  exit  of  the editor.  If the optional host
              argument is omitted or if the special host name global  is  specified,  the  global
              configuration  is  modified.   The   format  of  the  configuration is described in
              sge_conf(5).
              Requires root or manager privilege.

       -me hostname                  <modify execution host>
              Retrieves the current configuration for the specified execution host,  executes  an
              editor  (either  vi(1)  or the editor indicated by the EDITOR environment variable)
              and registers the changed configuration with  sge_qmaster(8)  upon  exit  from  the
              editor.    The   format  of  the  execution  host  configuration  is  described  in
              host_conf(5).  Requires root or manager privilege.

       -mhgrp group <modify host group configuration>
              The host group entries for the host group specified in group are retrieved  and  an
              editor (either vi(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 hostgroup(5).  Requires root or manager privileges.

       -mrqs [rqs_name]              <modify RQS configuration>
              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 vi(1) or the editor indicated  by  the  EDITOR  environment  variable)  and
              registers    the   new   configuration   with   the   sge_qmaster(8).    Refer   to
              sge_resource_quota(5) for details on the RQS configuration format.   Requires  root
              or manager privilege.

       -mp pe_name                   <modify PE configuration>
              Retrieves  the  current  configuration for the specified parallel environment (PE),
              executes an editor (either vi(1) or the editor indicated by the EDITOR  environment
              variable)  and  registers  the new configuration with the sge_qmaster(8).  Refer to
              sge_pe(5) for details on the PE configuration format.   Requires  root  or  manager
              privilege.

       -mprj project                 <modify project>
              Data  for  the specific project is retrieved (see project(5)) and an editor (either
              vi(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 manager privileges.

       -mq queuename                 <modify queue configuration>
              Retrieves the current configuration for the specified  queue,  executes  an  editor
              (either  vi(1)  or  the  editor  indicated  by the EDITOR environment variable) and
              registers the new configuration with the sge_qmaster(8).   Refer  to  queue_conf(5)
              for details on the queue configuration format.  Requires root or manager privilege.

       -msconf                       <modify scheduler configuration>
              The  current scheduler configuration (see sched_conf(5)) is retrieved, an editor is
              executed (either vi(1)  or  the  editor  indicated  by  $EDITOR)  and  the  changed
              configuration  is registered with sge_qmaster(8) upon exit of the editor.  Requires
              root or manager privilege.

       -mstnode node_path=shares,... <modify share tree node>
              Modifies the specified share tree node(s) in the share  tree  (see  share_tree(5)).
              The  node_path  is a hierarchical 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                       <modify share tree>
              Modifies  the  definition of the share tree (see share_tree(5)).  The present share
              tree is retrieved and an editor (either vi(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  sge_qmaster(8).   Requires  root  or  manager
              privileges.

       -mu acl_name                  <modify user access lists>
              Retrieves the current configuration for the specified user access list, executes an
              editor (either vi(1) or the editor indicated by the  EDITOR  environment  variable)
              and  registers  the  new  configuration  with the sge_qmaster(8).  Requires root or
              manager privilege.

       -muser user                   <modify user>
              Data for the specific user is retrieved (see user(5)) and an editor  (either  vi(1)
              or  the  editor  indicated  by  the  EDITOR  environment  variable)  is invoked for
              modifying the user definition. Upon  exiting  the  editor,  the  modified  data  is
              registered. Requires root or manager privileges.

       -purge queue attr_nm,... obj_spec
                 <purge divergent attribute settings>
              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 queue_conf(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  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 hostgroup.  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,...
                                     <replace object attributes>
              Allows  replacing a single configuration 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 .
              Requires root or manager privilege.

       -rsstnode node_path,...       <show share tree node>
              Recursively  shows  the name and shares of the specified share tree node(s) and the
              names and shares of its child nodes.  (see  share_tree(5)).   The  node_path  is  a
              hierarchical  path  ([/]node_name[[/.]node_name...])   specifying the location of a
              node in the share tree.

       -sc                           <show complexes>
              Display the complex configuration.

       -scal calendar_name           <show calendar>
              Display the configuration of the specified calendar.

       -scall                        <show calendar list>
              Show a list of all calendars currently defined.

       -sckpt ckpt_name              <show ckpt. environment>
              Display the configuration of the specified checkpointing environment.

       -sckptl                       <show ckpt. environment list>
              Show a list of the names of all checkpointing environments currently configured.

       -sconf [host,...|global]      <show configuration>
              Print the global or local (host specific) configuration.   If  the  optional  comma
              separated  host list argument is omitted or the special string global is given, the
              global configuration is displayed.  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 sge_conf(5).

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

       -sds                          <show detached settings>
              Displays detached settings in the cluster configuration.

       -se hostname                  <show execution host>
              Displays the definition of the specified execution host.

       -sel                          <show execution hosts>
              Displays the Sun Grid Engine execution host list.

       -secl                         <show event clients>
              Displays the Sun Grid Engine event client list.

       -sep                          <show licensed processors>
              Note: Deprecated, may be removed in future release.

              Displays  a  list of virtual processors. This value is taken from the underlying OS
              and it depends on underlying hardware  and  operating  system  whether  this  value
              represents sockets, cores or supported threads.

              If  this  option  is  used  in  combination with -cb  parameter then two additional
              columns will be shown in the output for the number of sockets and number of  cores.
              Currently  SGE  will enlist these values only if the corresponding operating system
              of execution host is Linux under kernel >= 2.6.16, or Solaris 10.  Other  operating
              systems  or  versions  might  be supported with the future update releases. In case
              these values won't be retrieved, '0' character will be displayed.

       -sh                           <show administrative hosts>
              Displays the Sun Grid Engine administrative host list.

       -shgrp group                  <show host group config.>
              Displays the host group entries for the group specified in group.

       -shgrpl                       <show host group lists>
              Displays a name list of all currently defined host groups which have a  valid  host
              group configuration.

       -shgrp_tree group     <show host group tree>
              Shows a tree like structure of host group.

       -shgrp_resolved group       <show host group hosts>
              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.

       -srqs [rqs_name_list]         <show RQS configuration>
              Show the definition of the resource quota sets (RQS) specified by the argument.

       -srqsl                        <show RQS-list>
              Show a list of all currently defined resource quota setss (RQSs).

       -sm                           <show managers>
              Displays the managers list.

       -so                           <show operators>
              Displays the operator list.

       -sobjl obj_spec attr_name val <show object list>
              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 queue_conf(5)
              or host_conf(5).  Also wildcards can be used to match multiple attributes.

              Val can be an arbitrary string or a wildcard expression.

       -sp pe_name                   <show PE configuration>
              Show the definition of the parallel environment (PE) specified by the argument.

       -spl                          <show PE-list>
              Show a list of all currently defined parallel environments (PEs).

       -sprj project                 <show project>
              Shows the definition of the specified project (see project(5)).

       -sprjl                        <show project list>
              Shows the list of all currently defined projects.

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

       -sql                          <show queue list>
              Show a list of all currently defined cluster queues.

       -ss                           <show submit hosts>
              Displays the Sun Grid Engine submit host list.

       -ssconf                       <show scheduler configuration>
              Displays   the   current   scheduler  configuration  in  the  format  explained  in
              sched_conf(5).

       -sstnode node_path,...        <show share tree node>
              Shows the name and shares of the specified share tree node(s) (see  share_tree(5)).
              The  node_path  is a hierarchical path ([/]node_name[[/.]node_name...])  specifying
              the location of a node in the share tree.

       -sstree                       <show share tree>
              Shows the definition of the share tree (see share_tree(5)).

       -sst                          <show formatted share tree>
              Shows the definition of the share tree in a tree view (see share_tree(5)).

       -sss                          <show scheduler status>
              Currently displays the host on which the Sun Grid Engine scheduler is active or  an
              error message if no scheduler is running.

       -su acl_name                  <show user ACL>
              Displays a Sun Grid Engine user access list (ACL).

       -sul                          <show user lists>
              Displays a list of names of all currently defined Sun Grid Engine user access lists
              (ACLs).

       -suser user,...               <show user>
              Shows the definition of the specified user(s) (see user(5)).

       -suserl                       <show users>
              Shows the list of all currently defined users.

       -tsm                          <trigger scheduler monitoring>
              The Sun Grid Engine scheduler is forced by this option to print trace  messages  of
              its  next  scheduling  run to the file <sge_root>/<cell>/common/schedd_runlog.  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 qstat(1)
              -F option (see description of Full Format in section OUTPUT FORMATS of the qstat(1)
              manual page.

ENVIRONMENTAL VARIABLES

       SGE_ROOT       Specifies the location of the Sun Grid Engine standard configuration files.

       SGE_CELL       If set, specifies the default Sun Grid Engine cell. To address a  Sun  Grid
                      Engine cell qconf 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  sge_qmaster(8)  is  expected  to
                      listen  for communication 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 sge_execd(8) is expected to  listen
                      for  communication  requests.   Most  installations will use a services map
                      entry instead to define that port.

       SGE_SINGLE_LINE
                      If  set,  indicates  that  long  lines  should  not  be  broken  up   using
                      backslashes.  This setting is useful for scripts which expect one entry per
                      line.

RESTRICTIONS

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

FILES

       <sge_root>/<cell>/common/act_qmaster
                       Sun Grid Engine master host file

SEE ALSO

       sge_intro(1),  qstat(1),  checkpoint(5), complex(5), sge_conf(5), host_conf(5), sge_pe(5),
       queue_conf(5), sge_execd(8), sge_qmaster(8), sge_resource_quota(5)

COPYRIGHT

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