Provided by: gridengine-client_6.2u5-4_i386 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.