4.5.6 Command-Line Options

Following is the command-line syntax to start CVW from the Run dialog box, which is displayed when you choose the Run command from the Program Manager File menu:

cvw [cvw_options] app_name[.exe] [app_arguments]

Parameters are not case-sensitive. Following are the command-line parameters:

cvw_options

Specifies one or more options that modify how CVW runs. Options are not case-sensitive. Valid options are as follows:

Option Purpose

/b Specifies a monochrome VGA display used as the secondary display with an 8514/a display. This option is valid only in conjunction with the /8 option.
/c command Specifies one or more commands that CVW is to carry out when it loads the application specified by the app_name parameter. The group of commands must be enclosed in double quotation marks ("). Commands must be separated with semicolons (;).
/l dll_or_exe Specifies the name of an application or DLL that has been compiled and linked with CVW symbols. CVW assumes the default filename extension .DLL if no extension is supplied. You can use the /l option more than once to specify multiple DLLs or executable files.
/m Disables the use of the mouse on the debugging screen. You should use this option when you set breakpoints in code that is responsive to mouse movements on the Windows application screen.
/tsf Inverts save-state-file status for the current session. For more information, see Section 4.6, “Saving Session Information.”
/v Allows single-monitor debugging on a non-VGA display.
/2 Allows CVW to use a secondary monochrome monitor for debugger output while displaying Windows output on your primary monitor.
/8 Allows CVW to use an 8514/a display as the Windows display and a VGA display for debugger output.
/25 Specifies 25-line mode for the secondary VGA display. This option is valid only in conjunction with the /8 option.
/43 Specifies 43-line mode for the secondary VGA display. This option is valid only in conjunction with the /8 option.
/50 Specifies 50-line mode for the secondary VGA display. This option is valid only in conjunction with the /8 option. The /50 option is not required, because 50-line mode is the default for the dual-monitor configuration.

app_name[.exe]

Specifies the location and name of the application for which CVW is to load symbols and issue an initial breakpoint. The .EXE extension is optional.

app_arguments

Specifies one or more arguments recognized by the application that CVW loads.