Version 9.5 SP1
 —  EntireX DCOM Wrapper  —

Using the EntireX DCOM Wrapper

This document covers the following topics:

See also Prerequisites for Using DCOM Wrapper Objects.


Starting the DCOM Wrapper

To use the DCOM Wrapper functions open the EntireX Workbench.

See also Visual Studio Wizard for DCOM Wrapper.

Top of page

Setting Wrapper Preferences

Start of instruction set To set the DCOM Wrapper Preferences

  1. Open the DCOM Wrapper Preferences (using: Window > Preferences > Software AG > EntireX > DCOM Wrapper).

  2. Ensure that the compiler path is set correctly.

For an explanation of other settings, see Setting Wrapper Properties.

graphics/dw01.png

Top of page

Setting DCOM Wrapper Properties

graphics/dw02.png

Start of instruction set To set the DCOM Wrapper Properties

  1. In the tree display, select the IDL file to be processed.

  2. Use the context menu or choose File > Properties to call the Properties window.

Property Description
Output directory Specify the output directory, relative to the selected IDL file. The directory will be created if it does not exist. NT is the default to be compatible with previous versions.

The location of the generated batch and other files depends on the name of the output directory.

NT Default. Batch files are generated in the same directory as the IDL file; other files are generated to subdirectory NT. This was the behavior in the initial version of EntireX 9.0 or earlier.
other Batch and other files are generated in a user-defined subdirectory.
Product version Specify the product version. Use the following format:
n.n.n.n
File version Specify the file version. Use the following format:
n.n.n.n
Numeric/Packed decimal to double Select this box to map Natural data types Numeric and Packed Decimal (not supported by C or Visual Basic) to data type double, which is supported by C and Visual Basic.

If you do not select the check box, the data type is mapped as a string (BSTR).

Note:
Conversion of data types may lead to loss of precision. Natural supports a precision of 29 digits, while the data type double supports a precision of 15 digits.

See table of supported data types.

Logon to Natural Library For Natural RPC Servers only.
Check this box to advise the Natural RPC Server to logon to the Natural library for RPC requests. For a conversation, the logon to the Natural library is performed when the conversation is opened; during a conversation the Natural library cannot be changed. This is available from Natural version 2.3 and above.
Generate DCOM proxy Check the Generate DCOM Proxy box to enable the use of DCOM.
DCOM Wrapper object location Specify where the generated DCOM Wrapper object (for example example.dll) is to be located (IP-address or location name). This field is evaluated only if proxy objects (for example pexample.dll) are in use, otherwise it is ignored.
Discard existing GUIDs Check this box if you have to re-generate a project:
  • if you want to discard all existing GUIDs

  • if you change the number of groups/structures.

Register client object Check this box to register the client object and the wrapper after generating the object.
ASP Scripting Support Create extended interface for ASP scripting support.
Features See also Setting Features.
Automation Object Name Specify the name of the registered object. The default is EOL.<Library>. See also Using Alias Names with the DCOM Wrapper.
Library Name Specify the library of the registered object.
DLL Name Specify the name of generated DLL file.

Top of page

Generating a DCOM Client

Start of instruction setTo generate a DCOM Client

  1. Select the Software AG IDL file.

  2. From the context menu, choose Generate DCOM from Software AG IDL file.

Top of page

Generating a DCOM Proxy

Start of instruction setTo generate a DCOM Proxy

  1. In the DCOM Wrapper Properties, check the box Generate DCOM proxy.

  2. Select the Software AG IDL file.

  3. From the context menu, choose Generate DCOM from Software AG IDL file.

Top of page