com.esri.arcgis.server
Interface IServerMachine2

All Superinterfaces:

IServerMachine, Serializable

All Known Implementing Classes:

IServerMachine2Proxy, ServerMachine

public interface IServerMachine2
extends IServerMachine, Serializable

Provides access to properties of a server host machine for administrators.

Remarks

ArcGIS Server is a distributed system. Server objects managed by the ArcGIS server can run on one or more host machines. A machine that can host server objects must have the Server Object Container installed on it, and the machine must be added to the list of host machines managed by the Server Object Manager.

The IServerMachine2 interface allows you to configure the Capacity property of a machine to be added to the ArcGIS Server. The Capacity property defines the number configuration instances on a SOC machine that are allowed to run concurrently before the pool-shrinking algorithm engages. The pool-shrinking algorithm removes least recently used configuration instances and replaces them with new instances. Capacity is dependent on system memory and CPU resources and should be tuned for each machine in the ArcGIS Server.

Use the AddMachine method of the IServerObjectAdmin interface to add new host machines to the ArcGIS Server. All server objects configured in the ArcGIS server can run on any of the host machines, so all host machines must have access to the necessary data and output directories used by all the server objects.

Product Availability

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

Method Summary

int	getCapacity() The number of desired concurrently available configurations (the capacity) of the ArcGIS Server.
void	setCapacity(int val) The number of desired concurrently available configurations (the capacity) of the ArcGIS Server.

Methods inherited from interface com.esri.arcgis.server.IServerMachine

getDescription, getName, setDescription, setName

Method Detail

getCapacity

int getCapacity()
                throws IOException,
                       AutomationException

The number of desired concurrently available configurations (the capacity) of the ArcGIS Server.

Remarks

The Capacity property defines the number configuration instances on a SOC machine that are allowed to run concurrently before the pool-shrinking algorithm engages. The pool-shrinking algorithm removes least recently used configuration instances and replaces them with new instances. Capacity is dependent on system memory and CPU resources and should be tuned for each machine in the ArcGIS Server.

Product Availability

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

Returns:

The val

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setCapacity

void setCapacity(int val)
                 throws IOException,
                        AutomationException

The number of desired concurrently available configurations (the capacity) of the ArcGIS Server.

Product Availability

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

Parameters:

val - The val (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.