op_mksim
A utility that binds a simulation together from its components: the simulation object code file, the associated model archive, and the Simulation Kernel libraries.
Description
Most Riverbed Modeler models are created and run from within the main program, which provides a comprehensive, interactive interface for this purpose. However, Riverbed Modeler also provides an alternative, external interface for creating and modifying models when functions in external archive libraries (.a files) must be linked into a simulation, as well as a mechanism for running simulations in a source-level debugger.
There are separate Riverbed Modeler tools available for externally accomplishing each stage of constructing a simulation. The component models of simulations (network, node, process, and parameter models) can be created by external, Ema-based applications. Process models, pipeline stages, and external code files can be compiled by the op_mko utility. Finally, the op_mksim utility is used to generate .sim files, which can be executed as an external simulation.
The purpose of op_mksim is to bind (link) together process model object code files and the simulation kernel into an executable simulation program. The simulation repository associated with the indicated network model is always reconstructed before it binds the simulation.
Note: You must have an unexpired product license available to run simulations. If a static executable built with op_mksim cannot find a valid license installed on your system, it terminates with an error message. If you are running static simulations in Windows, you must also ensure that <reldir>/sys/pc_intel_win32/bin is the first directory listed in your PATH environment.
Preferences
This program supports the following preference sets:
- “Standard Preferences”
- “Diagnostics” preferences (except diag_enable and rec_err_suppress)
- “Development” preferences
- “Licensing Preferences”
This program also supports the following additional preferences.
arch_prog
Specifies the ECI translation program or script to invoke to create a static library. For more information, see Chapter 5 “External Compiler Interface” on page 260.
| Type | Default Value |
|---|---|
| string | “” |
c
Specifies that all process models referenced by modules in the network model are to be recompiled prior to binding the simulation. This preference implicitly forces the option represented by the a preference, because the simulation archive must be reconstructed to include all the recompiled process models. This option is useful when a simulation needs to be comprehensively rebuilt from its basic components, such as situations where it is not known which process models have been changed since the last build.
| 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 |
net_name
Specifies the base name of the network model that is to be used as the basis of the simulation. The file path or file type suffix should not be included in the value of this preference.
This preference is required and can be entered only from the command line.
| Type | Default Value |
|---|---|
| string | none |
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 |
Example Usage
% op_mksim -net_name sample_net
----------------------------------------------
op_mksim: Simulation (/usr/fbasas/op_models/sample_net.sim) Produced
----------------------------------------------