qconf

Overview

qconf is a tool for querying Sun Grid Engine (SGE) configuration information. This implementation provides a compatibility interface for the FSCHED environment. The command lets users view queues, parallel environments, and other system configuration parameters.

Parameters

Supported Options

Queue Management

Option	Value Required	Value Range	Purpose	Key Differences
`-sql`	No	None	List all queue names
`-sq`	Yes	Queue name	Show detailed configuration for a specific queue	Some fields are dummy values

Host Management

Option	Value Required	Value Range	Purpose	Key Differences
`-sel`	No	None	List all execution hosts
`-se`	Yes	Hostname	Show detailed configuration for a specific host	Some fields are dummy values
`-sh`	No	None	List all administration hosts	Returns the control node
`-ss`	No	None	List all submit hosts	Returns the control node

Host Group Management

Option	Value Required	Value Range	Purpose	Key Differences
`-shgrpl`	No	None	List all host groups	Read from config file; returns `@allhosts` if not configured
`-shgrp`	Yes	Host group name	Show host group details	Read from config file
`-shgrp_tree`	Yes	Host group name	Show host groups in tree form	Displays host group hierarchy
`-shgrp_resolved`	Yes	Host group name	Show resolved host list	Expands all hostnames

Parallel Environments

Option	Value Required	Value Range	Purpose	Key Differences
`-spl`	No	None	List all parallel environments	Returns `smp` and `mpi` by default
`-sp`	Yes	Parallel environment name	Show parallel environment details	Read from config file

Users and Projects

Option	Value Required	Value Range	Purpose	Key Differences
`-suserl`	No	None	List all users	From config file or database
`-suser`	Yes	User name	Show user details	From config file or database; some fields are dummy values
`-sprjl`	No	None	List all projects	From config file or database
`-sprj`	Yes	Project name	Show project details	From config file or database

Access Control

Option	Value Required	Value Range	Purpose	Key Differences
`-sul`	No	None	List all user sets/ACLs	Read from config file
`-su`	Yes	ACL name	Show user set details	Read from config file
`-sm`	No	None	List all managers	Currently fixed to `root`
`-so`	No	None	List all operators	Fixed to `NONE`

Configuration Management

Option	Value Required	Value Range	Purpose	Key Differences
`-sconf`	Optional	`global` or hostname	Show global or host configuration	From system configuration
`-ssconf`	No	None	Show scheduler configuration	From system configuration
`-sconfl`	No	None	List all configuration hosts	Returns the control node

Complex Resources

Option	Value Required	Value Range	Purpose	Key Differences
`-sc`	No	None	Show all complex resource attribute definitions	Returns a predefined resource attribute list

Resource Quotas

Option	Value Required	Value Range	Purpose	Key Differences
`-srqsl`	No	None	List all resource quota sets	From the database
`-srqs`	No	Quota set name (optional)	Show quota set details; show all if no name is specified	Only name, description, enable status, and job/runtime/CPU limits are supported; complex filter rules are not supported

Scheduler Status

Option	Value Required	Value Range	Purpose	Key Differences
`-sss`	No	None	Show scheduler status	Returns control node information

Other Options

Option	Value Required	Value Range	Purpose	Key Differences
`-help`	No	None	Show help	Shows all supported options
`-version`	No	None	Show version	Shows wrapper version and build information

Advanced Queries

Option	Value Required	Value Range	Purpose	Key Differences
`-sobjl`	Yes	object_type attribute value	List objects matching the criteria	Partially supported

Queue Configuration Output (`-sq`)

Field	Description	Key Differences
`qname`	Queue name	From queue configuration
`hostlist`	Host list	From queue configuration
`seq_no`	Sequence number	Dummy value `0`
`load_thresholds`	Load thresholds	Fixed value `"np_load_avg=1.75"`
`suspend_thresholds`	Suspend thresholds	Dummy value `"NONE"`
`nsuspend`	Number of suspended slots	Dummy value `1`
`suspend_interval`	Suspend interval	Dummy value `"00:05:00"`
`priority`	Priority	From queue configuration
`min_cpu_interval`	Minimum CPU interval	Dummy value `"00:05:00"`
`processors`	Processor limit	Dummy value `"UNDEFINED"`
`qtype`	Queue type	Dummy value `"BATCH INTERACTIVE"`
`ckpt_list`	Checkpoint interface list	Dummy value `"NONE"`
`pe_list`	Parallel environment list	Fixed value `"make smp mpi"`
`rerun`	Rerun flag	Dummy value `"FALSE"`
`slots`	Total slots	From queue configuration
`tmpdir`	Temporary directory	Fixed value `"/tmp"`
`shell`	Shell path	Fixed value `"/bin/sh"`
`prolog`	Prolog script	From system configuration or `"NONE"`
`epilog`	Epilog script	From system configuration or `"NONE"`
`shell_start_mode`	Shell start mode	Fixed value `"posix_compliant"`
`starter_method`	Starter method	Dummy value `"NONE"`
`suspend_method`	Suspend method	Dummy value `"NONE"`
`resume_method`	Resume method	Dummy value `"NONE"`
`terminate_method`	Terminate method	Dummy value `"NONE"`
`initial_state`	Initial state	From queue configuration
`s_rt`	Soft real-time limit	From queue configuration or `"INFINITY"`
`h_rt`	Hard real-time limit	From queue configuration or `"INFINITY"`
`s_cpu`	Soft CPU limit	Dummy value `"INFINITY"`
`h_cpu`	Hard CPU limit	Dummy value `"INFINITY"`
`s_fsize`	Soft file size limit	Dummy value `"INFINITY"`
`h_fsize`	Hard file size limit	Dummy value `"INFINITY"`
`s_data`	Soft data limit	Dummy value `"INFINITY"`
`h_data`	Hard data limit	Dummy value `"INFINITY"`
`s_stack`	Soft stack limit	Dummy value `"INFINITY"`
`h_stack`	Hard stack limit	Dummy value `"INFINITY"`
`s_core`	Soft core file limit	Dummy value `"INFINITY"`
`h_core`	Hard core file limit	Dummy value `"INFINITY"`
`s_rss`	Soft RSS limit	Dummy value `"INFINITY"`
`h_rss`	Hard RSS limit	Dummy value `"INFINITY"`
`s_vmem`	Soft virtual memory limit	Dummy value `"INFINITY"`
`h_vmem`	Hard virtual memory limit	Dummy value `"INFINITY"`

