═══ 1. README.TXT ═══

                   ─────────────────────────────────────────────
            WFDOS Version 2.06 - (c) Copyright Per Jessen, 1994-1995 .
               Invoke DOS-tools from the IBM WorkFrame/2 Version 1.1
                   ─────────────────────────────────────────────

                                                 Markt Schwaben, 15 April, 1995.

  WFDOS enables a transparent use of DOS-tools in the IBM WorkFrame/2 Version 
  1.1. WFDOS is incorporated into the IBM WorkFrame/2 environment as any 
  OS/2-tool, and will run the DOS-program in the background, and display any 
  screen-directed output in the Monitor-window. 
  WFDOS can also be used to invoke DOS-programs from a MAKE-file, and still 
  maintain consistency with the IBM WorkFrame/2 environment. 

  Environment: 

  WFDOS was initially written for and tested on OS/2 2.1GA and Workframe/2 
  version 1.1. 

  It was later modified and re-built using OS/2 Warp Version 3.00. It is not 
  guaranteed to work with any other version of OS/2 than those mentioned above, 
  nor is it guaranteed to work with any other version of WorkFrame/2. 

  Freeware: 

  WFDOS is freeware, and you are not required to register your copy, nor are 
  you required to pay any kind of fee for its use. However, if you find it 
  useful, I would very much appreciate a brief note. 

  Note:  If you wish to use the source or parts thereof in a commercial product 
  of any kind, you are required to obtain the author's permission first. 

  Distribution: 

  You may freely and I strongly suggest you do so, distribute the complete and 
  unmodified WFDOS-package using whatever means you may deem suitable. 

  Package: 

  The package consists of the following files: 

  Filename          Contents 

  WFDOS.INF         You're reading it ... 

  WFDOS-S.EXE       OS/2 executable - the Server. 

  WFDOS-C.EXE       DOS executable  - the Client. 

  WFDOS-S.C         C-source for the Server. 

  WFDOS-C.C         C-source for the Client. 

  WFDOS.H           Include file for the Server and Client. 

  WFDOS.RC          Sample resource-script for generating an INI-file for the 
                    ADDTOOL-utility. 

  WFDOS.MAK         Sample MAKE-file that makes use of OS/2 as well as DOS 
                    tools. 

  WFDOS.INI         Sample INI-file for the ADDTOOL-utility. 

  History: 

  Version   Description 

  2.02      Although the basic functionality is the same, this release is quite 
            different from the previous one, as I am now using a named pipe to 
            transfer information between OS/2 and DOS. In general, this is a 
            much more elegant solution, should be slightly faster, and perhaps 
            even use a little less resources. 

  2.03      DOS-programs that require DPMI, but do not automatically detect it, 
            can now also be run with WFDOS. By default, the VDM is now always 
            started with DPMI_DOS_API=ENABLED. 
            Furthermore, multiple copies of WFDOS can now be executed 
            concurrently as a unique pipe is generated for every invocation. 

            Note:  Version 2.03 is an intermediate version, and was not 
            released to the public domain. 

  2.04      All valid VDM-overrides are now accepted. These maybe specified 
            directly on the command-line, or they maybe put separately in an 
            options-file. 

            Note:  The VDM is no longer started with DPMI_DOS_API=ENABLED by 
            default. 

  2.05      Bugfix: returncodes from the called DOS-program are now returned to 
            the Server. 

  2.06      Essentially a rebuild for OS/2 Warp 3.00, but also includes removal 
            of the environment variable WFDOS_CLIENT. Included in the .ZIP-file 
            is also source for two new sample output-filters. 

  Arguments: 

          ───── WFDOS-S ───┬─────┬─────┬───────────┬─────┬────────────┬──────
                           └─ ? ─┘     └─ /m<lvl> ─┘     └─ /c<path> ─┘


          ─────────────────────────┬────────────────────────────┬───────────
                                   │                           │
                 └─── /o<option> ───┘           └─── /v<file> ───┘


          ──── <DOSprogram> ───────────── <DOSarguments> ──────┬────────────┤
                                                               │
                                   └────────────────────────────┘

  Note:  All arguments must be separated by at least one blank. 

  Installation: 

  I suggest you place WFDOS-S.EXE and WFDOS-C.EXE in a subdirectory which is 
  included in the PATH-variable. \IBMWF\BIN\ seems a good idea to me. After 
  that you update the WFDOS.RC sample with the DOS-applications you wish to 
  use, and create an INI-file using MAKEINI. Then use ADDTOOL to install these 
  tools in the WorkFrame/2. 

  Of course, if you wish, you can also install WFDOS manually by simply 
  updating the Tools-configuration using WorkFrame/2. 

  Usage: 

  As you may notice from the various sample files, my initial requirement was 
  to be able to use Borland's Turbo Assembler. Later on, however, I also found 
  it quite useful to be able to use Borland's C/C++ (WFDOS itself was built by 
  one MAKE-file, doing DOS and OS/2 compilations using WFDOS.) and other 
  DOS-tools/software. 

  Even though I have used WFDOS with several different DOS-programs, I have not 
  done any extensive tests, as WFDOS should be completely independent of the 
  actual DOS-program being called. 
  Normal DOS-commands may be issued by calling COMMAND.COM with the /C option 
  followed by the command. 

  Disclaimer: 

                            ╔══════════════════════════════════════════════════════════════════════════════╗
                            ║                                        ║
                            ║  The code is provided on an "AS IS" basis without any warranty of any kind.  ║
                            ║  The author shall not be liable for any damages arising out of your use of  ║
                            ║  this code, even if he has been advised of the possibility of such damages.  ║
                            ║                                        ║
                            ╚══════════════════════════════════════════════════════════════════════════════╝

                              ────────── o ──────────

  I hope this tiny utility will be as useful to you as it is to me. If you have 
  any comments, suggestions, complaints etc., please do not hesitate to contact 
  me on the Email address below. 

    Per Jessen,
    MoosДcker 24,
    D-85570 Markt Schwaben,
    Germany.
    CIS 100044,3225.


