com.esri.arcgis.server
Class IServerMachine2Proxy

java.lang.Object
  extended by com.esri.arcgis.interop.Dispatch
      extended by com.esri.arcgis.server.IServerMachineProxy
          extended by 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 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.

See Also:
Serialized Form

Field Summary
 
Fields inherited from class com.esri.arcgis.interop.Dispatch
DISPATCH_METHOD, DISPATCH_PROPERTYGET, DISPATCH_PROPERTYPUT, DISPATCH_PROPERTYPUTREF, E
 
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 readExternal(ObjectInput in)
           
 void removeListener(String iidStr, Object theListener)
           
 void setCapacity(int val)
          The number of desired concurrently available configurations (the capacity) of the ArcGIS Server.
 void writeExternal(ObjectOutput out)
           
 
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, queryInterface, release, setNativeMode, setPropertyByName, toString, vtblInvoke
 
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
 

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

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.

writeExternal

public void writeExternal(ObjectOutput out)
                   throws IOException
Specified by:
writeExternal in interface Externalizable
Overrides:
writeExternal in class IServerMachineProxy
Throws:
IOException

readExternal

public void readExternal(ObjectInput in)
                  throws IOException,
                         ClassNotFoundException
Specified by:
readExternal in interface Externalizable
Overrides:
readExternal in class IServerMachineProxy
Throws:
IOException
ClassNotFoundException