test

Developing OTDs for Application Adapters

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.

ProcedureTo 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.

ProcedureTo 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.