SAP JRA Configuration: Procedure

Server Configuration

The server functionality of the SAP Java Resource Adapter receives calls from an AS ABAP and forwards them to the Message Driven Beans that are registered for this JRA instance.

For the server configuration, proceed as follows:

1. In the Application Resources area upper selection field ("Show"), choose All Resource Adapters .

2. Select a suitable resource adapter. The SAPJavaResourceAdapter15 instance is always available.

3. Maintain the required values in the Properties area. The following values however must be maintained :

   • MaxReaderThreadCount =<Number of servers that can receive calls>

   • ProgramID =<Program ID as defined in transaction SM59>

   • GatewayServer = <Name of Gateway Server> (only required if the client was configured for Load Balancing or if dealing with an external (non-SAP) client).

     Note

     When you execute server calls (ABAP calls Java), you also need the parameter for client calls to get the metadata information for inbound calls. This means that you must define the Property DestinationName.

4. Once you have made all the required settings, choose Save .

Client Configuration

Configuring Existing Connection Factory

Proceed as follows when configuring an existing Connection Factory :

1. In the upper selection field (" Show "), choose All Connection Factories .

2. Select a suitable Connection Factory ( eis/SAPJRAFactory is delivered as standard).

3. In the Configuration Properties area, define the required parameters for client calls.

   Note

   The simplest way to configure all the necessary connection parameters is by defining the DestinationName parameter. Here you can enter the name of the destination that you defined in Destination Service .

   You can overwrite the values for UserName and Password if required.

   You can, however, also configure all connection parameters directly in the ConnectionFactory instance.

   The following parameters are required for a connection to AS ABAP:

   • SAPClient=XXX

   • UserName=<username>

   • Password=<password>

   • ServerName=<name of target machine>

   • PortNumber=XX

     Note

     The Port Number field corresponds to the System Number field in AS ABAP and consists of a two-figure number, for example, "21".

     If you use a server cluster, instead of using ServerName and PortNumber use the parameters MessageServer , SystemID , and Group . In this case, a connection is made with a currently existing server.

   • Once you have made all the required settings, choose Save .

   Cloning the Connection Factory

   If you want to create (clone) a new Connection Factory for another destination, follow the steps below:

   1. Choose All JCA Resources in the Show <All Resources> selection menu.

   2. Choose  SAPJavaResourceAdapter15   Dependent JCA Connection Factories  

      Copy & Add New JCA Connection Factory.

   3. Enter a JNDI name for your new Connection Factory , for example, system name 'BCE'.

      Note

      The ConnectionFactory name that you enter here is the JNDI name that you also use in the application code of the corresponding resource adapter for the setting up a client call connection.

      Note

      The Connection Factory inherits the parameter values that were defined in the corresponding resource adapter. If, therefore, the JRA was already configured, the ConnectionFactory configuration does not have to be done again. It uses the ready-defined value of the DestinationName parameter for setting up the connection (in the BCE example above).

   4. Save your entries.