com.esri.arcgis.server
Class IServerObjectAdmin2Proxy

java.lang.Object
  com.esri.arcgis.interop.Dispatch
      com.esri.arcgis.server.IServerObjectAdminProxy
          com.esri.arcgis.server.IServerObjectAdmin2Proxy

All Implemented Interfaces:

IServerObjectAdmin, IServerObjectAdmin2, Externalizable, Serializable

Direct Known Subclasses:

IServerObjectAdmin3Proxy

public class IServerObjectAdmin2Proxy
extends IServerObjectAdminProxy
implements IServerObjectAdmin2, Serializable

Provides access to members that administer the ArcGIS server.

Description

IServerObjectAdmin2 provides methods to retrieve server configuration information and to administer the ArcGIS Server.

The IServerObjectAdmin2 interface can be obtained by a query interface with the IServerObjectAdmin interface.

Remarks

The following administration functionality of the ArcGIS Server is exposed by the methods of IServerObjectAdmin2 :

Administer the ArcGIS Server:

• add and remove server object extension types.
• access the server log.
• enable a disabled ArcGIS server.
• disable an enabled ArcGIS server.

Get ArcGIS Server configuration information:

• get information about server object extension types.
• get a reference to the server logs.
• retrieve information about the underlying hardware and operating system.

When To Use

Use the IServerObjectAmin2 interface when your application needs to connect to retrieve configuration information about the ArcGIS Server and when your application intends to administer the ArcGIS Server.

If your application is connecting to the server only to make use of objects in the server, use the IServerObjectManager interface instead.

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

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

Method Summary

void	addExtensionType(String sOTypeName, IServerObjectExtensionType pSOEType) Registers a new server object extension type with the server object type indicated in the argument list.
void	addListener(String iidStr, Object theListener, Object theSource)
IServerObjectExtensionType	createExtensionType() Creates a new empty server object extension type.
void	createFolder(String folderName) Creates a server configuration folder.
void	deleteExtensionType(String sOTypeName, String sOETypeName) Unregisters a server object extension type from the server object type indicated in the argument list.
void	deleteFolder(String folderName) Deletes a server configuration folder.
void	disable() Disables a started SOM.
void	enable() Enables a disabled SOM.
IEnumServerObjectConfiguration	getConfigurationsEx(String folderName) An enumerator over all the server object configurations in a server configuration folder.
IEnumServerObjectExtensionType	getExtensionTypes(String sOTypeName) An enumerator over all the server object extension types.
IPropertySet	getFolderInfo(String folderName) Properties associated with a server configuration folder.
IEnumBSTR	getFolders(String folderName) An array of folder names in the server configuration folder.
IServerLog	getServerLog() Retrieves a reference to the ArcGIS Server logs.
void	removeListener(String iidStr, Object theListener)
void	renameFolder(String folderName, String newName) Renames a server configuration folder.
void	setFolderInfo(String folderName, IPropertySet ppInfo) Properties associated with a server configuration folder.
void	validateConfiguration(String name, String typeName) Validates server object configuration.

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

addConfiguration, addMachine, addServerDirectory, createConfiguration, createMachine, createServerDirectory, deleteConfiguration, deleteMachine, deleteServerDirectory, getConfiguration, getConfigurations, getConfigurationStatus, getMachine, getMachines, getProperties, getServerDirectories, getServerDirectory, getTypes, pauseConfiguration, setProperties, startConfiguration, stopConfiguration, updateConfiguration, updateMachine, updateServerDirectory

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

addConfiguration, addMachine, addServerDirectory, createConfiguration, createMachine, createServerDirectory, deleteConfiguration, deleteMachine, deleteServerDirectory, getConfiguration, getConfigurations, getConfigurationStatus, getMachine, getMachines, getProperties, getServerDirectories, getServerDirectory, getTypes, pauseConfiguration, setProperties, startConfiguration, stopConfiguration, updateConfiguration, updateMachine, updateServerDirectory

Field Detail

noncastable

public boolean noncastable

Constructor Detail

IServerObjectAdmin2Proxy

public IServerObjectAdmin2Proxy()

IServerObjectAdmin2Proxy

public IServerObjectAdmin2Proxy(Object obj)
                         throws IOException

Throws:

IOException

IServerObjectAdmin2Proxy

