======================================================================
Microsoft(R) Product Support Services Application Note (Text File)
HF0556: USING WX AND WXSERVER TO RUN WINDOWS(TM)-BASED PROGRAMS FROM
AN MS-DOS(R) SESSION IN WINDOWS
======================================================================
Revision Date: 8/92
Disk Included

The following information applies to Microsoft FORTRAN version 5.1.

--------------------------------------------------------------------
| INFORMATION PROVIDED IN THIS DOCUMENT AND ANY SOFTWARE THAT MAY |
| ACCOMPANY THIS DOCUMENT (collectively referred to as an |
| Application Note) IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY |
| KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO |
| THE IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A |
| PARTICULAR PURPOSE. The user assumes the entire risk as to the |
| accuracy and the use of this Application Note. This Application |
| Note may be copied and distributed subject to the following |
| conditions: 1) All text must be copied without modification and |
| all pages must be included; 2) If software is included, all files |
| on the disk(s) must be copied without modification [the MS-DOS(R) |
| utility DISKCOPY is appropriate for this purpose]; 3) All |
| components of this Application Note must be distributed together; |
| and 4) This Application Note may not be distributed for profit. |
| |
| Copyright 1992 Microsoft Corporation. All Rights Reserved. |
| Microsoft, MS-DOS, and CodeView are registered trademarks and |
| Windows is a trademark of Microsoft Corporation. |
--------------------------------------------------------------------

The enclosed HF0556 disk contains three utilities that allow you to
run Windows-based programs from an MS-DOS session in Windows. WX is a
command-line utility that runs a Windows-based application from the
MS-DOS prompt either in a full screen or in a window. WXServer is a
Windows-based program that must be running before you can use WX. WX
and WXServer are shipped as part of the Microsoft C version 7.0
package in which Programmer's WorkBench (PWB) version 2.0 uses WX to
run Windows-based programs and Microsoft CodeView(R) for Windows
(CVW).

Two common uses of WX and WXServer are 1) to run Windows programs from
PWB version 1.1, and 2) to execute a Windows-based program from a
batch file in an MS-DOS session.

To use WX in an MS-DOS session under Windows, WX.EXE and WXSRVR.EXE
must be in your path. Copy WX.EXE and WXSRVR.EXE from the enclosed
HF0556 disk to your Windows directory or your FORTRAN \BIN
subdirectory. For example:

copy a:\wx*.* c:\fortran\bin

Copy VMB.386 from the enclosed HF0556 disk to your Windows \SYSTEM
subdirectory. For example:

copy a:\vmb.* c:\windows\system

WXServer and WX require Windows 386 enhanced mode. Add the following
line to the [386Enh] section of your SYSTEM.INI file:

device=vmb.386

To create an icon for WXServer in Windows, do the following:

1. From the File menu in Program Manager, choose New.

2. Select the Program Item option button, choose the OK button, and
type "wxsrvr" (without the quotation marks) in the Command Line box
of the Program Item Properties dialog box. Choose the OK button.

To run WXServer, double-click its icon. When WXServer is running, the
WXServer icon appears on the desktop. It does not display a window.

To run WX, open an MS-DOS session and type the following at the
command prompt:

wx [] []

To run CVW from version 1.1 of PWB, which is supplied in FORTRAN
version 5.1, choose Run DOS from the Run menu and type

wx [] cvw [] []

where is the filename of the Windows-based application and
are any command-line options, filenames, or other
arguments required to run the program. Specify to WX before
the program name. Option names are not case sensitive and can be
abbreviated to the shortest unique name.

Below is a list of the options available for use with WX:

Option Description
---------------------------------------------------------------

/A Runs the program asynchronously. By default, WX runs
synchronously, which pauses the MS-DOS session until
the program ends. The /A switch allows other
programs to run in the same MS-DOS session while the
Windows program is running.

When running synchronously, WX requires that the MS-
DOS prompt run in the background. (From the Control
menu, choose Settings, select the MS-DOS prompt, and
under Tasking Options, select the Background
option.)

WXServer can run only one program synchronously, but
it can run additional programs asynchronously.

/H[ELP] Calls the QuickHelp utility. If WX cannot find the
Help file or QuickHelp, it displays a brief summary
of the WX command-line syntax.

/N[OLOGO] Suppresses the WX copyright message.

/W Runs a program from an MS-DOS prompt that is in a
window rather than a full screen.

/? Displays a brief summary of the WX command-line
syntax.