GUI

GUI preferences specify options that affect the graphical user interface. These preferences are accepted by all programs with a GUI.

allow_rotated_world_coordinates

Allows subnets with degree units and 360 degree spans to wrap in the x direction. If TRUE, subnets can span the International Date Line (180 degrees longitude). If FALSE, subnets cannot span the International Date Line. Instead, subnets must be placed entirely on either one side of the International Date Line or the other side.

Data Type Default Value
boolean FALSE

annot_fonts.large

Specifies the font used for large text annotations.

Data Type Default Value
string “family:Lucida Console-size:9”

annot_fonts.medium

Specifies the font used for medium text annotations.

Data Type Default Value
string “family:Lucida Console-size:8”

annot_fonts.small

Specifies the font used for small text annotations.

Data Type Default Value
string “family:Lucida Console-size:7”

async_cmd_mode

Specifies whether the GUI program should accept external asynchronous commands. Currently opnet is the only GUI program that supports this preference.

Data Type Default Value
boolean FALSE

async_cmd_port

Specifies a particular UDP/IP port to open for reception of asynchronous commands. opnet is the only GUI program that supports this preference.

Data Type Default Value
integer 3567

async_cmd_trace

Specifies whether asynchronous communication trace information will be printed in the shell window. opnet is the only GUI program that supports this preference.

Data Type Default Value
boolean FALSE

browser_prog

Specifies the full path name of an HTML browser program for viewing web reports and online documentation.

Data Type Default Value
string “”

check_subnet_bounds

Specifies whether to enforce subnet bounds checking on the positions of contained sites. When TRUE, subnet bounds are checked.

Data Type Default Value
boolean TRUE

code_editor_prog

Specifies the full path name of the text editor program to use for editing C/C++ source code. The special value “editor_prog” means that the text editor specified by the editor_prog preference should be used.

Data Type Default Value
string “editor_prog”

console

When TRUE, specifies that the application console should be used for stdout and stderr messages.

Data Type Default Value
boolean FALSE

creation_mode

Specifies the mode for creating objects with the mouse. “repeat” allows the user to continue to create instances of the object until the operation is ended with a right-click. “single” automatically ends the operation after only one object is created.

Data Type Constraints Default Value
enum repeat, single repeat

des.close_after_next_step

Specifies whether the "Next Steps Page" should close the Simulation Progress dialog box when a next step has been selected. When FALSE, the dialog box remains open.

Type Default Value
boolean FALSE

des.configuration_mode

Specifies the interface used for configuring and executing discrete event simulations. The available modes are as follows:

  • simple mode – offers a streamlined user interface with basic configuration options; only one run is supported
  • detailed mode – supports all configuration options and multiple runs
  • advanced mode – supports all configuration options and multiple sets of runs (also called Simulation Sequence Editor)
Type Constraints Default Value
enum simple, detailed, advanced “detailed”

des.confirm_advanced_mode

Specifies whether a confirmation dialog box appears if Modeler automatically enters advanced mode when either simple or detailed mode is specified by the des.configuration_mode preference. This can happen when the simulation sequence being opened was previously configured with features not supported by simple or detailed mode (such as having only some of the defined simulation runs selected for execution).

Type Default Value
boolean TRUE

des.confirm_detailed_mode

Specifies whether a confirmation dialog appears if Modeler automatically enters detailed mode when simple mode is specified by the des.configuration_mode preference. This can happen when the simulation sequence being opened was previously configured with features not supported by simple mode (such as multiple simulation runs).

Type Default Value
boolean TRUE

des.console_mode

When TRUE, specifies that simulations should run in a native OS console, allowing them to interact with the user through the standard input (stdin). If both des.console_mode and console are TRUE, simulation input and output is through the application console.

Note: Because using a native console affects I/O redirection, setting this preference to TRUE disables the graphical ODB interface.

Type Default Value
boolean FALSE

des.force_compilation_once

When TRUE, turns off a simulation’s “Force model recompilation” option. As a result, recompilation of all model files used by the network will be forced only once, instead of each time the simulation is run. (The “Force model recompilation” option is set on the Execution > Advanced > Compilation page of the Configure/Run DES dialog box.)

Type Default Value
boolean FALSE

des.run_count_prompt_level

Specifies the minimum number of simulation runs that will cause Modeler to prompt whether to execute these runs. By default, you are prompted when about to start a simulation involving 10 or more runs. This preference lets you change this threshold to avoid prompts when large numbers of runs are expected.

Type Default Value
integer 10

des.show_next_steps

Specifies whether the "Next Steps Page" should be shown when a simulation completes. When TRUE, this page is automatically displayed.

Type Default Value
boolean TRUE

diagram_prog

Specifies the full executable path of Microsoft Visio or other network drawing application/viewer. After exporting to a Visio-formatted file, the specified executable is used to open the exported file.

Data Type Default Value
string ““

disable_message_confirmations

Specifies whether to display interactive message confirmations. If TRUE, interactive message confirmations are not displayed.

Data Type Default Value
boolean FALSE

disable_message_tips

Specifies whether to display pop-up message tips. If TRUE, pop-up message tips are not displayed.

Data Type Default Value
boolean FALSE

disable_object_operations

Specifies whether to show operation buttons in the Advanced Object Attribute editor. If TRUE, operation buttons in the Advanced Object Attributes editor are not shown.

Data Type Default Value
boolean FALSE

disable_object_palette_configuration

Specifies whether to show the Configuration button in object palettes. If TRUE, the Configure button in object palettes is not shown.

Data Type Default Value
boolean FALSE

disable_object_palette_model_properties_display

Specifies whether to display model details when right-clicking on a icon in the object palette. If TRUE, model details are not displayed.

Data Type Default Value
boolean FALSE

display

