// // Copyright (C) 2005 Andras Varga // // This program is free software; you can redistribute it and/or // modify it under the terms of the GNU General Public License // as published by the Free Software Foundation; either version 2 // of the License, or (at your option) any later version. // // This program is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with this program; if not, write to the Free Software // Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. // // // ScenarioManager is for setting up and controlling simulation experiments. // You can schedule certain events to take place at specified times, // like changing a parameter value, changing the bit error rate of // a connection, removing or adding connections, removing or // adding routes in a routing table, etc, so that you can observe the // transient behaviour. // // ScenarioManager executes a script specified in XML. It has a few // built-in commands, while other commands are dispatched to be carried out // by given simple modules. (The C++ class of these simple modules' needs // to implement the IScriptable interface, and the processCommand() method // must be redefined accordingly). // // An example script: // // <pre> // <scenario> // <set-param t="10" module="host[1].mobility" par="speed" value="5"/> // <set-param t="20" module="host[1].mobility" par="speed" value="30"/> // <at t="50"> // <set-param module="host[2].mobility" par="speed" value="10"/> // <set-param module="host[3].mobility" par="speed" value="10"/> // </at> // </scenario> // </pre> // // Built-in commands: <set-param>, <set-channel-attr>, <at>. // // All commands have a t attribute which carries the simulation time // at which the command has to be carried out. You can group several commands // to be carried out at the same simulation time using <at>, and // then only the <at> command is needed to have a t attribute. // // Supported attributes: // - <set-param>: module, par, value. // - <set-channel-attr>: src-module, src-gate, attr, value. // simple ScenarioManager parameters: script: xml; endsimple