Preparing Adapters

In this section:

 

Some iWay adapters require additional steps or files before they can be used. Your adapter may not be available and may not appear in iWay Explorer until these steps are performed. In many cases, this involves copying third-party libraries or JDBC drivers into the iWay \lib directory, for example:

C:\Program Files\iway7\lib

After performing the steps for your adapter, you will need to restart Service Manager if it is currently running. If you deploy components to an application server, you will need to restart the application server.

Note: This document sometimes lists the actual names of required files rather than the generic name of the driver or library. However, your vendor may change file names, update files, or have different versions of the drivers for different releases. Therefore, confirm which files are required by reviewing information provided by your vendor. Ensure that you use the latest version of the driver for the correct release of your target system, data source, or protocol.

Review the topics that follow. If you do not see your adapter listed, check the iWay website or contact a Customer Service representative.


Top of page

x
Legacy Mainframe Adapters With iWay Server Requirement

Access to the following legacy mainframe data sources is provided through an iWay (EDA) Full-Function Server component that must be installed and configured on the mainframe.

Access to and from these data sources are accomplished by first connecting to the iWay Server. Adapters for other legacy data sources do not require an iWay Server.

To configure legacy data adapters for use with iWay 7.0.7 SM:

  1. Install an iWay Server on the mainframe containing the data sources you wish to access.

    For information on iWay Server installation and configuration, see the WebFOCUS and iWay Server Installation manual and refer to the Server for z/OS chapter.

  2. Configure the iWay Server to access the data source using the iWay Full-Function Server Administration Console. The Administration Console help explains the required steps. These steps also appear in the Data Adapter Administrator User's Guide and the Server Administration for UNIX, Windows NT OpenVMS, OS/400, & z/OS manual.
  3. Install the iWay Data Management Administration Tools (DMAT) Suite on a Windows machine as explained in the iWay Data Management Administration Tools Suite Installation Guide.
  4. Use the Catalog Administrator (installed with iWay DMAT) to add stored procedures to the iWay Server catalog so the procedures are accessible from iWay Explorer.

    For information on adding stored procedures, see the iWay Catalog Administrator manual.


Top of page

x
Connect Direct

The iWay Adapter for Connect Direct requires the following library files:

The CDJAI.jar library file is used to implement Java APIs.


Top of page

x
ESRI (GEOLoad)

This section provides the supported versions and required library files for the iWay Technology Adapter for ESRI (GEOLoad).

Note: The iWay Technology Adapter for ESRI (GEOLoad) is supported only on Windows platforms.

Supported Versions

Required Library Files

ArcSDE Version 9.0 (For ESRILOAD):

ArcSDE Version 9.2 (For ESRILOAD):

ArcSDE Version 9.3 (For ESRILOAD):

GDT Matchmaker Version 6 (For Geocoding):


Top of page

x
FIX

The iWay Integration Solution for FIX requires the B2BITS® FIX Engine.

The B2BITS® FIX Engine is packaged as an archive (B2Bits_jar.zip) and can be downloaded from:

http://techsupport.informationbuilders.com/

For more information on installing the B2BITS® FIX Engine and configuring the iWay Integration Solution for FIX, see the iWay Integration Solution for FIX User’s Guide.


Top of page

x
J.D. Edwards EnterpriseOne (OneWorld)

J.D. Edwards EnterpriseOne (OneWorld) Java-based ThinNet API is required. This is normally distributed as JAR files with the J.D. Edwards installation media. These files may vary depending on the J.D. Edwards release. They usually consist of the following:

For J.D. Edwards OneWorld B7333 (XE) and B7334 (ERP8):

Kernel.jar
Connector.jar

For EnterpriseOne 8.10:

Kernel.jar
Connector.jar
jdeutil.jar
log4j.jar

For EnterpriseOne 8.11:

Base_JAR.jar
JdeNet_JAR.jar
System_JAR.jar
Connector.jar
log4j.jar

For EnterpriseOne 8.12 (Tools Release 8.96.2.0):

Base_JAR.jar
JdeNet_JAR.jar
System_JAR.jar
Connector.jar
EventProcessor_EJB.jar
EventProcessor_JAR.jar
log4j.jar

For EnterpriseOne 8.12 (Tools Release 8.97.1.2 and 8.97.2.0):

