OpenDX - Documentation
Full Contents QuickStart Guide User's Guide User's Reference
Previous Page Next Page Table of Contents Partial Table of Contents Index Search

C.2 Command Line Options

Table 5 lists the command line options available with Data Explorer. Those most commonly used are identified by a bullet (*). Table 6 lists command line options of particular interest to developers.

Command line options always override corresponding environment variables. As such, they offer a quick way to temporarily override environment settings. If parameters conflict, the last one entered takes precedence.

Table 5. Data Explorer Command Line Options
  Option syntax Function

-8bitcmap [private | shared | 0-1]
Set color-map error threshold (default: 0.1).
private = -1; stored = 1.
* -builder
Start the Data Explorer Module Builder (instead of Data Explorer).

-cache [on | off]
Enable executive cache (default: on).

-colors filename
Override DXCOLORS environment variable.

-connect host:port
Start a distributed executive only (no user interface).
* -data pathlist.
Override DXDATA environment variable.

-directory dirname
Change directory (cd) to dirname before starting the executive.

-display hostname:0
Set the X-display destination.

-dxroot dirname
Set the Data Explorer root directory (default: /usr/local/dx).

-echo
Echo the command lines without executing them.

-edit
Start the user interface in edit mode (default).

-exec filename
Use the specified executive.

-execonly
Start the executive only (no user interface) in remote mode.

-execute
Execute the visual program automatically at start-up.

-execute_on_change
Go into Execute On Change mode at start-up.

-full
Start the full Data Prompter. (See also -file and -prompter.)

-file filename
Start the Data Prompter with header file filename. (See also -full and -prompter.)

-help
Print the abbreviated help message.

-highlight [on | off]
Enable node execution highlighting: (default: on).
* -host hostname
Start the executive on machine. hostname.
* -hwrender [gl | opengl]
if both GL and OpenGL are supported, set the type of hardware-rendering used.
* -image
Start the user interface in image mode.

-include pathlist
Override DXINCLUDE environment variable.

-license [runtime | develop | timed]
Request that the user interface use only the indicated functional type

-local
Start the executive on the current machine (default).

-log [on | off]
Enable executive and user interface logging (default: off).
* -macros pathlist
Set list of directories to be searched for macros.

-mdf filename
Use .mdf file filename in addition to the default mdf file.
* -memory #Mbytes
Set the amount of memory the executive uses.
* -menubar
Start the user interface in menubar mode.

-metric
Set the graphical user interface to use metric units whenever possible.

-modules pathlist
Set list of directories to be searched for outboard modules.
* -morehelp
Print complete Help, including information about other options.
* -optimize [memory | precision]
Set the environment variables DXPIXELTYPE and DXDELAYEDCOLORS to optimize memory or precision. (The default is precision.)

-outboarddebug
Enable user to start outboard modules manually.
* -program filename
Start the user interface with visual program filename.
* -prompter
Start the Data Explorer Data Prompter (but not Data Explorer).

-readahead [on | off]
Enable executive readahead: (default: on).
* -script
Run the executive only (i.e., in script mode).
* -script filename
Run the executive only (i.e., in script mode) with script filename.

-suppress
Do not open any control panels at start-up (in image or menubar mode only).

-timed
Start Data Explorer using a timed license.

-timing [on | off]
Enable module timing (default: off).

-trace [on | off]
Enable executive trace (default: off).

-trialkey
Automatically determines the information needed to generate a trial key.
* -tutor
Start the Data Explorer tutorial.
* -uionly
Start the user interface only (no executive).

-verbose
Echo command lines before executing them.

-version
Show version numbers of dxexec and dxui.

Table 6. Command Line Options for Developers
For more detailed descriptions of functions, see Appendix D. "User Interface Configuration".
Option syntax Function
-encode -key <16-digit hex number> <file>
Encode a .net file. The Visual Program Editor will not display an encoded .net file, and such a file cannot be saved. (However, .cfg configuration files can be saved.)
-key <16-digit hex number> <file>
Decodes an encoded .net file.
-limitImageOptions
Remove options from Image window's Options menu.
-noAnchorAtStartup
Start Data Explorer, but do not put up any windows by default
-noCMapOpenMap
Remove Open... option from Colormap Editor's File menu.
-noCMapSaveMap
Remove Save As... option from Colormap Editor's File menu.
-noCMapSetNameOption
Remove Set Colormap Name... option from Colormap Editor's Options menu.
-noConnectionMenus
Remove Connection menu from all Windows (intended for use with DXLink applications).
-noConfirmedQuit
Turn off the "Are you sure you want to quit Data Explorer?" message.
-noDXHelp
Remove three options from the Help menu of the control panel and the Image window.
-noEditorAccess
Remove options from the Edit menu of the control panel and the Open Visual Program Editor option from the Image window's Windows menu.
-noEditorOnError
Turn off default behavior of popping up a VPE when an error occurs. Instead, a dialog box will ask whether a VPE should be opened.
-noExecuteMenus
Remove Execute menu from all Windows (intended for use with DXLink applications).
-noExitOptions
Changes"quit" to"Close" (intended for use with DXLink applications).
-noImageLoad
Remove both Load options from the Image window's File menu.
-noImageMenus
Remove menus from all Image and Display windows.
-noImagePrinting
Remove the Print Image... option from the Image Window's File menu.
-noImageRWNetFile
Remove Open, Save, and Save As... options from the Image Window's File menu.
-noImageSaving
Remove Save Image... option from the Image Window's File menu.
-noInteractorAttributes
Remove Set Attributes... option from the Image Window's File menu.
-noInteractorEdits
Remove four set options from the control panel's Edit menu.
-noInteractorMovement
Restricts the ability to move interactor instances within a control panel.
-noMessageInfoOption
Remove the Information Messages toggle button from the Message window's Options menu.
-noMessageWarningOption
Remove the Warning Messages toggle button from the Message window's Options menu.
-noOpenAllPanels
Remove Open All Panels... option from the Panels menu of the control panel and from the Windows menu of the Image Window.
-noPanelAccess
Remove the Panels menu from the control panel and panel options from the Windows menu of the Image Window.
-noPanelEdit
Remove the Edit menu from the control panel.
-noPanelOptions
Remove the Option menu from the control panel.
-noPGroupAssignment
Remove the Execution Group Assignment... option from the Image window's Connection menu.
-noRWConfig
Remove the Open... and Save As... options from the control panel's File menu.
-noScriptCommand
Remove the Execute Script Command... option from the Message Window's Options menu.
-restrictionLevel
Combines options to facilitate building applications for Data Explorer


Full Contents QuickStart Guide User's Guide User's Reference

[ OpenDX Home at IBM | OpenDX.org ]