AcuToWeb Desktop

The AcuToWeb Desktop is a client-side component that is responsible for processing certain resources within the application that cannot be processed via the browser.

The AcuToWeb Desktop must be running on a client machine containing applications that either want to capture client user-name/passwords for validation in the AcuConnect Access file, or applications that access certain client-side resources (see Supported AcuToWeb Desktop Functions); if you do not want to capture client user-name/passwords, or if the application does not use client-side resources, then your application can run without the AcuToWeb Desktop being present.

Prerequisite

Microsoft Visual C++ 2015 Redistributable, or later version

Installation

The AcuToWeb Desktop installation file, AcuToWeb_Desktop_Setup.msi, is located in the \redist\acutoweb subdirectory of your extend installation directory, which is %ProgramFiles(x86)\Micro Focus\extend AcuToWeb Desktop x.x.x by default, where x.x.x is the extend version.

After Installing

If you intend to run applications that require the AcuToWeb Desktop, you must launch the AcuToWeb Desktop before you start a new AcuToWeb session To launch:

From your Windows desktop, click Start > extend AcuToWeb Desktop x.x.x where x.x.x is the extend version.

When running successfully,

is displayed in the system tray.

Tip: Add the ATWDesktop.exe file, located in your installation directory, to your Windows Startup folder to ensure that you are ready to run all AcuToWeb applications when you log on to Windows. Alternatively, when the AcuToWeb Desktop is running, enable the Autorun option on the Tools menu to start the Desktop automatically next time Windows is started.

Once the AcuToWeb Desktop is running, another AcuToWeb Desktop will execute each time you start a new AcuToWeb session in the browser. At that point, a Web socket communications channel is created between the Gateway/browser and the Desktop, and then all the operations that cannot be handled by the browser are forwarded to the Desktop component for processing. For example, using the C$COPY routine to copy a file between the server and client requires the AcuToWeb Desktop, and without a link to the Desktop, the statement (and application) will fail.

Tip: If you are experiencing connection problems (that is, a communications channel cannot be created before your application starts), use the TIMEOUT_ATW_CONN option in your gateway configuration file; this will insert a time delay that will allow a connection to be made before your application starts.

Each AcuToWeb Desktop session captures information about that session. From each AcuToWeb Desktop, you can save the session information to a file.