com.esri.arcgis.trackinganalyst
Class GeneralTrackingConnector

java.lang.Object
  extended by com.esri.arcgis.trackinganalyst.GeneralTrackingConnector
All Implemented Interfaces:
com.esri.arcgis.interop.RemoteObjRef, IServerConnection, IServerConnection2, ITxConnectionMessages, ITxConnectorSetup, ITxDiagnostics, Serializable

public class GeneralTrackingConnector
extends Object
implements com.esri.arcgis.interop.RemoteObjRef, ITxDiagnostics, IServerConnection, IServerConnection2, ITxConnectorSetup, ITxConnectionMessages

Base Class for Tracking Workspace connector objects. This class is aggregated by the Tracking Workspace connector wizard.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

See Also:
Serialized Form

Constructor Summary
GeneralTrackingConnector()
          Constructs a GeneralTrackingConnector using ArcGIS Engine.
GeneralTrackingConnector(Object obj)
          Deprecated. As of ArcGIS 9.2, replaced by normal Java casts.
GeneralTrackingConnector theGeneralTrackingConnector = (GeneralTrackingConnector) obj;
 
Method Summary
 void addDataMessage(IDataMessage piMessage)
          Add a Data Message to the Connectors Queue.
 void addDebugMessage(String bstrMessage)
          Add a Debug Message to the internal Debug log.
 void addMessageDefinition(IDatasetDef piMessageDef)
          Add a message definition to the collection.
 void addTrackingServiceDefinition(ITrackingServiceDef piServiceDef)
          Add a tracking service definition to the collection.
 void connect(String bstrUserName, String bstrPassword)
          Creates connection to the server.
 void disableDataDefinition(String bstrDataDefinitionID)
          Disables data definition for the server connection.
 void disconnect()
          Disconnects connection from the server.
 void enableDataDefinition(String bstrDataDefinitionID)
          Enables data definition for the server connection.
 boolean equals(Object o)
          Compare this object with another
 String getActivityLog()
          Indicates error code value for the last Internet server connection.
static String getClsid()
          getClsid.
 String getConnectionName()
          Indicates the name of the connection to the server.
 IPropSet getConnectionProperties()
          Properties for the server connection.
 int getConnectionStatus()
          The Connection State of the object.
 String getConnectionString()
          Connection string value for the server connection.
 IDatasetDef getDataSetDefinition(String bstrName)
          Gets dataset definition information for the server connection.
 Object getDataSetDefinitionList()
          Lists the dataset definition information for the connection.
 Object getEnabledDataDefinitions()
          Indicates which data definitions are enabled.
 int getErrorCode()
          Error code of the last error.
 String getErrorMessage()
          Message associated with last error / error code.
 int getEventReadyHandle()
          The handle to the event that is signaled when a message is ready to be received.
 int getLastConnectionErrorCode()
          Indicates error code value for the last Internet server connection.
 String getLastConnectionErrorMessage()
          Indicates error code value for the last Internet server connection.
 IMessage getMessage(int nTimeOutInMilliseconds)
          Retrieves a message from the server connection.
 int getMessageCount()
          The count of messages ready to retrieve.
 IPlugin getPlugIn()
          Data link plugin information for the server connection.
 Object getServerActions(boolean bForEditing)
          Actions used on data in the server connection.
 String getServerName()
          Name for the server.
 ITrackingServiceDef getTrackingService(String bstrName)
          Gets tracking service for the server connection.
 Object getTrackingServicesList()
          List of tracking services.
 String getUserName()
          User's login name.
 int hashCode()
          the hashcode for this object
 boolean isConnected()
          Indicates whether the server connection is connected.
 boolean isEnableDataFiltering()
          Indicates whether data filtering is enabled for the connection.
 IMessage nextMessage()
          Retrieves a message from the server connection.
 void removeMessageDef(String bstrMessageDefinitionName)
          Removes a Message Definition from the collection.
 void removeTrackingServiceDef(String bstrServiceName)
          Removes a Tracking Service Definition from the collection.
 void returnDataSetDefinition(IDatasetDef piDataSetDef)
          Returns dataset definition information for the server connection.
 void returnServerActions(boolean bSave, Object piActionCollection)
          Actions used on data in the server connection.
 void returnTrackingService(ITrackingServiceDef piTrackingServiceDef)
          Returns tracking service for the server connection.
 IResponseMessage sendCommand(ICommandMessage piCmdMsg, int nTimeOut)
          Sends a command to the server connection.
 void sendMessage(IMessage piMessage)
          Sends a message through the server connection path.
 void setConnectionName(String pbstrConnectionName)
          Indicates the name of the connection to the server.
 void setConnectionProperties(IPropSet ppiProperties)
          Properties for the server connection.
 void setConnectionStatus(int peConnectionStatus)
          The Connection State of the object.
 void setConnectionString(String pbstrConnectionString)
          Connection string value for the server connection.
 void setEnableDataFiltering(boolean pbvVal)
          Indicates whether data filtering is enabled for the connection.
 void setErrorCode(int pdwLastErrorCode)
          Error code of the last error.
 void setErrorMessage(String pbstrLastErrorMessage)
          Message associated with last error / error code.
 void setParentByRef(Object rhs1)
          Assign the parent object so this interface object can communicate with its parent.
 void setServerName(String pVal)
          Name for the server.
 boolean validateTrackingService(ITrackingServiceDef piServiceDef)
          Validate a tracking service within the tracking service collection.
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait
 
