com.esri.arcgis.server
Class IServerMachine2Proxy

java.lang.Object
  com.esri.arcgis.interop.Dispatch
      com.esri.arcgis.server.IServerMachineProxy
          com.esri.arcgis.server.IServerMachine2Proxy

All Implemented Interfaces:

IServerMachine, IServerMachine2, Externalizable, Serializable

public class IServerMachine2Proxy
extends IServerMachineProxy
implements IServerMachine2, Serializable

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

Remarks

ArcGIS for 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 (SOC) installed on it, and the machine must be added to the list of host machines managed by the Server Object Manager (SOM).

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 an SOC machine that are allowed to run concurrently before the pool-shrinking algorithm engages. The pool-shrinking algorithm removes the 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.

See Also:

Serialized Form

Field Summary

boolean

noncastable

Fields inherited from class com.esri.arcgis.interop.Dispatch

DISPATCH_METHOD, DISPATCH_PROPERTYGET, DISPATCH_PROPERTYPUT, DISPATCH_PROPERTYPUTREF, objRef

Constructor Summary

	IServerMachine2Proxy()
	IServerMachine2Proxy(Object obj)
protected	IServerMachine2Proxy(Object obj, String iid)

Method Summary

void	addListener(String iidStr, Object theListener, Object theSource)
int	getCapacity() The number of desired concurrently available configurations (the capacity) of the ArcGIS Server.
void	removeListener(String iidStr, Object theListener)
void	setCapacity(int val) The number of desired concurrently available configurations (the capacity) of the ArcGIS Server.

Methods inherited from class com.esri.arcgis.server.IServerMachineProxy

getDescription, getName, setDescription, setName

Methods inherited from class com.esri.arcgis.interop.Dispatch

bindUsingMoniker, constructVtblPosTable, convertToNative, cookieForListener, createDispatch, createObjrefMonikerDisplayName, equals, getActiveObject, getActiveObject, getDefaultProperty, getDispatchIdOfName, getLastErrorCode, getMtsObjectContext, getObjRef, getPropertyByName, getPropertyByName, getVtblPos, hashCode, initDispatch, invoke, invokeMethodByName, invokeMethodByName, invokeMethodByName, invokePropertyGetByName, invokePropertyPutByName, invokePropertyPutByRefByName, isNativeMode, isObjRef, optimizedVtblInvoke, queryInterface, readExternal, release, setNativeMode, setPropertyByName, toString, vtblInvoke, writeExternal

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

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

getDescription, getName, setDescription, setName

Field Detail

noncastable

public boolean noncastable

Constructor Detail

IServerMachine2Proxy

public IServerMachine2Proxy()

IServerMachine2Proxy

public IServerMachine2Proxy(Object obj)
                     throws IOException

Throws:

IOException

IServerMachine2Proxy

protected IServerMachine2Proxy(Object obj,
                               String iid)
                        throws IOException

Throws:

IOException

Method Detail

addListener

public void addListener(String iidStr,
                        Object theListener,
                        Object theSource)
                 throws IOException

Overrides:

addListener in class IServerMachineProxy

Throws:

IOException

removeListener

public void removeListener(String iidStr,
                           Object theListener)
                    throws IOException

Overrides:

removeListener in class IServerMachineProxy

Throws:

IOException

getCapacity

public 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 an 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.

Specified by:

getCapacity in interface IServerMachine2

Returns:

The val

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setCapacity

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

Specified by:

setCapacity in interface IServerMachine2

Parameters:

val - The val (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.