Method ProcessCommand

Core/KernelSML/src/sml_KernelSML.cpp:578–625

* @brief Take an incoming command and call the appropriate * handler to process it. *************************************************************/

*           handler to process it.
*************************************************************/
bool KernelSML::ProcessCommand(char const* pCommandName, Connection* pConnection, AnalyzeXML* pIncoming, soarxml::ElementXML* pResponse)
{
    // Look up the function that handles this command
    CommandFunction pFunction = m_CommandMap[pCommandName] ;
    
    if (!pFunction)
    {
        // There is no handler for this command
        std::stringstream msg;
        msg << "Command " << pCommandName << " is not recognized by the kernel" ;
        
        AddErrorMsg(pConnection, pResponse, msg.str().c_str()) ;
        return false ;
    }
    
    // Look up the agent name parameter (most commands have this)
    char const* pAgentName = pIncoming->GetArgString(sml_Names::kParamAgent) ;
    
    AgentSML* pAgentSML = NULL ;
    
    if (pAgentName)
    {
        pAgentSML = GetAgentSML(pAgentName) ;
        
        if (!pAgentSML)
        {
            // Failed to find this agent
            std::stringstream msg;
            msg << "Could not find an agent with name: " << pAgentName ;
            AddErrorMsg(pConnection, pResponse, msg.str().c_str()) ;
            return false ;
        }
    }
    
    // Call to the handler (this is a pointer to member call so it's a bit odd)
    bool result = (this->*pFunction)(pAgentSML, pCommandName, pConnection, pIncoming, pResponse) ;
    
    // If we return false, we report a generic error about the call.
    if (!result)
    {
        std::stringstream msg;
        msg << "The call " << pCommandName << " failed to execute correctly." ;
        AddErrorMsg(pConnection, pResponse, msg.str().c_str()) ;
        return false ;
    }
    
    return true ;
}

/*************************************************************
* @brief    Takes an incoming SML message and responds with