Methods inherited from interface com.esri.arcgis.interop.RemoteObjRef
getJintegraDispatch, release
 

Constructor Detail

GeneralTrackingConnector

public GeneralTrackingConnector()
                         throws IOException,
                                UnknownHostException
Constructs a GeneralTrackingConnector using ArcGIS Engine.

Throws:
IOException - if there are interop problems
UnknownHostException - if there are interop problems

GeneralTrackingConnector

public GeneralTrackingConnector(Object obj)
                         throws IOException
Deprecated. As of ArcGIS 9.2, replaced by normal Java casts.
GeneralTrackingConnector theGeneralTrackingConnector = (GeneralTrackingConnector) obj;

Construct a GeneralTrackingConnector using a reference to such an object returned from ArcGIS Engine or Server. This is semantically equivalent to casting obj to GeneralTrackingConnector.

Parameters:
obj - an object returned from ArcGIS Engine or Server
Throws:
IOException - if there are interop problems
Method Detail

getClsid

public static String getClsid()
getClsid.


equals

public boolean equals(Object o)
Compare this object with another

Overrides:
equals in class Object

hashCode

public int hashCode()
the hashcode for this object

Overrides:
hashCode in class Object

getLastConnectionErrorCode

public int getLastConnectionErrorCode()
                               throws IOException,
                                      AutomationException
Indicates error code value for the last Internet server connection.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
getLastConnectionErrorCode in interface IServerConnection
Specified by:
getLastConnectionErrorCode in interface ITxDiagnostics
Returns:
The pnErrorCode
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getLastConnectionErrorMessage

public String getLastConnectionErrorMessage()
                                     throws IOException,
                                            AutomationException
Indicates error code value for the last Internet server connection.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
getLastConnectionErrorMessage in interface IServerConnection
Specified by:
getLastConnectionErrorMessage in interface ITxDiagnostics
Returns:
The pbstrErrorMessage
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getActivityLog

public String getActivityLog()
                      throws IOException,
                             AutomationException
Indicates error code value for the last Internet server connection.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
getActivityLog in interface ITxDiagnostics
Returns:
The pbstrLog
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

isConnected

public boolean isConnected()
                    throws IOException,
                           AutomationException
Indicates whether the server connection is connected.

Description

This property indicates the connection state to the TMS Server.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
isConnected in interface IServerConnection
Returns:
The pVal
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getServerName

public String getServerName()
                     throws IOException,
                            AutomationException
Name for the server.

Description

This property indicates the current server that we are connected to. If a connection does not exist this property contains an empty string.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
getServerName in interface IServerConnection
Specified by:
getServerName in interface ITxConnectorSetup
Returns:
The pVal
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setServerName

public void setServerName(String pVal)
                   throws IOException,
                          AutomationException
Name for the server.

Description