Specifies an identifier for a display host and server for remote graphics. The GUI-based program will send its X Window System graphics requests to the server indicated by this preference. The X server must be configured to permit graphics access from the host running the GUI-based program (this can be checked and modified via the X Window System xhost program). The host computer running the GUI-based program must be able to reach the display host via the IP network protocol.

The value of this preference must be of the form: <hostname>:<display_number>.<screen_number>. The hostname can be an IP address or a configured machine name. The display number and screen number are zero-based integers and are usually zero.

Data Type Default Value
string “:0.0”

display_timezone_string

Specifies whether the user-selected time zone (as specified by the timezone preference) is displayed in date/time strings. When FALSE, the time zone is not displayed.

Data Type Default Value
boolean FALSE

Specifies the font used to display link utilization values.

Data Type Default Value
font Tahoma, MS Sans Serif, medium

double_click.demand

Specifies the action that occurs when a user double-clicks on a demand object. Changes to this preference take effect immediately.

Data Type Constraints Default Value
enum edit_attributes, set_name, view_description, no_action edit_attributes

double_click.drawing_annotation

Specifies the action that occurs when a user double-clicks on a drawing annotation. Changes to this preference take effect immediately.

Data Type Constraints Default Value
enum edit_attributes, no_action edit_attributes

Specifies the action that occurs when a user double-clicks on a link object. Changes to this preference take effect immediately.

Data Type Constraints Default Value
enum no_action, edit_attributes, set_name, view_description, view_results, edit_link_model no_action

double_click.node

Specifies the action that occurs when a user double-clicks on a node object. Changes to this preference take effect immediately.

Data Type Constraints Default Value
enum set_name, edit_attributes, no_action, view_results, view_description, edit_node_model set_name

double_click.packet_stream

Specifies the action that occurs when a user double-clicks on a packet stream in the Node Editor. Changes to this preference take effect immediately.

Data Type Constraints Default Value
enum set_name, edit_attributes, no_action set_name

double_click.path

Specifies the action that occurs when a user double-clicks on a path object. Changes to this preference take effect immediately.

Data Type Constraints Default Value
enum no_action, edit_attributes, path_viewer, set_name, path_description no_action

double_click.state_transition

Specifies the action that occurs when a user double-clicks on a state transition in the Process Editor. Changes to this preference take effect immediately.

Data Type Constraints Default Value
enum no_action, edit_attributes no_action

double_click.text_annotation

Specifies the action that occurs when a user double-clicks on a text annotation. Changes to this preference take effect immediately.

Data Type Constraints Default Value
enum edit_text, edit_attributes, no_action edit_text

doubleclickinterval

Specifies the maximum allowed time interval, in seconds, between two mouse clicks for the clicks to be interpreted as a “double click” rather than two “single clicks.” Users with fast input styles may want to set this preference low (e.g., under the default of a quarter-second), thus avoiding incorrectly detected double-clicks. Users with slow input styles may want to set this preference high (e.g., closer to a half-second), thus ensuring that slow double-clicks will be detected.

Data Type Default Value
double 0.25

drag_obj_threshold

Specifies the maximum number of objects to show while dragging. When the number of objects being dragged is less than this value, a separate drag outline is drawn for each object. When the number is equal to or greater than this value, only two outlines are drawn—a small one representing the object the cursor is on and a large rectangle encompassing all of the dragged objects.

Data Type Default Value
integer 32

Specifies the default setting of the “Create right-angled link” checkbox on the object palette. Valid values are TRUE (on) and FALSE (off).

Data Type Default Value
boolean FALSE

edit_attr_confirm_handler_for_all

Specifies how the ETS attribute confirm handler should be called when “Apply changes to selected objects” is checked in the Edit Attributes dialog box. When FALSE, the handler is called only for the object being edited. When TRUE, the handler is called for all selected objects. (See "Confirm Handler Functions" on page 50 for details.)

Note: This preference should be changed only by developers using OPNET Development Kit.

Data Type Default Value
boolean FALSE

edit_pad.default_height

Specifies the initial height of text editor windows, in pixels.

Data Type Default Value
integer 480

edit_pad.default_width

Specifies the initial width of text editor windows, in pixels.

Data Type Default Value
integer 640

edit_pad.drag_and_drop

Specifies whether drag-and-drop editing is used by the built-in text editor. When TRUE, drag-and-drop editing is permitted.

Data Type Default Value
boolean FALSE

edit_pad.font

Specifies the font used by the built-in text editor.

Data Type Default Value
string Windows: “family:Lucida Console-size:8”
Linux: “ ”

edit_pad.selection_background_color

Specifies the background color for selected text in the built-in text editor.

Data Type Default Value
string RGB000

edit_pad.selection_color

Specifies the text color for selected text in the built-in text editor.

Data Type Default Value
string RGB333

edit_pad.show_line_number

Specifies whether the built-in text editor shows line numbers for the displayed text. When TRUE, line numbers are shown.

Data Type Default Value
boolean TRUE

edit_pad.text_background_color

Specifies the background color for text in the built-in text editor.

Data Type Default Value
string RGB333

edit_pad.text_color

Specifies the color of text in the built-in text editor.

Data Type Default Value
string RGB000

edit_pad.word_wrap

Specifies whether the built-in text editor should wrap lines of text when reaching the edge of the display area. When FALSE, lines are not wrapped and thus continue out of sight.

Data Type Default Value
boolean FALSE

editor_config

Specifies the name of the editor configuration file used by the program. This file defines the operations and menu layouts for the program.

The value of this preference changes only at start-up.

Data Type Default Value
string “”

editor_keep

External text editor programs such as vi and emacs can be used to provide text-editing functions for GUI applications. Temporary files are created to transfer content between the editor program and the application. If this preference is set to FALSE, these temporary files are automatically removed when the text editor exits. Otherwise, they are kept in the user's <op_admin>/tmp directory.

Data Type Default Value
boolean FALSE

