Content-type: text/html Manpage of QCONF

QCONF

Section: Sun Grid Engine User Commands (1)
Updated: 2002/07/29 15:51:30
Index Return to Main Contents
 

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.  

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 for the queue, for example).
Requires root/manager privileges.
-Ac complex_name fname      <add complex>
Add the complex complex_name defined in fname
to the Sun Grid Engine cluster. The format of the complex specification is described in Requires root or 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

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
to the list of supported checkpointing environments. Requires root or manager privileges.
-Aconf file_list            <add configurations>
Add the cluster configurations (see
specified in the files enlisted in the comma separated file_list.
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 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>
This option is only supported in case of a Sun Grid Engine, Enterprise Edition system. It is not available
for Sun Grid Engine systems.
Adds the project description defined in fname to the list of registered projects (see 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.
-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 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 for the queue, for example).
Requires root/manager privileges.
-Mc complex_name fname      <modify complex>
Overwrites the specified complex
by the contents of fname. The argument file must comply to the format specified in 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 Requires root or manager privilege.
-Mckpt fname                <modify ckpt. environment>
Overwrite an existing checkpointing environment with the definitions in
fname (see The name attribute in fname has to match an existing checkpointing environment. 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 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 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 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 for details on the queue configuration format. Requires root or manager privilege.
-Mqattr fname q_name,...    <modify queue attributes>
DEPRECATED: Use -Rattr!

Allows changing of selected queue configuration attributes in multiple queues with a single command. In all queues contained in the comma separated queue name list the queue attribute definitions contained in fname will be applied. Queue attributes not contained in fname will be left unchanged.

All queue attributes can be modified except for qname and qhostname. Refer to for details on the queue configuration format. Requires root or manager privilege.

-Mu fname                   <modify ACL>
Takes the user access list (ACL) defined in
fname to overwrite any existing ACL with the same name. See for information on the ACL configuration format. Requires root or manager privilege.
-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 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 parallel environment and the checkpointing interface configuration being specified as queue , exechost , pe or ckpt in obj_spec. The queue load_thesholds 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.
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
Requires root or manager privileges.
-ac complex_name            <add complex>
Adds a complex to the Sun Grid Engine environment. Complex entries
contain one or more resources which may be requested by jobs submitted to the system. The manual page contains detailed information about the format of a complex definition.
When using the -ac option the complex name is given in the command option. Qconf will then open a temporary file and start up the text editor indicated by the environment variable EDITOR (default editor is if EDITOR is not set). After entering the complex definition and closing the editor the new complex is checked and registered with Requires root/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

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 if EDITOR is not set). After entering the calendar definition and closing the editor the new calendar is checked and registered with 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 for details on the format of a checkpointing environment definition). Qconf retrieves a default checkpointing environment configuration and executes (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 Requires root/manager privileges.
-aconf host,...             <add configuration>
Successively adds cluster configurations (see
For the hosts in the comma separated file_list. For each host, an editor ($EDITOR indicated or is invoked and the configuration for the host can be entered. The configuration is registered with 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 or a generic template otherwise. The template is then stored in a file and qconf executes (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 When the changes are saved in the editor and the editor is quit the new execution host is registered with 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 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.
-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/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 for details on the format of a PE definition). Qconf retrieves a default PE configuration and executes (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 Requires root/manager privileges.
-aprj                       <add new project>
This option is only supported in case of a Sun Grid Engine, Enterprise Edition system. It is not available
for Sun Grid Engine systems.
Adds a project description to the list of registered projects (see Qconf retrieves a template project configuration and executes (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 Requires root or manager privileges.
-aq [q_template]            <add new queue>
Qconf retrieves either the default queue configuration (see
or the configuration of the queue q_template (if the optional argument is present) and executes (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 A minimal configuration requires only that the queue name and queue hostname 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>
This option is only supported in case of a Sun Grid Engine, Enterprise Edition system. It is not available
for Sun Grid Engine systems.
Adds the specified share tree node(s) to the share tree (see 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>
This option is only supported in case of a Sun Grid Engine, Enterprise Edition system. It is not available
for Sun Grid Engine systems.
Adds the definition of a share tree to the system (see A template share tree is retrieved and an editor (either or the editor indicated by $EDITOR) is invoked for modifying the share tree definition. Upon exiting the editor, the modified data is registered with 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>
This option is only supported in case of a Sun Grid Engine, Enterprise Edition system. It is not available
for Sun Grid Engine systems.
Add the user defined in fname to the Sun Grid Engine, Enterprise Edition cluster. The format of the user specification is described in Requires root or manager privileges.
-auser                      <add user>
This option is only supported in case of a Sun Grid Engine, Enterprise Edition system. It is not available
for Sun Grid Engine systems.
Adds a user to the list of registered users (see This command invokes an editor (either 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>
This option is only supported in case of a Sun Grid Engine, Enterprise Edition system. It is not available
for Sun Grid Engine systems.
Clears all user and project usage from the sharetree. All usage will be initialized back to zero.
-cq queue_name,...          <clean queue>
Cleans queue from jobs which haven't been reaped. Primarily a
development tool. Requires root/manager/operator privileges.
-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. Currently supported objects are the queue, the host, the parallel environment and the checkpointing interface configuration being specified as queue , exechost , pe or ckpt in obj_spec. The queue load_thesholds parameter is an example of a list attribute. With the -dattr option, entries can be deleted from such lists, while they can be added with -aattr, modified with -mattr, and replaced with -rattr.
The name of the configuration attribute to be modified is specified with attr_name followed by val defining the name of the attribute list entry to be deleted. 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 host object the load_values attribute cannot be modified (see
Requires root or manager privileges.
-dc complex_name,...        <delete complex>
Deletes complexes from Sun Grid Engine.
Requires root/manager privileges.
-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 configuration>
The configuration entry for the specified hosts is 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/manager privileges.
-dh host_name,...           <delete administrative host>
Deletes hosts from the Sun Grid Engine trusted host list. The host on which
is currently running cannot be removed from the list of administrative hosts. Requires root/manager privileges.
-dm user[,user,...]   <delete managers>
Deletes managers from the manager list.
Requires root/manager privileges.
-do user[,user,...]         <delete operators>
Deletes operators from the operator list.
Requires root/manager privileges.
-dp pe_name                 <delete parallel environment>
Deletes the specified parallel environment (PE).
Requires root/manager privileges.
-dprj project,...           <delete projects>
This option is only supported in case of a Sun Grid Engine, Enterprise Edition system. It is not available
for Sun Grid Engine systems.
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/manager privileges.
-ds host_name,...           <delete submit host>
Deletes hosts from the Sun Grid Engine submit host list.
Requires root/manager privileges.
-dstnode node_path,...      <delete share tree node>
This option is only supported in case of a Sun Grid Engine, Enterprise Edition system. It is not available
for Sun Grid Engine systems.
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>
This option is only supported in case of a Sun Grid Engine, Enterprise Edition system. It is not available
for Sun Grid Engine systems.
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>
This option is only supported in case of
a Sun Grid Engine, Enterprise Edition system. It is not available for Sun Grid Engine systems.
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>
Used to shutdown Sun Grid Engine components (daemons).
In the form -km is forced to terminate in a controlled fashion. In the same way the -ks switch causes termination of Shutdown of running 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 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 processes are shutdown.
Requires root or manager privileges.
-kec {id,...|all}           <kill event client>
Used to shutdown event clients registered at
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 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. Currently supported objects are the queue, the host, the parallel environment and the checkpointing interface configuration being specified as queue , exechost , pe or ckpt in obj_spec.
The name of the configuration attribute to be modified is specified with attr_name followed by the value to which the attribute is going to be set. If the attribute is a list, such as the queue load_thresholds, val can be a name=value pair, in which case only a corresponding entry in the list is changed. Refer to the -aattr, -dattr and -rattr options for a description of further means to change specifically such list attributes.
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 restrictions apply: For the queue object the qname and qhostname attributes cannot be modified (see For the host object the hostname, load_values and processors attributes cannot be modified (see
Requires root or manager privilege.
-mc complex_name            <modify complex>
The specified complex configuration (see
is retrieved, an editor is executed (either or the editor indicated by $EDITOR) and the changed complex configuration is registered with upon exit of the editor. Requires root or manager privilege.
-mcal calendar_name         <modify calendar>
The specified calendar definition (see
is retrieved, an editor is executed (either or the editor indicated by $EDITOR) and the changed calendar definition is registered with 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 or the editor indicated by the EDITOR environment variable) and registers the new configuration with the Refer to 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 or the editor indicated by $EDITOR) and the changed configuration is registered with upon exit of the editor. If the optional host argument is omitted or if the special host name "global" is specified, the cell global configuration is modified. The format of the host configuration is described in
Requires root or manager privilege.
-me hostname                <modify execution host>
Retrieves the current configuration for the specified execution host,
executes an editor (either or the editor indicated by the EDITOR environment variable) and registers the changed configuration with upon exit from the editor. The format of the execution host configuration is described in 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 or the editor indicated by the EDITOR environment variable) and registers the new configuration with the Refer to for details on the PE configuration format. Requires root or manager privilege.
-mprj project               <modify project>
This option is only supported in case of a Sun Grid Engine, Enterprise Edition system. It is not available
for Sun Grid Engine systems.
Data for the specific project is retrieved (see and an editor (either 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 or the editor indicated by the EDITOR environment variable) and registers the new configuration with the Refer to for details on the queue configuration format. Requires root or manager privilege.
-mqattr attr_name q_name,...<modify queue attributes>
DEPRECATED: Use -rattr!

Allows changing of a single queue configuration attribute in multiple queues with a single command. In all queues contained in the comma separated queue name list the value of the attribute attr_name will be overwritten with val.

All queue attributes can be modified except for qname and qhostname. Refer to for details on the queue configuration format. Requires root or manager privilege.

-msconf                     <modify scheduler configuration>
The current scheduler configuration (see
is retrieved, an editor is executed (either or the editor indicated by $EDITOR) and the changed configuration is registered with upon exit of the editor. Requires root or manager privilege.
-mstnode node_path=shares,...<modify share tree node>
This option is only supported in case of a Sun Grid Engine, Enterprise Edition system. It is not available
for Sun Grid Engine systems.
Modifies the specified share tree node(s) in the share tree (see 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>
This option is only supported in case of a Sun Grid Engine, Enterprise Edition system. It is not available
for Sun Grid Engine systems.
Modifies the definition of the share tree (see The present share tree is retrieved and an editor (either or the editor indicated by $EDITOR) is invoked for modifying the share tree definition. Upon exiting the editor, the modified data is registered with 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 or the editor indicated by the EDITOR environment variable) and registers the new configuration with the Requires root or manager privilege.
-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. Currently supported objects are the queue, the host, the parallel environment and the checkpointing interface configuration being specified as queue and the host configuration being specified as queue , exechost , pe or ckpt in obj_spec. The queue load_thesholds parameter is an example of a list attribute. With the -rattr option, such lists can be replaced, while entries can be added to them with -aattr, deleted with -dattr, and modified with -mattr.
Note, that "-rattr queue attr_name val q_name, ..." is equivalent to "-mqattr attr_name val q_name,..." (see below). The latter is available for backward compatibility.
The name of the configuration attribute to be modified is specified with attr_name followed by val defining the new setting of the attribute. 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 host object the load_values attribute cannot be modified (see
Requires root or manager privilege.
-Muser fname                <modify user>
This option is only supported in case of a Sun Grid Engine, Enterprise Edition system. It is not available
for Sun Grid Engine systems.
Modify the user defined in fname in the Sun Grid Engine, Enterprise Edition cluster. The format of the user specification is described in Requires root or manager privileges.
-muser user                 <modify user>
This option is only supported in case of a Sun Grid Engine, Enterprise Edition system. It is not available
for Sun Grid Engine systems.
Data for the specific user is retrieved (see and an editor (either 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.
-sc complex_name,...        <show complexes>
Display the configuration of one or more complexes.
-scal calendar_name         <show calendar>
Display the configuration of the specified calendar.
-scall                      <show calendar list>
Show a list of all calendars currently defined.
-scl                        <show complex list names>
Show a list of all complexes currently configured.
-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 cluster configuration being in effect globally or
on specified host(s). If the optional comma separated host list argument is omitted or the special string global is given, the global cell configuration is displayed. For any other hostname in the list the merger of the global configuration and the host specific configuration is displayed. The format of the host configuration is described in
-sconfl                    <show configuration list>
Display a list of hosts for which configurations are
available. The special host name "global" refers to the cell global 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>
Displays a list of number of processors which are licensed per execution
host and in total.
-sh                         <show administrative hosts>
Displays the Sun Grid Engine administrative host list.
-sm                <show managers>
Displays the managers list.
-so                         <show operators>
Displays the operator list.
-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>
This option is only supported in case of a Sun Grid Engine, Enterprise Edition system. It is not available
for Sun Grid Engine systems.
Shows the definition of the specified project (see
-sprjl                     <show project list>
This option is only supported in case of a Sun Grid Engine, Enterprise Edition system. It is not available
for Sun Grid Engine systems.
Shows the list of all currently defined projects.
-sq queue_name[,queue_name,...]<show queues>
Displays one or multiple queues.
-sql                        <show queue list>
Show a list of all currently defined 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
-sstnode node_path,...     <show share tree node>
This option is only supported in case of a Sun Grid Engine, Enterprise Edition system. It is not available
for Sun Grid Engine systems.
Shows the name and shares of the specified share tree node(s) (see 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>
This option is only supported in case of a Sun Grid Engine, Enterprise Edition system. It is not available
for Sun Grid Engine systems.
Shows the definition of the share tree (see
-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>
This option is only supported in case of a Sun Grid Engine, Enterprise Edition system. It is not available
for Sun Grid Engine systems.
Shows the definition of the specified user(s) (see
-suserl                    <show users>
This option is only supported in case of a Sun Grid Engine, Enterprise Edition system. It is not available
for Sun Grid Engine systems.
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 -F option (see description of Full Format in section OUTPUT FORMATS of the 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.
COMMD_PORT
If set, specifies the tcp port on which is expected to listen for communication requests. Most installations will use a services map entry instead to define that port.
COMMD_HOST
If set, specifies the host on which the particular to be used for Sun Grid Engine communication of the qconf client resides. Per default the local host is used.
 

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

 

COPYRIGHT

See for a full statement of rights and permissions.


 

Index

NAME
SYNTAX
DESCRIPTION
OPTIONS
ENVIRONMENTAL VARIABLES
RESTRICTIONS
FILES
SEE ALSO
COPYRIGHT

This document was created by man2html, using the manual pages.
Time: 17:34:22 GMT, September 12, 2003