Progress
Open Client
Developer’s Guide
Preparing To Generate Proxies For an ActiveX Client Using GUI ProxyGen
To configure your environment to generate an ActiveX proxy, you must first perform the following steps in the specified order:
- Install one of the following Progress products on a Windows system where you plan to run GUI ProxyGen:
- Download the Microsoft Java SDK Version 3.2 (or later) and the Java Virtual Machine (which might not be included in the SDK). Follow the instructions on the Microsoft Web site to complete the download and any subsequent installations.
- Ensure the PATH environment variable contains: Microsoft-Java-SDK-Install-Directory
\bin
. See Step 2.- Ensure that ProxyGen can access and execute the MIDL compiler, which it needs to create a Type Library. For instructions on completing this step, see the "Setting Up the MIDL Compiler" section and the "Setting Up the Environment To Run the MIDL Compiler" section.
Setting Up the MIDL Compiler
To set up the MIDL compiler for access by ProxyGen, make sure that one of the following products is installed on the machine:
- Visual J++ Version 1.1
- Visual C++ Version 5
- Visual C++ Version 6
- If one of these products is already on your machine, no further installation work is necessary. Skip to the "Setting Up the Environment To Run the MIDL Compiler" section for additional instructions.
- Choose which of these products to install. Here are some considerations:
- By default, ProxyGen uses the files provided by Visual J++ 1.1. An additional switch is required when you run ProxyGen to use MIDL from Visual C++. For more information, see the "Setting Up the Environment To Run the MIDL Compiler" section.
- The Progress Installation CD contains a copy of Visual J++ Version 1.1 Trial Edition, which you can install directly. For more information, move on to Step 3.
- Later versions of Visual J++ (for example, Version 6) do not contain the MIDL compiler and therefore are not sufficient for this requirement.
- If you choose to purchase Visual C++, both the Standard Edition and the Professional Edition contain the necessary files.
- If you choose to use Visual J++ 1.1 Trial Edition, follow these steps to install it from the Progress Installation CD:
Setting Up the Environment To Run the MIDL Compiler
Once you have selected and installed one of the recommended products containing the MIDL compiler, you must set up the environment for ProxyGen to run the MIDL compiler.
For Visual J++ Version 1.1, you must perform the following additional steps:
CAUTION: The PATH settings in Step 2 must be on the PATH after the Microsoft Java SDK
- Provide access to the
*.idl
files using one of these techniques:
NOTE: You can determine the Progress working directory by viewing the startup options in the- Copy the
*.idl
files from Microsoft-Visual-J++-Install-Directory\
DevStudio\Vj\include
to the Progress working directory (specified during Progress product installation).proxygen.prm file
located in the directory where you installed Progress. You can view theproxygen.prm
file with a text editor.
- Add the Microsoft-Visual-J++-Install-Directory
\DevStudio\vj\include
to your INCLUDE environment variable.- Ensure that the PATH environment variable contains:
bin
directory.For Visual C++, you must perform the following additional steps:
- Add the following startup option to the
proxygen.prm
file located in the directory where you installed Progress:
Surround this option with spaces and place it immediately before
com.progress.open4gl.proxygen.gui.ProxyGen
line in theproxygen.prm
file. For more information about adding information to theproxygen.prm
file, see the "Using GUI and Batch ProxyGen Execution Options" section in Generating and Managing Proxies."- Update the PATH environment variable to include:
- Visual C++
bin
directory — This directory containsmidl.exe
.For example, for Visual C++ 5.0, you would enter:
VC++-Install-Dir
\DevStudio\Vc\bin
or
VC++-Install-Dir
\DevStudio\SharedIDE\bin
- The common directory shared by the IDE for Visual C++ and other products — This is the directory containing the
*.dll
files associated withmidl.exe
.For example, for Visual C++ 6.0, you would enter:
VC++-Install-Dir
\Microsoft Visual Studio\Vc98\bin
or
VC++-Install-Dir
\Microsoft Visual Studio\Common\msdev98\bin
- For Windows 98 only, the INCLUDE environment variable must contain the Visual C++
include
directory.For example, for Visual C++ 5.0, you would include the following:
For more information on using ProxyGen to generate these files, see Generating and Managing Proxies."
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |