com.esri.arcgis.server
Class IServerStatusProxy

java.lang.Object
  com.esri.arcgis.interop.Dispatch
      com.esri.arcgis.server.IServerStatusProxy

All Implemented Interfaces:

IServerStatus, Externalizable, Serializable

public class IServerStatusProxy
extends com.esri.arcgis.interop.Dispatch
implements IServerStatus, Serializable

Provides access to the properties of the status of the ArcGIS Server.

Remarks

The IServerStatus interface provides access to information concerning the state of the ArcGIS Server, its SOC machines and its server object configurations. This interface can be obtained with a Query Interface on IServerObjectAdmin.

The InstanceCount property holds the number of server object instances currently running on the entire ArcGIS Server (includes all SOC machines). This number will always contain two more configuration instances than you deploy. These two "extra" configuration instances correspond to an instance of the SDM.ServerDirectoryManager and an instance of the SrvLog.ServerLog configurations and are started and controlled by the SOM. You cannot alter these configurations. It is also important to note that these two instances do participate in the total number of instances allowed by the server configuration Capacity property. For example, if you set Capacity = 22, you will only be able to add 20 more configuration instances before the pool-shrinking algorithm engages. However, these two configurations will not be removed in a pool-shrinking operation and will stay on the machine on which they were instantiated unless that machine is removed or becomes disabled. In this case, the two instances will get redistributed to somewhere on the other SOC machines.

The InstanceInUseCount property holds the number of server object instances that are currently in use by ArcGIS Server clients. An instance is counted as "in use" until the client releases the server context.

The GetConfigurationStatus method returns an IServerObjectConfigurationStatus interface which can report the number of active and inactive instances and the enabled status of the configuration in the method argument.

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

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

Method Summary

void	addListener(String iidStr, Object theListener, Object theSource)
IServerObjectConfigurationStatus	getConfigurationStatus(String name, String typeName) Gets the configuration status for the server object configuration with the specified Name and TypeName.
int	getInstanceCount(int access) The number of server object instances currently running in the ArcGIS server.
int	getInstanceInUseCount(int access) The number of currently running server object instances in use by clients of the ArcGIS server.
IServerMachineStatus	getMachineStatus(String machine) Gets the status for an ArcGIS Server host machine.
Date	getStartTime() The time that the server was started.
boolean	isEnabled() Indicates if the server is started and enabled(true) or not(false).
void	removeListener(String iidStr, Object theListener)

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

Field Detail

noncastable

public boolean noncastable

Constructor Detail

IServerStatusProxy

public IServerStatusProxy()

IServerStatusProxy

public IServerStatusProxy(Object obj)
                   throws IOException

Throws:

IOException

IServerStatusProxy

protected IServerStatusProxy(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 com.esri.arcgis.interop.Dispatch

Throws:

IOException

removeListener

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

Overrides:

removeListener in class com.esri.arcgis.interop.Dispatch

Throws:

IOException

getInstanceCount

public int getInstanceCount(int access)
                     throws IOException,
                            AutomationException

The number of server object instances currently running in the ArcGIS server.

Product Availability

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

Specified by:

getInstanceCount in interface IServerStatus

Parameters:

access - A com.esri.arcgis.server.esriAccessLevel constant (in)

Returns:

The pVal

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getInstanceInUseCount

public int getInstanceInUseCount(int access)
                          throws IOException,
                                 AutomationException

The number of currently running server object instances in use by clients of the ArcGIS server.

Product Availability

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

Specified by:

getInstanceInUseCount in interface IServerStatus

Parameters:

access - A com.esri.arcgis.server.esriAccessLevel constant (in)

Returns:

The pVal

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getConfigurationStatus

public IServerObjectConfigurationStatus getConfigurationStatus(String name,
                                                               String typeName)
                                                        throws IOException,
                                                               AutomationException

Gets the configuration status for the server object configuration with the specified Name and TypeName.

Remarks

The GetConfigurationStatus method of the IServerStatus interface provides access to information about the enabled state and running instances of a particular server object configuration.

Product Availability

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

Specified by:

getConfigurationStatus in interface IServerStatus

Parameters:

name - The name (in)

typeName - The typeName (in)

Returns:

A reference to a com.esri.arcgis.server.IServerObjectConfigurationStatus

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getMachineStatus

public IServerMachineStatus getMachineStatus(String machine)
                                      throws IOException,
                                             AutomationException

Gets the status for an ArcGIS Server host machine.

Product Availability

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

Specified by:

getMachineStatus in interface IServerStatus

Parameters:

machine - The machine (in)

Returns:

A reference to a com.esri.arcgis.server.IServerMachineStatus

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getStartTime

public Date getStartTime()
                  throws IOException,
                         AutomationException

The time that the server was started.

Product Availability

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

Specified by:

getStartTime in interface IServerStatus

Returns:

The pVal

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

isEnabled

public boolean isEnabled()
                  throws IOException,
                         AutomationException

Indicates if the server is started and enabled(true) or not(false).

Product Availability

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

Specified by:

isEnabled in interface IServerStatus

Returns:

The pVal

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.