com.esri.arcgis.system
Interface IServerEnvironment

All Superinterfaces:

Serializable

All Known Subinterfaces:

IServerEnvironment2, IServerEnvironment3

All Known Implementing Classes:

IServerEnvironment2Proxy, IServerEnvironmentProxy

public interface IServerEnvironment
extends Serializable

Provides access to Server configuration information.

Superseded By

IServerEnvironment2

Description

The methods of IServerEnvironment allow access to the ILog interface and the PropertySet of server configuration properties.

Remarks

This interface is primarily used when developing server object extensions. It permits access to an ILog interface which provides a conduit to log messages. It also retrieves the server properties as an IPropertySet interface. This PropertySet can be used to determine various properties, for example, output and input operating system paths, that might be useful to a server object extension programmer.

When To Use

Use this interface to retrieve the server properties and write access to the server logs.

Product Availability

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

Method Summary

String	getCurrentJobID() Retrieves current job ID.
String	getJobDirectory(String jobID) Retrieves job directory for given job.
IJobTracker	getJobTracker() Retrieves IJobTracker interface that provides access to members that track and control execution of jobs.
ILog	getLog() Retrieves an ILog interface that can be used to add logging messages.
IPropertySet	getProperties() Retrieves an IProperySet interface that provides access to the server configuration information.

Method Detail

getLog

ILog getLog()
            throws IOException,
                   AutomationException

Retrieves an ILog interface that can be used to add logging messages.

Product Availability

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

Returns:

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

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getProperties

IPropertySet getProperties()
                           throws IOException,
                                  AutomationException

Retrieves an IProperySet interface that provides access to the server configuration information.

Product Availability

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

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.

getJobTracker

IJobTracker getJobTracker()
                          throws IOException,
                                 AutomationException

Retrieves IJobTracker interface that provides access to members that track and control execution of jobs.

Product Availability

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

Returns:

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

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getJobDirectory

String getJobDirectory(String jobID)
                       throws IOException,
                              AutomationException

Retrieves job directory for given job.

Product Availability

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

Parameters:

jobID - The jobID (in)

Returns:

The pDirPath

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getCurrentJobID

String getCurrentJobID()
                       throws IOException,
                              AutomationException

Retrieves current job ID.

Product Availability

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

Returns:

The pJobID

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.