com.esri.arcgis.server
Class IServerObjectAdmin2Proxy

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

Get ArcGIS Server configuration information:

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.