home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / wfdos.zip / WFDOS.INF (.txt) < prev    next >
OS/2 Help File  |  1995-04-17  |  9KB  |  254 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. README.TXT ΓòÉΓòÉΓòÉ
  3.  
  4.                    ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  5.             WFDOS Version 2.06 - (c) Copyright Per Jessen, 1994-1995 .
  6.                Invoke DOS-tools from the IBM WorkFrame/2 Version 1.1
  7.                    ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  8.  
  9.                                                  Markt Schwaben, 15 April, 1995.
  10.  
  11.   WFDOS enables a transparent use of DOS-tools in the IBM WorkFrame/2 Version 
  12.   1.1. WFDOS is incorporated into the IBM WorkFrame/2 environment as any 
  13.   OS/2-tool, and will run the DOS-program in the background, and display any 
  14.   screen-directed output in the Monitor-window. 
  15.   WFDOS can also be used to invoke DOS-programs from a MAKE-file, and still 
  16.   maintain consistency with the IBM WorkFrame/2 environment. 
  17.  
  18.   Environment: 
  19.  
  20.   WFDOS was initially written for and tested on OS/2 2.1GA and Workframe/2 
  21.   version 1.1. 
  22.  
  23.   It was later modified and re-built using OS/2 Warp Version 3.00. It is not 
  24.   guaranteed to work with any other version of OS/2 than those mentioned above, 
  25.   nor is it guaranteed to work with any other version of WorkFrame/2. 
  26.  
  27.   Freeware: 
  28.  
  29.   WFDOS is freeware, and you are not required to register your copy, nor are 
  30.   you required to pay any kind of fee for its use. However, if you find it 
  31.   useful, I would very much appreciate a brief note. 
  32.  
  33.   Note:  If you wish to use the source or parts thereof in a commercial product 
  34.   of any kind, you are required to obtain the author's permission first. 
  35.  
  36.   Distribution: 
  37.  
  38.   You may freely and I strongly suggest you do so, distribute the complete and 
  39.   unmodified WFDOS-package using whatever means you may deem suitable. 
  40.  
  41.   Package: 
  42.  
  43.   The package consists of the following files: 
  44.  
  45.   Filename          Contents 
  46.  
  47.   WFDOS.INF         You're reading it ... 
  48.  
  49.   WFDOS-S.EXE       OS/2 executable - the Server. 
  50.  
  51.   WFDOS-C.EXE       DOS executable  - the Client. 
  52.  
  53.   WFDOS-S.C         C-source for the Server. 
  54.  
  55.   WFDOS-C.C         C-source for the Client. 
  56.  
  57.   WFDOS.H           Include file for the Server and Client. 
  58.  
  59.   WFDOS.RC          Sample resource-script for generating an INI-file for the 
  60.                     ADDTOOL-utility. 
  61.  
  62.   WFDOS.MAK         Sample MAKE-file that makes use of OS/2 as well as DOS 
  63.                     tools. 
  64.  
  65.   WFDOS.INI         Sample INI-file for the ADDTOOL-utility. 
  66.  
  67.   History: 
  68.  
  69.   Version   Description 
  70.  
  71.   2.02      Although the basic functionality is the same, this release is quite 
  72.             different from the previous one, as I am now using a named pipe to 
  73.             transfer information between OS/2 and DOS. In general, this is a 
  74.             much more elegant solution, should be slightly faster, and perhaps 
  75.             even use a little less resources. 
  76.  
  77.   2.03      DOS-programs that require DPMI, but do not automatically detect it, 
  78.             can now also be run with WFDOS. By default, the VDM is now always 
  79.             started with DPMI_DOS_API=ENABLED. 
  80.             Furthermore, multiple copies of WFDOS can now be executed 
  81.             concurrently as a unique pipe is generated for every invocation. 
  82.  
  83.             Note:  Version 2.03 is an intermediate version, and was not 
  84.             released to the public domain. 
  85.  
  86.   2.04      All valid VDM-overrides are now accepted. These maybe specified 
  87.             directly on the command-line, or they maybe put separately in an 
  88.             options-file. 
  89.  
  90.             Note:  The VDM is no longer started with DPMI_DOS_API=ENABLED by 
  91.             default. 
  92.  
  93.   2.05      Bugfix: returncodes from the called DOS-program are now returned to 
  94.             the Server. 
  95.  
  96.   2.06      Essentially a rebuild for OS/2 Warp 3.00, but also includes removal 
  97.             of the environment variable WFDOS_CLIENT. Included in the .ZIP-file 
  98.             is also source for two new sample output-filters. 
  99.  
  100.   Arguments: 
  101.  
  102.           ΓöÇΓöÇΓöÇΓöÇΓöÇ WFDOS-S ΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  103.                            ΓööΓöÇ ? ΓöÇΓöÿ     ΓööΓöÇ /m<lvl> ΓöÇΓöÿ     ΓööΓöÇ /c<path> ΓöÇΓöÿ
  104.  
  105.  
  106.           ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  107.                                    Γöé                           Γöé
  108.                  ΓööΓöÇΓöÇΓöÇ /o<option> ΓöÇΓöÇΓöÇΓöÿ           ΓööΓöÇΓöÇΓöÇ /v<file> ΓöÇΓöÇΓöÇΓöÿ
  109.  
  110.  
  111.           ΓöÇΓöÇΓöÇΓöÇ <DOSprogram> ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ <DOSarguments> ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  112.                                                                Γöé
  113.                                    ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  114.  
  115.   Note:  All arguments must be separated by at least one blank. 
  116.  
  117.   Installation: 
  118.  
  119.   I suggest you place WFDOS-S.EXE and WFDOS-C.EXE in a subdirectory which is 
  120.   included in the PATH-variable. \IBMWF\BIN\ seems a good idea to me. After 
  121.   that you update the WFDOS.RC sample with the DOS-applications you wish to 
  122.   use, and create an INI-file using MAKEINI. Then use ADDTOOL to install these 
  123.   tools in the WorkFrame/2. 
  124.  
  125.   Of course, if you wish, you can also install WFDOS manually by simply 
  126.   updating the Tools-configuration using WorkFrame/2. 
  127.  
  128.   Usage: 
  129.  
  130.   As you may notice from the various sample files, my initial requirement was 
  131.   to be able to use Borland's Turbo Assembler. Later on, however, I also found 
  132.   it quite useful to be able to use Borland's C/C++ (WFDOS itself was built by 
  133.   one MAKE-file, doing DOS and OS/2 compilations using WFDOS.) and other 
  134.   DOS-tools/software. 
  135.  
  136.   Even though I have used WFDOS with several different DOS-programs, I have not 
  137.   done any extensive tests, as WFDOS should be completely independent of the 
  138.   actual DOS-program being called. 
  139.   Normal DOS-commands may be issued by calling COMMAND.COM with the /C option 
  140.   followed by the command. 
  141.  
  142.   Disclaimer: 
  143.  
  144.                             ΓòöΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòù
  145.                             Γòæ                                        Γòæ
  146.                             Γòæ  The code is provided on an "AS IS" basis without any warranty of any kind.  Γòæ
  147.                             Γòæ  The author shall not be liable for any damages arising out of your use of  Γòæ
  148.                             Γòæ  this code, even if he has been advised of the possibility of such damages.  Γòæ
  149.                             Γòæ                                        Γòæ
  150.                             ΓòÜΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓò¥
  151.  
  152.                               ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ o ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  153.  
  154.   I hope this tiny utility will be as useful to you as it is to me. If you have 
  155.   any comments, suggestions, complaints etc., please do not hesitate to contact 
  156.   me on the Email address below. 
  157.  
  158.     Per Jessen,
  159.     Moos╨öcker 24,
  160.     D-85570 Markt Schwaben,
  161.     Germany.
  162.     CIS 100044,3225.
  163.  
  164.  
  165. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  166.  
  167. ? - optional. 
  168.  
  169. Display arguments format. 
  170.  
  171.  
  172. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  173.  
  174. /m - optional. 
  175.  
  176. Set message-level. 
  177.  
  178. <lvl> 
  179.  
  180.        0 = Suppress all informational messages. 
  181.        1 = Display logo only - default. 
  182.        2 = Display Client runtime-information. 
  183.        3 = Display Server and Client runtime information. 
  184.  
  185.  
  186. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  187.  
  188. /c - optional. 
  189.  
  190. Override default path to the Client - WFDOS-C.EXE. 
  191.  
  192. <path> 
  193.  
  194. The path to the Client - WFDOS-C.EXE. 
  195.  
  196. By default WFDOS-S will use the standard searchpath. 
  197.  
  198.  
  199. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  200.  
  201. <DOSprogram> - required. 
  202.  
  203. The fully or partially qualified name of a DOS-program to call. 
  204.  
  205. If partially qualified, standard search-paths are applied. 
  206.  
  207.  
  208. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  209.  
  210. <DOSarguments> - optional. 
  211.  
  212. 0-32 arguments to be supplied to the DOS-program. 
  213.  
  214.  
  215. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  216.  
  217. /o - optional. 
  218.  
  219. Specify overrides of the default VDM-settings. 
  220.  
  221. <option> 
  222.  
  223.        DOS_DPMI_API=ENABLED 
  224.        DPMI_MEMORY_LIMIT=16 
  225.        DOS_RMSIZE=639 
  226.        etc. 
  227.  
  228.  
  229. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  230.  
  231. /v - optional. 
  232.  
  233. Specify filename containing overrides of the default VDM-settings. 
  234.  
  235. <file> 
  236.  
  237. Fully or partially qualified name of a file containing specific VDM options. 
  238. Each line of the file will be added as a separate VDM-override. 
  239.  
  240. If the environment-variable WFDOS_VDMOPT specifies a fully or partially 
  241. qualified filename, this will be treated the same way. 
  242.  
  243. WFDOS will look for both of these files in the current directory, and if not 
  244. found, in the path specified by DPATH in your CONFIG.SYS. 
  245.  
  246. Setting WFDOS_VDMOPT in CONFIG.SYS or a CMD-file. 
  247.  
  248.  
  249. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  250.  
  251. Setting WFDOS_VDMOPT in CONFIG.SYS or a CMD-file: 
  252.  
  253. SET WFDOS_VDMOPT=DEFAULT.VDO;
  254.