Base_JAR.jar
JdeNet_JAR.jar
System_JAR.jar
Connector.jar
EventProcessor_EJB.jar
EventProcessor_JAR.jar
commons-httpclient-3.0.jar
jmxri.jar
ManagementAgent_JAR.jar
log4j.jar

For EnterpriseOne 9.0 (Tools Release 8.98):

Base_JAR.jar
JdeNet_JAR.jar
System_JAR.jar
Connector.jar
EventProcessor_EJB.jar
EventProcessor_JAR.jar
commons-httpclient-3.0.jar
jmxri.jar
jmxremote_optional.jar
ManagementAgent_JAR.jar
log4j.jar

For EnterpriseOne 9.10 (Tools Release 9.1.0.4):

Base_JAR.jar
JdeNet_JAR.jar
System_JAR.jar
Connector.jar
EventProcessor_EJB.jar
EventProcessor_JAR.jar
commons-httpclient-3.0.jar
jmxremote.jar
commons-logging.jar
jmxri.jar
jmxremote_optional.jar
ManagementAgent_JAR.jar
log4j.jar

Note: These files are located in the \\system\classes folder on the JDE Client and the Deployment Server.

You must copy the JAR files into the iWay \lib directory, for example:

C:\Program Files\iway7\lib

Top of page

x
J.D. Edwards WorldSoft

The DB2/400 JDBC driver (jt400.jar) is required. Copy the driver into the iWay \lib directory, for example:

C:\Program Files\iway7\lib

Top of page

x
LDAP

Before installing iWay Application Protocol Adapter for LDAP, iWay Service Manager (iSM) Version 7.0 or higher must be installed on a system that is running Java 2 Standard Edition (J2SE™) JDK 1.7 or higher. For more information, see Installing iWay 7.0.7 Service Manager Components.



x
Required Installation Files

This section lists and describes the required installation files for iWay Application Protocol Adapter for LDAP.

The following file is required for the operation of the LDAP adapter, but is considered optional for a Java VM installation:


Top of page

x
Microsoft CRM 2011

All required .jar library files for the iWay Application Adapter for Microsoft Dynamics 2011 CRM On-Premises are provided in the iWay \lib folder.

Note: The iWay Application Adapter for Microsoft Dynamics CRM (Compatibility Mode) cannot be used with Microsoft CRM 2013.


Top of page

x
Microsoft .NET

The iWay Technology Adapter for Microsoft .NET allows you to expose Microsoft .NET assemblies without requiring any additional custom attributes or wrapper code.

Microsoft .NET Versions 2.0 - 4.5 are supported by the adapter.

In iWay Service Manager (iSM) Version 7.0.7, the iWay Technology Adapter for Microsoft .NET 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.



x
Required Installation Files

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



x
Sample Files

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

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


Top of page

x
MySAP ERP (SAP Java Connector Version 3.x)

The iWay Application Adapter for mySAP ERP uses the SAP Java Connector (JCo) to communicate with SAP ABAP system targets. The following protocols and document styles are supported:

No other connection methods and interface types are supported.

The official supported platform for the iWay Application Adapter for mySAP ERP is SAP Java Connector (JCo) Version 3.nn for Java Version 1.7nn. In this section, nn refers to release specifications. For a list of supported platforms and exact library names, refer to SAP Note 1077727. Use the SAP note to ensure the JVM and the JCo are compatible for the selected hardware and software platform.

Not all SAP supported platforms are supported by iWay Service Manager. For more information, check the list of iWay supported platforms to ensure compatibility.

The SAP JCo library files must be downloaded from the SAP Service Marketplace. A valid SAP support ID is required to access the SAP Service Marketplace. For assistance, contact your SAP administrator. For more information on installing, configuring, and verifying the iWay Application Adapter for mySAP ERP, see the iWay Application Adapter for mySAP ERP User's Guide.

To install iWay Application Adapter for mySAP ERP (SAP JCo 3.0), ensure that MySAP JCO 30 is selected under the Application Adapters category in the Adapter Selection pane during the iSM installation process.

The iSM installation process automatically adds the iwmysap30.jar file to the <ism_home>\lib directory.



x
Required SAP Library Files

This section lists the SAP library files that are required by the iWay Application Adapter for mySAP ERP (SAP JCo 3.0).

