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:

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
----------------------------------------------

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com