Integration Using the Java Proxy Runtime

Procedure

The Java Proxy Runtime (JPR) handles the connectivity between Java proxies and the Integration Server. It converts data contained in Java proxy objects to XML messages and the other way round at runtime. For this purpose it requires information from both the exchange profile and the System Landscape Directory (SLD). More information about JPR: Java Proxy Runtime .

The JPR is installed with and integrated into the Adapter Engine. The Adapter Engine guarantees the quality of service Exactly Once (In Order) required for asynchronous messages and provides services for queuing, persistence, and monitoring of messages.

The JPR is integrated into AS Java as follows:

  • In the outbound case, an application uses proxy beans to send request messages and possibly receive response messages. The proxies in turn call the JPR to connect to the Adapter Engine which sends the messages to the Integration Server.

  • In the inbound case, a proxy server application is provided, which consists of an EJB bean handling the processing of incoming XI messages. This bean acts as a listener to the Adapter Engine, which receives the messages from the Integration Server, and in turn calls the application bean registered for the particular inbound interface.

Settings in the Exchange Profile in a Dual-Stack Installation

The JPR uses the values of certain parameters from the exchange profile to determine system-wide settings. These values should have been set during installation of the Adapter Engine.

You access the maintenance screen at: http://<host:port>/webdynpro/dispatcher/sap.com/com.sap.xi.exprofui/XIProfileApp

The variables host and port are the hostname and connection port of the AS Java of your business system. Under Connection , the connection parameters of your Integration Server should appear. From there, all necessary profile data is copied to the AS Java Secure store.

Entries in the System Landscape Directory

In addition to the deployment of your client proxy classes on the AS Java of your business system, you have to create a business system instance in the SLD when implementing an outbound Java proxy scenario. This information is used by JPR to determine the sender service when creating an outbound message, and by the Adapter Engine to locate the address of the Integration Server when sending the message. More information: System Landscape Directory .

A JPR instance used by Java applications is represented in the SLD by a technical system of type AS Java and must be associated with a business system. The technical system is specified by a system name and the name of the AS Java host.

During installation of the Adapter Engine a technical system of type AS Java is created in the SLD. It contains the following values:

  • System Name (SID): C11

  • System Home: < your hostname >

Use the built-in wizard of the SLD to create a business system instance by specifying the following:

  • An arbitrary name

  • The type of the associated technical system ( AS Java )

  • The name of the associated technical system (to be selected from the dropdown list; C11 on < your hostname > in the above example)

  • The related Integration Server (to be selected from the dropdown list)

Security Roles for the Java Proxy Runtime

  1. Use the SAP NetWeaver Administrator and choose Start of the navigation pathOperations Management  Next navigation step  User and Access Management  Next navigation step  Identity ManagementEnd of the navigation path to assign the following security roles to the appropriate user groups as follows:

Security Role Assignments

Security Role

User Group

xi_jpr_register_bindings

SAP_XI_ADMINSTRATOR_J2EE

SAP_XI_DEVELOPER_J2EE

xi_jpr_list_bindings

SAP_XI_ADMINSTRATOR_J2EE

SAP_XI_DEVELOPER_J2EE

SAP_XI_CONFIGURATOR_J2EE

xi_jpr_admin

SAP_XI_ADMINSTRATOR_J2EE

SAP_XI_CONFIGURATOR_J2EE

Configuring an Inbound Service for the Java Proxy Runtime

This is an additional configuration step, which is only required if the JPR is to be used by inbound services, that is, by EJB beans implementing inbound interfaces on a Java application server.

More information: Configuring the Channel for Java Proxy Receivers .