Platform

SAP Library Files

Windows

  • sapjco3.jar
  • sapjco3.dll

Linux/Solaris/OS400

  • sapjco3.jar
  • libsapjco3.so

HP-UX

  • sapjco3.jar
  • libsapjco3.sl

AIX

  • sapjco3.jar
  • libsapjco3.so



x
Installing the Required SAP Library Files

This section describes the specific directories where the library files must be copied for the iWay Application Adapter for mySAP ERP (SAP JCo 3.0).

Note: When the sapjco3.jar library file is added to the <ism_home>\lib folder, iWay Service Manager will automatically add this .jar file to the CLASSPATH environment variable at runtime.

The sapjco3.jar library file must always be added to the environment variable locating the system load library path, and must be the first entry in the list of library paths.

Windows

Copy the sapjco3.jar and sapjco3.dll library files to the following directory:

<ism_home>\lib

where:

<ism_home>

Is the root installation directory where iSM is installed (for example, C:\Program Files\iway7).

The sapjco3.dll library file will be added to the PATH by iWay Service Manager at runtime if it is located in the <ism_home>\lib folder. Do not install this file into the Windows\System32 folder as this file is not compatible with other versions of the library file and may cause issues if an instance of SAP GUI or other program is found on the system.

Linux

Copy the sapjco3.jar and libsapjco3.so library files to the following directory:

<ism_home>/lib

where:

<ism_home>

Is the root installation directory where iSM is installed (for example, /iway/install/iway7).

After installing the libsapjco3.so library file, this file must be added to the path indicated by the LD_LIBARARY_PATH environment variable and be the first library in the list.

HP-UX

Copy the sapjco3.jar and libsapjco3.sl library files to the following directory:

<ism_home>/lib

where:

<ism_home>

Is the root installation directory where iSM is installed (for example, /iway/install/iway7).

After installing the libsapjco3.sl library file, this file must be added to the path indicated by the SHLIB_PATH environment variable and be the first library in the list.

AIX

Copy the sapjco3.jar and libsapjco3.so library files to the following directory:

<ism_home>/lib

where:

<ism_home>

Is the root installation directory where iSM is installed (for example, /iway/install/iway7).

After installing the libsapjco3.so library file, this file must be added to the path indicated by the LIBPATH environment variable and be the first library in the list.

IBM iSeries

Consult SAP Note 1269638 on configuring the SAP JCo 3.0 on IBM iSeries. The default JVM provided cannot be used with JCo 3.0. SAP Note 1269638 has more information on this topic.

Solaris

There are different packages for different architectures (SPARC, X64, INTEL, or AMD 64 bit processor). Locate and install the correct package. Add the library file to the path indicated by the LD_LIBRARY_PATH environment variable and ensure the file is the first library in the list.


Top of page

x
Oracle Applications (E-Business Suite)

Oracle JDBC driver (ojdbc6.jar) is required by the iWay Application Adapter for Oracle E-Business Suite. You must copy this .JAR file into the iWay \lib directory, for example:

C:\Program Files\iway7\lib

To use iWay Concurrent Program request functionality, you must install and configure Oracle Client on the Oracle database that supports Oracle E-Business Suite.

Installing the iWay Oracle API Wrapper

If you want to use the iWay Application Adapter for Oracle E-Business Suite to interact with Oracle APIs (Stored Procedures and Packages), you must install the iWay Oracle API wrapper. For more information, see the iWay Application Adapter for Oracle E-Business Suite User’s Guide.

Installing the GETCLOB Procedure

The GETCLOB procedure must be installed under the schema the adapter uses to run Oracle APIs. For more information, see the iWay Application Adapter for Oracle E-Business Suite User’s Guide.


Top of page

x
PeopleSoft

This section indicates which combination of releases and system platforms are supported for the iWay Application Adapter for PeopleSoft.

PeopleSoft Platform

PeopleSoft Release

PeopleTools Release Level

All PeopleSoft supported platforms (Windows, Solaris, AIX, Linux, and HP-UX).

8.1

8.4

8.16.03 - 8.22

8.40.05 - 8.52

Note that the adapter goes by the PeopleTools release and not by the PeopleSoft application version.