editor_prog

Specifies a text editor program to be used when editing text files other than source code. (Use the code_editor_prog preference to specify a source code editor.) The default value is “builtin”, meaning that a text edit pad should be used (described in "Text Edit Pads" on page 10). However, a path name for any executable program can be specified.

The specified program is invoked with a single argument that is the name of a file containing the initial text to be loaded by the editor program. The GUI application expects the modified text to be present in this same file when the editor program quits. Two shell scripts for Linux (vi_exec and emacs_exec) and one for Windows (notepad_exec.bat) are provided to allow users to make use of vi, emacs, or Notepad as text editors within the GUI.

Data Type Default Value
string “builtin”

ets_oppy.unhandled_exception

Specifies how to respond to unhandled Python exceptions. The possible values and actions are:

  • open_in_window_and_log – Displays the exception in a new window and writes a stack trace to the error log
  • open_in_window – Displays the exception in a new window.
  • write_to_err_log – Writes a stack trace to the error log.
  • ignore – Ignores the exception.
Data Type Constraints Default Value
enum open_in_window_and_log, open_in_window, write_to_err_log, ignore open_in_window_and_log

expanded_subnets_iconic

If FALSE, expanding a subnet removes the subnet icon and creates a bounding box based on the placement of objects in the subnet. If TRUE, the subnet icon remains in place and no bounding box appears. (Note that an object in the expanded subnet can overlap the icon, so it might not be visible.)

Data Type Default Value
boolean FALSE

expanded_subnets_thickness

Specifies the thickness of the borders of expanded subnets, in pixels.

Data Type Default Value
integer 2

flow_spreadsheet_import_filename

Stores the default filename used when importing spreadsheet traffic.

Data Type Default Value
string “”

flow_spreadsheet_import_overwrite

Stores the default choice for overwriting traffic when importing spreadsheet traffic. When FALSE, only the traffic specified in the import file is overwritten. When TRUE, all traffic is replaced by the imported traffic.

Data Type Default Value
boolean FALSE

font

Specifies a default font used by various UI components.

The value of this preference changes only at startup.

Data Type Default Value
string “”

html_export_max_image_width

Specifies the maximum width, in pixels, for exported HTML pages.

The value of this preference changes only at startup.

Data Type Default Value
integer 1024

http_port

Specifies the port number for ASN and web hot links. Set to -1 to disable.

The value of this preference changes only at startup.

Data Type Default Value
integer 81

icon_autosizing.disable

Specifies whether automatic resizing of site icons in the workspace is disabled. When FALSE, autosizing is enabled.

Data Type Default Value
boolean FALSE

icon_autosizing.large_element_count

Specifies a threshold for disabling icon autosizing. When the number of nodes in a subnet exceeds this threshold, icon autosizing is disabled to avoid excessive screen-redraw delays.

Data Type Default Value
integer 500

icon_autosizing.max_neighbors

Specifies the maximum number of overlapping neighbors to consider before minimizing an icon. This number is interpreted loosely, but increasing it will make automatic minimization less likely, and vice versa.

Data Type Default Value
integer 30

icon_dbs

Specifies which icon databases are used by GUI-based programs. Any number of icon databases can be listed, including user-created or user-modified databases. The databases must be stored in a directory listed in the mod_dirs preference and are listed here by name only (no path or suffix).

Programs search the databases for an icon in the sequence in which the databases are listed and use the first instance of the icon found. Thus, you should list the icon databases in the desired order of precedence.

When you use this preference in a preferences file, programs will start up faster if you specify icon databases separately for each program. For example, to specify icon databases for op_vuanim, you add the line:

op_vuanim.icon_dbs: sys, op_vuanim

The value of this preference changes only at start-up.

Data Type Default Value
string list <empty>

image_capture.border_width

Specifies how wide the black border placed around image captures should be.

Data Type Default Value
integer 0

image_capture.include_window_title

Specifies whether to include the window title when a window image is captured. When TRUE, the title is included.

Data Type Default Value
boolean TRUE

image_capture.screen_hot_key

Specifies a special key combination to start an image capture of a selected area of a window, as described in "Capturing a Bitmap Image" on page 841.

Data Type Default Value
string ctrl-shift-t

image_capture.show_in_browser

Specifies whether an image of a window or screen rectangle should be displayed in a browser after capture. When TRUE, the captured image is displayed.

Data Type Default Value
boolean FALSE

image_capture.window_hot_key

Specifies a special key combination to start an image capture of the active window.

Data Type Default Value
string ctrl-t

load_image

Specifies an image to display while the application starts.

This file must be converted to the Modeler image format, placed in the top mod_dirs (op_models) directory, and have a .image file extension.

The value of this preference changes only at startup.

Data Type Default Value
string “”

Specifies whether to display link utilization values in the network topology of the Project Editor.

Data Type Default Value
boolean TRUE

Specifies the style for the display of link utilization values.

Data Type Constraints Default Value
enum white background highlight
white background with box
dynamic color with box
dynamic color highlight
plain black text
“white background highlight”

map_cities_label_color

Specifies the color of the city labels in the background map.

Data Type Default Value
color gray50

map_cities_symbol_override_color

Specifies the override color for all city symbols in the background map.

Data Type Default Value
color gray50

map_cities_symbol_color_override_enable

Specifies whether to use a single override color for all city symbols in the background map. This color is specified by the map_cities_symbol_override_color preference.

Data Type Default Value
boolean TRUE

mark_nondefault_attrs

Specifies whether to use color in the Edit Attributes dialog box to highlight attributes that do not inherit their default value. When TRUE, attributes whose values are Intended or Changed have a colored background.

Data Type Default Value
boolean FALSE

mark_nondefault_attrs.changed_color

Specifies the color used to highlight values that have been changed in the current instance of an Edit Attributes dialog box.

