



                        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.


