Skip to main content

This is documentation for Caché & Ensemble. See the InterSystems IRIS version of this content.

For information on migrating to InterSystems IRIS, see How to Migrate to InterSystems IRIS, available on the WRC Distributions page (login required).


SAP Java Connector (SAP JCo) is a Java-based component that supports communication with an SAP Server in both directions. InterSystems provides components that you can add to a production to enable the production to communicate with SAP JCo, and thus with an SAP Server. The following picture shows the architecture:

generated description: outbound

The architecture includes the Java Gateway, which must be running.

To communicate with SAP JCo, the production must include the following items:

  • EnsLib.SAP.Operation, which communicates via TCP/IP with the Java Gateway.

  • EnsLib.JavaGateway.Service, which starts and stops the Java Gateway.

    This business host performs an additional function: its settings indicate the location of the Java Gateway. When correctly configured, the EnsLib.SAP.Operation business host retrieves those settings and uses them. Thus it is not necessary to set any environment variables.

    Unlike most business hosts in an Ensemble production, EnsLib.JavaGateway.Service does not handle any Ensemble messages.

It is not necessary to manually create message classes to carry the SAP requests within the production. InterSystems provides a CSP page that you can use to generate the message classes.