Calling Broker ActiveX Control Remotely

You can call Broker ActiveX Control remotely if you use it as an automation server. This means you can use the Broker component from a separate process - either on the same machine or on another machine in the network.

This document covers the following topics:


Setting up the Server Environment

To configure the security settings use Component Services from the Administrative Tools in the Control Panel.

Below is a step-by-step guide on how to configure the server environment:

Step 1

Open the Component Services on the server.

The following dialog box will be displayed:

Component Services

Select EntireX Broker ActiveX Control in the DCOM Config list box and choose the properties from the context menu.

The following dialog box will be displayed:

DCOM Configuration Properties

Step 2

Click the Security tab.

DCOM Configuration - Security

In the dialog box displayed above, keep the defaults for access, launch and configuration permissions.

Step 3

Click the Identity tab.

DCOM Configuration - Identity

There are three options to define the user account to be used to run the application:

  • The interactive user

    This implies that a user with permission to launch the application must be logged on to the server machine.

  • The launching user

    This implies that an account must be created on the server machine with the same username/password as on the client machine. This account will then be used to launch the application.

  • This user

    A final option is to specify a user account to be used when launching the application.

In each case, the username/password of the client machine must also exist on the server machine.

Select one of the options and choose OK to return to the Component Services.

Step 4

Click on My Computer and choose the properties from the context menu.

My Computer

The following dialog box will be displayed; click on the Default Properties tab.

Default Properties

Choose the options as shown in the dialog box above.

Step 5

Click on the COM Security tab.

My Computer - COM Security

In the Launch and Activation Permissions area of the dialog box displayed above, choose Edit Default. The following dialog box will be displayed:

Launch and Activation Permissions

Make sure that either the user corresponding to the client machine account, or a group to which the user belongs, has Allow Launch as Type of Access.

Choose OK in this screen and then Apply, and exit Component Services on the server.

Setting up the Client Environment

The EbxProxy.dll is installed by default on the server in directory <drive>:\SoftwareAG\EntireX\bin. Copy the file from the server machine to the client machine.

The DLL must then be registered with: REGSVR32 <path>\EBXproxy.dll.

To configure the client environment use Component Services from the Administrative Tools in the Control Panel.

Below is a step-by-step guide on how to configure the client environment:

Step 1

Open the Component Services on the client.

The following dialog box will be displayed:

Component Services

Select EntireX Broker ActiveX Control in the DCOM Config list box, choose the properties from the context menu and click the Location tab.

Step 2

DCOM Configuration - Location

In the Location tab of the ActiveX Control Properties dialog box above, select the check box Run application on the following computer: and enter either the hostname or the IP address of the server machine.

Choose Apply and then OK.

Step 3

Select My Computer and choose the properties from the context menu.

My Computer

The My Computer Properties dialog box will be displayed. Select the Default Properties tab.

Default Properties

Choose the check box Enable Distributed COM on this computer, set the default authentication level to Call and the default impersonation level to Identify.

Choose OK.

Testing the Connection

You are now ready to test the connection between the client machine and the server machine.

Test the TCP/IP Connection

Test the TCP/IP connection between the client and the server (use, for example, PING).

Test the Remote Call

To test whether an application can be called remotely, you can use the OLE/COM Object Viewer:

Run the OLE/COM Object Viewer on the client.

The OLE/COM Object Viewer dialog box will be displayed:

OLE/COM Object Viewer

Select Automation Objects in the navigation frame to display a list of all the automation objects on the client machine.

A screen similar to the one displayed below will be displayed:

OLE/COM Object Viewer - Automation Objects

Select EntireX Broker ActiveX Control, open its context menu and choose Create Instance.

If the remote call is successful, the EntireX Broker component on the server machine will be called and the following screen will be displayed:

OLE/COM Object Viewer - Create Instance

If you receive an error message (for example "Class not registered") please check the following:

  • the TCP/IP connection (with PING)

  • the security definitions on the server with Component Services

  • the remote server name on the client (this can also be checked with the OLE/COM Object Viewer)

When the connection has been established, you will be able to run your application on the client. Please remember that Broker ActiveX Control must be used as automation server. For information on how to use Broker ActiveX Control with Visual Basic see Broker ActiveX Control as an Automation Server.