Host Configuration Output (`-se`)

Field	Description	Key Differences
`hostname`	Hostname	From host configuration
`load_scaling`	Load scaling	Dummy value `"NONE"`
`complex_values`	Complex resource values	Dummy value `"NONE"` (load data is in the `load_values` field)
`load_values`	Load values	Real-time load from system information
`processors`	Processor count	From host configuration
`user_lists`	User list	Dummy value `"NONE"`
`xuser_lists`	Excluded user list	Dummy value `"NONE"`
`projects`	Project list	Dummy value `"NONE"`
`xprojects`	Excluded project list	Dummy value `"NONE"`
`usage_scaling`	Usage scaling	Dummy value `"NONE"`
`report_variables`	Report variables	Dummy value `"NONE"`

Parallel Environment Configuration Output (`-sp`)

Field	Description	Key Differences
`pe_name`	Parallel environment name	Fixed to `smp` or `mpi`
`slots`	Slots	smp=999, mpi=99999
`allocation_rule`	Allocation rule	smp="$pe_slots", mpi="$fill_up"
`accounting_summary`	Accounting summary	smp=TRUE, mpi=FALSE
`control_slaves`	Control slaves	Fixed value TRUE
`job_is_first_task`	Job is first task	Fixed value TRUE

User Information Output (`-suser`)

Field	Description	Key Differences
`name`	User name	From config file or database
`oticket`	Override tickets	Dummy value `0`
`fshare`	Functional shares	Dummy value `0`
`delete_time`	Delete time	Dummy value
`default_project`	Default project	From config file or database

Examples

Example 1: List all queues

qconf -sql

Sample output:

compute
test

Example 2: Show queue details

qconf -sq compute

Sample output:

qname                 compute
hostlist              compute[1-11]
seq_no                0
...

Example 3: List all execution hosts

qconf -sel

Sample output:

compute1
compute2
test1

Example 4: Show host details

qconf -se compute1

Sample output:

hostname              compute1
load_scaling          NONE
complex_values        NONE
...

Example 5: Show global configuration

qconf -sconf global

Sample output:

#global:
execd_spool_dir              /opt/fastone/wrappers/sge/spool
mailer                       /bin/mail
...

Example 6: List all host groups

qconf -shgrpl

Sample output:

@allhosts

Example 7: List all parallel environments

qconf -spl

Sample output:

smp
mpi

Example 8: List all users

qconf -suserl

Sample output:

root

Example 9: Show project details

qconf -sprj project_a

Sample output:

name project_a
oticket 0
fshare 0
acl NONE
xacl NONE

Example 10: List resource quota sets

qconf -srqsl

Sample output:

normal
high
medium
low

Notes

Unsupported Features

All modification options (-a*, -m*, etc.): No configuration changes are supported
Administrative options (-k*, -clearusage, etc.): No administrative operations are supported

Parameter Limitations

-sp only supports predefined parallel environments (smp, mpi)
-sconf only supports global configuration

Overview​

Parameters​

Supported Options​

Queue Management​

Host Management​

Host Group Management​

Parallel Environments​

Users and Projects​

Access Control​

Configuration Management​

Complex Resources​

Resource Quotas​

Scheduler Status​

Other Options​

Advanced Queries​

Queue Configuration Output (-sq)​

Host Configuration Output (-se)​

Parallel Environment Configuration Output (-sp)​

User Information Output (-suser)​

Examples​

Example 1: List all queues​

Example 2: Show queue details​

Example 3: List all execution hosts​

Example 4: Show host details​

Example 5: Show global configuration​

Example 6: List all host groups​

Example 7: List all parallel environments​

Example 8: List all users​

Example 9: Show project details​

Example 10: List resource quota sets​

Notes​

Unsupported Features​

Parameter Limitations​

Overview

Parameters

Supported Options

Queue Management

Host Management

Host Group Management

Parallel Environments

Users and Projects

Access Control

Configuration Management

Complex Resources

Resource Quotas

Scheduler Status

Other Options

Advanced Queries

Queue Configuration Output (`-sq`)

Host Configuration Output (`-se`)

Parallel Environment Configuration Output (`-sp`)

User Information Output (`-suser`)

Examples

Example 1: List all queues

Example 2: Show queue details

Example 3: List all execution hosts

Example 4: Show host details

Example 5: Show global configuration

Example 6: List all host groups

Example 7: List all parallel environments

Example 8: List all users

Example 9: Show project details

Example 10: List resource quota sets

Notes

Unsupported Features

Parameter Limitations