Installing the USoftComJavaCall component

The USoft COM-Java Call component is COM+ component that is required in development environments and production environments where developers or runtime users browse web applications with a USoft-defined UI (= USoft-defined web pages) which is being disclosed by IIS. The component is needed by IIS to access the USoft Page Engine which serves the USoft defined web pages.

1.	Open Component Services. From the Windows Start menu, go to the Control Panel, Administrative Tools.

2.	Click the Component Services, Computers, My Computer, COM+ Applications.

3.	Click with your right mouse on COM+ Applications and select New, Application.

5.	Enter USoftPageEngine as name for the application (for example), and click Next.

6.	Select "This User" and enter a user id and password that has domain administrator privileges on the server.

9.	Click with your right mouse on Components and select New, Component.

11.	Browse to the BIN directory in the USoft installation directory (by default it is C:\program files\USD9\BIN for USoft 9, for example).

For recent Windows versions only, the following settings must be made for the USoftComJavaCall component in Component Services.

To make these settings, right-click on the USoftComJavaCall node in the tree view and choose Properties to open its property sheet.

1.	On the Security tab, the: "Authorization ->Enforce access checks for this application" setting must be unchecked, i.e. switched off.

If you have this checkbox set to checked, you will receive server component access error messages.

On the Identity tab of the property sheet, for Account, if you select the System Account option, then make sure you avoid selecting the Interactive User option. This option can be useful on a developer machine if you know you are always logged in as the system administrator but on a server machine, it is not practical.

If you select the This User option, then make sure you specify the username and password of the account under which the page engine is to run.

3.	On the Activation tab, for Activation Type, make sure you select the "Server application" option.

4.	On the Advanced tab, for Server Process Shutdown, select the "Leaving running when idle" option. This way, the Page Engine is always ready for use, even if you have not called the Rules Service that uses it for a period.

1.	Create a virtual folder (an alias) in Internet Information Services (IIS) that points to the physical folder that holds the generated web pages. A virtual folder treats the referenced physical directory as an application.

2.	Set the Session Timeout to a value larger than 0. The session timeout value determines how long users can be idle and still continue working without re-login.

Raising this value consumes more system resources because some data is kept on behalf of each user. From a security perspective, a long session timeout doesn't stop a user being away from his browser whilst others misuse his open session. From a user friendliness perspective, a short session timeout forces a user to type his password after an short idle period.