op_runsim
Program to run simulations.
Description
There are two ways to run simulations. One way is to execute the simulation executable program generated by op_mksim. The other way is to use op_runsim from either the GUI (using DES menu commands) or from the command line. op_runsim accepts the same preferences as a simulation executable and has the advantage of automatically rebuilding the simulation repository, which contains the model object code. Because op_runsim is not tied to a specific network model, the network model must be specified via the net_name preference. Also, if running simultaneous simulations of the same network model from the command line, you must specify a unique execution ID for each run with the exec_id preference.
Note: When you invoke op_runsim from the GUI, you can specify command-line arguments from the Execution > Advanced > Application page of the Configure/Run DES dialog box.
Running op_runsim invokes one of several simulation kernels. The development kernels collect useful debugging information during the simulation, and are therefore best used when developing models. They run more slowly than the optimized kernels. The optimized kernels do not collect the debugging information, but they do execute more quickly. Therefore, use a development kernel when developing models and an optimized kernel after the models are established.
The “kernel_type”, “m32”, “m64”, and “mt” preferences specify which simulation kernel to use. Depending on the values of these preferences, op_runsim will invoke one of the following programs (from the appropriate sys\<architecture>\bin directory) to link and run simulations:
- op_runsim_dev
- op_runsim_opt
- op_runsim_mtdev
- op_runsim_mtopt
op_runsim and simulation executables created by op_mksim work similarly, except that op_runsim dynamically rebuilds the network repository and op_mksim will link static library information into the simulation executable.
Note: You must have an unexpired (free or in-use) simulation license in order to run simulations. If op_runsim cannot find a valid license installed on your system, it terminates with an error message.
Simulation Preferences
Simulations accept a wide range of preferences that set parameters and options. The standard sets accepted by simulations are listed below:
- “Standard Preferences”
- “Development” preferences
- “Diagnostics” preferences
- “Licensing Preferences”
- “User Lock” preferences
The specific static preferences accepted by simulations are listed in the remainder of this section.
anim_attempts
Specifies the maximum number of times the simulation will attempt to send an animation request packet to the animation viewer. If this count is exceeded, the simulation will disable animation and will no longer transmit animation requests. (For more information, see the related attributes anim_view and anim_timeout.)
| Type | Default Value |
|---|---|
| Integer | 5 |
anim_hist
Specifies that animation be enabled within the simulation, and that animation requests be captured in a file for later viewing by the animation viewer program. The file will be given the name specified as this preference’s value, with the file type suffix .ah (animation history). If no name is specified, the network name will be used.
| Type | Default Value |
|---|---|
| string | “” |
anim_host
If animation is enabled, specifies a host computer running the animation viewer to which the simulation will send animation request packets. The default value indicates that the animation viewer is running on the same host as the simulation. (For more information, see the related attributes anim_view and anim_port.)
| Type | Default Value |
|---|---|
| string | “localhost “ |
anim_port
Specifies an offset to be added to the default animation UDP/IP port number (3211) when the simulation attempts to contact the animation viewer program. This allows communication to be established between the simulation and the animation viewer even if the default port is already in use. (For more information, see the related attributes anim_view and anim_host.)
| Type | Default Value |
|---|---|
| integer | 0 |
anim_timeout
If animation is enabled, specifies the timeout interval for animation request packets; the simulation will wait this length of time for a response from the animation viewer program before resending the request. (For more information, see the related attributes anim_view and anim_attempts.)
| Type | Units | Default Value |
|---|---|---|
| double | seconds | 3.0 |
anim_view
Specifies that animation be enabled within the simulation, and that animation requests be sent to a concurrently running animation viewer. (The anim_host and anim_port attributes can also be set to specify the location of the animation viewer program to which the animation requests will be sent.)
| Type | Default Value |
|---|---|
| boolean | FALSE |
attr_reqs_file
Specifies an environment file in which to save promoted attribute requests. When a simulation is run, it may initially prompt the user to enter values for promoted object attributes. If this preference is set, these attribute assignments are saved within an environment file with a name composed from the argument value and the .ef file type suffix.
| Type | Default Value |
|---|---|
| string | “” |
c
Specifies that all object files referenced by the network model are to be recompiled and the repository rebuilt prior to building the simulation. This option is useful when a simulation needs to be comprehensively rebuilt from its basic components, as in situations where it is not known which models have been changed since the last build. (This argument is not valid for static simulations.)
Note: Model files to be recompiled can be in either binary (.m) or XML (.xml) form.
| Type | Default Value |
|---|---|
| boolean | FALSE |
c_exclude_standard_models
Specifies that standard models should be excluded from a forced model recompilation. When both this and the c preference are TRUE, all model files within the Modeler installation directory tree (<install_dir>) will be excluded from the forced recompile.
| Type | Default Value |
|---|---|
| boolean | FALSE |
child_id
Specifies the “child ID” of the simulation, which the simulation uses to identify itself when communicating with the modeler program (simulations spawned by the GUI are child processes of modeler). This preference is only used by modeler; it should not be specified by users running simulations from a shell.
| Type | Default Value |
|---|---|
| integer | -1 |
collect_model_deps_in_file
Specifies a file in which op_runsim will generate a list of model files referenced during a simulation. If no file is specified, the dependency list is not generated.
This is a command-line-only preference whose value changes only at start-up.
| Type | Default Value |
|---|---|
| string | “” |
cosim
Specifies a simulation description file that op_runsim will use to find the other simulators for a cosimulation. If no file is specified, cosimulation is not performed. See “Cosimulation” on page 391 for more details.
This is a command-line-only preference whose value changes only at start-up.
| Type | Default Value |
|---|---|
| string | “” |
cosimulation_optimization_mode
Specifies whether the simulation will sleep while waiting for external events to arrive. When set to “low-latency”, the simulation does not sleep. This reduces latency at the expense of increased CPU usage.
| Type | Default Value | Constraints |
|---|---|---|
| enum | none | none, low-latency |
debug
Specifies to execute the simulation under the control of the OPNET Simulation Debugger (ODB), which provides a character-oriented command interpreter shortly after execution commences.
| Type | Default Value |
|---|---|
| boolean | FALSE |
des.checkpoint.autogen
When set, specifies when periodic checkpoints should be taken. The following values are possible (where # represents a positive integer):
- “Event_#” – at event number #
- “Every_#” – every # events
- “Enter_#” – before entering # seconds
- “Leave_#” – leaving # seconds
- “Tenter_#” – entering every # seconds
- “Tleave_#” – leaving every # seconds
This preference has no effect unless “des.checkpoint.enabled” is TRUE. It is available only on Linux.
| Type | Default Value | Constraints |
|---|---|---|
| string | “” | <empty>, Event_#, Every_#, Enter_#, Leave_#, Tenter_#, Tleave_# |
des.checkpoint.autogen_stop_after_restart
When TRUE, specifies that a restarted simulation will turn off any configured auto-checkpoint generation. This allows a restarted simulation to run to completion without being interrupted by additional checkpointing.
| Type | Default Value |
|---|---|
| boolean | TRUE |
des.checkpoint.continue
Specifies whether the simulation should continue after a checkpoint is taken. When FALSE, the simulation terminates after the first checkpoint.
This preference has no effect unless “des.checkpoint.enabled” is TRUE. It is available only on Linux.
| Type | Default Value |
|---|---|
| boolean | TRUE |
des.checkpoint.keep_last
Specifies how many checkpoints should be kept during a simulation run. When set to 0, all checkpoints are kept. Otherwise, only the last n checkpoints are kept.
This preference has no effect unless “des.checkpoint.enabled” is TRUE. It is available only on Linux.
| Type | Default Value |
|---|---|
| integer | 0 |
des.checkpoint.lowmem
Specifies whether a checkpoint should be taken when a memory allocation fails. When TRUE, a checkpoint is taken.
This preference has no effect unless “des.checkpoint.enabled” is TRUE. It is available only on Linux.
| Type | Default Value |
|---|---|
| boolean | FALSE |
des.checkpoint.verbose
Specifies whether to print the debug statements associated with checkpointing. When TRUE, detailed messages are printed.
This preference has no effect unless “des.checkpoint.enabled” is TRUE. It is available only on Linux.
| Type | Default Value |
|---|---|
| boolean | FALSE |
duration
Specifies the intended duration of the simulation. The value of duration is interpreted in terms of simulation time, rather than real execution time. Simulation events scheduled for times later than the duration value will be discarded when the simulation ends. A simulation may end before the duration value is reached due to a program abort or process-requested termination.
| Type | Units | Default Value |
|---|---|---|
| double | seconds | 1000.0000 |
endsim_memstats
When TRUE, specifies that a memory statistic report will be automatically generated when the simulation terminates. This report is similar to that generated by the ODB “memstats” command. If the simulation was launched from the OPNET GUI, the output is displayed on the Memory Stats page of the Simulation Progress dialog box; otherwise, output goes to the console.
| Type | Default Value |
|---|---|
| boolean | FALSE |
etrace_diff
Causes op_runsim to compare the simulation execution trace of the current simulation to a trace captured from another simulation. If any differences are encountered, op_runsim will stop the current simulation and report the differences in the simulation console. Use the etrace_dump preference to capture the trace used for comparison. The value of the etrace_diff preference is the path and name of the trace file to compare against.
This preference can be entered only from the command line.
| Type | Default Value |
|---|---|
| string | “” |
etrace_dump
Activates execution trace debugging, which causes op_runsim to capture a simulation execution trace that can be feed into another simulation (with the etrace_diff preference) to find the point at which simulation execution diverges. You can reduce the size of the capture file with the etrace_start_time and etrace_end_time preferences. The value of the etrace_dump preference is a path and name for the capture file.
This preference can be entered only from the command line.
| Type | Default Value |
|---|---|
| string | “” |
etrace_end_time
Specifies the simulation end time for an etrace operation (etrace_dump or etrace_diff. Any event after this time is not taken into account. When comparing traces, the end time must match the end time of the comparison trace.
This preference can be entered only from the command line.
| Type | Default Value | Constraints |
|---|---|---|
| double | 1e+100 | > 0 and > etrace_start_time |
etrace_start_time
Specifies the simulation start time for an etrace operation (etrace_dump or etrace_diff. Any event before this time is not taken into account. When comparing traces, the start time must match the start time of the comparison trace.
This preference can be entered only from the command line.
| Type | Default Value | Constraints |
|---|---|---|
| double | 0 | >= 0 |
event_order_method
Specifies how the processing order for events occurring at the same simulation time is determined. If strict, events are ordered by the following keys:
- Object (module) priority
- Interrupt priority
- Natural (event) order
If partial, events are ordered either by object priority (for events in different objects) or interrupt priority (for events in the same object), with ties resolved by event order in both cases.
See “Event Prioritization for Simultaneous Event Execution” on page 162 for descriptions of these priority keys.
| Type | Constraints | Default Value |
|---|---|---|
| enum | strict, partial | strict |
event_speed_parameter
Provides an advanced event management system that can be tuned to maintain peak performance when simulating very large systems. Larger values will result in faster simulations. The trade-off is that higher values of this preference require additional memory.
At the end of each simulation, a value for this preference is calculated and reported in the Simulation Log. Optimal values depend on the type and size of models. You may want to experiment with different values and compare the simulation's performance. In general, increasing this parameter will not yield significant performance gains for small, lightly-loaded systems.
| Type | Default Value |
|---|---|
| integer | 100,000 |
exec_id
Specifies the execution ID needed to generate distinct output files when performing multiple simulation runs of the same network model. From the GUI, a unique execution ID is set automatically for each run of a simulation set. From the command line, however, you must use this preference to manually specify a unique execution ID for each run. If you do not, new output files will overwrite older ones. Also, simultaneous runs might try to write to the same file, potentially causing warnings and errors.
This preference should be used only from the command line.
| Type | Default Value |
|---|---|
| integer | 1 |
fully_serialized_event_ids
When TRUE, op_runsim replaces the event ID scheme (in which IDs are serialized by module) with the global serialization used prior to OPNET 10.0.
| Type | Default Value |
|---|---|
| boolean | TRUE for sequential kernels; FALSE for parallel kernels |
fully_serialized_event_execution_ids
When TRUE, op_runsim replaces the event ID scheme (in which IDs are serialized by module) with the global serialization used prior to OPNET 10.0.
| Type | Default Value |
|---|---|
| boolean | TRUE for sequential kernels; FALSE for parallel kernels |
fully_serialized_ici_ids
When TRUE, op_runsim replaces the ICI ID scheme (in which IDs are serialized by module) with the global serialization used prior to OPNET 10.0.
| Type | Default Value |
|---|---|
| boolean | TRUE for sequential kernels; FALSE for parallel kernels |
fully_serialized_packet_ids
When TRUE, op_runsim replaces the packet ID scheme (in which IDs are serialized by module) with the global serialization used prior to OPNET 10.0.
| Type | Default Value |
|---|---|
| boolean | TRUE for sequential kernels; FALSE for parallel kernels |
jitd_cmd_line
Specifies a command line to use for launching a just-in-time debugger (Linux only).
| Type | Default Value |
|---|---|
| string | “xterm -T OPNET_JITD -e gdb -c %d” |
jitd_enable
When TRUE, enables just-in-time debugging (Linux only).
| Type | Default Value |
|---|---|
| boolean | FALSE |
livelock_thresh
Specifies the threshold used to determine when a process model has entered a livelock condition (i.e., the process model is continually making transitions without reaching an unforced state). The threshold value is in effect a maximum count for the number of transitions which can be performed on a single process model invocation without causing a warning.
| Type | Units | Default Value |
|---|---|---|
| integer | transitions | 8192 |
log_endsim_perf
Specifies whether to generate a DES log entry based on the final performance report.
| Type | Default Value |
|---|---|
| boolean | FALSE |
log_file
Specifies the name of the DES log file. If no name is specified, the network name will be used.
| Type | Default Value |
|---|---|
| string | “” |
log_time_precision
Specifies the number of decimal places recorded for simulation times in the DES log.
| Type | Default Value | Constraints |
|---|---|---|
| integer | 12 | >= 0 |
max_log_entries
Specifies the maximum number of entries in the DES log.
| Type | Default Value |
|---|---|
| integer | 200 |
mem_track
Specifies whether the memory allocation and deallocation tracking features of the Simulation Kernel should be enabled for use within ODB. When mem_track is TRUE, the ODB commands “memsrc” and “memsnk” can be used to obtain lists of the allocation sources and deallocation sinks within a simulation.
Note: This preference is part of the Development preference set, but is also documented here due to its special role in simulations.
| Type | Default Value |
|---|---|
| boolean | FALSE |
mem_track_object
Specifies the name of a particular object for which to track memory allocation and deallocation. Specifying an object allows for efficient tracking if only one object is of interest. Used when mem_track is TRUE.
Note: This preference is part of the Development preference set, but is also documented here due to its special role in simulations.
| Type | Default Value |
|---|---|
| string | “” |
memstat_autogen
Specifies how often a simulation will generate memory statistics. When the simulation is run from the GUI, updates go to the Memory Stats tabbed page of the Simulation Progress dialog box. When the simulation is run from the command line, a memstats table is printed to the console. The following values are possible (where F represents a positive float and N represents a positive integer):
- “progress” – when a progress report is generated
- “enter_0” – at time 0, before the first event is executed
- “leave_0” – at time 0, after all events have been executed
- “enter_F” – every time F, before events are executed
- “leave_F” – every time F, after all events in the timecell are executed
- “every_N” – every N events
| Type | Default Value |
|---|---|
| string | “” |
memtag_all
Specifies whether the simulation should tag memory allocations for tracing on the Memory Sources tabbed page of the Simulation Progress dialog box. When TRUE, all allocations are tagged. When FALSE, no allocations are tagged. See “Using Memory Source Tracing” on page 57 for details.
| Type | Default Value |
|---|---|
| boolean | FALSE |
memtag_list
Specifies a list of memory categories for which the simulation should tag memory allocations. This tagging is used for memory source tracing on the Memory Sources tabbed page of the Simulation Progress dialog box. See “Using Memory Source Tracing” on page 57 for details.
| Type | Default Value |
|---|---|
| string list | “” |
net_name
Specifies the name of the network model that will be loaded by the simulation. For static simulations, this preference can be left unset (in which case, it defaults to the name of the static simulation). The value of net_name is used as a default for the anim_hist, ef, log_file, os_file, ov_file, and probe preferences when they are specified without a value.
This preference (or seq) is required, and can be used only from the command line. net_name and seq are mutually exclusive and cannot be used together.
| Type | Default Value |
|---|---|
| string | “” |
num_collect_values
Specifies the default maximum number of values to collect for each statistic during a simulation. This value can be changed for a given scenario in the Configure/Run DES dialog box.
| Type | Default Value |
|---|---|
| integer | 100 |
odb_break_if_abort
Specifies that ODB (if running) should pause after reporting an “abort” error.
This preference is available only in development kernels.
| Type | Default Value |
|---|---|
| boolean | FALSE |
odb_break_if_recover
Specifies that ODB (if running) should pause after reporting a “recoverable” error.
This preference is available only in development kernels.
| Type | Default Value |
|---|---|
| boolean | FALSE |
opnet_port
Specifies the IPC port used by the modeler program to communicate with spawned simulations. This preference is for internal modeler use only, and should not be modified or set by the user.
| Type | Default Value |
|---|---|
| integer | 0 |
ov_file
Specifies the name of the output vector file to be used to record vector statistic values from the executing simulation. The .ov suffix of the file should not be included in the preference value. If no name is specified, the network name will be used.
| Type | Default Value |
|---|---|
| string | “” |
ov_mem_size
Specifies the maximum size of the output vector data buffer in megabytes. When a buffer reaches the specified limit, its entries are written to disk, and it resumes the collection of new values. Setting this preference to larger values than the default trades off less writes to disk versus more memory usage. If fragments are allowed to grow too large, the simulation may need to use swap space which will reduce execution speed.
| Type | Default Value |
|---|---|
| integer | 4 |
parallel_sim.serialization_level
Specifies the serialization level used by the parallel kernel. Depending on this preference, only one event per node or one event per module can be executed at any time. See “Parallel Simulation Concepts” on page 400 for details.
| Type | Default Value | Constraints |
|---|---|---|
| enum | node | node, module |
parallel_sim.event_execution_time_window
Specifies a window of simulation time for executing events in parallel. Only events in the same time window are eligible for parallel execution. The default value (0.0) means that only events at the same simulation time are eligible for parallel execution. See “Parallel Simulation Concepts” on page 400 for details.
| Type | Units | Default Value |
|---|---|---|
| double | seconds | 0.0 |
parallel_sim.num_processors
Specifies the number of processors to be used by the Simulation Kernel. This preference applies only to the parallel kernels. If this preference is set to 0 or Maximum, the simulation will try to determine the number of CPUs available and use them all. This value can be changed for a given scenario with the “Number of threads” field on the Kernel Type page of the Configure/Run DES dialog box.
WARNING: Requesting that simulations use more CPUs than are physically present and available will degrade simulation performance dramatically.
| Type | Default Value |
|---|---|
| integer | 1 |
per_module_random_stream
When FALSE, specifies that all random numbers are generated from the same stream. Thus, adding new distributions into a simulation will affect the random numbers seen by existing distributions.
When TRUE, specifies that each module maintains an independent random stream. Calls to op_dist KPs will use the appropriate module’s stream. Thus, adding new nodes or modules will not affect existing modules. This also makes it easier for parallel simulations to have reproducible results.
| Type | Default Value |
|---|---|
| boolean | FALSE for sequential kernels; TRUE for parallel kernels |
probe
Specifies the name of the probe file to be used to guide the collection of statistics and the subsequent recording of vector data by the simulation. The .pb.m suffix of the probe file should not be included in the preference value. If no name is specified, the network name will be used.
| Type | Default Value |
|---|---|
| string | “” |
probe_error_enable
Enables warning messages regarding probe mismatches during simulation loading.
| Type | Default Value |
|---|---|
| boolean | FALSE |
probe_start_time
If positive, specifies a simulation time before which no probing takes place. The start times of individual probes will be taken into account only if later than this time.
| Type | Units | Default Value |
|---|---|---|
| double | seconds | -1.0 |
probe_stop_time
If positive, specifies a simulation time after which no probing takes place. The stop times of individual probes will be taken into account only if earlier than this time.
| Type | Units | Default Value |
|---|---|---|
| double | seconds | -1.0 |
rand_gen_type
Specifies the pseudo-random number generator to use. “Linear-Congruential” is a port of the random() function from the BSD UNIX source distribution, with a period of 2^31-1. “Mersenne-Twister” is a newer algorithm that generates higher quality random numbers with a period of 2^607-1.
| Type | Default Value | Constraints |
|---|---|---|
| enum | Linear-Congruential | Linear-Congruential, Mersenne-Twister |
rand_num_ext_res
Specifies to generate random numbers with extended resolution (that is, with a wider range of possible outcomes). If it is necessary to generate a stream of random numbers compatible with earlier releases of OPNET, assign this preference the value FALSE.
| Type | Default Value |
|---|---|
| boolean | TRUE |
raw_err
Specifies how compiler output should be handled. When FALSE, compiler output is parsed and displayed in tabular form. When TRUE, the raw compiler output is displayed.
This preference can be entered only from the command line.
| Type | Default Value |
|---|---|
| boolean | FALSE |
realtime_ratio
Specifies a speed ratio (relative to real time) that op_runsim uses to control the speed of a cosimulation. Note that the requested speed might be unachievable, in which case the simulation will run as close to the requested speed as possible. For example:
- 0 – run simulation at full speed
- 1 – run in real time
- 0.1 – run 10 times slower than real time (that is, one-tenth of the real-time speed)
- 5 – run 5 times faster than real time
This preference can be set on the Execution > Advanced > Kernel Preferences page of the Configure/Run DES dialog box.
| Type | Default Value |
|---|---|
| double | 0 |
rec_err_suppress
Specifies that the simulation should suppress the printing and logging of recoverable errors.
| Type | Default Value |
|---|---|
| boolean | FALSE |
record_gstats
Specifies that the simulation should record all global statistics in the output vector file, regardless of the probe definitions.
| Type | Default Value |
|---|---|
| boolean | FALSE |
reports
Specifies the set of report probe files to use during the simulation.
| Type | Default Value |
|---|---|
| string list | <empty> |
repositories
Specifies the set of code repositories to load for a simulation. If you specify repository files, op_runsim uses them instead of the default set.
| Type | Default Value | Constraints |
|---|---|---|
| string list | <empty> |
<empty>, “none”, “stdmod”, valid repository files |
script_mode
Specifies the ODB scripting mode. The possible values are “none”, “play”, and “record”. If “play” is specified, the simulation will execute the commands in the file specified by the script_name preference immediately after starting ODB. If “record”, the simulation will record all ODB commands in the file specified by script_name.
| Type | Default Value |
|---|---|
| string | “none” |
script_name
Specifies the name of a script file for use with ODB.
| Type | Default Value |
|---|---|
| string | “odb_script” |
seed
Specifies the seed value to be used by the simulation’s random number generator. This generator provides either a simulation-wide random number sequence or seeds for individual per-module sequences, depending on the per_module_random_stream preference. See “Generating Random Numbers” on page 410 for details.
| Type | Default Value |
|---|---|
| integer | 128 |
seq
Specifies the name of a simulation sequence that will be loaded by the simulation. op_runsim will extract the sets from the simulation sequence and generate the required simulation runs, creating support files as needed.
This preference (or net_name) is required, and can be used only from the command line. seq and net_name are mutually exclusive and cannot be used together.
| Type | Default Value |
|---|---|
| string | “” |
sim_packet_sharing
Specifies the packet sharing mode used by the simulation kernel. To reduce simulation run time and conserve memory, packets can be shared when copies are needed (for example, when transmitted to multiple receivers). When packets are copied—either by procedures such as op_pk_copy() or through automatic duplication by the Simulation Kernel—only the packet header is copied at first. The packet copy references the fields in the original packet. Later, if a field of either the original packet or the copy is to be changed, all of the packet fields are copied to the packet copy. The possible values for this preference are:
- Full – All packets are shared. This is the most efficient setting, but requires that the structure fields not be modified directly when in a packet.
- Conservative – [default] All packets are shared except those with information that can be accessed directly by a model (such as structure field content).
- Disabled – Packets are never shared.
| Type | Constraints | Default Value |
|---|---|---|
| enum | conservative, disabled, full | conservative |
sim_process_priority
Specifies the scheduling priority of the discrete event simulation process within the operating system.
| Type | Constraints | Default Value |
|---|---|---|
| enum | normal, high, low (Windows) normal, low, lowest (Linux) ¹ |
normal |
Note 1: Non-superusers on Linux cannot increase the priority of a process.
sim_time_quantum
Specifies the smallest quantum of time, in seconds, that the Simulation Kernel will resolve. For instance, if 1 microsecond is specified (0.000001 or 1e-6), simulation events will occur only on 1-microsecond boundaries. Events scheduled for times that are not multiples of the specified quantum will be rounded to the nearest quantum multiple.
If the value of this preference is zero, simulation time values are not quantized and have the full resolution of double-precision floating-point variables.
| Type | Default Value |
|---|---|
| double | 0.0 |
site_position_cache_size
Specifies how many positions are cached by each mobile site, in addition to the current position. Although caching multiple positions can help the simulation run faster, the speed increase uses additional memory. Requires Wireless functionality.
| Type | Default Value |
|---|---|
| integer | 3 |
sitl_realtime_ratio_check
Specifies whether SITL simulations should generate a warning message if the realtime_ratio simulation preference is not set to 1. (Typically, it should be 1 for a SITL simulation. However, other values are allowed for special cases, such as using SITL to inject data into a simulation.) When TRUE, the message is generated.
| Data Type | Default Value |
|---|---|
| boolean | TRUE |
sla_compute_all_violations
Normally, OPNET does not compute compliance for statistics that are bucketized by default as count, sum over time, or time average. If TRUE, OPNET computes compliance for all statistics.
| Type | Default Value |
|---|---|
| boolean | FALSE |
sla_reports
Specifies the set of service level agreement (SLA) report probe files to use during the simulation.
| Type | Default Value |
|---|---|
| string list | <empty> |
update_interval
Specifies the number of simulation events that are to elapse between printing simulation update messages, which are generated when the verbose_sim preference is set to TRUE.
| Type | Units | Default Value |
|---|---|---|
| double | simulation events | 500,000 |
updates_in_seconds
When TRUE, specifies that the simulation time reported in update messages should be given in seconds instead of the usual hh:mm:ss format.
| Type | Default Value |
|---|---|
| boolean | FALSE |
verbose_cell_size_report
When TRUE, specifies that the simulation generate a report giving the distribution of events per time cell. In parallel simulations, this report also contains the number of events processed in parallel. See “Cell Size Report” on page 404 for details.
This preference is available only in sequential development kernels.
| Type | Default Value |
|---|---|
| boolean | FALSE |
verbose_event_report
When TRUE, specifies that the simulation generate a report giving details about event generation.
This preference is available only in sequential development kernels.
| Type | Default Value |
|---|---|
| boolean | FALSE |
verbose_event_timing_report
When TRUE, specifies that the simulation generate a report giving the average event processing rate per time cell. This report provides a view of the event execution happening in a simulation to analyze its potential for good parallel simulation. See “Event Timing Report” on page 407 for details.
This preference is available only in sequential development kernels.
| Type | Default Value |
|---|---|
| boolean | FALSE |
verbose_load
Specifies that the simulation should print messages to the standard output during its loading phase, describing distribution models as they are loaded.
| Type | Default Value |
|---|---|
| boolean | FALSE |
verbose_packet_report
When TRUE, specifies that the simulation generate a report giving details about packet creation.
This preference is available only in sequential development kernels.
| Type | Default Value |
|---|---|
| boolean | FALSE |
verbose_parallel_speedup_report
When TRUE, specifies that the simulation generate a report predicting the potential increases in execution speed for various numbers of processors. This report can be used to estimate the value of using parallel simulation. See “Parallel Speedup Report” on page 404 for details.
This preference is available only in sequential development kernels.
| Type | Default Value |
|---|---|
| boolean | FALSE |
verbose_sim
Specifies that the simulation print update messages to the standard output during mainline execution (i.e., in the post-loading phase). The messages indicate the number of events that have executed, the elapsed real and simulated times, and the efficiency of the simulation in events-per-second.
| Type | Default Value |
|---|---|
| boolean | FALSE |
Example Usage
% op_runsim -net_name ACE-local_net -debug
|-----------------------------------------------------------------------------|
| ____ _____ _ _ ______ _______ |
| / __ \ | __ \ | \ | || ____||__ __| Simulation and Model Library |
| | | | || |__) || \| || |__ | | Copyright 2014 Riverbed Technology.|
| | | | || ___/ | . ` || __| | | All rights reserved. |
| | |__| || | | |\ || |____ | | as a part of OPNET Release 18.0 |
| \____/ |_| |_| \_||______| |_| |
|-----------------------------------------------------------------------------|
| Application and Network Performance |
|-----------------------------------------------------------------------------|
| Riverbed Technologies / 680 Folsom St., San Francisco, CA 94107, USA |
| WEB: http://www.riverbed.com / TEL: +1.415.247.8800 / FAX: +1.415.247.8801 |
|-----------------------------------------------------------------------------|
| Network Simulation of: ACE-local_net |
|-----------------------------------------------------------------------------|
| Kernel: development (not optimized), sequential |
|-----------------------------------------------------------------------------|
|-----------------------------------------------------------------------------|
| Reading network model (ACE-local_net) |
|-----------------------------------------------------------------------------|
|-----------------------------------------------------------------------------|
| Reading result collection file: (ACE-local_net) |
|-----------------------------------------------------------------------------|
|-----------------------------------------------------------------------------|
| Verifying model consistency. |
|-----------------------------------------------------------------------------|
|-----------------------------------------------------------------------------|
| Loading scenario model library. |
|-----------------------------------------------------------------------------|
|-----------------------------------------------------------------------------|
| Counting objects. |
|-----------------------------------------------------------------------------|
|-----------------------------------------------------------------------------|
| Allocating objects. |
|-----------------------------------------------------------------------------|
|-----------------------------------------------------------------------------|
| Allocating objects. |
|-----------------------------------------------------------------------------|
|-----------------------------------------------------------------------------|
| Allocating attributes. |
|-----------------------------------------------------------------------------|
|-----------------------------------------------------------------------------|
| Installing subnetworks and nodes. |
|-----------------------------------------------------------------------------|
|-----------------------------------------------------------------------------|
| Installing links. |
|-----------------------------------------------------------------------------|
|-----------------------------------------------------------------------------|
| Constructing model hierarchy. |
|-----------------------------------------------------------------------------|
|-----------------------------------------------------------------------------|
| Creating node contents. |
|-----------------------------------------------------------------------------|
|-----------------------------------------------------------------------------|
| Attaching links to nodes. |
|-----------------------------------------------------------------------------|
|-----------------------------------------------------------------------------|
| Preparing for results collection. |
|-----------------------------------------------------------------------------|
|-----------------------------------------------------------------------------|
| Releasing Model Memory. |
|-----------------------------------------------------------------------------|
|-----------------------------------------------------------------------------|
| Opening results file. |
|-----------------------------------------------------------------------------|
|-----------------------------------------------------------------------------|
| Final initializations for all objects. |
|-----------------------------------------------------------------------------|
|-----------------------------------------------------------------------------|
| Initializing results. |
|-----------------------------------------------------------------------------|
|-----------------------------------------------------------------------------|
| Loading OPNET Debugger. |
|-----------------------------------------------------------------------------|
_______________ OPNET Simulation Debugger _______________
Type 'help' for Command Summary
odb> quit
|-----------------------------------------------------------------------------|
| Simulation Completed - Collating Results. |
| Simulated: Time (0 sec.), Events (26) |
| Time: Elapsed (8 sec.) |
|-----------------------------------------------------------------------------|
%