This property sets the TMS server to connected to. The default of an empty string is localhost

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
setServerName in interface IServerConnection
Parameters:
pVal - The pVal (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getUserName

public String getUserName()
                   throws IOException,
                          AutomationException
User's login name.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
getUserName in interface IServerConnection
Specified by:
getUserName in interface ITxConnectorSetup
Returns:
The pVal
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

isEnableDataFiltering

public boolean isEnableDataFiltering()
                              throws IOException,
                                     AutomationException
Indicates whether data filtering is enabled for the connection.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
isEnableDataFiltering in interface IServerConnection
Returns:
The pbvVal
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setEnableDataFiltering

public void setEnableDataFiltering(boolean pbvVal)
                            throws IOException,
                                   AutomationException
Indicates whether data filtering is enabled for the connection.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
setEnableDataFiltering in interface IServerConnection
Parameters:
pbvVal - The pbvVal (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getDataSetDefinitionList

public Object getDataSetDefinitionList()
                                throws IOException,
                                       AutomationException
Lists the dataset definition information for the connection.

Description

This read only property returns an array of all available datasetdefinitions names. A user can then use the getDataSetDefinition and returnDataSetDefinition methods to retrieve and return the actual object.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
getDataSetDefinitionList in interface IServerConnection
Returns:
A Variant
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getEnabledDataDefinitions

public Object getEnabledDataDefinitions()
                                 throws IOException,
                                        AutomationException
Indicates which data definitions are enabled.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
getEnabledDataDefinitions in interface IServerConnection
Returns:
A Variant
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getConnectionName

public String getConnectionName()
                         throws IOException,
                                AutomationException
Indicates the name of the connection to the server.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
getConnectionName in interface IServerConnection
Returns:
The pbstrConnectionName
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setConnectionName

public void setConnectionName(String pbstrConnectionName)
                       throws IOException,
                              AutomationException
Indicates the name of the connection to the server.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
setConnectionName in interface IServerConnection
Parameters:
pbstrConnectionName - The pbstrConnectionName (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getConnectionString

public String getConnectionString()
                           throws IOException,
                                  AutomationException
Connection string value for the server connection.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
getConnectionString in interface IServerConnection
Specified by:
getConnectionString in interface ITxConnectorSetup
Returns:
The pbstrConnectionString
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setConnectionString

public void setConnectionString(String pbstrConnectionString)
                         throws IOException,
                                AutomationException
Connection string value for the server connection.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
setConnectionString in interface IServerConnection
Parameters:
pbstrConnectionString - The pbstrConnectionString (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

connect

public void connect(String bstrUserName,
                    String bstrPassword)
             throws IOException,
                    AutomationException
Creates connection to the server.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
connect in interface IServerConnection
Parameters:
bstrUserName - The bstrUserName (in)
bstrPassword - The bstrPassword (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

disconnect

public void disconnect()
                throws IOException,
                       AutomationException
Disconnects connection from the server.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
disconnect in interface IServerConnection
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

sendMessage

public void sendMessage(IMessage piMessage)
                 throws IOException,
                        AutomationException
Sends a message through the server connection path.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
sendMessage in interface IServerConnection
Parameters:
piMessage - A reference to a com.esri.arcgis.trackinganalyst.IMessage (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getMessage

public IMessage getMessage(int nTimeOutInMilliseconds)
                    throws IOException,
                           AutomationException
Retrieves a message from the server connection.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
getMessage in interface IServerConnection
Parameters:
nTimeOutInMilliseconds - The nTimeOutInMilliseconds (in)
Returns:
A reference to a com.esri.arcgis.trackinganalyst.IMessage
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

enableDataDefinition

public void enableDataDefinition(String bstrDataDefinitionID)
                          throws IOException,
                                 AutomationException
Enables data definition for the server connection.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
enableDataDefinition in interface IServerConnection
Parameters:
bstrDataDefinitionID - The bstrDataDefinitionID (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

disableDataDefinition

public void disableDataDefinition(String bstrDataDefinitionID)
                           throws IOException,
                                  AutomationException
Disables data definition for the server connection.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
disableDataDefinition in interface IServerConnection
Parameters:
bstrDataDefinitionID - The bstrDataDefinitionID (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

returnDataSetDefinition

public void returnDataSetDefinition(IDatasetDef piDataSetDef)
                             throws IOException,
                                    AutomationException
Returns dataset definition information for the server connection.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
returnDataSetDefinition in interface IServerConnection
Parameters:
piDataSetDef - A reference to a com.esri.arcgis.trackinganalyst.IDatasetDef (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getDataSetDefinition

public IDatasetDef getDataSetDefinition(String bstrName)
                                 throws IOException,
                                        AutomationException
Gets dataset definition information for the server connection.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
getDataSetDefinition in interface IServerConnection
Parameters:
bstrName - The bstrName (in)
Returns:
A reference to a com.esri.arcgis.trackinganalyst.IDatasetDef
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

sendCommand

public IResponseMessage sendCommand(ICommandMessage piCmdMsg,
                                    int nTimeOut)
                             throws IOException,
                                    AutomationException
Sends a command to the server connection.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
sendCommand in interface IServerConnection
Parameters:
piCmdMsg - A reference to a com.esri.arcgis.trackinganalyst.ICommandMessage (in)
nTimeOut - The nTimeOut (in)
Returns:
A reference to a com.esri.arcgis.trackinganalyst.IResponseMessage
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getConnectionProperties

public IPropSet getConnectionProperties()
                                 throws IOException,
                                        AutomationException
Properties for the server connection.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
getConnectionProperties in interface IServerConnection2
Returns:
A reference to a com.esri.arcgis.trackinganalyst.IPropSet
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setConnectionProperties

public void setConnectionProperties(IPropSet ppiProperties)
                             throws IOException,
                                    AutomationException
Properties for the server connection.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
setConnectionProperties in interface IServerConnection2
Parameters:
ppiProperties - A reference to a com.esri.arcgis.trackinganalyst.IPropSet (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getPlugIn

public IPlugin getPlugIn()
                  throws IOException,
                         AutomationException
Data link plugin information for the server connection.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
getPlugIn in interface IServerConnection2
Returns:
A reference to a com.esri.arcgis.trackinganalyst.IPlugin
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getTrackingServicesList

public Object getTrackingServicesList()
                               throws IOException,
                                      AutomationException
List of tracking services.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
getTrackingServicesList in interface IServerConnection2
Returns:
A Variant
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getTrackingService

public ITrackingServiceDef getTrackingService(String bstrName)
                                       throws IOException,
                                              AutomationException
Gets tracking service for the server connection.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
getTrackingService in interface IServerConnection2
Parameters:
bstrName - The bstrName (in)
Returns:
A reference to a com.esri.arcgis.trackinganalyst.ITrackingServiceDef
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

returnTrackingService

public void returnTrackingService(ITrackingServiceDef piTrackingServiceDef)
                           throws IOException,
                                  AutomationException
Returns tracking service for the server connection.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
returnTrackingService in interface IServerConnection2
Parameters:
piTrackingServiceDef - A reference to a com.esri.arcgis.trackinganalyst.ITrackingServiceDef (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getServerActions

public Object getServerActions(boolean bForEditing)
                        throws IOException,
                               AutomationException
Actions used on data in the server connection.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
getServerActions in interface IServerConnection2
Parameters:
bForEditing - The bForEditing (in)
Returns:
A reference to another Object (IUnknown)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

returnServerActions

public void returnServerActions(boolean bSave,
                                Object piActionCollection)
                         throws IOException,
                                AutomationException
Actions used on data in the server connection.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
returnServerActions in interface IServerConnection2
Parameters:
bSave - The bSave (in)
piActionCollection - A reference to another Object (IUnknown) (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

addMessageDefinition

public void addMessageDefinition(IDatasetDef piMessageDef)
                          throws IOException,
                                 AutomationException
Add a message definition to the collection.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
addMessageDefinition in interface ITxConnectorSetup
Parameters:
piMessageDef - A reference to a com.esri.arcgis.trackinganalyst.IDatasetDef (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

addTrackingServiceDefinition

public void addTrackingServiceDefinition(ITrackingServiceDef piServiceDef)
                                  throws IOException,
                                         AutomationException
Add a tracking service definition to the collection.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
addTrackingServiceDefinition in interface ITxConnectorSetup
Parameters:
piServiceDef - A reference to a com.esri.arcgis.trackinganalyst.ITrackingServiceDef (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

validateTrackingService

public boolean validateTrackingService(ITrackingServiceDef piServiceDef)
                                throws IOException,
                                       AutomationException
Validate a tracking service within the tracking service collection.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
validateTrackingService in interface ITxConnectorSetup
Parameters:
piServiceDef - A reference to a com.esri.arcgis.trackinganalyst.ITrackingServiceDef (in)
Returns:
The pbvarValid
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

removeTrackingServiceDef

public void removeTrackingServiceDef(String bstrServiceName)
                              throws IOException,
                                     AutomationException
Removes a Tracking Service Definition from the collection. A * will remove all Tracking Services.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
removeTrackingServiceDef in interface ITxConnectorSetup
Parameters:
bstrServiceName - The bstrServiceName (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

removeMessageDef

public void removeMessageDef(String bstrMessageDefinitionName)
                      throws IOException,
                             AutomationException
Removes a Message Definition from the collection. A * will remove all Message definitions.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
removeMessageDef in interface ITxConnectorSetup
Parameters:
bstrMessageDefinitionName - The bstrMessageDefinitionName (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

addDebugMessage

public void addDebugMessage(String bstrMessage)
                     throws IOException,
                            AutomationException
Add a Debug Message to the internal Debug log.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
addDebugMessage in interface ITxConnectorSetup
Parameters:
bstrMessage - The bstrMessage (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

addDataMessage

public void addDataMessage(IDataMessage piMessage)
                    throws IOException,
                           AutomationException
Add a Data Message to the Connectors Queue.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
addDataMessage in interface ITxConnectorSetup
Parameters:
piMessage - A reference to a com.esri.arcgis.trackinganalyst.IDataMessage (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getConnectionStatus

public int getConnectionStatus()
                        throws IOException,
                               AutomationException
The Connection State of the object.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
getConnectionStatus in interface ITxConnectorSetup
Returns:
A com.esri.arcgis.trackinganalyst.enumConnectionStatus constant
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setConnectionStatus

public void setConnectionStatus(int peConnectionStatus)
                         throws IOException,
                                AutomationException
The Connection State of the object.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
setConnectionStatus in interface ITxConnectorSetup
Parameters:
peConnectionStatus - A com.esri.arcgis.trackinganalyst.enumConnectionStatus constant (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getErrorCode

public int getErrorCode()
                 throws IOException,
                        AutomationException
Error code of the last error.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
getErrorCode in interface ITxConnectorSetup
Returns:
The pdwLastErrorCode
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setErrorCode

public void setErrorCode(int pdwLastErrorCode)
                  throws IOException,
                         AutomationException
Error code of the last error.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
setErrorCode in interface ITxConnectorSetup
Parameters:
pdwLastErrorCode - The pdwLastErrorCode (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getErrorMessage

public String getErrorMessage()
                       throws IOException,
                              AutomationException
Message associated with last error / error code.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
getErrorMessage in interface ITxConnectorSetup
Returns:
The pbstrLastErrorMessage
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setErrorMessage

public void setErrorMessage(String pbstrLastErrorMessage)
                     throws IOException,
                            AutomationException
Message associated with last error / error code.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
setErrorMessage in interface ITxConnectorSetup
Parameters:
pbstrLastErrorMessage - The pbstrLastErrorMessage (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setParentByRef

public void setParentByRef(Object rhs1)
                    throws IOException,
                           AutomationException
Assign the parent object so this interface object can communicate with its parent.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
setParentByRef in interface ITxConnectorSetup
Parameters:
rhs1 - A reference to another Object (IUnknown) (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getMessageCount

public int getMessageCount()
                    throws IOException,
                           AutomationException
The count of messages ready to retrieve.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
getMessageCount in interface ITxConnectionMessages
Returns:
The plNumberOfMessages
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getEventReadyHandle

public int getEventReadyHandle()
                        throws IOException,
                               AutomationException
The handle to the event that is signaled when a message is ready to be received.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
getEventReadyHandle in interface ITxConnectionMessages
Returns:
The phReadyEvent (A COM typedef)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

nextMessage

public IMessage nextMessage()
                     throws IOException,
                            AutomationException
Retrieves a message from the server connection.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
nextMessage in interface ITxConnectionMessages
Returns:
A reference to a com.esri.arcgis.trackinganalyst.IMessage
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.