ArcObjects Library Reference (Server)

IServerObjectConfiguration Interface

Provides access to administrators to members that control the behavior and properties of a server object configuration.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

When To Use

Use the IServerObjectConfiguration interface to do the following:

Define a new server object configuration to be added to the server with the AddConfiguration method on IServerObjectAdmin

Update an existing server object configuration with the UpdateConfiguration method on IServerObjectAdmin

View the administrator level properties of an existing server object configuration. Administrator level properties are those that are not available through the IServerObjectConfigurationInfo interface, and include:

Properties
RecycleProperties
MinInstances
MaxInstances
IsolationLevel
StartupType
WaitTimeout
UsageTimeout

Properties that are available through bot the IServerObjectConfiguration (read/write) and IServerObjectConfigurationInfo (read only) interfaces include:

Name
TypeName
Description
IsPooled

Members

	Name	Description
	Description	Description of the server object configuration.
	IsolationLevel	The isolation level of the server objects defined by the server object configuration.
	IsPooled	Indicates whether the server objects defined by this configuration are pooled.
	MaxInstances	The maximum number of server object instances for a server object configuration.
	MinInstances	The minimum number of server object instances for a server object configuration.
	Name	Name of the server object configuration.
	Properties	Initialization parameters and properties for the server objects created by the server object configuration.
	RecycleProperties	The recycling properties for the server object configuration.
	StartupType	The startup type for this server object configuration. Startup type describes whether the server object configuration is started when the server object manager service is started for the GIS server.
	TypeName	Type of the server object configuration (MapServer or GeocodeServer).
	UsageTimeout	Maximum time (in seconds) a client can hold onto an instance of a server object for this server object configuration before releasing it back to the server. It is the maximum time allowed between calling CreateServerContext and ReleaseServerContext.
	WaitTimeout	Maximum time (in seconds) a client will wait for an instance of a server object for this server object configuration using the CreateServerContext method on IServerObjectManager before timing out.

CoClasses that implement IServerObjectConfiguration

CoClasses and Classes	Description
ServerObjectConfiguration	The ServerObjectConfiguration object which defines the properties and behavior for server objects running in the GIS server.

Remarks

The ArcGIS Server manages a set of server objects running across one or more host (container) machines. How those server objects are configured and run is defined by a set of server object configurations. Server object configurations can be added, removed, and modified by users or developers who are members of the agsadmin users group, and therfore have administrator priviliges on the ArcGIS Server.

The IServerObjectConfiguration interface is a read/write interface on a server object configuration that allows administrators to configure new server object configurations to add to the server, update existing server object confiurations, and to view the configuration properties of a server object configuration.

Users and developers that are not part the the agsadmin user group do not have access to this interface. An additional read-only interface called IServerObjectConfigurationInfo is available to non-administrators, which provides read-only access to a subset of the server object configuration's properties.

If you use IServerObjectConfiguration to modify any of a configuration's properties, you must call UpdateConfiguration on IServerObjectAdmin for those changes to be reflected in the server.