Method DirectRun

Core/KernelSML/src/sml_KernelSML.cpp:761–802

A fully direct run would be a call straight to gSKI but supporting that is too dangerous due to the extra events and control logic surrounding the SML RunScheduler. So we compromise with a call directly to that scheduler, boosting performance over the standard "run" path which goes through the command line processor.

// So we compromise with a call directly to that scheduler, boosting performance over the standard "run" path
// which goes through the command line processor.
void KernelSML::DirectRun(char const* pAgentName, bool forever, int stepSize, int interleaveSizeIn, uint64_t count)
{
    smlRunStepSize interleaveSize = static_cast<smlRunStepSize>(interleaveSizeIn);
    
    RunScheduler* pScheduler = GetRunScheduler() ;
    smlRunFlags runFlags = sml_NONE ;
    
    // Decide on the type of run.
    smlRunStepSize runType = (forever) ? sml_DECISION : static_cast<smlRunStepSize>(stepSize) ;
    
    // Decide how large of a step to run each agent before switching to the next agent
    pScheduler->VerifyStepSizeForRunType(forever, runType, interleaveSize) ;
    
    if (pAgentName)
    {
        AgentSML* pAgentSML = GetAgentSML(pAgentName);
        if (!pAgentSML)
        {
            return ;
        }
        
        runFlags = smlRunFlags(runFlags | sml_RUN_SELF) ;
        
        // Schedule just this one agent to run
        pScheduler->ScheduleAllAgentsToRun(false) ;
        pScheduler->ScheduleAgentToRun(pAgentSML, true) ;
    }
    else
    {
        runFlags = smlRunFlags(runFlags | sml_RUN_ALL) ;
        
        // Ask all agents to run
        pScheduler->ScheduleAllAgentsToRun(true) ;
    }
    
    // If we're running by decision cycle synchronize up the agents to the same phase before we start
    bool synchronizeAtStart = (runType == sml_DECISION) ;
    
    // Do the run
    pScheduler->RunScheduledAgents(forever, runType, count, runFlags, smlRunStepSize(interleaveSize), synchronizeAtStart) ;
    return ;
}