═══ <hidden>  ═══

? - optional. 

Display arguments format. 


═══ <hidden>  ═══

/m - optional. 

Set message-level. 

<lvl> 

       0 = Suppress all informational messages. 
       1 = Display logo only - default. 
       2 = Display Client runtime-information. 
       3 = Display Server and Client runtime information. 


═══ <hidden>  ═══

/c - optional. 

Override default path to the Client - WFDOS-C.EXE. 

<path> 

The path to the Client - WFDOS-C.EXE. 

By default WFDOS-S will use the standard searchpath. 


═══ <hidden>  ═══

<DOSprogram> - required. 

The fully or partially qualified name of a DOS-program to call. 

If partially qualified, standard search-paths are applied. 


═══ <hidden>  ═══

<DOSarguments> - optional. 

0-32 arguments to be supplied to the DOS-program. 


═══ <hidden>  ═══

/o - optional. 

Specify overrides of the default VDM-settings. 

<option> 

       DOS_DPMI_API=ENABLED 
       DPMI_MEMORY_LIMIT=16 
       DOS_RMSIZE=639 
       etc. 


═══ <hidden>  ═══

/v - optional. 

Specify filename containing overrides of the default VDM-settings. 

<file> 

Fully or partially qualified name of a file containing specific VDM options. 
Each line of the file will be added as a separate VDM-override. 

If the environment-variable WFDOS_VDMOPT specifies a fully or partially 
qualified filename, this will be treated the same way. 

WFDOS will look for both of these files in the current directory, and if not 
found, in the path specified by DPATH in your CONFIG.SYS. 

Setting WFDOS_VDMOPT in CONFIG.SYS or a CMD-file. 


═══ <hidden>  ═══

Setting WFDOS_VDMOPT in CONFIG.SYS or a CMD-file: 

SET WFDOS_VDMOPT=DEFAULT.VDO;