Note: You must connect with only one version of an EIS at a given point in time. You cannot connect to two different versions of PeopleTools using the adapter. Do not use two versions of an EIS library file simultaneously. You also cannot use the library files for two different versions in the \lib folder.

Required Library Files

This section lists the library files that are required by the iWay Application Adapter for PeopleSoft.

All the library files for the PeopleSoft adapter must be copied to the specific directory, such as <iWAY_Home>\lib.


Top of page

x
RDBMS

iWay Technology Adapter for RDBMS connects iSM to various database engines that have an available JDBC compliant driver from the database or third party vendor. Generally, the JDBC driver should match the database version as well as the version of the JVM that is hosting iSM. Database versions that have reached the end of their vendor supported lifecycle are no longer supported by iSM and the iWay Technology Adapter for RDBMS.

All JDBC drivers are installed in the \lib. For example:



x
DB2

iSM requires a class 4 DB2 JDBC driver to access functionality database and data types. Currently, the following driver versions are required:



x
Informix


x
Oracle


x
Microsoft SQL Server


x
MySQL


x
PostGres


x
Sybase

Top of page

x
SAP R/3

The iWay Application Adapter for SAP R/3 using SAP JCo 2 is no longer supported. SAP has discontinued support for SAP JCo 2 and as a result, iWay cannot offer the adapter on unsupported versions of the JCo. For all SAP adapter installations, use the iWay Application Adapter for mySAP ERP instead. The installation instructions for mySAP ERP should be followed in any scenario that requires the SAP R/3 adapter. The mySAP ERP adapter will support SAP releases from SAP R/3 4.6C to SAP ERP 7.

For more information, see MySAP ERP (SAP Java Connector Version 3.x).


Top of page

x
Siebel

For Siebel Versions 6.3 - 8.1, Siebel Java Data Bean API is required. This is distributed as JAR files with the Siebel Thin Client.

Copy the required JAR files into the iWay \lib directory, for example:

C:\Program Files\iway7\lib

The required files vary by Siebel release in both content and name. Therefore, the Siebel Thin Client provided with the target Siebel system must always be used with the adapter, for example:

The Siebel COM-based API (Windows only) requires the Siebel Thin Client to be installed and accessible to the adapter.

The following files are for English language implementations:

SiebelTC_enu.jar
SiebelJI_enu.jar 

For non-English installations, the last three letters (_enu) vary.

Siebel Version 6.2 and Lower Connectivity Prerequisites

You must perform additional steps to connect to a Siebel system (version 6.2 and lower) using COM connectivity for an iBSP configuration. For more information, see the iWay Application Adapter for Siebel User's Guide.

Configuring Connection Pooling for Siebel

To configure connection pooling for Siebel, you must create a siebel.properties file for use with the iWay Application Adapter for Siebel. For more information on how to configure the siebel.properties file, see the iWay Application Adapter for Siebel User's Guide.


Top of page

x
Terminal Emulation Adapter (3270/5250) (Telnet)

The iWay Emulation Adapter (3270/5250) links new business applications to mainframe-based business logic through IBM 3270 and 5250 terminal screens and data streams. It enables you to transform your 3270 or 5250 mainframe screens into HTML pages or to create a remote procedure request (RPC) to transform the output of screens into an answer set. The adapter provides a simple, lightweight, and scalable way to reuse the business logic and data of terminal applications.

The iWay Emulation Adapter (3270/5250) requires client components that you must configure after installing iWay. The two client components are:

The iWay Emulation Adapter (3270/5250) includes the Telnet Designer, which is a tool to create screen-based interactions that can run with the adapter. The Telnet Designer is supported on Windows platforms only.

If the adapter is installed on a UNIX platform, then you will need to copy the Telnet Designer component, in binary format, from the UNIX system to the Windows system.

For information about using the adapter, including the Telnet Designer, see the iWay Emulation Adapter (3270/5250) User's Guide.


Top of page

x
TIBCO Rendezvous

The following file is required.

tibrvj.jar

Copy this file into the iWay \lib directory, for example:

C:\Program Files\iway7\lib

In addition to the Java file, tibrvj.jar, the iWay Adapter for TIBCO requires several TIBCO binary files. These files are stored in the following TIBCO directory:

C:\tibco\tibrv\bin

This directory must be added to the search PATH variable of any user ID that runs iWay components.


iWay Software