SAP JRA Configuration: Procedure

Procedure

To configure the SAP JRA, proceed as follows:

Open NW Administrator in a browser window by entering the URL http://<Servername>:<Portname>.
Log on to the SAP NetWeaver Administrator.
Choose the SAP NetWeaver Administrator link.
On the upper menu bar, choose the Connection Management Infrastructure Management and Application Resources links.

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:

In the Application Resources area upper selection field ("Show"), choose All Resource Adapters .
Select a suitable resource adapter. The SAPJavaResourceAdapter15 instance is always available.
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.
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 :

In the upper selection field (" Show "), choose All Connection Factories .
Select a suitable Connection Factory ( eis/SAPJRAFactory is delivered as standard).
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.

More Information

For detailed information on SAP JRA Programming, see:

SAP JRA Development Guidelines (EN)