--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/testexecmgmt/ucc/Source/DynamicsCommandWrapper/CDynamicsCommand.cpp	Mon Mar 08 15:04:18 2010 +0800
@@ -0,0 +1,1408 @@
+/*
+* Copyright (c) 2005-2009 Nokia Corporation and/or its subsidiary(-ies).
+* All rights reserved.
+* This component and the accompanying materials are made available
+* under the terms of "Eclipse Public License v1.0"
+* which accompanies this distribution, and is available
+* at the URL "http://www.eclipse.org/legal/epl-v10.html".
+*
+* Initial Contributors:
+* Nokia Corporation - initial contribution.
+*
+* Contributors:
+*
+* Description:  
+* System Includes
+*
+*/
+
+
+
+#include <stdio.h>
+#include <assert.h>
+#include <string.h>
+#include <ctype.h>
+#ifndef WIN32
+#include <sys/socket.h>
+#include <netinet/in.h>
+#include <arpa/inet.h>
+#else
+#include <winsock2.h>
+#endif
+#include <stdlib.h>
+
+
+/****************************************************************************************
+ * 
+ * Local Includes
+ * 
+ ***************************************************************************************/
+#include "CDynamicsCommand.h"
+#include "../include/standard_unix.h"
+#include "../ProcessLibrary/proclib.h"
+#include "../include/strncpynt.h"
+
+
+/****************************************************************************************
+ * 
+ * Definitions
+ * 
+ ***************************************************************************************/
+#define HOME_AGENT_TOOL				"./dynha_tool"
+#define FOREIGN_AGENT_TOOL			"./dynfa_tool"
+#define MOBILE_NODE_AGENT_TOOL		        "./dynmn_tool"
+
+#define CALL_FAILED_PREFIX			"Call failed: "
+#define INVALID_ARGUMENTS_PREFIX	        "Invalid arguments. "
+#define CSH_FAILED_PREFIX                       "csh: "
+#define TARGET_NOT_FOUND                        "No such file" 
+#define FOREIGN_AGENT_DESTROY_TUNNEL_PREFIX     "Destroyed tunnel"
+#define MOBILE_AGENT_FOREIGN_AGENT_LIST_PREFIX  "List of heard mobility agents:"
+#define MOBILE_NODE_AGENT_SETPOLICY_PREFIX      "Set policy succeeded."
+#define MOBILE_NODE_AGENT_CONNECT_PREFIX        "Connect success."
+#define MOBILE_NODE_AGENT_DISCONNECT_PREFIX     "Disconnected"
+#define MOBILE_NODE_AGENT_CONFIRM_PREFIX        "Confirmed."
+#define CALL_FAILED_FUNCTION_NOT_PERMITTED      "function not permitted"
+#define CALL_FAILED_AGENT_UNREACHABLE           "agent unreachable"
+
+#define TOKENSIZE                               256
+#define MAX_TIMEOUT			        120000
+#define MIN_TIMEOUT				1
+
+
+/****************************************************************************************
+ * 
+ * Macro Functions
+ * 
+ ***************************************************************************************/
+#define IS_WHITESPACE(c)  (((c) == ' ')||((c) == '\t'))
+#define MIN(x,y)          (((x) < (y)) ? (x) : (y))
+
+
+/****************************************************************************************
+ * 
+ * File-scope static variables
+ * 
+ ***************************************************************************************/
+char *iTunnelModeString[] = { "no tunnel", "full tunnel", "triangle tunnel", "full tunnel direct to HA", NULL };
+char *iPolicyString[] = { "Early-expire", "Newest-FA", "Eager-switching", "Newest-ADV", NULL };
+
+
+/****************************************************************************************
+ * 
+ * PUBLIC METHOD: General
+ * 
+ ***************************************************************************************/
+CDynamicsCommand::CDynamicsCommand()
+{
+	iTimeout = MAX_TIMEOUT;
+}
+
+
+CDynamicsCommand::~CDynamicsCommand()
+{
+}
+
+
+void CDynamicsCommand::SetPipePath( string aPipePath )
+{
+	iPipePath = aPipePath;
+}
+
+
+void CDynamicsCommand::SetTimeout( int aTimeout )
+{
+	if( (aTimeout >= MIN_TIMEOUT) && (aTimeout <= MAX_TIMEOUT) ) {
+		iTimeout = aTimeout;
+	}
+}
+
+
+/****************************************************************************************
+ * 
+ * PUBLIC METHOD: ForeignAgentGetStatus
+ * 
+ ***************************************************************************************/
+TDynamicsCallInfo CDynamicsCommand::ForeignAgentGetStatus( TForeignAgentStatusInfo *aForeignAgentInfo )
+{
+  TDynamicsCallInfo rv;
+  string standard_output, standard_error;
+  int res = 0;
+
+  // check params
+  assert( aForeignAgentInfo != NULL );
+  
+  // run the dynamics command line 
+  rv = DynamicsCall( FOREIGN_AGENT_TOOL, "status", NULL, &standard_output, &standard_error );
+  if( rv.iResult != DC_SUCCESS ) {
+    return rv;
+  }
+
+  // parse the output 
+  res |= GetIntegerEntry( standard_output.c_str(), "tunnels", &(aForeignAgentInfo->iTunnelCount) );
+  res |= GetIntegerEntry( standard_output.c_str(), "pending reg.req.", &(aForeignAgentInfo->iPendingRegistrationRequests) );
+  res |= GetIntegerEntry( standard_output.c_str(), "request rejected", &(aForeignAgentInfo->iRequestsRejected) );
+  res |= GetIntegerEntry( standard_output.c_str(), "request accepted", &(aForeignAgentInfo->iRequestsAccepted) );
+  res |= GetIntegerEntry( standard_output.c_str(), "reply accepted", &(aForeignAgentInfo->iReplysAccepted) );
+  res |= GetIntegerEntry( standard_output.c_str(), "reply rejected", &(aForeignAgentInfo->iReplysRejected) );
+  res |= GetIntegerEntry( standard_output.c_str(), "discard(unk. ext)", &(aForeignAgentInfo->iDiscardedUnknownExtension) );
+  res |= GetIntegerEntry( standard_output.c_str(), "discard(malformed)", &(aForeignAgentInfo->iDiscardedMalformed) );
+  res |= GetIntegerEntry( standard_output.c_str(), "discard(vendor)", &(aForeignAgentInfo->iDiscardedVendor) );
+  res |= GetIntegerEntry( standard_output.c_str(), "advertisement sent", &(aForeignAgentInfo->iAdvertisementsSent) );
+  
+  // check for errors
+  if( res != 0 ) {
+    rv.iResult = DC_UNEXPECTED_OUTPUT;
+  }
+  
+  // done
+  return rv;
+}
+
+
+/****************************************************************************************
+ * 
+ * PUBLIC METHOD: ForeignAgentDestroyTunnel
+ * 
+ ***************************************************************************************/
+TDynamicsCallInfo CDynamicsCommand::ForeignAgentDestroyTunnel( unsigned int aMobileNodeAddress )
+{
+  TDynamicsCallInfo rv;
+  int match;
+  string standard_output, standard_error;
+  char *mnaddr;
+  struct in_addr iaddr;
+  char params[MAXCOMMANDLINE];
+ 
+  // create the params string
+  iaddr.ADDRESS_INTEGER = aMobileNodeAddress;
+  mnaddr = inet_ntoa( iaddr );
+  snprintf( params, MAXCOMMANDLINE, "%s", mnaddr );
+
+  // run the dynamics command line 
+  rv = DynamicsCall( FOREIGN_AGENT_TOOL, "destroy", params, &standard_output, &standard_error );
+  if( rv.iResult != DC_SUCCESS ) {
+    return rv;
+  }
+
+  // check for success - otherwise give general error
+  match = strncmp( FOREIGN_AGENT_DESTROY_TUNNEL_PREFIX, standard_output.c_str(), strlen(FOREIGN_AGENT_DESTROY_TUNNEL_PREFIX) );
+  if( match != 0 ) {
+    rv.iResult = DC_UNEXPECTED_OUTPUT;
+  }
+  return rv;
+}
+
+
+/****************************************************************************************
+ * 
+ * PUBLIC METHOD: ForeignAgentGetTunnels
+ * 
+ ***************************************************************************************/
+TDynamicsCallInfo CDynamicsCommand::ForeignAgentGetTunnels( int *aTunnelCount, TTunnelID *aTunnelIDArray )
+{
+  TDynamicsCallInfo rv;
+  string standard_output, standard_error;
+  int list_size;
+
+  // check the params
+  assert( aTunnelCount != NULL );
+  assert( aTunnelIDArray != NULL );
+  list_size = *aTunnelCount;
+  *aTunnelCount = 0;
+
+  // run the dynamics command line 
+  rv = DynamicsCall( FOREIGN_AGENT_TOOL, "list", NULL, &standard_output, &standard_error );
+  if( rv.iResult != DC_SUCCESS ) {
+    return rv;
+  }
+
+  // parse the output and return
+  rv =  ParseForeignAgentListOutput( standard_output, list_size, aTunnelIDArray, aTunnelCount );
+  return rv;
+}
+
+
+/****************************************************************************************
+ * 
+ * PUBLIC METHOD: ForeignAgentGetTunnelInfo
+ * 
+ ***************************************************************************************/
+TDynamicsCallInfo CDynamicsCommand::ForeignAgentGetTunnelInfo( unsigned int aMobileNodeAddress, TForeignAgentTunnelInfo *aTunnelInfo )
+{
+  TDynamicsCallInfo rv;
+  string standard_output, standard_error;
+  int res = 0;
+  char params[MAXCOMMANDLINE];
+  struct in_addr mobile_node_address;
+
+  // check params
+  assert( aTunnelInfo != NULL );
+
+  // write the params
+  mobile_node_address.ADDRESS_INTEGER = aMobileNodeAddress;
+  snprintf( params, MAXCOMMANDLINE, " %s", inet_ntoa(mobile_node_address) );
+
+  // run the dynamics command line 
+  rv = DynamicsCall( FOREIGN_AGENT_TOOL, "show", params, &standard_output, &standard_error );
+  if( rv.iResult != DC_SUCCESS ) {
+    return rv;
+  }
+
+  // parse the output 
+  res |= GetAddressEntry( standard_output.c_str(), "mobile addr", &(aTunnelInfo->iMobileNodeAddress) );
+  res |= GetAddressEntry( standard_output.c_str(), "care-of addr", &(aTunnelInfo->iCareofAddress) );
+  res |= GetAddressEntry( standard_output.c_str(), "home agent addr", &(aTunnelInfo->iHomeAgentAddress) );
+  res |= GetIntegerEntry( standard_output.c_str(), "private HA id", &(aTunnelInfo->iPrivateHomeAgentID) );
+  res |= GetDateEntry( standard_output.c_str(), "creation time", &(aTunnelInfo->iCreationTime) );
+  res |= GetDateEntry( standard_output.c_str(), "expiration time", &(aTunnelInfo->iExpirationTime) );
+  res |= GetDateEntry( standard_output.c_str(), "refresh time", &(aTunnelInfo->iRefreshTime) );
+  res |= GetDateEntry( standard_output.c_str(), "last timestamp", &(aTunnelInfo->iLastTimestamp) );
+  res |= GetIntegerEntry( standard_output.c_str(), "SPI", &(aTunnelInfo->iSPI) );
+  res |= GetIntegerEntry( standard_output.c_str(), "timeout", &(aTunnelInfo->iTimeout) );
+  
+  // check for errors
+  if( res != 0 ) {
+    rv.iResult = DC_UNEXPECTED_OUTPUT;
+  }
+  
+  // done
+  return rv;
+}
+
+
+/****************************************************************************************
+ * 
+ * PUBLIC METHOD: HomeAgentGetStatus
+ * 
+ ***************************************************************************************/
+TDynamicsCallInfo CDynamicsCommand::HomeAgentGetStatus( THomeAgentStatusInfo *aHomeAgentInfo )
+{
+  TDynamicsCallInfo rv;
+  string standard_output, standard_error;
+  int res = 0;
+
+  // check params
+  assert( aHomeAgentInfo != NULL );
+  
+  // run the dynamics command line 
+  rv = DynamicsCall( HOME_AGENT_TOOL, "status", NULL, &standard_output, &standard_error );
+  if( rv.iResult != DC_SUCCESS ) {
+    return rv;
+  }
+
+  // parse the output 
+  res |= GetIntegerEntry( standard_output.c_str(), "tunnels", &(aHomeAgentInfo->iTunnelCount) );
+  res |= GetIntegerEntry( standard_output.c_str(), "request rejected", &(aHomeAgentInfo->iRequestsRejected) );
+  res |= GetIntegerEntry( standard_output.c_str(), "request accepted", &(aHomeAgentInfo->iRequestsAccepted) );
+  res |= GetIntegerEntry( standard_output.c_str(), "discard(unk. ext)", &(aHomeAgentInfo->iDiscardedUnknownExtension) );
+  res |= GetIntegerEntry( standard_output.c_str(), "discard(malformed)", &(aHomeAgentInfo->iDiscardedMalformed) );
+  res |= GetIntegerEntry( standard_output.c_str(), "discard(vendor)", &(aHomeAgentInfo->iDiscardedVendor) );
+  res |= GetIntegerEntry( standard_output.c_str(), "advertisement sent", &(aHomeAgentInfo->iAdvertisementsSent) );
+  
+  // check for errors
+  if( res != 0 ) {
+    rv.iResult = DC_UNEXPECTED_OUTPUT;
+  }
+  
+  // done
+  return rv;
+}
+
+
+/****************************************************************************************
+ * 
+ * PUBLIC METHOD: HomeAgentDestroyTunnel
+ * 
+ ***************************************************************************************/
+TDynamicsCallInfo CDynamicsCommand::HomeAgentDestroyTunnel( unsigned int aMobileNodeAddress, unsigned int aHomeAgentAddress, 
+							    int aTunnelID )
+{
+  TDynamicsCallInfo rv;
+  int match;
+  string standard_output, standard_error;
+  char *mnaddr;
+  struct in_addr iaddr;
+  char params[MAXCOMMANDLINE];
+
+  // create the params string
+  iaddr.ADDRESS_INTEGER = aMobileNodeAddress;
+  mnaddr = inet_ntoa( iaddr );
+  snprintf( params, MAXCOMMANDLINE, "%s", mnaddr );
+
+  // run the dynamics command line 
+  rv = DynamicsCall( HOME_AGENT_TOOL, "destroy", params, &standard_output, &standard_error );
+  if( rv.iResult != DC_SUCCESS ) {
+    return rv;
+  }
+
+  // check for success - otherwise give general error
+  match = strncmp( FOREIGN_AGENT_DESTROY_TUNNEL_PREFIX, standard_output.c_str(), strlen(FOREIGN_AGENT_DESTROY_TUNNEL_PREFIX) );
+  if( match != 0 ) {
+    rv.iResult = DC_UNEXPECTED_OUTPUT;
+  }
+  return rv;
+}
+
+
+/****************************************************************************************
+ * 
+ * PUBLIC METHOD: HomeAgentGetTunnels
+ * 
+ ***************************************************************************************/
+TDynamicsCallInfo CDynamicsCommand::HomeAgentGetTunnels( int *aTunnelCount, unsigned int *aMobileNodeAddresses )
+{
+  TDynamicsCallInfo rv;
+  string standard_output, standard_error;
+  int list_size;
+
+  // check the params
+  assert( aTunnelCount != NULL );
+  assert( aMobileNodeAddresses != NULL );
+  list_size = *aTunnelCount;
+  *aTunnelCount = 0;
+
+  // run the dynamics command line 
+  rv = DynamicsCall( HOME_AGENT_TOOL, "list", NULL, &standard_output, &standard_error );
+  if( rv.iResult != DC_SUCCESS ) {
+    return rv;
+  }
+
+  // parse the output and return
+  rv =  ParseHomeAgentListOutput( standard_output, list_size, aMobileNodeAddresses, aTunnelCount );
+  return rv;
+}
+
+
+/****************************************************************************************
+ * 
+ * PUBLIC METHOD: HomeAgentGetTunnelInfo
+ * 
+ ***************************************************************************************/
+TDynamicsCallInfo CDynamicsCommand::HomeAgentGetTunnelInfo( unsigned int aMobileNodeAddress, THomeAgentTunnelInfo *aTunnelInfo )
+{
+  TDynamicsCallInfo rv;
+  string standard_output, standard_error;
+  int res = 0;
+  char params[MAXCOMMANDLINE];
+  struct in_addr mobile_node_address;
+
+  // check params
+  assert( aTunnelInfo != NULL );
+
+  // write the params
+  mobile_node_address.ADDRESS_INTEGER = aMobileNodeAddress;
+  snprintf( params, MAXCOMMANDLINE, " %s", inet_ntoa(mobile_node_address) );
+
+  // run the dynamics command line 
+  rv = DynamicsCall( HOME_AGENT_TOOL, "show", params, &standard_output, &standard_error );
+  if( rv.iResult != DC_SUCCESS ) {
+    return rv;
+  }
+
+  // parse the output   
+  res |= GetAddressEntry( standard_output.c_str(), "mobile addr", &(aTunnelInfo->iMobileNodeAddress) );
+  res |= GetAddressEntry( standard_output.c_str(), "care-of addr", &(aTunnelInfo->iCareofAddress) );
+  res |= GetAddressEntry( standard_output.c_str(), "home agent addr", &(aTunnelInfo->iHomeAgentAddress) );
+  res |= GetDateEntry( standard_output.c_str(), "creation time", &(aTunnelInfo->iCreationTime) );
+  res |= GetDateEntry( standard_output.c_str(), "expiration time", &(aTunnelInfo->iExpirationTime) );
+  res |= GetDateEntry( standard_output.c_str(), "refresh time", &(aTunnelInfo->iRefreshTime) );
+  res |= GetDateEntry( standard_output.c_str(), "last timestamp", &(aTunnelInfo->iLastTimestamp) );
+  res |= GetIntegerEntry( standard_output.c_str(), "SPI", &(aTunnelInfo->iSPI) );
+  res |= GetIntegerEntry( standard_output.c_str(), "timeout", &(aTunnelInfo->iTimeout) );
+  
+  // check for errors
+  if( res != 0 ) {
+    rv.iResult = DC_UNEXPECTED_OUTPUT;
+  }
+  
+  // done
+  return rv;
+}
+
+
+/****************************************************************************************
+ * 
+ * PUBLIC METHOD: MobileNodeAgentGetCareofAddress
+ * 
+ ***************************************************************************************/
+TDynamicsCallInfo CDynamicsCommand::MobileNodeAgentGetCareofAddress( struct in_addr *aCareofAddress )
+{
+  TDynamicsCallInfo rv;
+  string standard_output, standard_error;
+  int res = 0;
+  unsigned int addr;
+
+  // check params
+  assert( aCareofAddress != NULL );
+
+  // run the dynamics command line 
+  rv = DynamicsCall( MOBILE_NODE_AGENT_TOOL, "careof", NULL, &standard_output, &standard_error );
+  if( rv.iResult != DC_SUCCESS ) {
+    return rv;
+  }
+
+  // parse the output   
+  res = GetAddressEntry( standard_output.c_str(), "Care-of address:", &addr );
+  if( res != 0 ) {
+    rv.iResult = DC_UNEXPECTED_OUTPUT;
+  }
+  aCareofAddress->s_addr = addr;
+  return rv;
+}
+
+
+/****************************************************************************************
+ * 
+ * PUBLIC METHOD: MobileNodeAgentGetStatus
+ * 
+ ***************************************************************************************/
+TDynamicsCallInfo CDynamicsCommand::MobileNodeAgentGetStatus( TMobileNodeAgentStatusInfo *aMobileNodeAgentInfo )
+{
+  TDynamicsCallInfo rv;
+  string standard_output, standard_error;
+  int res = 0;
+  char buff[MAXCOMMANDLINE];
+  // check params
+  assert( aMobileNodeAgentInfo != NULL );
+  
+  // run the dynamics command line 
+  rv = DynamicsCall( MOBILE_NODE_AGENT_TOOL, "status", NULL, &standard_output, &standard_error );
+  if( rv.iResult != DC_SUCCESS ) {
+    return rv;
+  }
+
+  // parse the output 
+  res |= GetStringEntry( standard_output.c_str(), "state", buff, MAXCOMMANDLINE );
+  res |= CheckMatchAsBoolean( buff, "Connected", &(aMobileNodeAgentInfo->iConnected) );
+  res |= GetStringEntry( standard_output.c_str(), "tunnel is", buff, MAXCOMMANDLINE );
+  res |= CheckMatchAsBoolean( buff, "up", &(aMobileNodeAgentInfo->iTunnelUp) );
+  res |= GetAddressEntry( standard_output.c_str(), "local addr", &(aMobileNodeAgentInfo->iLocalAddress) );
+  res |= GetAddressEntry( standard_output.c_str(), "co-addr", &(aMobileNodeAgentInfo->iColocatedAddress) );
+  res |= GetAddressEntry( standard_output.c_str(), "FA-addr", &(aMobileNodeAgentInfo->iForeignAgentAddress) );
+  res |= GetAddressEntry( standard_output.c_str(), "HA-addr", &(aMobileNodeAgentInfo->iHomeAgentAddress) );
+  res |= GetAddressEntry( standard_output.c_str(), "Home addr", &(aMobileNodeAgentInfo->iHomeAddress) );
+  res |= GetStringEntry( standard_output.c_str(), "info text", aMobileNodeAgentInfo->iInfoText, MAXINFOLEN );
+  res |= GetStringEntry( standard_output.c_str(), "tunneling mode", buff, MAXCOMMANDLINE );
+  res |= ConvertTunnelStringToInteger( buff, &(aMobileNodeAgentInfo->iTunnelMode) );
+
+  // the following are optional - they only appear in the output when we have a connection
+  GetStringEntry( standard_output.c_str(), "last warning", aMobileNodeAgentInfo->iLastErrorString, MAXERRORSTRING );
+  GetIntegerEntry( standard_output.c_str(), "reply code", &(aMobileNodeAgentInfo->iReplyCode) );
+  GetIntegerEntry( standard_output.c_str(), "lifetime left", &(aMobileNodeAgentInfo->iLifetimeRemaining) );
+  GetIntegerEntry( standard_output.c_str(), "last request", &(aMobileNodeAgentInfo->iSecondsSinceLastRequest) );
+  GetIntegerEntry( standard_output.c_str(), "last reply", &(aMobileNodeAgentInfo->iSecondsSinceLastReply) );
+  
+  // check for errors
+  if( res != 0 ) {
+    rv.iResult = DC_UNEXPECTED_OUTPUT;
+  }
+  
+  // done
+  return rv;
+}
+
+
+/****************************************************************************************
+ * 
+ * PUBLIC METHOD: MobileNodeAgentConnect
+ * 
+ ***************************************************************************************/
+TDynamicsCallInfo CDynamicsCommand::MobileNodeAgentConnect()
+{
+  TDynamicsCallInfo rv;
+  string standard_output, standard_error;
+  int match;
+
+  // run the dynamics command line 
+  rv = DynamicsCall( MOBILE_NODE_AGENT_TOOL, "connect", NULL, &standard_output, &standard_error );
+  if( rv.iResult != DC_SUCCESS ) {
+    return rv;
+  }
+
+  // check output
+  match = strncmp( MOBILE_NODE_AGENT_CONNECT_PREFIX, standard_output.c_str(), strlen(MOBILE_NODE_AGENT_CONNECT_PREFIX) );
+  if( match != 0 ) {
+    rv.iResult = DC_UNEXPECTED_OUTPUT;
+    STRNCPY_NULL_TERMINATE( rv.iDynamicsErrorString, standard_output.c_str(), MAXIMUMERRORSTRINGLENGTH );
+  }
+  return rv;
+}
+
+
+/****************************************************************************************
+ * 
+ * PUBLIC METHOD: MobileNodeAgentDisconnect
+ * 
+ ***************************************************************************************/
+TDynamicsCallInfo CDynamicsCommand::MobileNodeAgentDisconnect()
+{
+  TDynamicsCallInfo rv;
+  string standard_output, standard_error;
+  int match;
+
+  // run the dynamics command line 
+  rv = DynamicsCall( MOBILE_NODE_AGENT_TOOL, "disconnect", NULL, &standard_output, &standard_error );
+  if( rv.iResult != DC_SUCCESS ) {
+    return rv;
+  }
+
+  // check output
+  match = strncmp( MOBILE_NODE_AGENT_DISCONNECT_PREFIX, standard_output.c_str(), strlen(MOBILE_NODE_AGENT_DISCONNECT_PREFIX) );
+  if( match != 0 ) {
+    rv.iResult = DC_UNEXPECTED_OUTPUT;
+  }
+  return rv;
+}
+
+
+/****************************************************************************************
+ * 
+ * PUBLIC METHOD: MobileNodeAgentConfirm
+ * 
+ ***************************************************************************************/
+TDynamicsCallInfo CDynamicsCommand::MobileNodeAgentConfirm()
+{
+  TDynamicsCallInfo rv;
+  string standard_output, standard_error;
+  int match;
+
+  // run the dynamics command line 
+  rv = DynamicsCall( MOBILE_NODE_AGENT_TOOL, "confirm", NULL, &standard_output, &standard_error );
+  if( rv.iResult != DC_SUCCESS ) {
+    return rv;
+  }
+
+  // check output
+  match = strncmp( MOBILE_NODE_AGENT_CONFIRM_PREFIX, standard_output.c_str(), strlen(MOBILE_NODE_AGENT_CONFIRM_PREFIX) );
+  if( match != 0 ) {
+    rv.iResult = DC_UNEXPECTED_OUTPUT;
+  }
+  return rv;
+}
+
+
+/****************************************************************************************
+ * 
+ * PUBLIC METHOD: MobileNodeAgentRescan
+ * 
+ ***************************************************************************************/
+TDynamicsCallInfo CDynamicsCommand::MobileNodeAgentRescan()
+{
+  TDynamicsCallInfo rv;
+  string standard_output, standard_error;
+
+  // run the dynamics command line 
+  rv = DynamicsCall( MOBILE_NODE_AGENT_TOOL, "rescan", NULL, &standard_output, &standard_error );
+  if( rv.iResult != DC_SUCCESS ) {
+    return rv;
+  }
+  return rv;
+}
+
+
+/****************************************************************************************
+ * 
+ * PUBLIC METHOD: MobileNodeAgentSetPolicy
+ * 
+ ***************************************************************************************/
+TDynamicsCallInfo CDynamicsCommand::MobileNodeAgentSetPolicy( int aPolicyVector )
+{
+  TDynamicsCallInfo rv, res;
+  string standard_output, standard_error;
+  char params[MAXCOMMANDLINE];
+  int i, match;
+
+  // init the rv to success
+  memset( &rv, 0, sizeof(rv) );
+  rv.iResult = DC_SUCCESS;  
+
+  // we can only set one policy at a time - so set each time
+  for( i = 0; iPolicyString[i] != NULL; i++ ) { 
+
+    // set the parameter string
+    snprintf( params, MAXCOMMANDLINE, " %s %s", iPolicyString[i], ((aPolicyVector&(1<<i)) ? "on" : "off") );
+
+    // run the dynamics command line
+    res = DynamicsCall( MOBILE_NODE_AGENT_TOOL, "policy", params, &standard_output, &standard_error );
+
+    // check output
+    match = strncmp( MOBILE_NODE_AGENT_SETPOLICY_PREFIX, standard_output.c_str(), strlen(MOBILE_NODE_AGENT_SETPOLICY_PREFIX) );
+    if( match != 0 ) {
+      res.iResult = DC_UNEXPECTED_OUTPUT;
+    }
+
+    // return the first error
+    if( (res.iResult != DC_SUCCESS) && (rv.iResult == DC_SUCCESS) ) {
+      rv = res;
+      rv.iErrorDetail = i;
+    }
+  }
+
+  // done
+  return rv;
+}
+
+
+/****************************************************************************************
+ * 
+ * PUBLIC METHOD: MobileNodeAgentGetPolicy
+ * 
+ ***************************************************************************************/
+TDynamicsCallInfo CDynamicsCommand::MobileNodeAgentGetPolicy( int *aPolicyVector )
+{
+  TDynamicsCallInfo rv;
+  string standard_output, standard_error;
+  int res, on, i;
+
+  // check the params
+  assert( aPolicyVector != NULL );
+  *aPolicyVector = 0;
+  memset( &rv, 0, sizeof(rv) );
+  
+  // run the dynamics command line 
+  rv = DynamicsCall( MOBILE_NODE_AGENT_TOOL, "policy", NULL, &standard_output, &standard_error );
+  if( rv.iResult != DC_SUCCESS ) {
+    return rv;
+  }
+
+  // parse the output
+  for( i = 0; iPolicyString[i] != NULL; i++ ) {
+    res = GetPolicyEntry( standard_output.c_str(), iPolicyString[i], &on );
+    if( res != 0 ) {
+      rv.iResult = DC_UNEXPECTED_OUTPUT;
+      return rv;
+    }
+    if( on != 0 ) {
+      (*aPolicyVector) |= (1<<i);
+    }
+  } 
+
+  // done
+  rv.iResult = DC_SUCCESS;
+  return rv;
+}
+
+
+/****************************************************************************************
+ * 
+ * PUBLIC METHOD: MobileNodeAgentGetForeignAgentList
+ * 
+ ***************************************************************************************/
+TDynamicsCallInfo CDynamicsCommand::MobileNodeAgentGetForeignAgentList( int *aListCount, 
+									TMobileNodeForeignAgentInfo *aForeignAgentInfoList )
+{
+  TDynamicsCallInfo rv;
+  string standard_output, standard_error;
+  int list_size;
+
+  // check params 
+  assert( aListCount != NULL );
+  assert( aForeignAgentInfoList != NULL );
+  list_size = *aListCount;
+  *aListCount = 0;
+
+  // init the list
+  memset( aForeignAgentInfoList, 0, (sizeof(*aForeignAgentInfoList)*list_size) );
+
+  // run the dynamics command line 
+  rv = DynamicsCall( MOBILE_NODE_AGENT_TOOL, "list", NULL, &standard_output, &standard_error );
+  if( rv.iResult != DC_SUCCESS ) {
+    return rv;
+  }
+
+  // parse the output
+  rv = ParseMobileNodeAgentListOutput( standard_output, list_size, aForeignAgentInfoList, aListCount );
+  return rv;
+}
+
+
+/****************************************************************************************
+ * 
+ * PUBLIC METHOD: MobileNodeAgentGetForeignAgentInfo
+ * 
+ ***************************************************************************************/
+TDynamicsCallInfo CDynamicsCommand::MobileNodeAgentGetForeignAgentInfo( unsigned int aFAAddress, 
+									TMobileNodeForeignAgentInfo *aForeignAgentInfo )
+{ 
+  TDynamicsCallInfo rv;
+  string standard_output, standard_error;
+  int res = 0;
+  char params[MAXCOMMANDLINE];
+  struct in_addr foreign_agent_address;
+
+  // check params
+  assert( aForeignAgentInfo != NULL );
+  memset( aForeignAgentInfo, 0, sizeof(*aForeignAgentInfo) );
+
+  // write the params
+  foreign_agent_address.ADDRESS_INTEGER = aFAAddress;
+  snprintf( params, MAXCOMMANDLINE, " %s", inet_ntoa(foreign_agent_address) );
+
+  // run the dynamics command line 
+  rv = DynamicsCall( MOBILE_NODE_AGENT_TOOL, "show", params, &standard_output, &standard_error );
+  if( rv.iResult != DC_SUCCESS ) {
+    return rv;
+  }
+
+  // parse the output 
+  res |= GetAddressEntry( standard_output.c_str(), "FA", &(aForeignAgentInfo->iForeignAgentAddress) );
+  res |= GetStringEntry( standard_output.c_str(), "Interface", aForeignAgentInfo->iInterfaceName, MAXINTERFACENAME );
+  res |= GetIntegerEntry( standard_output.c_str(), "Priority", &(aForeignAgentInfo->iPriority) );
+  aForeignAgentInfo->iInUse = 1;
+  res |= GetIntegerEntry( standard_output.c_str(), "Interface index", &(aForeignAgentInfo->iInterfaceIndex) );
+  res |= GetIntegerEntry( standard_output.c_str(), "Last adv.", &(aForeignAgentInfo->iInterfaceIndex) );
+  res |= GetStringEntry( standard_output.c_str(), "NAI", aForeignAgentInfo->iNAI, MAXNAILEN );
+
+  
+  // check for errors
+  if( res != 0 ) {
+    rv.iResult = DC_UNEXPECTED_OUTPUT;
+  }
+  
+  // done
+  return rv;
+
+}
+
+
+/****************************************************************************************
+ * 
+ * SECTION: HELPERS
+ * 
+ ***************************************************************************************/
+
+/****************************************************************************************
+ * 
+ * PRIVATE METHOD: GetDateEntry
+ * 
+ ***************************************************************************************/
+int CDynamicsCommand::GetDateEntry( const char *aOutput, const char *aLabel, int *aValue )
+{
+  char *ptr;
+  struct tm stime;
+  time_t ttime;
+
+  // check params
+  assert( aOutput != NULL );
+  assert( aLabel != NULL );
+  assert( aValue != NULL );
+
+  // set default
+  *aValue = 0;
+
+  // look for the label in the output
+  ptr = strstr( aOutput, aLabel );
+  if( ptr == NULL ) {
+    return -1;
+  }
+
+  // skip over any spaces
+  ptr += strlen(aLabel);
+  for( ; IS_WHITESPACE(*ptr); ptr++ ) 
+    ;
+
+  // convert the string address into an int
+  strptime( ptr, "%A %B %d %H:%M:%S %Y", &stime );
+  ttime = mktime( &stime );
+  *aValue = ttime;
+  return 0;
+}
+
+
+/****************************************************************************************
+ * 
+ * PRIVATE METHOD: GetAddressEntry
+ * 
+ ***************************************************************************************/
+int CDynamicsCommand::GetAddressEntry( const char *aOutput, const char *aLabel, unsigned int *aValue )
+{
+  int err;
+  char *ptr;
+  struct in_addr iaddr;
+
+  // check params
+  assert( aOutput != NULL );
+  assert( aLabel != NULL );
+  assert( aValue != NULL );
+
+  // set default
+  *aValue = 0;
+
+  // look for the label in the output
+  ptr = strstr( aOutput, aLabel );
+  if( ptr == NULL ) {
+    return -1;
+  }
+
+  // skip over any spaces
+  ptr += strlen(aLabel);
+  for( ; IS_WHITESPACE(*ptr); ptr++ ) 
+    ;
+
+  // if the current char is no a digit then there is a problem
+  if( !isdigit(*ptr) ) {
+    return -1;
+  }
+
+  // convert the string address into an in_addr 
+  err = inet_aton( ptr, &iaddr );
+  if( err == 0 ) {
+    return -1;
+  }
+  *aValue = iaddr.ADDRESS_INTEGER;
+  return 0;
+}
+
+
+/****************************************************************************************
+ * 
+ * PRIVATE METHOD: GetIntegerEntry
+ * 
+ ***************************************************************************************/
+int CDynamicsCommand::GetIntegerEntry( const char *aOutput, const char *aLabel, int *aValue )
+{
+  char *ptr;
+
+  // check params
+  assert( aOutput != NULL );
+  assert( aLabel != NULL );
+  assert( aValue != NULL );
+
+  // set the default value
+  *aValue = 0;
+
+  // look for the label in the output
+  ptr = strstr( aOutput, aLabel );
+  if( ptr == NULL ) {
+    return -1;
+  }
+
+  // skip over any spaces
+  ptr += strlen(aLabel);
+  for( ; IS_WHITESPACE(*ptr); ptr++ ) 
+    ;
+
+  // if the current char is no a digit then there is a problem
+  if( (!isdigit(*ptr)) && ((*ptr) != '-') ) {
+    return -1;
+  }
+
+  // otherwise return the integer
+  *aValue = atoi(ptr);
+  return 0;
+}
+
+
+/****************************************************************************************
+ * 
+ * PRIVATE METHOD: GetPolicyEntry
+ * 
+ ***************************************************************************************/
+int CDynamicsCommand::GetPolicyEntry( const char *aOutput, const char *aLabel, int *aValue )
+{
+  char *ptr;
+
+  // check params
+  assert( aOutput != NULL );
+  assert( aLabel != NULL );
+  assert( aValue != NULL );
+
+  // set the default
+  *aValue = 0;
+
+  // look for the label in the output
+  ptr = strstr( aOutput, aLabel );
+  if( ptr == NULL ) {
+    return -1;
+  }
+
+  // skip over any spaces
+  ptr += strlen(aLabel);
+  for( ; IS_WHITESPACE(*ptr); ptr++ ) 
+    ;
+
+  // if the string is not 'ON' or 'OFF' then we are confused
+  if( (ptr[0] != 'O') || ((ptr[1] != 'N') && (ptr[1] != 'F')) ) {
+    return -1;
+  }
+
+  // this should either be OFF => O or ON => 1
+  *aValue = ((ptr[1] == 'N') ? 1 : 0);
+  return 0;
+}
+
+
+/****************************************************************************************
+ * 
+ * PRIVATE METHOD: GetStringEntry
+ * 
+ ***************************************************************************************/
+int CDynamicsCommand::GetStringEntry( const char *aOutput, const char *aLabel, char *aValue, int aBufferSize  )
+{
+  char *ptr, *start, *end;
+  int string_length;
+
+  // check params
+  assert( aOutput != NULL );
+  assert( aLabel != NULL );
+  assert( aValue != NULL );
+  assert( aBufferSize > 0 );
+
+  // set the default
+  aValue[0] = 0;
+
+  // look for the label in the output
+  ptr = strstr( aOutput, aLabel );
+  if( ptr == NULL ) {
+    return -1;
+  }
+
+  // skip over any spaces
+  ptr += strlen(aLabel);
+  for( ; IS_WHITESPACE(*ptr); ptr++ ) 
+    ;
+
+  // get the length of the substr to copy - don't copy the newline
+  start = ptr;
+  end = strchr( start, '\n' );
+  if( end == NULL ) {
+    end = strchr( start, 0 );
+  }
+  string_length = end - start;
+  string_length = MIN( string_length, (aBufferSize-1) );
+  
+  // now copy the string and return
+  memcpy( aValue, start, string_length );
+  aValue[string_length] = 0;
+  return 0;
+}
+
+
+/****************************************************************************************
+ * 
+ * PRIVATE METHOD: ParseForeignAgentListOutput: Parse ((IP_ADDR + SPACE + IP_ADDR + SPACE + INTEGER + '\n')* + '\n')
+ * 
+ ***************************************************************************************/
+TDynamicsCallInfo CDynamicsCommand::ParseForeignAgentListOutput( string aOutput, int aListSize, TTunnelID *aTunnelIDArray, int *aListCount )
+{
+  TDynamicsCallInfo rv;
+  const char *cline, *mobile_node_address_str, *home_agent_address_str, *tunnel_id_str;
+  int tunnel_id, err;
+  struct in_addr mobile_node_address, home_agent_address;
+
+  // intialise the result
+  memset( &rv, 0, sizeof(rv) );
+  rv.iResult = DC_SUCCESS;
+
+  // parse a line at a time
+  cline = aOutput.c_str();
+  while( 1 ) {
+    
+    // check for end of output 
+    if( (cline == NULL) || (*cline == 0) || (*cline == '\n') ) {
+      break;
+    }
+
+    // check for full output buffer
+    if( (*aListCount) == aListSize ) {
+      break;
+    }
+
+    // otherwise go and find the tokens
+    mobile_node_address_str = cline;
+    home_agent_address_str = strchr( mobile_node_address_str, ' ' );
+    if( home_agent_address_str == NULL ) {
+      rv.iResult = DC_UNEXPECTED_OUTPUT;
+      break;
+    }
+    home_agent_address_str++;
+    tunnel_id_str = strchr( home_agent_address_str, ' ' );
+    if( tunnel_id_str == NULL ) {
+      rv.iResult = DC_UNEXPECTED_OUTPUT;
+      break;
+    }
+    tunnel_id_str++;
+
+    // try and convert these into the correct format
+    err = inet_aton( mobile_node_address_str, &mobile_node_address );
+    if( err == 0 ) {
+      rv.iResult = DC_UNEXPECTED_OUTPUT;
+      break;
+    }
+    err = inet_aton( home_agent_address_str, &home_agent_address );
+    if( err == 0 ) {
+      rv.iResult = DC_UNEXPECTED_OUTPUT;
+      break;
+    }
+    tunnel_id = atoi( tunnel_id_str );
+
+    // now place these into the output array
+    (aTunnelIDArray[*aListCount]).iMobileNodeAddress = mobile_node_address.ADDRESS_INTEGER;
+    (aTunnelIDArray[*aListCount]).iHomeAgentAddress = home_agent_address.ADDRESS_INTEGER;
+    (aTunnelIDArray[*aListCount]).iTunnelID = tunnel_id;
+    (*aListCount) += 1;
+
+    // finally, update the 
+    cline = strchr( cline, '\n' );
+    if( cline == NULL ) {
+      break;
+    }
+    cline++;
+  }
+    
+  // done 
+  return rv;
+}
+
+
+/****************************************************************************************
+ * 
+ * PRIVATE METHOD: ParseHomeAgentListOutput: Parse: (X tunnels:\n(IP_ADDR+\n)*\n)
+ * 
+ ***************************************************************************************/
+TDynamicsCallInfo CDynamicsCommand::ParseHomeAgentListOutput( string aOutput, int aListSize, unsigned int *aTunnelList, int *aListCount )
+{
+  TDynamicsCallInfo rv;
+  const char *cline;
+  int err, i;
+  struct in_addr saddr;
+
+  // check params
+  assert( aListCount != NULL );
+  assert( aTunnelList != NULL );
+  *aListCount = 0;
+
+  // initialise the result
+  memset( &rv, 0, sizeof(rv) );
+  rv.iResult = DC_SUCCESS;
+
+  // now parse each line
+  for( cline = aOutput.c_str(), i = 0; i < aListSize; i++ ) {
+
+    // if this line starts with a newline then we are at the end
+    if( (cline == NULL) || (*cline == 0) || (*cline == '\n') ) {
+      break;
+    }
+    
+    // get the IP address of the mobile node
+    err = inet_aton( cline, &saddr );
+    if( err == 0 ) {
+      rv.iResult = DC_UNEXPECTED_OUTPUT;
+      break;
+    }
+    
+    // store this in the list
+    aTunnelList[(*aListCount)] = saddr.s_addr;
+    (*aListCount)++;
+
+    // now move to the next line
+    cline = strchr( cline, '\n' );
+    if( cline == NULL ) {
+      break;
+    }
+    cline++;
+  }
+    
+    
+  // done 
+  return rv;
+}
+
+
+/****************************************************************************************
+ * 
+ * PRIVATE METHOD: ParseMobileNodeAgentListOutput: 
+ * 
+ ***************************************************************************************/
+TDynamicsCallInfo CDynamicsCommand::ParseMobileNodeAgentListOutput( string aOutput, int aListSize, 
+								    TMobileNodeForeignAgentInfo *aForeignAgentList, int *aListCount )
+{
+  TDynamicsCallInfo rv;
+  const char *cline;
+  int match, priority, in_use_flag, err;
+  struct in_addr saddr;
+  char foreign_address_string[TOKENSIZE], interface_name_string[TOKENSIZE], white_space[TOKENSIZE];
+
+  // check params
+  assert( aForeignAgentList != NULL );
+  assert( aListCount != NULL );
+  memset( &rv, 0, sizeof(rv) );
+  rv.iResult = DC_SUCCESS;
+  *aListCount = 0;
+
+  // the first line should be "List of heard mobility agents:\n"
+  cline = aOutput.c_str();
+  assert( cline != NULL );
+  match = strncmp( MOBILE_AGENT_FOREIGN_AGENT_LIST_PREFIX, cline, strlen(MOBILE_AGENT_FOREIGN_AGENT_LIST_PREFIX) );
+  if( match != 0 ) {
+      rv.iResult = DC_UNEXPECTED_OUTPUT;
+      return rv;
+  }
+
+  // now process each line 
+  while( 1 ) {
+    
+    // move to the next line
+    cline = strchr( cline, '\n' );
+    cline++;
+    
+    // if are at the end of input then we are done
+    if( *cline == 0 ) {
+      break;
+    }
+
+    // if the list is full then we are done
+    if( (*aListCount) >= aListSize ) {
+      break;
+    }
+    
+    // parse the line: IP_ADDR + WHITESPACE + INTERFACENAME + WHITESPACE + prio + 100 + ...
+    err = sscanf( cline, "%s%[ \t]%s%[ \t]prio%[ \t]%d", foreign_address_string, white_space, interface_name_string, 
+		  white_space, white_space, &priority );
+    if( err != 6 ) {
+      rv.iResult = DC_UNEXPECTED_OUTPUT;
+      break;
+    }
+
+    // check for flags in the line - IN-USE
+    in_use_flag = strstrbeforedelim( cline, "IN-USE", '\n' );
+
+    // save these values in the list making appropriate conversions
+    inet_aton( foreign_address_string, &saddr );
+    aForeignAgentList[(*aListCount)].iForeignAgentAddress = saddr.ADDRESS_INTEGER;
+    STRNCPY_NULL_TERMINATE( aForeignAgentList[(*aListCount)].iInterfaceName, interface_name_string, MAXINTERFACENAME );
+    aForeignAgentList[(*aListCount)].iInUse = ((in_use_flag == 0) ? 1 : 0);
+    aForeignAgentList[(*aListCount)].iPriority = priority;
+
+    // fill in the fields not got here
+    aForeignAgentList[(*aListCount)].iInterfaceIndex = 0;
+    aForeignAgentList[(*aListCount)].iLastAdvertisement = 0;
+    aForeignAgentList[(*aListCount)].iNAI[0] = 0;
+
+    // update the list count
+    (*aListCount) += 1;
+  }      
+    
+  // done 
+  return rv;
+}
+
+
+/****************************************************************************************
+ * 
+ * PRIVATE METHOD: DynamicsCall
+ * 
+ ***************************************************************************************/
+TDynamicsCallInfo CDynamicsCommand::DynamicsCall( char *aExecutable, char *aCommand, char *aParams, 
+						  string *aStandardOutput, string *aStandardError )
+{
+  int command_length, match, errcode;
+  TDynamicsCallInfo rv;
+  CAProcess proc;
+  TCAProcessError perr;
+  char dynamics_error_string[MAXIMUMERRORSTRINGLENGTH], *ptr, *submatch;
+
+	// check params
+	assert( aExecutable != NULL );
+	assert( aCommand != NULL );
+	assert( aStandardOutput != NULL );
+	assert( aStandardError != NULL );
+
+	// init the rv
+	memset( &rv, 0, sizeof(rv) );
+
+	// create the command line for this call
+	snprintf( iCommandLine, MAXCOMMANDLINE, "%s %s", aExecutable, aCommand );
+
+	// append the params if set
+	if( aParams != NULL ) {
+		command_length = strlen( iCommandLine );
+		snprintf( &(iCommandLine[command_length]), (MAXCOMMANDLINE - command_length), " %s", aParams );
+	}
+
+	// append the config file if set
+	if( iPipePath.length() != 0 ) {
+		command_length = strlen( iCommandLine );
+		snprintf( &(iCommandLine[command_length]), (MAXCOMMANDLINE - command_length), " -p %s", iPipePath.c_str() );
+	}
+
+	// now run the command line and trap the output
+	//	fprintf( stderr, "COMMANDLINE: '%s'\n", iCommandLine );
+	perr = proc.Execute( iCommandLine, &errcode, iTimeout, aStandardOutput, aStandardError );
+	if( perr != CAE_NONE ) {
+		rv.iResult = DC_EXECUTE_FAILED;
+		rv.iErrorCode = (int)perr;
+		rv.iErrorDetail = errcode;
+		return rv;
+	}
+
+	// see if there was a 'csh:' error
+	match = strncmp( CSH_FAILED_PREFIX, aStandardError->c_str(), strlen(CSH_FAILED_PREFIX) );
+	if( match == 0 ) {
+	  submatch = strstr( aStandardError->c_str(), TARGET_NOT_FOUND );
+	  rv.iResult = ((submatch == NULL) ? DC_CSH_FAILED: DC_COMMAND_TOOL_NOT_FOUND);
+	  rv.iErrorCode = 0;
+	  rv.iErrorDetail = 0;
+	  if( rv.iResult == DC_CSH_FAILED ) {
+	    STRNCPY_NULL_TERMINATE( dynamics_error_string, aStandardError->c_str(), MAXIMUMERRORSTRINGLENGTH );
+	    ptr = &(dynamics_error_string[strlen(CSH_FAILED_PREFIX)]);
+	    STRNCPY_NULL_TERMINATE( rv.iDynamicsErrorString, ptr, MAXIMUMERRORSTRINGLENGTH );
+	  }
+	  return rv;
+	}
+
+	// see if there was a 'Call failed: ' error
+	match = strncmp( CALL_FAILED_PREFIX, aStandardOutput->c_str(), strlen(CALL_FAILED_PREFIX) );
+	if( match == 0 ) {
+		rv.iResult = DC_CALL_FAILED;
+		rv.iErrorCode = GetCallFailedReason( aStandardOutput->c_str() );
+		rv.iErrorDetail = 0;
+		if( rv.iErrorCode == DCF_UNKNOWN ) {
+		  STRNCPY_NULL_TERMINATE( dynamics_error_string, aStandardOutput->c_str(), MAXIMUMERRORSTRINGLENGTH );
+		  ptr = &(dynamics_error_string[strlen(CALL_FAILED_PREFIX)]);
+		  STRNCPY_NULL_TERMINATE( rv.iDynamicsErrorString, ptr, MAXIMUMERRORSTRINGLENGTH );
+		} else {
+		  rv.iDynamicsErrorString[0] = 0;
+		}
+		return rv;
+	}
+
+	// see if there was an 'Invalid arguments. ' error
+	match = strncmp( INVALID_ARGUMENTS_PREFIX, aStandardOutput->c_str(), strlen(INVALID_ARGUMENTS_PREFIX) );
+	if( match == 0 ) {
+		rv.iResult = DC_INVALID_ARGUMENTS;
+		rv.iErrorCode = 0;
+		rv.iErrorDetail = 0;
+		STRNCPY_NULL_TERMINATE( dynamics_error_string, aStandardOutput->c_str(), MAXIMUMERRORSTRINGLENGTH );
+		ptr = &(dynamics_error_string[strlen(INVALID_ARGUMENTS_PREFIX)]);
+		STRNCPY_NULL_TERMINATE( rv.iDynamicsErrorString, ptr, strlen(INVALID_ARGUMENTS_PREFIX) );
+		return rv;
+	}
+	
+	// otherwise everything looks ok - return the output for the upper layer to translate
+	rv.iResult = DC_SUCCESS;
+	rv.iErrorCode = 0;
+	rv.iErrorDetail = 0;
+	(rv.iDynamicsErrorString)[0] = 0;
+	return rv;
+}
+
+
+/****************************************************************************************
+ * 
+ * PRIVATE METHOD: GetCallFailedReason
+ * 
+ ***************************************************************************************/
+TDynamicsCallFailedReason CDynamicsCommand::GetCallFailedReason( const char *aOutput )
+{
+  int match;
+  const char *err_string;
+
+  // validate that this is a call failed 
+  match = strncmp( CALL_FAILED_PREFIX, aOutput, strlen(CALL_FAILED_PREFIX) );
+  assert( match == 0 );
+
+  // get the error string
+  err_string = &(aOutput[strlen(CALL_FAILED_PREFIX)]);
+
+  // check for 'function not permitted'
+  match = strncmp( CALL_FAILED_FUNCTION_NOT_PERMITTED, err_string, strlen(CALL_FAILED_FUNCTION_NOT_PERMITTED) );
+  if( match == 0 ) {
+    return DCF_FUNCTION_NOT_PERMITTED;
+  }
+
+  // check for 'agent unreachable'
+  match = strncmp( CALL_FAILED_AGENT_UNREACHABLE, err_string, strlen(CALL_FAILED_AGENT_UNREACHABLE) );
+  if( match == 0 ) {
+    return DCF_AGENT_UNREACHABLE;
+  }
+
+  // can't interpret
+  return DCF_UNKNOWN;
+}
+
+
+
+/****************************************************************************************
+ * 
+ * PRIVATE METHOD: ConvertTunnelStringToInteger
+ * 
+ ***************************************************************************************/
+int CDynamicsCommand::ConvertTunnelStringToInteger( char *aTunnelMode, int *aValue )
+{
+  int rv = -1, i, match;
+
+  // check params
+  assert( aTunnelMode != NULL );
+  assert( aValue != NULL );
+  *aValue = -1;
+
+  // look for a match
+  for( i = 0; iTunnelModeString[i] != NULL; i++ ) {
+    match = strncmp( iTunnelModeString[i], aTunnelMode, strlen(iTunnelModeString[i]) );
+    if( match == 0 ) {
+      *aValue = i;
+      rv = 0;
+    }
+  }
+
+  // done
+  return rv;
+}
+
+
+/****************************************************************************************
+ * 
+ * PRIVATE METHOD: CheckMatchAsBoolean
+ * 
+ ***************************************************************************************/
+int CDynamicsCommand::CheckMatchAsBoolean( char *aInput, char *aTrue, int *aValue )
+{
+  int match;
+
+  // check params
+  assert( aInput != NULL );
+  assert( aTrue != NULL );
+  assert( aValue != NULL );
+
+  // check match
+  match = strcmp( aInput, aTrue );
+  *aValue = ((match == 0) ? 1 : 0);
+  return 0;
+}
+
+
+/****************************************************************************************
+ * 
+ * PRIVATE METHOD: strstrbeforedelim
+ * 
+ ***************************************************************************************/
+int CDynamicsCommand::strstrbeforedelim( const char *aSearchSpace, const char *aToken, char aDelim )
+{
+  char *next_delim_position, *next_substr_position;
+ 
+  // check params
+  assert( aSearchSpace != NULL );
+  assert( aToken != NULL );
+  
+  // look for the substr - if not found then not found
+  next_substr_position = strstr( aSearchSpace, aToken );
+  if( next_substr_position == NULL ) {
+    return -1;
+  }
+
+  // look for the delim - if not found then the substr was found
+  next_delim_position = strchr( aSearchSpace, aDelim );
+  if( next_delim_position == NULL ) {
+    return 0;
+  }
+
+  // see which one came first
+  if( next_substr_position < next_delim_position ) {
+    return 0;
+  }
+  return -1;
+}
+
+