1 /* Copyright (c) 2013-2014. The SimGrid Team.
2 * All rights reserved. */
4 /* This program is free software; you can redistribute it and/or modify it
5 * under the terms of the license (GNU LGPL) which comes with this package. */
7 #include "network_cm02.hpp"
8 #include "maxmin_private.hpp"
9 #include "simgrid/sg_config.h"
11 XBT_LOG_EXTERNAL_DEFAULT_CATEGORY(surf_network);
13 double sg_sender_gap = 0.0;
14 double sg_latency_factor = 1.0; /* default value; can be set by model or from command line */
15 double sg_bandwidth_factor = 1.0; /* default value; can be set by model or from command line */
16 double sg_weight_S_parameter = 0.0; /* default value; can be set by model or from command line */
18 double sg_tcp_gamma = 0.0;
19 int sg_network_crosstraffic = 0;
25 void net_define_callbacks(void)
27 /* Figuring out the network links */
28 sg_platf_link_add_cb(netlink_parse_init);
29 sg_platf_postparse_add_cb(net_add_traces);
36 /************************************************************************/
37 /* New model based on optimizations discussed during Pedro Velho's thesis*/
38 /************************************************************************/
39 /* @techreport{VELHO:2011:HAL-00646896:1, */
40 /* url = {http://hal.inria.fr/hal-00646896/en/}, */
41 /* title = {{Flow-level network models: have we reached the limits?}}, */
42 /* author = {Velho, Pedro and Schnorr, Lucas and Casanova, Henri and Legrand, Arnaud}, */
43 /* type = {Rapport de recherche}, */
44 /* institution = {INRIA}, */
45 /* number = {RR-7821}, */
48 /* pdf = {http://hal.inria.fr/hal-00646896/PDF/rr-validity.pdf}, */
50 void surf_network_model_init_LegrandVelho(void)
52 if (surf_network_model)
55 surf_network_model = new NetworkCm02Model();
56 net_define_callbacks();
57 ModelPtr model = surf_network_model;
58 xbt_dynar_push(model_list, &model);
60 xbt_cfg_setdefault_double(_sg_cfg_set, "network/latency_factor",
62 xbt_cfg_setdefault_double(_sg_cfg_set, "network/bandwidth_factor",
64 xbt_cfg_setdefault_double(_sg_cfg_set, "network/weight_S", 20537);
67 /***************************************************************************/
68 /* The nice TCP sharing model designed by Loris Marchal and Henri Casanova */
69 /***************************************************************************/
70 /* @TechReport{ rr-lip2002-40, */
71 /* author = {Henri Casanova and Loris Marchal}, */
72 /* institution = {LIP}, */
73 /* title = {A Network Model for Simulation of Grid Application}, */
74 /* number = {2002-40}, */
78 void surf_network_model_init_CM02(void)
81 if (surf_network_model)
84 surf_network_model = new NetworkCm02Model();
85 net_define_callbacks();
86 ModelPtr model = surf_network_model;
87 xbt_dynar_push(model_list, &model);
89 xbt_cfg_setdefault_double(_sg_cfg_set, "network/latency_factor", 1.0);
90 xbt_cfg_setdefault_double(_sg_cfg_set, "network/bandwidth_factor",
92 xbt_cfg_setdefault_double(_sg_cfg_set, "network/weight_S", 0.0);
95 /***************************************************************************/
96 /* The models from Steven H. Low */
97 /***************************************************************************/
99 /* author={Steven H. Low}, */
100 /* title={A Duality Model of {TCP} and Queue Management Algorithms}, */
102 /* journal={{IEEE/ACM} Transactions on Networking}, */
103 /* volume={11}, number={4}, */
105 void surf_network_model_init_Reno(void)
107 if (surf_network_model)
110 surf_network_model = new NetworkCm02Model();
111 net_define_callbacks();
112 ModelPtr model = surf_network_model;
113 xbt_dynar_push(model_list, &model);
114 lmm_set_default_protocol_function(func_reno_f, func_reno_fp,
116 surf_network_model->f_networkSolve = lagrange_solve;
118 xbt_cfg_setdefault_double(_sg_cfg_set, "network/latency_factor", 10.4);
119 xbt_cfg_setdefault_double(_sg_cfg_set, "network/bandwidth_factor",
121 xbt_cfg_setdefault_double(_sg_cfg_set, "network/weight_S", 8775);
125 void surf_network_model_init_Reno2(void)
127 if (surf_network_model)
130 surf_network_model = new NetworkCm02Model();
131 net_define_callbacks();
132 ModelPtr model = surf_network_model;
133 xbt_dynar_push(model_list, &model);
134 lmm_set_default_protocol_function(func_reno2_f, func_reno2_fp,
136 surf_network_model->f_networkSolve = lagrange_solve;
138 xbt_cfg_setdefault_double(_sg_cfg_set, "network/latency_factor", 10.4);
139 xbt_cfg_setdefault_double(_sg_cfg_set, "network/bandwidth_factor",
141 xbt_cfg_setdefault_double(_sg_cfg_set, "network/weight_S",
145 void surf_network_model_init_Vegas(void)
147 if (surf_network_model)
150 surf_network_model = new NetworkCm02Model();
151 net_define_callbacks();
152 ModelPtr model = surf_network_model;
153 xbt_dynar_push(model_list, &model);
154 lmm_set_default_protocol_function(func_vegas_f, func_vegas_fp,
156 surf_network_model->f_networkSolve = lagrange_solve;
158 xbt_cfg_setdefault_double(_sg_cfg_set, "network/latency_factor", 10.4);
159 xbt_cfg_setdefault_double(_sg_cfg_set, "network/bandwidth_factor",
161 xbt_cfg_setdefault_double(_sg_cfg_set, "network/weight_S", 8775);
164 void NetworkCm02Model::initialize()
166 char *optim = xbt_cfg_get_string(_sg_cfg_set, "network/optim");
168 xbt_cfg_get_boolean(_sg_cfg_set, "network/maxmin_selective_update");
170 if (!strcmp(optim, "Full")) {
171 p_updateMechanism = UM_FULL;
172 m_selectiveUpdate = select;
173 } else if (!strcmp(optim, "Lazy")) {
174 p_updateMechanism = UM_LAZY;
175 m_selectiveUpdate = 1;
176 xbt_assert((select == 1)
178 (xbt_cfg_is_default_value
179 (_sg_cfg_set, "network/maxmin_selective_update")),
180 "Disabling selective update while using the lazy update mechanism is dumb!");
182 xbt_die("Unsupported optimization (%s) for this model", optim);
186 p_maxminSystem = lmm_system_new(m_selectiveUpdate);
188 routing_model_create(createLink("__loopback__",
189 498000000, NULL, 0.000015, NULL,
190 SURF_RESOURCE_ON, NULL,
191 SURF_LINK_FATPIPE, NULL));
193 if (p_updateMechanism == UM_LAZY) {
194 p_actionHeap = xbt_heap_new(8, NULL);
195 xbt_heap_set_update_callback(p_actionHeap, surf_action_lmm_update_index_heap);
196 p_modifiedSet = new ActionLmmList();
197 p_maxminSystem->keep_track = p_modifiedSet;
203 Link* NetworkCm02Model::createLink(const char *name,
205 tmgr_trace_t bw_trace,
207 tmgr_trace_t lat_trace,
208 e_surf_resource_state_t state_initial,
209 tmgr_trace_t state_trace,
210 e_surf_link_sharing_policy_t policy,
211 xbt_dict_t properties)
213 xbt_assert(NULL == Link::byName(name),
214 "Link '%s' declared several times in the platform",
217 return new NetworkCm02Link(this, name, properties, p_maxminSystem, sg_bandwidth_factor * bw_initial, history,
218 state_initial, state_trace, bw_initial, bw_trace, lat_initial, lat_trace, policy);
221 void NetworkCm02Model::updateActionsStateLazy(double now, double /*delta*/)
223 NetworkCm02ActionPtr action;
224 while ((xbt_heap_size(p_actionHeap) > 0)
225 && (double_equals(xbt_heap_maxkey(p_actionHeap), now, sg_surf_precision))) {
226 action = (NetworkCm02ActionPtr) xbt_heap_pop(p_actionHeap);
227 XBT_DEBUG("Something happened to action %p", action);
228 if (TRACE_is_enabled()) {
229 int n = lmm_get_number_of_cnst_from_var(p_maxminSystem, action->getVariable());
231 for (i = 0; i < n; i++){
232 lmm_constraint_t constraint = lmm_get_cnst_from_var(p_maxminSystem,
233 action->getVariable(),
235 NetworkCm02Link *link = static_cast<NetworkCm02Link*>(lmm_constraint_id(constraint));
236 TRACE_surf_link_set_utilization(link->getName(),
237 action->getCategory(),
238 (lmm_variable_getvalue(action->getVariable())*
239 lmm_get_cnst_weight_from_var(p_maxminSystem,
240 action->getVariable(),
242 action->getLastUpdate(),
243 now - action->getLastUpdate());
247 // if I am wearing a latency hat
248 if (action->getHat() == LATENCY) {
249 XBT_DEBUG("Latency paid for action %p. Activating", action);
250 lmm_update_variable_weight(p_maxminSystem, action->getVariable(), action->m_weight);
251 action->heapRemove(p_actionHeap);
252 action->refreshLastUpdate();
254 // if I am wearing a max_duration or normal hat
255 } else if (action->getHat() == MAX_DURATION ||
256 action->getHat() == NORMAL) {
257 // no need to communicate anymore
258 // assume that flows that reached max_duration have remaining of 0
259 XBT_DEBUG("Action %p finished", action);
260 action->setRemains(0);
262 action->setState(SURF_ACTION_DONE);
263 action->heapRemove(p_actionHeap);
272 void NetworkCm02Model::updateActionsStateFull(double now, double delta)
274 NetworkCm02ActionPtr action;
275 ActionListPtr running_actions = getRunningActionSet();
277 for(ActionList::iterator it(running_actions->begin()), itNext=it, itend(running_actions->end())
278 ; it != itend ; it=itNext) {
281 action = (NetworkCm02ActionPtr) &*it;
282 XBT_DEBUG("Something happened to action %p", action);
283 double deltap = delta;
284 if (action->m_latency > 0) {
285 if (action->m_latency > deltap) {
286 double_update(&(action->m_latency), deltap, sg_surf_precision);
289 double_update(&(deltap), action->m_latency, sg_surf_precision);
290 action->m_latency = 0.0;
292 if (action->m_latency == 0.0 && !(action->isSuspended()))
293 lmm_update_variable_weight(p_maxminSystem, action->getVariable(),
296 if (TRACE_is_enabled()) {
297 int n = lmm_get_number_of_cnst_from_var(p_maxminSystem, action->getVariable());
299 for (i = 0; i < n; i++){
300 lmm_constraint_t constraint = lmm_get_cnst_from_var(p_maxminSystem,
301 action->getVariable(),
303 NetworkCm02Link* link = static_cast<NetworkCm02Link*>(lmm_constraint_id(constraint));
304 TRACE_surf_link_set_utilization(link->getName(),
305 action->getCategory(),
306 (lmm_variable_getvalue(action->getVariable())*
307 lmm_get_cnst_weight_from_var(p_maxminSystem,
308 action->getVariable(),
310 action->getLastUpdate(),
311 now - action->getLastUpdate());
314 if (!lmm_get_number_of_cnst_from_var
315 (p_maxminSystem, action->getVariable())) {
316 /* There is actually no link used, hence an infinite bandwidth.
317 * This happens often when using models like vivaldi.
318 * In such case, just make sure that the action completes immediately.
320 action->updateRemains(action->getRemains());
322 action->updateRemains(lmm_variable_getvalue(action->getVariable()) * delta);
324 if (action->getMaxDuration() != NO_MAX_DURATION)
325 action->updateMaxDuration(delta);
327 if ((action->getRemains() <= 0) &&
328 (lmm_get_variable_weight(action->getVariable()) > 0)) {
330 action->setState(SURF_ACTION_DONE);
332 } else if (((action->getMaxDuration() != NO_MAX_DURATION)
333 && (action->getMaxDuration() <= 0))) {
335 action->setState(SURF_ACTION_DONE);
342 ActionPtr NetworkCm02Model::communicate(RoutingEdgePtr src, RoutingEdgePtr dst,
343 double size, double rate)
347 NetworkCm02Link *link;
349 NetworkCm02ActionPtr action = NULL;
350 double bandwidth_bound;
351 double latency = 0.0;
352 xbt_dynar_t back_route = NULL;
353 int constraints_per_variable = 0;
355 xbt_dynar_t route = xbt_dynar_new(sizeof(RoutingEdgePtr), NULL);
357 XBT_IN("(%s,%s,%g,%g)", src->getName(), dst->getName(), size, rate);
359 routing_platf->getRouteAndLatency(src, dst, &route, &latency);
360 xbt_assert(!xbt_dynar_is_empty(route) || latency,
361 "You're trying to send data from %s to %s but there is no connection at all between these two hosts.",
362 src->getName(), dst->getName());
364 xbt_dynar_foreach(route, i, _link) {
365 link = static_cast<NetworkCm02Link*>(_link);
366 if (link->getState() == SURF_RESOURCE_OFF) {
371 if (sg_network_crosstraffic == 1) {
372 routing_platf->getRouteAndLatency(dst, src, &back_route, NULL);
373 xbt_dynar_foreach(back_route, i, _link) {
374 link = static_cast<NetworkCm02Link*>(_link);
375 if (link->getState() == SURF_RESOURCE_OFF) {
382 action = new NetworkCm02Action(this, size, failed);
384 #ifdef HAVE_LATENCY_BOUND_TRACKING
385 action->m_latencyLimited = 0;
387 action->m_weight = action->m_latency = latency;
389 action->m_rate = rate;
390 if (p_updateMechanism == UM_LAZY) {
391 action->m_indexHeap = -1;
392 action->m_lastUpdate = surf_get_clock();
395 bandwidth_bound = -1.0;
396 if (sg_weight_S_parameter > 0) {
397 xbt_dynar_foreach(route, i, _link) {
398 link = static_cast<NetworkCm02Link*>(_link);
399 action->m_weight += sg_weight_S_parameter / link->getBandwidth();
402 xbt_dynar_foreach(route, i, _link) {
403 link = static_cast<NetworkCm02Link*>(_link);
404 double bb = bandwidthFactor(size) * link->getBandwidth(); //(link->p_power.peak * link->p_power.scale);
406 (bandwidth_bound < 0.0) ? bb : min(bandwidth_bound, bb);
409 action->m_latCurrent = action->m_latency;
410 action->m_latency *= latencyFactor(size);
411 action->m_rate = bandwidthConstraint(action->m_rate, bandwidth_bound, size);
413 xbt_assert(!xbt_dynar_is_empty(route),
414 "Using a model with a gap (e.g., SMPI) with a platform without links (e.g. vivaldi)!!!");
416 link = *static_cast<NetworkCm02Link **>(xbt_dynar_get_ptr(route, 0));
417 gapAppend(size, link, action);
418 XBT_DEBUG("Comm %p: %s -> %s gap=%f (lat=%f)",
419 action, src->getName(), dst->getName(), action->m_senderGap,
423 constraints_per_variable = xbt_dynar_length(route);
424 if (back_route != NULL)
425 constraints_per_variable += xbt_dynar_length(back_route);
427 if (action->m_latency > 0) {
428 action->p_variable = lmm_variable_new(p_maxminSystem, action, 0.0, -1.0,
429 constraints_per_variable);
430 if (p_updateMechanism == UM_LAZY) {
431 // add to the heap the event when the latency is payed
432 XBT_DEBUG("Added action (%p) one latency event at date %f", action,
433 action->m_latency + action->m_lastUpdate);
434 action->heapInsert(p_actionHeap, action->m_latency + action->m_lastUpdate, xbt_dynar_is_empty(route) ? NORMAL : LATENCY);
437 action->p_variable = lmm_variable_new(p_maxminSystem, action, 1.0, -1.0, constraints_per_variable);
439 if (action->m_rate < 0) {
440 lmm_update_variable_bound(p_maxminSystem, action->getVariable(), (action->m_latCurrent > 0) ? sg_tcp_gamma / (2.0 * action->m_latCurrent) : -1.0);
442 lmm_update_variable_bound(p_maxminSystem, action->getVariable(), (action->m_latCurrent > 0) ? min(action->m_rate, sg_tcp_gamma / (2.0 * action->m_latCurrent)) : action->m_rate);
445 xbt_dynar_foreach(route, i, _link) {
446 link = static_cast<NetworkCm02Link*>(_link);
447 lmm_expand(p_maxminSystem, link->getConstraint(), action->getVariable(), 1.0);
450 if (sg_network_crosstraffic == 1) {
451 XBT_DEBUG("Fullduplex active adding backward flow using 5%%");
452 xbt_dynar_foreach(back_route, i, _link) {
453 link = static_cast<NetworkCm02Link*>(_link);
454 lmm_expand(p_maxminSystem, link->getConstraint(), action->getVariable(), .05);
458 xbt_dynar_free(&route);
461 surf_callback_emit(networkCommunicateCallbacks, action, src, dst, size, rate);
465 void NetworkCm02Model::addTraces(){
466 xbt_dict_cursor_t cursor = NULL;
467 char *trace_name, *elm;
469 static int called = 0;
474 /* connect all traces relative to network */
475 xbt_dict_foreach(trace_connect_list_link_avail, cursor, trace_name, elm) {
476 tmgr_trace_t trace = (tmgr_trace_t) xbt_dict_get_or_null(traces_set_list, trace_name);
477 NetworkCm02Link *link = static_cast<NetworkCm02Link*>( Link::byName(elm) );
479 xbt_assert(link, "Cannot connect trace %s to link %s: link undefined",
482 "Cannot connect trace %s to link %s: trace undefined",
485 link->p_stateEvent = tmgr_history_add_trace(history, trace, 0.0, 0, link);
488 xbt_dict_foreach(trace_connect_list_bandwidth, cursor, trace_name, elm) {
489 tmgr_trace_t trace = (tmgr_trace_t) xbt_dict_get_or_null(traces_set_list, trace_name);
490 NetworkCm02Link *link = static_cast<NetworkCm02Link*>( Link::byName(elm) );
492 xbt_assert(link, "Cannot connect trace %s to link %s: link undefined",
495 "Cannot connect trace %s to link %s: trace undefined",
498 link->p_power.event = tmgr_history_add_trace(history, trace, 0.0, 0, link);
501 xbt_dict_foreach(trace_connect_list_latency, cursor, trace_name, elm) {
502 tmgr_trace_t trace = (tmgr_trace_t) xbt_dict_get_or_null(traces_set_list, trace_name);
503 NetworkCm02Link *link = static_cast<NetworkCm02Link*>(Link::byName(elm));;
505 xbt_assert(link, "Cannot connect trace %s to link %s: link undefined",
508 "Cannot connect trace %s to link %s: trace undefined",
511 link->p_latEvent = tmgr_history_add_trace(history, trace, 0.0, 0, link);
518 NetworkCm02Link::NetworkCm02Link(NetworkCm02ModelPtr model, const char *name, xbt_dict_t props,
520 double constraint_value,
521 tmgr_history_t history,
522 e_surf_resource_state_t state_init,
523 tmgr_trace_t state_trace,
525 tmgr_trace_t metric_trace,
527 tmgr_trace_t lat_trace,
528 e_surf_link_sharing_policy_t policy)
529 : Link(model, name, props, lmm_constraint_new(system, this, constraint_value), history, state_trace)
531 setState(state_init);
534 p_power.peak = metric_peak;
536 p_power.event = tmgr_history_add_trace(history, metric_trace, 0.0, 0, this);
538 p_power.event = NULL;
540 m_latCurrent = lat_initial;
542 p_latEvent = tmgr_history_add_trace(history, lat_trace, 0.0, 0, this);
544 if (policy == SURF_LINK_FATPIPE)
545 lmm_constraint_shared(getConstraint());
550 void NetworkCm02Link::updateState(tmgr_trace_event_t event_type,
551 double value, double date)
553 /* printf("[" "%g" "] Asking to update network card \"%s\" with value " */
554 /* "%g" " for event %p\n", surf_get_clock(), nw_link->name, */
555 /* value, event_type); */
557 if (event_type == p_power.event) {
558 updateBandwidth(value, date);
559 if (tmgr_trace_event_free(event_type))
560 p_power.event = NULL;
561 } else if (event_type == p_latEvent) {
562 updateLatency(value, date);
563 if (tmgr_trace_event_free(event_type))
565 } else if (event_type == p_stateEvent) {
567 setState(SURF_RESOURCE_ON);
569 lmm_constraint_t cnst = getConstraint();
570 lmm_variable_t var = NULL;
571 lmm_element_t elem = NULL;
573 setState(SURF_RESOURCE_OFF);
574 while ((var = lmm_get_var_from_cnst(getModel()->getMaxminSystem(), cnst, &elem))) {
575 ActionPtr action = (ActionPtr) lmm_variable_id(var);
577 if (action->getState() == SURF_ACTION_RUNNING ||
578 action->getState() == SURF_ACTION_READY) {
579 action->setFinishTime(date);
580 action->setState(SURF_ACTION_FAILED);
584 if (tmgr_trace_event_free(event_type))
587 XBT_CRITICAL("Unknown event ! \n");
592 ("There were a resource state event, need to update actions related to the constraint (%p)",
597 void NetworkCm02Link::updateBandwidth(double value, double date){
598 double delta = sg_weight_S_parameter / value - sg_weight_S_parameter /
599 (p_power.peak * p_power.scale);
600 lmm_variable_t var = NULL;
601 lmm_element_t elem = NULL;
602 lmm_element_t nextelem = NULL;
605 NetworkCm02ActionPtr action = NULL;
607 p_power.peak = value;
608 lmm_update_constraint_bound(getModel()->getMaxminSystem(),
610 sg_bandwidth_factor *
611 (p_power.peak * p_power.scale));
612 TRACE_surf_link_set_bandwidth(date, getName(), sg_bandwidth_factor * p_power.peak * p_power.scale);
613 if (sg_weight_S_parameter > 0) {
614 while ((var = lmm_get_var_from_cnst_safe(getModel()->getMaxminSystem(), getConstraint(), &elem, &nextelem, &numelem))) {
615 action = (NetworkCm02ActionPtr) lmm_variable_id(var);
616 action->m_weight += delta;
617 if (!action->isSuspended())
618 lmm_update_variable_weight(getModel()->getMaxminSystem(), action->getVariable(), action->m_weight);
623 void NetworkCm02Link::updateLatency(double value, double date){
624 double delta = value - m_latCurrent;
625 lmm_variable_t var = NULL;
626 lmm_element_t elem = NULL;
627 lmm_element_t nextelem = NULL;
629 NetworkCm02ActionPtr action = NULL;
631 m_latCurrent = value;
632 while ((var = lmm_get_var_from_cnst_safe(getModel()->getMaxminSystem(), getConstraint(), &elem, &nextelem, &numelem))) {
633 action = (NetworkCm02ActionPtr) lmm_variable_id(var);
634 action->m_latCurrent += delta;
635 action->m_weight += delta;
636 if (action->m_rate < 0)
637 lmm_update_variable_bound(getModel()->getMaxminSystem(), action->getVariable(), sg_tcp_gamma / (2.0 * action->m_latCurrent));
639 lmm_update_variable_bound(getModel()->getMaxminSystem(), action->getVariable(),
640 min(action->m_rate, sg_tcp_gamma / (2.0 * action->m_latCurrent)));
642 if (action->m_rate < sg_tcp_gamma / (2.0 * action->m_latCurrent)) {
643 XBT_INFO("Flow is limited BYBANDWIDTH");
645 XBT_INFO("Flow is limited BYLATENCY, latency of flow is %f",
646 action->m_latCurrent);
649 if (!action->isSuspended())
650 lmm_update_variable_weight(getModel()->getMaxminSystem(), action->getVariable(), action->m_weight);
657 void NetworkCm02Action::updateRemainingLazy(double now)
661 if (m_suspended != 0)
664 delta = now - m_lastUpdate;
667 XBT_DEBUG("Updating action(%p): remains was %f, last_update was: %f", this, m_remains, m_lastUpdate);
668 double_update(&(m_remains), m_lastValue * delta, sg_maxmin_precision*sg_surf_precision);
670 XBT_DEBUG("Updating action(%p): remains is now %f", this, m_remains);
673 if (m_maxDuration != NO_MAX_DURATION)
674 double_update(&m_maxDuration, delta, sg_surf_precision);
676 if (m_remains <= 0 &&
677 (lmm_get_variable_weight(getVariable()) > 0)) {
679 setState(SURF_ACTION_DONE);
681 heapRemove(getModel()->getActionHeap());
682 } else if (((m_maxDuration != NO_MAX_DURATION)
683 && (m_maxDuration <= 0))) {
685 setState(SURF_ACTION_DONE);
686 heapRemove(getModel()->getActionHeap());
690 m_lastValue = lmm_variable_getvalue(getVariable());
692 void NetworkCm02Action::recycle()