protected IServerObjectAdmin2Proxy(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 IServerObjectAdminProxy

Throws:

IOException

removeListener

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

Overrides:

removeListener in class IServerObjectAdminProxy

Throws:

IOException

getExtensionTypes

public IEnumServerObjectExtensionType getExtensionTypes(String sOTypeName)
                                                 throws IOException,
                                                        AutomationException

An enumerator over all the server object extension types.

Remarks

Server object extensions can be designated by a type name, description and class ID. The GetExtensionTypes method of the IServerObjectAdmin2 interface provides a reference to an enumeration of IServerObjectExtensionTypes. IServerObjectExtensionType has methods that can be interrogated for type name, description and class ID.

Product Availability

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

Specified by:

getExtensionTypes in interface IServerObjectAdmin2

Parameters:

sOTypeName - The sOTypeName (in)

Returns:

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

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getServerLog

public IServerLog getServerLog()
                        throws IOException,
                               AutomationException

Retrieves a reference to the ArcGIS Server logs.

Remarks

The ServerLog property of the IServerObjectAdmin2 interface is a reference to an IServerLog interface. The IServerLog interface is used to query and retrieve records from the logs on disk.

Product Availability

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

Specified by:

getServerLog in interface IServerObjectAdmin2

Returns:

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

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

enable

public void enable()
            throws IOException,
                   AutomationException

Enables a disabled SOM.

Remarks

The Enable method of the IServerObjectAdmin2 interface enables a previously disabled SOM. Using this method on a currently enabled SOM has no effect. Server objects that had been disabled will be immediately available.

Product Availability

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

Specified by:

enable in interface IServerObjectAdmin2

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

disable

public void disable()
             throws IOException,
                    AutomationException

Disables a started SOM.

Remarks

The Disable method of the IServerObjectAdmin2 interface disables a SOM. This prevents further communication with any server objects until the Enable method is called. Diabling a SOM does not remove server objects from RAM. When the SOM is enabled again, the server objects will be immediately available.

Product Availability

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

Specified by:

disable in interface IServerObjectAdmin2

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

createExtensionType

public IServerObjectExtensionType createExtensionType()
                                               throws IOException,
                                                      AutomationException

Creates a new empty server object extension type.

Product Availability

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

Specified by:

createExtensionType in interface IServerObjectAdmin2

Returns:

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

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

addExtensionType

public void addExtensionType(String sOTypeName,
                             IServerObjectExtensionType pSOEType)
                      throws IOException,
                             AutomationException

Registers a new server object extension type with the server object type indicated in the argument list.

Product Availability

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

Specified by:

addExtensionType in interface IServerObjectAdmin2

Parameters:

sOTypeName - The sOTypeName (in)

pSOEType - A reference to a com.esri.arcgis.server.IServerObjectExtensionType (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

deleteExtensionType

public void deleteExtensionType(String sOTypeName,
                                String sOETypeName)
                         throws IOException,
                                AutomationException

Unregisters a server object extension type from the server object type indicated in the argument list.

Product Availability

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

Specified by:

deleteExtensionType in interface IServerObjectAdmin2

Parameters:

sOTypeName - The sOTypeName (in)

sOETypeName - The sOETypeName (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

createFolder

public void createFolder(String folderName)
                  throws IOException,
                         AutomationException

Creates a server configuration folder.

Product Availability

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

Specified by:

createFolder in interface IServerObjectAdmin2

Parameters:

folderName - The folderName (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

deleteFolder

public void deleteFolder(String folderName)
                  throws IOException,
                         AutomationException

Deletes a server configuration folder.

Product Availability

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

Specified by:

deleteFolder in interface IServerObjectAdmin2

Parameters:

folderName - The folderName (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

renameFolder

public void renameFolder(String folderName,
                         String newName)
                  throws IOException,
                         AutomationException

Renames a server configuration folder.

Product Availability

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

Specified by:

renameFolder in interface IServerObjectAdmin2

Parameters:

folderName - The folderName (in)

newName - The newName (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getFolders

public IEnumBSTR getFolders(String folderName)
                     throws IOException,
                            AutomationException

An array of folder names in the server configuration folder.

Product Availability

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

Specified by:

getFolders in interface IServerObjectAdmin2

Parameters:

folderName - The folderName (in)

Returns:

A reference to a com.esri.arcgis.system.IEnumBSTR

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getFolderInfo

public IPropertySet getFolderInfo(String folderName)
                           throws IOException,
                                  AutomationException

Properties associated with a server configuration folder.

Product Availability

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

Specified by:

getFolderInfo in interface IServerObjectAdmin2

Parameters:

folderName - The folderName (in)

Returns:

A reference to a com.esri.arcgis.system.IPropertySet

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setFolderInfo

public void setFolderInfo(String folderName,
                          IPropertySet ppInfo)
                   throws IOException,
                          AutomationException

Properties associated with a server configuration folder.

Product Availability

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

Specified by:

setFolderInfo in interface IServerObjectAdmin2

Parameters:

folderName - The folderName (in)

ppInfo - A reference to a com.esri.arcgis.system.IPropertySet (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getConfigurationsEx

public IEnumServerObjectConfiguration getConfigurationsEx(String folderName)
                                                   throws IOException,
                                                          AutomationException

An enumerator over all the server object configurations in a server configuration folder.

Remarks

GetConfigurationEx returns an enumeration (IEnumServerObjectConfiguration) of IServerObjectConfiguration for configurations of any esriConfigurationStatus from the folder specified.

Some folderNames have special significance:

folderName == “” means “root”.

folderName == “NULL” means “all folders and root”

Product Availability

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

Specified by:

getConfigurationsEx in interface IServerObjectAdmin2

Parameters:

folderName - The folderName (in)

Returns:

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

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

validateConfiguration

public void validateConfiguration(String name,
                                  String typeName)
                           throws IOException,
                                  AutomationException

Validates server object configuration.

Product Availability

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

Specified by:

validateConfiguration in interface IServerObjectAdmin2

Parameters:

name - The name (in)

typeName - The typeName (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.