Installing SAP JCo

The SAP Java Connector file, sapjco.jar, is a middleware component that enables the development of SAP-compatible components and applications in Java. This component is required by the SAP BAPI OTD Wizard to create BAPI and RFC OTDs during design time, and to support inbound and outbound SAP server communication during runtime.

Since we are installing the SAP Java Connector as standalone component, certain installation files are required. Download the installation files from SAPNet at http://service.sap.com/connectors/. Once logged in, this link redirects you to SAP Service Marketplace. Click the following links to access the SAP Java Connector (SAP JCo) tools and services page:

SAP NetWeaver > SAP NetWeaver in Detail > Application Platform > Connectivity > Connectors > SAP Java Connector > Tools & Services

The following section details the basic guidelines for installation.

To Install SAP JCo on Windows 32

1. Create a directory.

   For example

    C:\SAPJCo

   and extract the JCo ZIP file into this directory.

2. Copy the files librfc32.dll and sapjcorfc.dll from your SAP JCo main directory to

    C:\WINNT\SYSTEM32

   Make sure that the version that is already there is not a more recent version than the one that is delivered with the SAP JCo.

3. Copy the file sapjco.jar from your SAP JCo main directory to

    <JavaCAPS6>\netbeans\lib\ext

   Where <JavaCAPS51> is the Sun Java Composite Application Platform Suite install directory.

4. The sapjco.jar file is also required during runtime. For this, add the JAR file to

    <JavaCAPS6>\netbeans\is\lib

5. Download the following DLL files:

   • msvcp71.dll

   • msvcr71.dll

   These are available, free of charge, from various sources on the Internet:

6. Manually add the DLL files to the following location:

   c:\WINNT\system32

   Note - Restart both Netbeans IDE and the domain after installing the JAR file.

To Install SAP JCo on Unix

The instructions for the installation of SAP JCo on other operating systems are included in the corresponding download files.

1. On UNIX operating systems, add the OS specific shared lib files to the library path.
2. Check the SAP BAPI Adapter readme to confirm the supported operating systems.
3. Copy the JCo JAR file to the following location before deploying and running command line code generation.

    \compile\lib\ext

4. Copy the JCo JAR file to the c:\Sun\ApplicationServer\lib folder before deploying and running via the Sun Java™ System Application Server Enterprise Edition 8.1.
5. Copy the JCo JAR file to the following location before deploying and running via the WebLogic Application Server, version 9.1.

    c:\bea\weblogic91\samples\domains\wl_server\lib

   Note - The SAP Java Connector file, JCo version 2.1.6 is not backwards compatible with previous versions, such as 2.1.3. Confirm backwards compatibility issues with SAP before attempting to switch between different JCo versions on different machines.

   Note - SAP BAPI Adapters can run on a 64-bit JVM, but only after the correct 64-bit JCo files (version 2.1.3 or later) have been applied.

   Note - The SAP application must be configured to communicate with the SAP BAPI Adapter as described in Configuring SAP in the SAP BAPI Adapter Intelligent Adapter User’s Guide.

   Note - We recommend only using the directory path when setting your library path, not the directory path and file name.

   Note - JCo 2.1.6 does not support mixed case, users may need to convert passwords to upper case for all design time and runtime SAP connection configurations.