Data Type Default Value
string #FFDFBF

mark_nondefault_attrs.intended_color

Specifies the color used to highlight values that do not inherit their attribute’s default value, but which have not been changed in the current instance of an Edit Attributes dialog box.

Data Type Default Value
string #BFBFFF

mark_nonfiltered_attrs

Specifies whether to color-code the filter results in the Attributes dialog box. Color coding the results makes it easier to identify matching attributes.

Data Type Default Value
boolean FALSE

mark_nonfiltered_attrs.builtins

Specifies the color of “built-in” attributes. These attributes are not filtered and are always displayed.

Data Type Default Value
color #FFFFBF

mark_nonfiltered_attrs.match

Specifies the color for matching filter results.

Data Type Default Value
color #BFBFFF

mark_nonfiltered_attrs.parent_of_match

Specifies the color for parents of matching filter results. Parents are included in the filter results to maintain the attribute hierarchy.

Data Type Default Value
color #BFFFBF

mark_nonfiltered_attrs.prominent

Specifies the color for associated attributes of matching filter results. Associated attributes are included in the filter results because they support the matching attribute.

Data Type Default Value
color #FFBFBF

mark_nonfiltered_attrs.symbol_match

Specifies the color for matching filter results when the match is a value that can be selected for an attribute.

Data Type Default Value
color #BFBFBF

model_name

Specifies the name of a model to open when the program starts.

Data Type Default Value
string “”

move_delta

Specifies the number of pixels the mouse must move before the drag-and-drop operation is initiated.

Data Type Default Value Units
integer 10 pixels

netbiz_show_promote_button

Specifies whether a Promote button is displayed in the attribute dialog boxes of a Netbiz application. When TRUE, the Promote button is displayed.

Data Type Default Value
boolean FALSE

network_add_world_map_to_new_models

Specifies whether a world map should be included in the top subnet of newly created network models. When TRUE, the map is automatically included.

Data Type Default Value
boolean TRUE

network_layout.adjust_unconnected_groups

Specifies whether the spacing of unconnected groups of nodes in a subnet should be adjusted. This preference applies to automatic layout operations using the balanced algorithm (such as during a topology import or as part of the "Lay Out Nodes (Balanced)" operation). Setting this preference to FALSE turns off adjustment of unconnected groups and might speed up the layout operation.

Data Type Default Value
boolean TRUE

Specifies the maximum number of overlapping links between nodes that will be represented with bends by an automatic balanced layout operation (such as during a topology import). The default value of –1 means no limit.

Data Type Default Value
integer –1

network_layout.use_140_balanced_layout_algorithm

Specifies whether to use the balanced layout algorithm that was in place for version 14.0 and prior.

Data Type Default Value
boolean FALSE

network_layout.use_simple_threshold

Specifies the number of sites in a subnet that will trigger the use of a simple, but efficient, layout algorithm instead of the more balanced algorithm. The simple algorithm corresponds to the "Lay Out Nodes (Simple)" operation. Topology imports use this preference to determine which layout algorithm to use.

Data Type Default Value
integer 1000

Specifies whether to scale link thickness using a threshold inferred from the thresholds of attached nodes. When TRUE, link thickness will be narrowed as the icons of the attached nodes are scaled down during zoom operations.

Data Type Default Value
boolean FALSE

network_palette.style

Specifies whether the default display of the Object Palette is the Tree View style or the Icon View style.

Data Type Constraints Default Value
enum treeview, iconview treeview

network_path_add_subnet_single_left_click

Specifies whether subnets can be added to a path object with a single left click, rather than from a right-click menu. When TRUE, the left-click method is enabled.

Data Type Default Value
boolean FALSE

network_positions_in_deg_min_sec

