NAME

qconf - Sun Grid Engine Queue Configuration

SYNTAX

qconfoptions

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.
-Aattrobj_specfnameobj_instance,...<addtoobjectattributes>
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.
-Acalfname<addcalendar>
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.
-Ackptfname<addckpt.environment>
Add the checkpointing environment as defined in fname (see
checkpoint(5)) to the list of supported checkpointing
environments. Requires root or manager privileges.
-Aconffile_list<addconfigurations>
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.
-Aefname<addexecutionhost>
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.
-Ahgrpfile<addhostgroupconfig>
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.
-Arqsfname<addRQSconfiguration>
Add the resource quota set (RQS) defined in the file named fname
to the Sun Grid Engine cluster. Requires root or manager
privileges.
-Apfname<addPEconfiguration>
Add the parallel environment (PE) defined in fname to the Sun
Grid Engine cluster. Requires root or manager privileges.
-Aprjfname<addnewproject>
Adds the project description defined in fname to the list of
registered projects (see project(5)). Requires root or manager
privileges.
-Aqfname<addnewqueue>
Add the queue defined in fname to the Sun Grid Engine cluster.
Requires root or manager privileges.
-Aufname<addanACL>
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.
-Dattrobj_specfnameobj_instance,...<del.fromobjectattribs>
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.
-Mattrobj_specfnameobj_instance,...<mod.objectattributes>
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.
-Mcfname<modifycomplex>
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.
-Mcalfname<modifycalendar>
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.
-Mckptfname<modifyckpt.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.
-Mconffile_list<modifyconfigurations>
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.
-Mefname<modifyexecutionhost>
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.
-Mhgrpfile<modifyhostgroupconfig.>
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).
-Mrqsfname[mrqs_name]<modifyRQSconfiguration>
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.
-Mpfname<modifyPEconfiguration>
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.
-Mprjfname<modifyprojectconfig.>
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.
-Mqfname<modifyqueueconfiguration>
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.
-Msconffname<modifyschedulerconfigurationfromfile>
The current scheduler configuration (see sched_conf(5)) is
overridden with the configuration specified in the file.
Requires root or manager privilege.
-Mstreefname<modifysharetree>
Modifies the definition of the share tree (see share_tree(5)).
The modified sharetree is read from file fname. Requires root
or manager privileges.
-Mufname<modifyACL>
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.
-Muserfname<modifyuser>
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.
-Rattrobj_specfnameobj_instance,...<replaceobjectattribs>
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.
-aattrobj_specattr_namevalobj_instance,...<addtoobjectattributes>
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.
-acalcalendar_name<addcalendar>
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.
-ackptckpt_name<addckpt.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.
-aconfhost,...<addconfiguration>
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]<addexecutionhost>
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.
-ahhostname,...<addadministrativehost>
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.
-ahgrpgroup<addhostgroupconfig.>
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]<addnewRQS>
Adds one or more ResourceQuotaSet (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.
-amuser,...<addmanagers>
Adds the indicated users to the Sun Grid Engine manager list.
Requires root or manager privileges.
-aouser,...<addoperators>
Adds the indicated users to the Sun Grid Engine operator list.
Requires root or manager privileges.
-appe_name<addnewPE>
Adds a ParallelEnvironment (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.
-atthread_name<activatesthreadinmaster>
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<addnewproject>
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]<addnewqueue>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.
-ashostname,...<addsubmithosts>
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.
-astnodenode_path=shares,...<addsharetreenode>
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<addsharetree>
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.
-Astreefname<addsharetree>
Adds the definition of a share tree to the system (see
share_tree(5)) from the file fname. Requires root or manager
privileges.
-auuser,...acl_name,...<adduserstoACLs>
Adds users to Sun Grid Engine user access lists (ACLs). User
lists are used for queue usage authentication. Requires
root/manager/operator privileges.
-Auserfname<adduser>
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<adduser>
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<clearsharetreeusage>
Clears all user and project usage from the sharetree. All usage
will be initialized back to zero.
-cqwc_queue_list<cleanqueue>
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).
-dattrobj_specattr_namevalobj_instance,...<deleteinobjectattribs>
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-dcalcalendar_name,...<deletecalendar>
Deletes the specified calendar definition from Sun Grid Engine.
Requires root/manager privileges.
-dckptckpt_name<deleteckpt.environment>
Deletes the specified checkpointing environment. Requires
root/manager privileges.
-dconfhost,...<deletelocalconfiguration>
The local configuration entries for the specified hosts are
deleted from the configuration list. Requires root or manager
privilege.
-dehost_name,...<deleteexecutionhost>
Deletes hosts from the Sun Grid Engine execution host list.
Requires root or manager privileges.
-dhhost_name,...<deleteadministrativehost>
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.
-dhgrpgroup<deletehostgroupconfiguration>
Deletes host group configuration with the name specified in
group. Requires root or manager privileges.
-drqsrqs_name_list<deleteRQS>
Deletes the specified resource quota sets (RQS). Requires root
or manager privileges.
-dmuser[,user,...]<deletemanagers>
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.
-douser[,user,...]<deleteoperators>
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.
-dppe_name<deleteparallelenvironment>
Deletes the specified parallel environment (PE). Requires root
or manager privileges.
-dprjproject,...<deleteprojects>
Deletes the specified project(s). Requires root/manager
privileges.
-dqqueue_name,...<deletequeue>
Removes the specified queue(s). Active jobs will be allowed to
run to completion. Requires root or manager privileges.
-dshost_name,...<deletesubmithost>
Deletes hosts from the Sun Grid Engine submit host list.
Requires root or manager privileges.
-dstnodenode_path,...<deletesharetreenode>
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<deletesharetree>
Deletes the current share tree. Requires root or manager
privileges.
-duuser,...acl_name,...<deleteusersfromACL>
Deletes one or more users from one or more Sun Grid Engine user
access lists (ACLs). Requires root/manager/operator privileges.
-dulacl_name,...<deleteuserlists>
Deletes one or more user lists from the system. Requires
root/manager/operator privileges.
-duseruser,...<deleteusers>"
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}}<shutdownSunGridEngine>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 -kmsge_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.
-ktthread_name<terminatemasterthread>"
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}<killeventclient>
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.
-mattrobj_specattr_namevalobj_instance,...<modifyobjectattributes>
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<modifycomplex>
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.
-mcalcalendar_name<modifycalendar>
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.
-mckptckpt_name<modifyckpt.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]<modifyconfiguration>
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 globalisspecified,theglobalconfigurationismodified.Theformatoftheconfigurationisdescribedinsge_conf(5).
Requires root or manager privilege.
-mehostname<modifyexecutionhost>
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.
-mhgrpgroup<modifyhostgroupconfiguration>
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]<modifyRQSconfiguration>
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.
-mppe_name<modifyPEconfiguration>
Retrieves the current configuration for the specified parallelenvironment (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.
-mprjproject<modifyproject>
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.
-mqqueuename<modifyqueueconfiguration>
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<modifyschedulerconfiguration>
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.
-mstnodenode_path=shares,...<modifysharetreenode>
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<modifysharetree>
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.
-muacl_name<modifyuseraccesslists>
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.
-museruser<modifyuser>
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.
-purgequeueattr_nm,...obj_spec<purgedivergentattributesettings>
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.
-rattrobj_specattr_namevalobj_instance,...<replaceobjectattributes>
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.
-rsstnodenode_path,...<showsharetreenode>
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<showcomplexes>
Display the complex configuration.
-scalcalendar_name<showcalendar>
Display the configuration of the specified calendar.
-scall<showcalendarlist>
Show a list of all calendars currently defined.
-sckptckpt_name<showckpt.environment>
Display the configuration of the specified checkpointing
environment.
-sckptl<showckpt.environmentlist>
Show a list of the names of all checkpointing environments
currently configured.
-sconf[host,...|global]<showconfiguration>
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<showconfigurationlist>
Display a list of hosts for which configurations are available.
The special host name globalreferstotheglobalconfiguration.-sds<showdetachedsettings>
Displays detached settings in the cluster configuration.
-sehostname<showexecutionhost>
Displays the definition of the specified execution host.
-sel<showexecutionhosts>
Displays the Sun Grid Engine execution host list.
-secl<showeventclients>
Displays the Sun Grid Engine event client list.
-sep<showlicensedprocessors>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<showadministrativehosts>
Displays the Sun Grid Engine administrative host list.
-shgrpgroup<showhostgroupconfig.>
Displays the host group entries for the group specified in
group.-shgrpl<showhostgrouplists>
Displays a name list of all currently defined host groups which
have a valid host group configuration.
-shgrp_treegroup<showhostgrouptree>
Shows a tree like structure of host group.
-shgrp_resolvedgroup<showhostgrouphosts>
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]<showRQSconfiguration>
Show the definition of the resourcequotasets (RQS) specified
by the argument.
-srqsl<showRQS-list>
Show a list of all currently defined resourcequotasetss
(RQSs).
-sm<showmanagers>
Displays the managers list.
-so<showoperators>
Displays the operator list.
-sobjlobj_specattr_nameval<showobjectlist>
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.
-sppe_name<showPEconfiguration>
Show the definition of the parallelenvironment (PE) specified
by the argument.
-spl<showPE-list>
Show a list of all currently defined parallelenvironments
(PEs).
-sprjproject<showproject>
Shows the definition of the specified project (see project(5)).
-sprjl<showprojectlist>
Shows the list of all currently defined projects.
-sqwc_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<showqueuelist>
Show a list of all currently defined cluster queues.
-ss<showsubmithosts>
Displays the Sun Grid Engine submit host list.
-ssconf<showschedulerconfiguration>
Displays the current scheduler configuration in the format
explained in sched_conf(5).
-sstnodenode_path,...<showsharetreenode>
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<showsharetree>
Shows the definition of the share tree (see share_tree(5)).
-sst<showformattedsharetree>
Shows the definition of the share tree in a tree view (see
share_tree(5)).
-sss<showschedulerstatus>
Currently displays the host on which the Sun Grid Engine
scheduler is active or an error message if no scheduler is
running.
-suacl_name<showuserACL>
Displays a Sun Grid Engine user access list (ACL).
-sul<showuserlists>
Displays a list of names of all currently defined Sun Grid
Engine user access lists (ACLs).
-suseruser,...<showuser>
Shows the definition of the specified user(s) (see user(5)).
-suserl<showusers>
Shows the list of all currently defined users.
-tsm<triggerschedulermonitoring>
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 FullFormat in section OUTPUTFORMATS of the
qstat(1) manual page.

ENVIRONMENTALVARIABLES

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