Enabling the SAP application for the connector

After installing the connector and configuring the standard and connector-specific configuration properties, you have the option of modifying the event handling and logging capabilities for the connector from within the SAP application.

Setting up event distribution

Load balancing distributes event and business object request processing across multiple connectors. The IBM WebSphere Business Integration Adapter for mySAP.com can handle only one transaction at a time. Therefore, if you set up multiple connectors to handle specific business objects, then multiple events and business objects can be processed at the same time. For more information on setting up multiple connectors, see Installing multiple connectors.

To set up event distribution for multiple connectors:

  1. Go to the IBM WebSphere InterChange Server Connector Tools window (transaction YXR1).
  2. From the Customizing menu, click Connector, and then click Event Distribution.
  3. Click the New Entries button (F5), and in the New Entries window, enter the business object name, connector name, and InterChange Server name.
  4. Enter a number in the counter field for each business object. The combination of the business object and counter provides a unique key for the event distribution table. The counter can be any number up to six digits in length.

Note:
In a test environment, you may have multiple users testing the same business object that is subscribed to by multiple connectors. If each user wants only a certain event for that business object, then you can specify a user name to differentiate between which event is passed to which combination of connector and integration broker. In the User (Event Trigger) field, enter the appropriate user name for the business objects.

Setting up event filtering

The configuration table in the SAP application cannot accommodate all modifications, so the IBM WebSphere Business Integration Adapter for mySAP.com provides an ABAP include program that can be modified to filter events. This program, YXRRESTR is called from within the event trigger Y_XR_ADD_TO_QUEUE to enable additional filtering of events.

Note:
You must have developer privileges to make changes because the code needs to be recompiled.

To view or modify the include program YXRRESTR:

  1. Go to the IBM WebSphere InterChange Server Connector Tools window (transaction YXR1).
  2. From the Customizing menu, click Event Triggering, and click Modify Restrictions (transaction YXRS).

A number of possibilities for event filtering can be configured using this program.

Setting up event priority

You can set the priority of an event to be processed based on its importance. By setting the priority of each combination of business object, connector, and integration broker, you can delay a connector's retrieval of an event. For example, if you set the priority of an event to 10, the connector polls the event table ten times before retrieving the event. So, if the connector polls the event table every 5 seconds, the connector picks up the event after 50 seconds. Each time the connector polls, the priority value is reduced by one until the event is retrieved and processed.

To set the priority of an event:

  1. Go to the IBM WebSphere InterChange Server Connector Tools window (transaction YXR1).
  2. From the Customizing menu, click Connector, and click Event Distribution.
  3. Populate the Priority column, with a value between 1 and 99 for the appropriate business object.

Increasing log tablespace size

The log tables for the IBM WebSphere Business Integration Adapter for mySAP.com are located, by default, in the tablespace named PSAPUSER1D,and the indexes are located in tablespace PSAPUSER1I. PSAPUSER1D and PSAPUSER1I are SAP application tablespaces reserved for customer use, but are typically small. Because of the default size, these tablespaces can fill up quickly, depending on the level of activity and the logging level of the adapter's installation.

To view the current size of these tablespaces, go to transaction DB02, and then click the Current Sizes button. The volume of events captured by IBM WebSphere business integration system determines the size needed for these tablespaces.

If the default sizes are too small, ask the SAP database administrator for the installation to modify them.

Verifying number ranges for transport objects

There are three objects for the adapter that must have an adequate number range within the SAP application. When the transports are installed, the following objects and their default number ranges are set:

You should have to verify only that the associated number ranges are set correctly. To view the number ranges:

  1. Go to transaction SNRO.
  2. Populate the Object field with the object name (for example, YXR_EVENT).
  3. Click Number Ranges, and then click Intervals.

Note:
If you reinstall the Primary connector transport in an installation where events have already been generated, new events may be created using existing event IDs. To prevent this problem, turn off logging (transaction YXRM), and then truncate the log completely before re-importing the connector transport file. Once the connector transport file has been successfully loaded, turn logging back on. For more information on truncating the event log, see "Setting up truncation of the event log".

Copyright IBM Corp. 1997, 2004