Specifies how the Project Editor displays degree-position attributes when a subnetwork’s view properties are expressed in degrees. When TRUE, degrees are displayed in degrees-minutes-seconds format (e.g., 39 52' 46.30"). When FALSE, degrees are displayed in decimal format (39.8795). You can set an object’s x_position and y_position attributes using either format, regardless of this preference’s setting.

Data Type Default Value
boolean FALSE

Specifies whether to show links from an object in one subnet to objects in parent and sibling subnets. When TRUE, such links are shown.

Data Type Default Value
boolean TRUE

network_use_trx_prompt

Specifies whether to open the transceiver/port chooser dialog box when a user is manually hooking up links. When TRUE, the transceiver/port chooser is opened. When FALSE, the transceivers and port are chosen automatically.

Data Type Default Value
boolean TRUE

Specifies whether to activate the link bundling feature. Additionally, if activated, this preference specifies the default display of bundled links: collapsed or expanded (fanned-out).

Data Type Constraints Default Value
enum form link bundles (collapse by default), form link bundles (always fan out), never form link bundles “form link bundles (collapse by default)”

network_visualization.collapse_peripheral_nodes

Specifies whether to collapse all peripheral nodes to their highest common ancestor which is not the parent of the current subnet.

Data Type Default Value
boolean FALSE

network_visualization.icon_style

Specifies whether to use the default icons or the chassis icons for nodes.

Data Type Constraints Default Value
enum Default, Chassis Default

network_visualization.minimized_icon_pixel_threshold

Specifies the size threshold (in pixels) at which icons should be minimized. If an icon is scaled to this size or smaller, the icon is drawn according to the network_visualization.minimized_icon_size preference.

Data Type Default Value
integer 12

network_visualization.minimized_icon_size

Specifies the size of a minimized icon, in pixels.

Data Type Default Value
integer 6

network_visualization.node_label_style

Specifies the background color of the node label.

Data Type Constraints Default Value
enum None, White background, White box None

network_visualization.peripheral_node_hide_title

Specifies whether to hide peripheral node names.

Data Type Default Value
boolean TRUE

network_visualization.peripheral_node_icon

Specifies the icon used to represent peripheral nodes.

Data Type Default Value
string “default icon”

network_visualization.peripheral_node_label

Specifies whether to use hierarchical name for peripheral node labels. Hierarchical names include all the parent subnet names prepended to the node name.

Data Type Constraints Default Value
enum full hierarchical name, base name only “full hierarchical name”

network_visualization.peripheral_node_location

Specifies the default placement of peripheral nodes.

Data Type Constraints Default Value
enum project to node location, arrange along closest subnet bound “project to node location”

network_visualization.peripheral_node_max_icon_size

Specifies the maximum size of peripheral nodes, in pixels.

Data Type Default Value
integer 15

network_visualization.show_demand_labels

Specifies whether demands are labeled when drawn in the workspace.

Data Type Constraints Default Value
enum always, never never

network_visualization.show_labels_icon_pixel_threshold

Specifies the size threshold (in pixels) for labeling nodes. If a node’s icon is larger than this size and the network_visualization.show_node_labels preference is set to “for_icons_larger_than_specified”, the node’s label is displayed.

Data Type Default Value
integer 12

Specifies which links are drawn with arrowheads.

Data Type Constraints Default Value
enum always, for_simplex_links_only, never for_simplex_links_only

Specifies whether links are labeled when drawn in the workspace.

Data Type Constraints Default Value
enum always, for_off_page_links_only, never never

network_visualization.show_node_label_outline

Specifies whether to display a shadow behind the label text for nodes and subnets. Depending on the background, a label text shadow can enhance visibility and contrast. This preference is especially helpful when placing nodes on a detailed background, such as a MIF map or a CADRG image.

Data Type Default Value
boolean TRUE

network_visualization.show_node_labels

Specifies whether nodes are labeled when drawn in the workspace. The size for the “for_icons_larger_than_specified” option is specified by the network_visualization.show_labels_icon_pixel_threshold preference.

Data Type Constraints Default Value
enum always, for_non_minimized_icons, for_full_icons, for_icons_larger_than_specified, never for_non_minimized_icons

network_visualization.show_path_labels

Specifies whether paths are labeled when drawn in the workspace.

Data Type Constraints Default Value
enum always, never never

network_world_map.default_cities_style

Specifies the cities (by population size) to display on background maps.

Data Type Constraints Default Value
enum show when appropriate, show larger than 50K, show larger than 100K, show larger than 500K, show larger than 1M, do not show “show when appropriate”

network_world_map.default_ocean_style

Specifies whether to display bodies of water in blue on background maps.

Data Type Constraints Default Value
enum show when appropriate, do not show “show when appropriate”

network_world_map.default_region_style

Specifies whether to display land (with country, state, province borders) on background maps.

Data Type Constraints Default Value
enum show when appropriate, show borders only, do not show “show when appropriate”

network_world_map.deprecated_border_map_behavior

Specifies whether to suppress deprecated boarder maps in subnets.

Data Type Constraints Default Value
enum suppress showing, do not suppress “suppress showing”

network_world_map.deprecated_mif_map_behavior

Specifies whether to suppress deprecated MIF maps in subnets.

Data Type Constraints Default Value
enum suppress showing, do not suppress “suppress showing”

network_world_map.update_behavior

Specifies whether to replace deprecated maps with new maps. Replaced maps are retained, but they are not displayed. Select from the following:

Data Type Constraints Default Value
enum replace deprecated mif and border maps – Specifies to display deprecated MIF and border maps. In addition to this setting, you must use Background > Set Properties to display the deprecated MIF and boarder maps.
replace deprecated border maps – Specifies to display deprecated border maps. In addition to this setting, you must use Background > Set Properties to display the deprecated border maps.
do not replace automatically – Specifies that the deprecated maps are hidden.
“replace deprecated mif and border maps”

node_model_change_warning

Specifies whether a warning appears when changing the “model” attribute of a node.

Data Type Default Value
boolean TRUE

obj_dbox_default_keywords

Specifies the default filter results for keyword filtering in the Edit Attributes dialog box.

Data Type Default Value
string list ““

obj_dbox_headers

Specifies text strings to be displayed in the Edit Attributes dialog box of objects. Each string contains four pieces of information, separated by commas:

  • <label_text> – A label indicating the value displayed, such as “Type: ” or “Model: ”.
  • <label_tooltip> – The text that appears in the tooltip when a user rests the cursor over the label.
  • <value_tooltip> – The text that appears in the tooltip when a user rests the cursor over the label.
  • <value_text> – The data that appears in the value field. You can specify data from the model’s preference list and self-description for this field.

For information about the text strings used in this preference, see "Edit Attributes" on page 361.

Data Type Default Value
string list <empty>

orbit_draw_style

Specifies whether satellite orbits are drawn as dashed or solid lines.

Data Type Constraints Default Value
enum dashed, solid dashed

panels_close_behavior

Specifies the behavior of the close box in analysis panels, as follows:

  • query – Clicking the close box opens a dialog giving the option to hide or remove the panel, or cancel the operation.
  • hide – Clicking the close box hides the panel.
  • remove – Clicking the close box removes the panel.
Data Type Constraints Default Value
enum query, hide, remove query

panels_tile_columns_size

Specifies the number of columns to use when tiling analysis panels.

Data Type Default Value
integer 1

panels_tile_rows_size

Specifies the number of rows to create when tiling analysis panels.

Data Type Default Value
integer 1

panels_tile_sizing_automatic

Specifies how analysis panels are sized when being tiled. When TRUE, panel sizes are calculated based on the number of panels and the window size. When FALSE, panels are tiled using the sizes specified by panels_tile_x_size and panels_tile_y_size.

Data Type Default Value
boolean TRUE

panels_tile_spacing

Specifies the desired spacing between tiled analysis panels, in pixels.

Data Type Default Value
integer 1

panels_tile_x_size

Specifies the desired horizontal size of tiled analysis panels, in pixels.

Data Type Default Value
integer 35

panels_tile_y_size

Specifies the desired vertical size of tiled analysis panels, in pixels.

Data Type Default Value
integer 35

process_edit_close_on_save

Specifies whether the Process Editor should automatically close a built-in code editor when the contents are saved.

Data Type Default Value
boolean FALSE

process_edit_forced_state_color

Specifies the color used to display forced states in the Process Editor.

Data Type Constraints Default Value
enum green, white, yellow, blue, red, black green

process_edit_new_transition_color

Specifies the color used to display newly created transitions in the Process Editor. Existing transitions are not affected.

Data Type Default Value
string RGB000

process_edit_show_full_titles

Specifies whether the Process Editor should display the full title of each state, instead of only what fits in a state’s circle.

Data Type Default Value
boolean FALSE

process_edit_show_line_counts

Specifies whether the Process Editor should display a count of the lines of code in the enter and exit executives. When TRUE, this information is shown below each state.

Data Type Default Value
boolean FALSE

process_edit_unforced_state_color

Specifies the color used to display unforced states in the Process Editor.

Data Type Constraints Default Value
enum red, white, yellow, blue, green, black red

program_banner

Specifies the text that appears as the title of the program window. The title is usually taken from the program’s configuration file, which is overridden if this preference is given a value.

The value of this preference changes only at startup.

Data Type Default Value
string “”

program_resources

Specifies program resources (.wrc files) to be used in addition to those specified in the <product>.ets file.

The value of this preference changes only at startup.

Data Type Default Value
string list <empty>

progress_bar_max_size

Specifies the maximum number of updates to a progress bar that has a definite size.

Data Type Default Value
integer 200

progress_bar_update_interval

Specifies the minimum time, in seconds, between updates for indeterminate (barber pole) progress bars.

Data Type Default Value
double 1.5

project_backup_on_dont_save

Specifies whether to back up project files when exiting the Project Editor. When TRUE, projects are backed up regardless of whether they were saved. When FALSE, projects are backed up only if saved.

Data Type Default Value
boolean FALSE

project_editable_attributes

Specifies a list of attributes that can be modified even if a project is read-only.

Data Type Default Value
string list <empty>

project_readonly

Specifies whether projects should be opened as read-only. When TRUE, projects cannot be modified (except for attributes listed by project_editable_attributes).

Data Type Default Value
boolean FALSE

recent_files_limit

Specifies the maximum number of recent files to list for each type of editor in the File > Recent Files list.

Data Type Default Value
integer 5

report_top_n

Specifies the number of objects that will be included in the top results reports (including SLA reports). See "Project Editor" for details on top results reports.

Data Type Default Value
integer 5

scenario_name

Specifies the name of a scenario to open initially in the Project Editor. (This is only useful if the model_name preference has been supplied and the Project Editor is used to open the model.)

The value of this preference changes only at startup.

Data Type Default Value
string “”

select_live_network

When TRUE, objects are selected dynamically as you click and drag the mouse in the Project Editor workspace. When FALSE, objects are not selected until you release the mouse button.

Data Type Default Value
boolean TRUE

select_live_node

When TRUE, objects are selected dynamically as you click and drag the mouse in the Node Editor workspace. When FALSE, objects are not selected until you release the mouse button.

Data Type Default Value
boolean TRUE

self_desc_validate

Specifies whether self-descriptions should be validated. When TRUE, all self-descriptions are validated before importing a network. When FALSE, all information currently stored in the self-description database is assumed to be correct, even though it might be out-of-date with respect to node model changes, additions, and removals.

Data Type Default Value
boolean TRUE

show_ca_count

When TRUE, specifies that the count column appears in compound object attribute dialog boxes.

Data Type Default Value
boolean False

show_network_browser_threshold

Specifies the minimum number of nodes required in the project for the Network Browser to automatically display after an import.

Data Type Default Value
integer 250

show_subnet_outline

A subnet outline shows the geographic boundaries of a subnet, and appears as a square around its corresponding subnet icon in the Project Editor workspace. A new preference (show_subnet_outline) enables you to show or hide all subnet outlines in the Project Editor window.

Data Type Default Value
boolean True

show_units

Specifies whether the units column appears in object attribute dialog boxes.

Data Type Default Value
boolean False

sim_duration_default

Specifies the default duration for simulations, in hours.

Data Type Default Value
double 1

splash_image

Specifies the image to display in the main application window.

This file must be converted to the Modeler image format, placed in the top mod_dirs (op_models) directory, and have a .image file extension.

The value of this preference changes only at startup.

Data Type Default Value
string “”

subnet_hierarchy.interactive.reparenting_disable

Disables the ability to move nodes from one subnet to another subnet using either drag and drop or right-click operations.

Data Type Default Value
boolean FALSE

suppress_use_startup_wizard_checkbox

Specifies whether the checkbox “Use Startup Wizard when creating new scenarios” appears on the dialog box when specifying the name of a new scenario.

This preference is used with the use_startup_wizard preference.

Data Type Default Value
boolean FALSE

system_window_behavior

Specifies how the system (main application) window should behave. The following behaviors are available:

  • show_if_last – the system window will unhide and come to the front when the last editor window is closed, thus allowing the user to open a new editor window.
  • quit_if_hidden – the application will quit without showing the system window when the last editor window is closed. The user must restart the application to open a new editor.
  • hide_on_startup – same as quit_if_hidden, plus the application will start up with the system window hidden if an editor has been opened via a preference setting.
  • hide_when_inactive – same as hide_on_startup, plus the system window will hide automatically whenever an editor is opened. The system window must be explicitly opened via the Windows > System Window operation.
Data Type Constraints Default Value
enum show_if_last, quit_if_hidden, hide_on_setup, hide_when_inactive show_if_last

timezone

Specifies the time zone for the current product session.

Data Type Default Value
enum “local timezone”

title_autoplacing.directions

Specifies allowable directions (relative to an icon) for placing a site label.

Data Type Constraints Default Value
enum bottom/top/right/left, bottom/top, bottom/right/left, bottom “bottom/top/right/left”

title_autoplacing.disable

Specifies whether automatic placement of site labels in the workspace is enabled or disabled. When FALSE, autoplacement is enabled.

Data Type Default Value
boolean FALSE

title_autoplacing.try_small_font

Specifies whether automatic placement of site labels can try a smaller font to make a label fit. When FALSE, a smaller font is not tried.

Data Type Default Value
boolean FALSE

tool_name

Specifies the name of a tool (such as the Project Editor) to open when the program starts.

Data Type Default Value
string “”

tool_open_save_behavior

Configures the file browser interface used when files are opened and saved. There are has two interfaces for opening and saving files:

  • The Windows-style browser, which is useful in the following situations:
  • The traditional browser, which was the standard interface in release 11.5 and earlier. This browser is useful in the following situations:
    • When you want to see all models of a specific type that reside in your model directories
    • If you prefer the traditional interface for opening and saving files

When you use the traditional browser, you are restricted your current model directories: you cannot open a file from, or save a file to, a directory unless it is listed in the mod_dirs preference. To add a directory to your model directories, choose File > Add Model Directory.

This preference has the following settings:

  • always_browse – Always use a Windows-style file browser.
  • always_browse_and_update_mod_dirs – Always use a Windows-style file browser. When a user saves a file to a directory that is not included in mod_dirs, update mod_dirs to include that directory.
  • never_browse – Use the traditional (release 11.5 and earlier) file browser. With this option selected, you are restricted to the set of current model directories (that is, the directories listed in the mod_dirs preference).
  • browse_button_some – Use the traditional (release 11.5 and earlier) file browser; include a Browse button for those editors so specified in the modeler.ets file.
  • browse_button_all – Use the traditional (release 11.5 and earlier) file browser, including a Browse button, for all editors.
Data Type Constraints Default Value
enum always_browse_and_update_mod_dirs, browse_button_some, browse_button_all, never_browse, always_browse always_browse_and_update_mod_dirs

tool_open_start_dir

Specifies the starting directory for the file browser opened when editors are opened and saved (if specified by the tool_open_save_behavior preference).

The value of this preference changes only at startup.

Data Type Default Value
string “”

tool_override_dir_behavior

Specifies whether typed files in the same directory as a browsed-to model file also should be included in the FIles window of the Open dialog box. The following behaviors are available:

  • same_name – typed files with the same base name are included.
  • specific_file – only the browsed-to file is included.
  • all_files – all typed files in the directory are included (these files override any identically named files in other mod_dirs directories).

The value of this preference changes only at startup.

Data Type Constraints Default Value
enum same_name, specific_file, all_files same_name

tooltip.annot_attributes

Specifies the list of attributes to show in tool tips for annotations.

Data Type Default Value
string list <empty>

tooltip.demand_attributes

Specifies the list of attributes to show in tool tips for demands.

Data Type Default Value
string list <empty>

Specifies the list of attributes to show in tool tips for links.

When a new preferences file is created by the new_prefs_file preference, this preference is given the value “tool tip, name”.

Data Type Default Value
string list <empty>

tooltip.object_update

Specifies whether to determine all object attributes before building the tool tip for an object. If this preference is set to FALSE, then occasionally incorrect or outdated information may appear in an object’s tool tip. Setting this value to TRUE may result in slower performance.

Data Type Default Value
boolean FALSE

tooltip.path_attributes

Specifies the list of attributes to show in tool tips for paths.

Data Type Default Value
string list <empty>

tooltip.site_attributes

Specifies the list of attributes to show in tool tips for sites (fixed, mobile, and satellite nodes).

When a new preferences file is created by the new_prefs_file preference, this preference is given the value “tooltip”.

Data Type Default Value
string list <empty>

tooltip_delay

Specifies the delay, in milliseconds, after the cursor stops moving before the tool tips display appears.

The value of this preference changes only at startup.

Data Type Default Value
integer 1000

treeview_connector_style

Specifies the line style used in a treeview to show connections between nodes.

Data Type Constraints Default Value
enum Dotted Lines, Solid Lines, No Lines “Dotted Lines”

treeview_font

Specifies the default font used for treeviews.

Data Type Default Value
font “Arial, 12”

tutorial_top

Specifies whether the tutorial window is above all other windows on the desktop, regardless of whether it is the active window. When TRUE, the tutorial window is always the top window.

This preference has no effect in the Linux environment.

Data Type Default Value
boolean TRUE

ui_colors.tool_back

Specifies the background color of tool windows.

The value of this preference changes only at startup.

Data Type Default Value
string RGB222

ui_colors.tool_fore

Specifies the color for foreground objects such as selection markers; grid-numbering text; and, in the Process Editor, state names and the initial-state arrow.

Data Type Default Value
string RGB000

ui_colors.transparent_pixel_color

Specifies the color for transparent pixels when exporting images to formats such as TIFF or GIF using the function Ets_Icon_Export().

Data Type Default Value
string RGB222

ui_fonts.header

Specifies the header font used by various UI components.

Data Type Default Value
string Windows: “family:Times New Roman-face:bold-size:18”
Linux: “family:helvetica-face:bold-size:18”

ui_fonts.large

Specifies the large font used by various UI components.

Data Type Default Value
string Windows: “family:Tahoma-family:MS Sans Serif-face:bold-size:12”
Linux: “family:courier-face:medium-size:14”

ui_fonts.medium

Specifies the medium font used by various UI components.

Data Type Default Value
string Windows: “family:Tahoma-family:MS Sans Serif-size:10”
Linux: “family:courier-face:medium-size:12”

ui_fonts.small

Specifies the small font used by various UI components.

Data Type Default Value
string Windows: “family:Tahoma-family:MS Sans Serif-size:8”
Linux: “family:courier-face:medium-size:10”

ui_fonts.tiny

Specifies the tiny font used by various UI components.

Data Type Default Value
string Windows: “family:Tahoma-family:MS Sans Seri-size:7”
Linux: “family:courier-face:medium-size:8”

ui.hide_all_windows

Specifies whether to display any windows. When TRUE, all windows are hidden while the program runs.

Note: Because no windows are visible, Modeler cannot be shut down normally. You must use an automation script, the Windows Task Manager, or the Linux kill command to stop the program.

This preference can be used only from the command line, and its value changes only at start-up.

Data Type Default Value
boolean FALSE

ui.offscreen_buffer_behavior

Specifies whether to use an off-screen buffer for refreshing dialog boxes.

Data Type Constraints Default Value
enum use_for_all_dialog_boxes, use_for_domains_only, never_use use_for_all_dialog_boxes

Note: Use this preference to debug drawing performance issues or unexpected rendering artifacts.

ui.remember_window_sizes_and_positions

Specifies whether application windows should open with the same size and position they had last. When TRUE, size and position are remembered. When FALSE, windows open with their default size and position.

Data Type Default Value
boolean TRUE

ui_toolbar.dockable

Specifies whether an editor toolbar can float above the editor window and can be dragged anywhere on the desktop. When TRUE, the following options appear under the Windows menu: "Configure Toolbar", "Show Toolbar", and "Float Toolbar".

Data Type Default Value
boolean FALSE

See related preferences: ui_toolbar.follow_editor and ui_toolbar.hide_buttons.

ui_toolbar.follow_editor

Specifies whether floating toolbars follow their windows when the windows are moved.

Data Type Default Value
boolean TRUE

See related preferences: ui_toolbar.dockable and ui_toolbar.hide_buttons.

ui_toolbar.hide_buttons

Specifies whether the toolbar is displayed. If the preference ui_toolbar.dockable is set to TRUE, this preferences specifies the default setting of whether the toolbar is displayed. (The display of the toolbar can be changed by the menu option Windows > "Show Toolbar".)

The value of this preference changes only at start-up.

Data Type Default Value
boolean TRUE

See related preference: ui_toolbar.follow_editor.

use_startup_wizard

Specifies whether to use the startup wizard when specifying a new scenario.

Data Type Default Value
boolean FALSE

This preference is used with the suppress_use_startup_wizard_checkbox preference. The following table lists the effects of different settings for these options.

Table 19: Effects of use_startup_wizard and suppress_use_startup_wizard_checkbox

suppress_use_startup_wizard_checkbox = TRUE suppress_use_startup_wizard_checkbox = FALSE
use_startup_wizard = TRUE The checkbox does not appear and the startup wizard is used by default. The checkbox appears and the startup wizard is used if the checkbox is selected.
use_startup_wizard = FALSE The checkbox does not appear and the startup wizard is not used. The checkbox appears and the startup wizard is used if the checkbox is selected. Additionally, if the checkbox is selected, the setting for the use_startup_wizard preference is set to TRUE.

Specifies whether to display the first line of the tooltip text as a label for links (subject to the setting of network_visualization.show_link_labels). If TRUE, tooltip text is used as a label. When FALSE, the link name is used as a label.

Data Type Default Value
boolean FALSE

verbose_report

Specifies that reports generated by the Generate Text Report command in the Process, Packet Format, and ICI editors should be done in verbose mode. In non-verbose mode, only the name, type, value, and default value of an object attribute is printed.

Data Type Default Value
boolean FALSE

vudoc_prog

Specifies the path name of the Acrobat Reader program. Under Linux, the value of this preference typically remains blank because the program is installed in a fixed location (sys/doc/viewer). Under Windows, Modeler sets this value when it is installed.

Data Type Default Value
string “”

win_height

Specifies the default height (in pixels) for tool windows that do not have a natural size. This preference will not affect tool windows whose positions are remembered if the ui.remember_window_sizes_and_positions preference is TRUE.

Data Type Default Value
integer 600

win_width

Specifies the default width (in pixels) for tool windows that do not have a natural size. This preference will not affect tool windows whose positions are remembered if the ui.remember_window_sizes_and_positions preference is TRUE.

Data Type Default Value
integer 760

win_x

Specifies the default x position (in pixels) for the first tool window. This preference will not affect tool windows whose positions are remembered if the ui.remember_window_sizes_and_positions preference is TRUE.

Data Type Default Value
integer 40

win_x_inset

Specifies the minimum horizontal distance (in pixels) from the left or right screen edge that is reserved when a window is opened.

Data Type Default Value
integer 0

win_x_stagger

Specifies the horizontal offset (in pixels) for subsequent tool windows after the first one is opened.

Data Type Default Value
integer 15

win_y

Specifies the default y position (in pixels) for the first tool window. This preference will not affect tool windows whose positions are remembered if the ui.remember_window_sizes_and_positions preference is TRUE.

Data Type Default Value
integer 40

win_y_inset

Specifies the minimum vertical distance (in pixels) from the top or bottom screen edge that is reserved when a window is opened.

Data Type Default Value
integer 0

win_y_stagger

Specifies the vertical offset (in pixels) for subsequent tool windows after the first one is opened.

Data Type Default Value
integer 35

window_icon

Specifies the name of the icon to use for application windows.

Data Type Default Value
string “opnet_logo_small”

Specifies whether links should visually extend more than 180 degrees in longitude. When TRUE, links are drawn using the shortest route between sites, even if this means wrapping from the left side of the screen to the right. When FALSE, all links are drawn continuously across the map.

Data Type Default Value
boolean TRUE

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · 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