Contents

Figures
About this document
What this document includes
What this document does not include
Audience
Related documents
Typographic conventions
Naming conventions
New in this release
New in version 6.0.x
New in version 5.5.x
New in version 5.4.x
New in version 5.3.x
New in version 5.2.x
New in version 5.1.x
New in version 5.0.x
New in version 4.8.x
New in version 4.7.x
New in version 4.6.x
New in version 4.5.x
New in version 4.4.x
New in version 4.3.x
New in version 4.2.x
New in version 4.1.x
Connector overview and setup
Overview
Adapter environment
Terminology
Connector architecture
How the vision connector framework works
Installing the connector
Installation tasks
Installing the connector for mySAP.com and related files
Verifying installation
Installing the SAP JCo
Upgrading the connector for the ALE Module's management of TIDs
Configuring the connector
Overview of Connector Configurator
Starting Connector Configurator
Running Configurator from System Manager
Creating a connector-specific property template
Creating a new configuration file
Using an existing file
Completing a configuration file
Setting the configuration file properties
Saving your configuration file
Changing a configuration file
Completing the configuration
Using Connector Configurator in a globalized environment
Running the connector
Starting the connector
Taking advantage of load balancing
Generating business object definitions using SAPODA
Installation and usage
Using SAPODA in Business Object Designer
After using SAPODA
Troubleshooting the connector
Generic troubleshooting
WBI performance tuning and memory management
Troubleshooting for the ABAP Extension Module
Troubleshooting for the BAPI Module
Troubleshooting for the RFC Server Module
Troubleshooting for the ALE Module
Troubleshooting the Hierarchical Dynamic Retrieve Module
Troubleshooting SAPODA
Getting support
BAPI Module
Overview of the BAPI Module
BAPI Module components
How the BAPI Module works
Configuring the BAPI Module
BAPI Module directories and files
BAPI Module configuration properties
Developing business objects for the BAPI Module
Business object naming conventions
Business object structure
Supported verbs
Business object attribute properties
Business object application-specific information
Using generated business object definitions
Using custom business object handlers
ALE Module
Overview of the ALE Module
Overview of ALE technology
ALE Module components
Using the ALE Module
Prerequisites to running the ALE Module
ALE Module directories and files
Configuring the ALE Module
Checking the SAP configuration
Checking MQ configuration
Configuring SAP to update IDoc status
Running the ALE Module
Developing business objects for the ALE Module
Creating the IDoc definition file
Business object structure
Supported verbs
Processing multiple IDocs with a wrapper business object
RFC Server Module
Overview of the RFC Server Module
RFC Server Module components
How the RFC Server Module works
Configuring the RFC Server Module
RFC Server Module directories and files
RFC Server Module configuration properties
Registering the RFC Server Module with the SAP gateway
Developing business objects for the RFC Server Module
Business object naming conventions
Business object structure
Supported verbs
Business object attribute properties
Business object application-specific information
Using generated business objects and business object handlers
Hierarchical Dynamic Retrieve Module
Overview of the Hierarchical Dynamic Retrieve Module
Hierarchical Dynamic Retrieve Module components
How the connector works
Configuring the Hierarchical Dynamic Retrieve Module
Hierarchical Dynamic Retrieve Module directories and files
Hierarchical Dynamic Retrieve Module configuration properties
Developing business objects for the Hierarchical Dynamic Retrieve Module
Business object development utilities
Business object names
Business object structure
Business object attribute properties
Business object application-specific information
Generating business objects
ABAP Extension Module
Overview of the ABAP Extension Module
ABAP Extension Module components
How the ABAP Extension Module works
Installing and customizing the ABAP Extension Module
Connector transport file installation
Verifying connector transport file installation
Upgrading the ABAP Extension Module
Enabling the SAP application for the connector
Modifying adapter-delivered ABAP objects
Preventing event ping-pong
Business object processing in the ABAP Extension Module
Business object conversion to a flat structure
Business object data routing to ABAP handlers
How ABAP handlers process business object data
Flat structure conversion to a business object
Developing business objects for the ABAP Extension Module
Background information
Developing business objects using dynamic transaction
Developing business objects using IDocs
Calling the ABAP Extension Module and ABAP handler
Developing event detection for the ABAP Extension Module
Designing an event detection mechanism
Implementing an event detection mechanism
Managing the ABAP Extension Module
Managing the connector log file
Monitoring the SAP gateway service connections
Shutting down the connector
Maintaining the event queue
Maintaining the archive table
Upgrading the ABAP Extension Module
Upgrading within a new version of SAP R/3
Upgrading ABAP handlers
Upgrade considerations
Appendixes
Appendix A. Quick Steps
Common configuration properties
Quick steps for the BAPI Module
Quick steps for the RFC Server Module
Quick steps for the ALE Module
Quick steps for the HDR Module
Appendix B. Common event infrastructure
Required software
Enabling Common Event Infrastructure
Obtaining Common Event Infrastructure adapter events
For more information
Common Event Infrastructure event catalog definitions
XML format for "start adapter" metadata
XML format for "stop adapter" metadata
XML format for "timeout adapter" metadata
XML format for "request" or "delivery" metadata
Appendix C. Application response measurement
Application Response Measurement instrumentation support
Appendix D. Standard configuration properties
New properties
Standard connector properties overview
Standard properties quick-reference
Standard properties
Appendix E. Connector-specific configuration properties
Connector-specific configuration properties
Appendix F. IBM WebSphere BI Station support levels
Development tab
Tools tab
Management tab
Configuration tab
Troubleshooting tab
Index
Notices
Programming interface information
Trademarks and service marks

Copyright IBM Corporation 1997, 2004. All Rights Reserved.