|  |  |  |  |  |  |  |  |  | 
|  | ||||||||
|  |  |  |  | |||||
|  |  |  |  |  |  | |||
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 | 
[ OpenDX Home at IBM | OpenDX.org ]