SYNTAX
       qconf options

DESCRIPTION
       Qconf  allows  the  system administrator to add, delete, and modify the
       current Univa 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  charac-
       ters) into smaller lines using backslash line continuation where possi-
       ble.  Lines will only be broken up at commas or whitespace.  This  fea-
       ture  can  be disabled by setting the SGE_SINGLE_LINE environment vari-
       able.

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 Univa Grid Engine environ-
              ment.   Calendars  are  used  in  Univa 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 environ-
              ments.  Requires root or manager privileges.

       -Aconf fname_list             <add configurations>
              Add the configurations (see sge_conf(5)) specified in the  files
              enlisted in the comma separated fname_list. The configuration is
              added for the host that is identical to the file name.
              to the Univa Grid Engine cluster. Requires root or manager priv-
              ileges.

       -Ap fname                     <add PE configuration>
              Add  the parallel environment (PE) defined in fname to the Univa
              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 Univa Grid Engine cluster.
              Requires root or manager privileges.

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

       -cb    This parameter can be used since Univa 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
              Univa 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.

              root or manager privileges.

       -Mconf fname_list             <modify configurations>
              Modify  the  configurations  (see  sge_conf(5)) specified in the
              files enlisted in the comma separated fname_list. The configura-
              tion  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 fname                  <modify host group configuration>
              Allows changing of host group configuration with a  single  com-
              mand.   All  host group configuration entries contained in fname
              will be applied. Configuration entries not  contained  in  fname
              will  be  deleted.  The  file format of fname 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 for-
              mat.  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 con-
              tain a changed configuration.  Refer to sge_pe(5) for details on
              the  PE  configuration  format.  Requires root or manager privi-
              lege.

       -Mprj fname                   <modify project configuration>
              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
              manager privilege.

       -Muser fname                  <modify user>
              Modify  the user defined in fname in the Univa Grid Engine clus-
              ter. 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 com-
              mand. Currently supported objects are the queue, the  host,  the
              host  group,  the  parallel environment, the resource quota sets
              and the checkpointing interface configuration being specified as
              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 clus-
              ter queues attribute sublist the cluster queues implicit default
              configuration  value  or the queue domain configuration value or
              queue instance configuration value.  The  queue  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 speci-
              fied 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 Univa Grid Engine environ-
              ment.   Calendars  are  used  in  Univa Grid Engine for defining
              point(5)  for  details on the format of a checkpointing environ-
              ment definition).  Qconf retrieves a default checkpointing envi-
              ronment configuration and executes vi(1) (or $EDITOR if the EDI-
              TOR environment variable is set) to allow you to  customize  the
              checkpointing environment configuration. Upon exit from the edi-
              tor, the checkpointing environment is registered with  sge_qmas-
              ter(8).  Requires root/manager privileges.

       -aconf host,...               <add configuration>
              Successively adds configurations (see sge_conf(5)) For the hosts
              in the comma separated fname_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 edi-
              tor.
              Requires root or manager privileges.

       -ae [host_template]           <add execution host>
              Adds a host to the list of Univa Grid Engine execution hosts. If
              a queue is configured on a host this host is automatically added
              to the Univa 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_qmas-
              ter(8)  or  a  generic template otherwise.  The template is then
              stored in a file and qconf executes vi(1) (or the  editor  indi-
              cated  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 Univa Grid Engine trusted  host  list
              (a  host  must  be  in this list to execute administrative Univa
              Grid Engine commands, the sole exception to this being the  exe-
              cution  of  qconf on the sge_qmaster(8) node). The default Univa
              Grid Engine installation procedures usually add  all  designated
              execution  hosts  (see  the  -ae option above) to the Univa Grid
              Engine trusted host list automatically.  Requires root  or  man-
              ager privileges.

       -ahgrp group                  <add host group configuration>
              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.

       -ao user,...                  <add operators>
              Adds the indicated users to the Univa 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 Univa 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 envi-
              ronment  variable  is set) to allow you to customize the PE con-
              figuration. 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  corre-
              sponding  thread is only started when it is not already running.
              There might be only one scheduler and only one JVM thread in the
              master process at the same time.

       -aprj                         <add new project>
              Adds  a  project  description to the list of registered projects
              (see project(5)).  Qconf retrieves a template project configura-
              tion  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_qmas-
              ter(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 regis-
              tered 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  Univa
              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.

       -au user,... acl_name,...     <add users to ACLs>
              Adds users to Univa 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 Univa 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 edi-
              tor. 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  com-
              mand.    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  Univa  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 Univa Grid Engine  execution  host  list.
              Requires root or manager privileges.

       -dh host_name,...             <delete administrative host>
              Deletes hosts from the Univa Grid Engine trusted host list.  The
              ager 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 man-
              ager 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 privi-
              leges.

       -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  Univa  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 privi-
              leges.

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

       -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 Univa Grid Engine>
              Note: The -ks switch is deprecated, may  be  removed  in  future
              release.  Please use the -kt switch instead.

       -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  infor-
              mation  concerning  obj_spec and obj_instance in the description
              of -aattr

       -mc                           <modify complex>
              The complex configuration (see complex(5)) is retrieved, an edi-
              tor  is  executed (either vi(1) or the editor indicated by $EDI-
              TOR) and the changed complex configuration  is  registered  with
              sge_qmaster(8)  upon  exit of the editor.  Requires root or man-
              ager 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  check-
              pointing  environment,  executes  an editor (either vi(1) or the
              editor indicated by the EDITOR environment variable) and  regis-
              ters  the  new  configuration with the sge_qmaster(8).  Refer to
              checkpoint(5) for details on the checkpointing environment  con-
              figuration 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 omit-
              ted  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).
              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 privi-
              leges.

       -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 indi-
              cated  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 for-
              mat.  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  man-
              ager 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 privi-
              lege.

       -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  regis-
              tered  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>
       -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 envi-
              ronment  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 multi-
              ple  instances  of  an  object with a single command.  Find more
              information concerning obj_spec and obj_instance in the descrip-
              tion 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 envi-

       -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 Univa Grid Engine execution host list.

       -secl                         <show event clients>
              Displays the Univa 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 num-
              ber of sockets and number of cores. Currently  SGE  will  enlist
              these  values only if the corresponding operating system of exe-
              cution 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 Univa 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
              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 Univa 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.
              Displays a Univa Grid Engine user access list (ACL).

       -sul                          <show user lists>
              Displays a list of names of all  currently  defined  Univa  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  Univa  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 descrip-
              tion of Full Format in section OUTPUT FORMATS  of  the  qstat(1)
              manual page.

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

       SGE_CELL       If set, specifies the default Univa Grid Engine cell. To
                      address  a  Univa  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 writ-
                      ten 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
                       Univa 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.



UGE 8.0.0                $Date: 2009/12/02 13:47:56 $                 QCONF(1)

Man(1) output converted with man2html