Citrix Winview Application Notes MITech WinGate DDE Technology This application note is for informational use only and Citrix makes no representations or warranties with respect to the contents or use of this document or of any of third-party products discussed within. 01/11/95 Citrix Systems 210 University Drive Suite 700 Coral Springs, FL 33071 (305) 755-0559 FAX (305) 341-6880 Overview: --------- This application note facilitates the configuration of the MITech WinGate DDE Technology (WinGate) with Citrix "WinView for Networks". This product allows applications that use the WinGate technology to share information between DOS sessions and Windows to run under WinView. DOS applications can start Windows applications, as well as share information with Windows applications. An example of an application that uses this technology is Delphi's SMART System software. In this case, the DOS program called 'DMS', when started from Windows, can now call the Windows program which handles the forms called 'EasyForm'. In addition, another portion of 'DMS' calls a Windows program to view graphical images stored in the client records. Disclaimer: ----------- The scenarios described in this document have been tested by Citrix Systems. Other variations to the scenarios described in this document may work, however they have not specifically been tested by Citrix. In order to recreate the configurations, you should use the specified revision levels of all software products described in this document and stay within the bounds of the features and functions described in this document. Please note that this application note is a living document and will be modified as new information and versions of the software described herein become availiable. Make sure you have the latest version of this document before you begin. The latest version is always available in the Citrix Forum on Compuserve. Requirements: ------------- MITech WinGate DDe Technology version 1.43 WinView for Networks version 2.3 or higher Patch file for WinView WINGATE.EXE Setup: ------ After the normal Winview for Networks installation, as per the Instruction in the WinView for Networks Installation Guide, proceed with the following steps: 1) Copy the WINGATE.EXE into a temporary directory on the drive where WinView was installed. Type 'WINGATE' in a DOS session, and the following files will self-extract: VDPX.SYS - Virtual DPMI translation VWINGATE.SYS - Virtual WinGate interface WINGATED.EXE - WinGate daemon 2) All three of these files go in the \OS2\MDOS directory on the drive where WinView was installed. The VDPX.SYS file will replace the old VDPX.SYS located there, so you may want to make a backup copy of this file before copying. The other two files are new and may be copied straight into the directory. 3) The following two lines should be added to the end of the CONFIG.SYS file to enable WinGate support: DEVICE=C:\OS2\MDOS\VWINGATE.SYS RUN=C:\OS2\MDOS\WINGATED.EXE where C: is the drive WinView is installed. Change the drive letter to match the drive of your installation. 4) Exit the DOS session, start an OS/2 session, and type: shutdown /now The WinView for Networks server will reboot with WinGate support enabled. Notes: ------ It is possible to use the WinGate support without the WINGATED.EXE. However, if so, session switching will not be enabled automatically. The WINGATED process allows the WinGate technology to automatically switch into Windows applications that are called from the DOS session. Including the WINGATED.EXE line in the CONFIG.SYS is therefore recommended.