Installing the iWay .NET Technology Adapter

Topics:

Microsoft .NET Framework Version 3.5 and higher is the minimum requirement for running this release of the iWay .NET Technology Adapter.

In iWay Service Manager (iSM) Version 7.0, the iWay .NET Technology Adapter supports 32- and 64-bit JVM environments. The required components for both environments are automatically installed. During the iSM installation process, ensure that Microsoft .NET is selected under the Technology Adapters category in the Adapter Selection pane, as shown in the following image.

Required Installation Files

Topics:

The iSM installation process installs the following adapter components in the <ism_home>\lib directory:

  • iwdotnet.jar. Exposes design time and runtime interfaces for the iWay .NET Technology Adapter.
  • iwdotnet32.dll or iwdotnet64.dll. Export the JNI methods that are required by the Java classes, which implement the adapter and act as a common language runtime host.

    Note: Both versions of the iwdotnet DLL file are shipped with the adapter. Depending on the JVM, the adapter will select the appropriate DLL file to load. A 64-bit JVM can load 32 - and 64-bit Assemblies. A 32-bit JVM can only load 32-bit Assemblies no matter the platform type (32 - or 64-bit).

  • iwclr.dll. Contains the functionality to explore Assemblies during design time, load and invoke classes and methods at runtime, and implement the optional custom attributes used for Assembly annotation.

    Note: The installation will also install in the Windows Global Assembly Cache an iwclr module with a strongly named Assembly with key and version. This GAC resident copy of iwclr enables the adapter to reload Assemblies and to introspect GAC resident Assemblies when requested.

The following diagram illustrates the runtime architecture of the iWay .NET Technology Adapter when performing services that interact directly with a .NET application.

The iWay .NET Technology Adapter allows you to expose Microsoft .NET Assemblies in a J2EE environment. Unmanaged COM components may be invoked through a .NET Run Time Callable Wrapper (RCW).

Required User Provided Files

An instance of J2EE.jar, which is dated from 2009 or later is required.

The iWay .NET Technology Adapter has been tested with Microsoft .NET Framework Version 4.5 and 4.0, on both client and server machines. The CLI depends on class libraries that cannot be checked at runtime. Ensure the features of the framework that the deployed code will execute are present and installed on the current system before proceeding.

Sample Files

The iWay .NET Technology Adapter installs the following sample .NET Assemblies in the <ism_home>\etc\samples\dotnet\bin directory:

  • Complex.dll. Nested classes sample.
  • Math.dll. Using mathematical functions.
  • Misc.dll. Parameter decoration sample.
  • scriptor.dll. Sample text functions.
  • SubComplex.dll. A subclass of the Complex sample.

These precompiled Microsoft .NET Assemblies can be used for adapter testing and verification purposes.