WebSphere Business Integration for SAP

ibm.com/redbooks
WebSphere Businesssiness
Integration for SAPAP
Saida Davies
Khirallah Birkler
Niall Cargill
Tino Friedemann
Reinhard Heite
Tony Shan
Sudha Chandra Veerni
Torsten Wilms
WebSphere and SAP integration using
WBI Adapters
BusinessconnectivityusingWBI
brokers
WBI and SAP XI
interoperability scenario
Front cover

WebSphere Business Integration for SAP
December 2004
International Technical Support Organization
SG24-6354-00

© Copyright International Business Machines Corporation 2004. All rights reserved.
Note to U.S. Government Users Restricted Rights -- Use, duplication or disclosure restricted by GSA ADP
Schedule Contract with IBM Corp.
First Edition (December 2004)
This edition applies to:
Version 8, Release 1, Modification 5.473 of IBM DB2
Version 5, Release 3, Modification 0 of WebSphere MQ + CSD05
Version 5, Release 0, Modification 3 of WebSphere Business Integration Message Broker
Version 5, Release 1, Modification 0 of WebSphere Business Integration Server Foundation
Version 5, Release 1, Modification 1 of WebSphere Studio Application Developer Integration
Edition
Version 4, Release 2, Modification 2.2 of WebSphere Business Integration ICS
Version 2, Release 4, Modification 0 of WebSphere Business Integration Adapter Framework
Version 5, Release 5, Modification 0 of WebSphere Business Integration Adapter for mySAP.com
Version 5, Release 5, Modification 2 of WebSphere Business Integration Adapter for mySAP.com
Version 2, Release 4, Modification 0 of, WebSphere Business Integration Adapter for JDBC
Version 1, Release 1, Modification 0 of WebSphere Business Integration Adapter for Lotus
Domino
Version 6, Release 0, Modification 0 of Lotus Domino
Version 1, Release 0, Modification 0 of WebSphere Business Integration Adapter for SAP XI
Version 3, Release 0, Modification 0 of SAP XI
Note: Before using this information and the product it supports, read the information in
“Notices” on page xxix.

© Copyright IBM Corp. 2004. All rights reserved. iii
Contents
Figures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xi
Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xxvii
Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxix
Trademarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxx
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxxi
The team that wrote this redbook. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xxxii
Become a published author . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxxix
Comments welcome. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxxix
Part 1. Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Chapter 1. Introduction and book structure . . . . . . . . . . . . . . . . . . . . . . . . . 3
1.1 Objectives . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.2 What this book is . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.3 How this book is organized . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
1.3.1 Part structure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
1.3.2 Chapter structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
1.4 What this book does not cover . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Chapter 2. Business Integration technology concepts . . . . . . . . . . . . . . . . 9
2.1 Technology overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
2.1.1 Business Integration needs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
2.1.2 Integration challenges. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
2.1.3 Concepts and terminologies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
2.1.4 IBM WebSphere Business Integration product family. . . . . . . . . . . . 14
2.2 IBM Business Integration Reference Architecture. . . . . . . . . . . . . . . . . . . 19
2.2.1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
2.2.2 Comprehensive Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
2.2.3 Roles and sample artifacts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
2.2.4 IBM software offerings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
2.2.5 Service Oriented Architecture (SOA) . . . . . . . . . . . . . . . . . . . . . . . . 37
2.2.6 e-business on demand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
2.3 SAP Enterprise Service Architecture. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
2.3.1 People Integration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
2.3.2 Information Integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
2.3.3 Process Integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

iv WebSphere Business Integration for SAP
2.3.4 Application platform. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
2.3.5 Solution Lifecycle Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
2.3.6 Composite Application Framework . . . . . . . . . . . . . . . . . . . . . . . . . . 49
2.4 Interoperability of WBI and SAP XI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Part 2. Business scenario solution design. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Chapter 3. Business case scenario. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
3.1 Business domain. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
3.1.1 Current business model of Company A . . . . . . . . . . . . . . . . . . . . . . 54
3.1.2 Current business model of Company B . . . . . . . . . . . . . . . . . . . . . . 56
3.1.3 Merger business objectives. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
3.1.4 Unified business model. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
3.1.5 Unified business model benefits . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
3.2 Business Use Case definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
3.2.1 Use Case 1 - Product data repository . . . . . . . . . . . . . . . . . . . . . . . . 62
3.2.2 Use Case 2- Internal purchase requisition process . . . . . . . . . . . . . 64
3.2.3 Use Case 3 - Inventory availability validation . . . . . . . . . . . . . . . . . . 66
3.2.4 Use Case 4 - Customer data repository . . . . . . . . . . . . . . . . . . . . . . 69
3.3 Constraints and assumptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
Chapter 4. Solution approaches and technology options. . . . . . . . . . . . . 73
4.1 Basic technology integration components. . . . . . . . . . . . . . . . . . . . . . . . . 74
4.2 SAP specialities regarding business integration . . . . . . . . . . . . . . . . . . . . 77
4.2.1 Support of various SAP releases . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
4.2.2 Support of a staged system landscape. . . . . . . . . . . . . . . . . . . . . . . 80
4.2.3 Support of various SAP R/3 interfaces . . . . . . . . . . . . . . . . . . . . . . . 81
4.3 WebSphere Business Integration product suite capabilities . . . . . . . . . . . 82
4.3.1 WebSphere Business Integration adapters. . . . . . . . . . . . . . . . . . . . 82
4.3.2 WebSphere InterChange Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
4.3.3 WebSphere Business Integration Server Foundation. . . . . . . . . . . . 88
4.3.4 WebSphere Business Integration Message Broker . . . . . . . . . . . . . 91
4.3.5 Integration server selection. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
4.4 WebSphere Business Integration in the SAP environment . . . . . . . . . . . . 94
4.4.1 WBI Adapter for mySAP.com . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
4.4.2 WBI Adapter for SAP Exchange Infrastructure . . . . . . . . . . . . . . . . 104
Chapter 5. Solution design. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
5.1 Business process analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
5.2 Design principles and methodology . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
5.3 System context . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
5.3.1 Logical model of Company A . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
5.3.2 Logical model of Company B . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
5.3.3 Unified model of merged enterprise . . . . . . . . . . . . . . . . . . . . . . . . 114

Contents v
5.4 System architecture. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
5.5 Communications and connectivity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
5.6 Use Case 1 - Solution overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
5.6.1 Process flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
5.6.2 Technology selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
5.6.3 Solution details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
5.7.1 Process flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
5.7.3 Solution detail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
5.8.1 Process flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
5.8.3 Solution detail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
5.9.1 Process flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
5.9.3 Solution detail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
5.10 Related technology used in this book . . . . . . . . . . . . . . . . . . . . . . . . . . 141
Part 3. Business scenario solution implementation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
Chapter 6. Environment setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
6.1 Technology matrix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
6.2 Run-time environment overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
6.3 Common installations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
6.3.1 Installing IBM DB2 UDB Version 8.1 with FixPack 5. . . . . . . . . . . . 150
6.3.2 Installing WebSphere MQ V5.3 with CSD04. . . . . . . . . . . . . . . . . . 171
Chapter 7. Use Case 1: WBIMB using WBI Adapter for mySAP.com . . . 173
7.1 Operational model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
7.2 Installation of WebSphere Business Integration components . . . . . . . . . 176
7.2.1 Plan the installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
7.2.2 Install Microsoft Windows 2000 Service Packs. . . . . . . . . . . . . . . . 178
7.2.3 Install a Java Runtime Environment . . . . . . . . . . . . . . . . . . . . . . . . 179
7.2.4 Install IBM DB2 UDB V8.1 with FixPack 5 . . . . . . . . . . . . . . . . . . . 179
7.2.5 Install Microsoft Data Access Component (MDAC) V2.7 . . . . . . . . 179
7.2.6 Install WebSphere MQ V5.3 with CSD05 . . . . . . . . . . . . . . . . . . . . 180
7.2.7 Install IBM Agent Controller . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
7.2.8 Install WebSphere Business Integration Message Broker . . . . . . . 180
7.2.9 Install Message Broker FixPacks . . . . . . . . . . . . . . . . . . . . . . . . . . 192
7.2.10 Install WBI Adapter Framework V2.4 . . . . . . . . . . . . . . . . . . . . . . 194
7.2.11 Install WBI Adapter for mySAP.com . . . . . . . . . . . . . . . . . . . . . . . 199
7.3 Configuration of WebSphere Business Integration components. . . . . . . 203

vi WebSphere Business Integration for SAP
7.3.1 Configure WebSphere MQ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204
7.3.2 Create a message broker domain. . . . . . . . . . . . . . . . . . . . . . . . . . 210
7.3.3 Configure the WBI Adapter for mySAP.com to access SAP R/3
via ALE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
7.3.4 Configure the WBI Adapter for mySAP.com to access SAP R/3 via the
ABAP Extension module. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
7.4 Configuration of SAP R/3 - general configuration steps . . . . . . . . . . . . . 233
7.4.1 Configure a SAP Gateway . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
7.4.2 Create a CPIC User ID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
7.4.3 Set up a RFC Destination from SAP R/3 to Gateway . . . . . . . . . . . 234
7.5 Configuration of SAP R/3 to work with the ALE Module of the Adapter . 236
7.5.1 Create a partner logical system . . . . . . . . . . . . . . . . . . . . . . . . . . . 237
7.5.2 Create a local SAP logical system . . . . . . . . . . . . . . . . . . . . . . . . . 237
7.5.3 Create a Distribution Model in the inbound SAP application. . . . . . 239
7.5.4 Create a Distribution Model in the outbound SAP application . . . . 242
7.6 Configuration of SAP R/3 to work with the ABAP Extension Module of the
Adapter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
7.6.1 Creating the /CWLD/ namespace . . . . . . . . . . . . . . . . . . . . . . . . . . 243
7.6.2 Install connector transport files for the ABAP Extension Module . . 248
7.6.3 Process the business objects in the ABAP Extension module . . . . 256
7.6.4 Create an Event triggering and detection mechanism . . . . . . . . . . 258
7.7 Development of WebSphere Business Integration Business Objects. . . 273
7.7.1 Create Business Object for the ALE module. . . . . . . . . . . . . . . . . . 274
7.7.2 Create Business Object for the ABAP Extension Module. . . . . . . . 283
7.7.3 Create Message Sets and loading Business Object Definitions . . . 288
7.8 Development of a message flow for the MaterialSynchronization (ALE
Module) scenario . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295
7.8.1 Create a Message Flow Project . . . . . . . . . . . . . . . . . . . . . . . . . . . 295
7.8.2 Build the message flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297
7.8.3 Configure the message flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300
7.8.4 Write ESQL for the Compute node . . . . . . . . . . . . . . . . . . . . . . . . . 302
7.9 Development of a message flow for the OrderEventNotification (ABAP
Extension Module) scenario . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304
7.9.1 Create a Message Flow Project . . . . . . . . . . . . . . . . . . . . . . . . . . . 304
7.9.2 Build the message flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306
7.9.3 Configure the message flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308
7.10 Deployment of the message flow applications . . . . . . . . . . . . . . . . . . . 310
7.10.1 Deploy a message broker archive. . . . . . . . . . . . . . . . . . . . . . . . . 310
7.11 Run the business scenario . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312
7.11.1 Part 1: Run the MaterialSynchronisation (ALE) scenario . . . . . . . 312
7.11.2 Part 2: Run the OrderEventNotification (ABAP Extension Module)
Scenario . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315
7.12 Usage of the Message Broker’s trace to locate errors . . . . . . . . . . . . . 325

Contents vii
7.13 Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326
Chapter 8. Use Case 2: WBISF using WBI Adapter for mySAP.com . . . 327
8.2 Installation of WebSphere Business Integration components . . . . . . . . . 330
8.2.1 Plan the installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330
8.2.2 Install WSADIE V5.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
8.2.3 Install WBISF V5.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336
8.2.4 Install IBM Remote Agent Controller V5.1 . . . . . . . . . . . . . . . . . . . 344
8.2.5 Install WBI Adapter Framework V2.4 . . . . . . . . . . . . . . . . . . . . . . . 349
8.2.6 Install WBI Adapter for mySAP.com V5.5 . . . . . . . . . . . . . . . . . . . . 355
8.3 Configuration of WebSphere Business Integration components. . . . . . . 359
8.3.1 Configuration of WebSphere MQ . . . . . . . . . . . . . . . . . . . . . . . . . . 359
8.3.2 Configuration of WBI Adapter for mySAP.com . . . . . . . . . . . . . . . . 360
8.3.3 Configuration of WSADIE V5.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361
8.3.4 Configuration of WBISF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370
8.4 Development of a business process . . . . . . . . . . . . . . . . . . . . . . . . . . . . 374
8.4.1 Create Business Objects and Connector Configuration . . . . . . . . . 374
8.4.2 Import prepackaged workspace . . . . . . . . . . . . . . . . . . . . . . . . . . . 389
8.4.3 Create the ERP Procurement Service . . . . . . . . . . . . . . . . . . . . . . 392
8.4.4 Create the HR Information Lookup Service . . . . . . . . . . . . . . . . . . 398
8.4.5 Deploy the ERP Procurement service. . . . . . . . . . . . . . . . . . . . . . . 404
8.4.6 Deploy the HR Information Lookup service. . . . . . . . . . . . . . . . . . . 407
8.4.7 Incorporate external services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 410
8.4.8 Design Internal Order business process . . . . . . . . . . . . . . . . . . . . . 412
8.4.9 Configure the Visual Test Connector . . . . . . . . . . . . . . . . . . . . . . . 431
8.4.10 Configure the mySAP.com Connector . . . . . . . . . . . . . . . . . . . . . 433
8.5 Deployment of the business process . . . . . . . . . . . . . . . . . . . . . . . . . . . 433
8.6 Run the business process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 440
8.6.1 Create internal orders using the Web client . . . . . . . . . . . . . . . . . . 441
8.6.2 Execute approval activity using the Web client . . . . . . . . . . . . . . . . 454
8.6.3 Review approved internal orders using the Web client . . . . . . . . . . 460
8.7 Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 464
Chapter 9. Use Case 3: WICS using WBI Adapter for mySAP.com and
JDBC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 465
9.2 Installation and configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 466
9.2.1 Installing Microsoft Windows 2000 Service Packs . . . . . . . . . . . . . 467
9.2.2 Installation of WebSphere MQ . . . . . . . . . . . . . . . . . . . . . . . . . . . . 467
9.2.3 Configuration of WebSphere MQ . . . . . . . . . . . . . . . . . . . . . . . . . . 467
9.2.4 Installation of IBM DB2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 472
9.2.5 Configuration of IBM DB2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 472

viii WebSphere Business Integration for SAP
9.2.6 Installation of Interchange Server . . . . . . . . . . . . . . . . . . . . . . . . . . 475
9.2.7 JDBC Adapter Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 491
9.2.8 mySAP.com Adapter Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . 496
9.3 Development . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 497
9.4 Deployment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 543
9.5 Testing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 548
9.6 Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 552
Chapter 10. Use Case 4: Integration of SAP XI with WBI
InterChange Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 555
10.1 Overview of Use Case CustomerDataRepository . . . . . . . . . . . . . . . . . 556
10.2 Operational model for CustomerDataRepository . . . . . . . . . . . . . . . . . 558
10.3 Configuring the adapter for Lotus Domino . . . . . . . . . . . . . . . . . . . . . . 559
10.3.1 The architecture of the adapter for Lotus Domino. . . . . . . . . . . . . 561
10.3.2 Configuring the Domino server for the adapter . . . . . . . . . . . . . . . 562
10.3.3 Configure the Domino connector . . . . . . . . . . . . . . . . . . . . . . . . . 567
10.3.4 Test the configured connector for Lotus Domino . . . . . . . . . . . . . 586
10.4 Configure the adapter for SAP XI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 598
10.4.1 The architecture of the adapter. . . . . . . . . . . . . . . . . . . . . . . . . . . 598
10.4.2 Generate Business Object Definitions . . . . . . . . . . . . . . . . . . . . . 599
10.4.3 Define the map Customer_Debmas01 . . . . . . . . . . . . . . . . . . . . . 602
10.4.4 Configure the configuration meta-object . . . . . . . . . . . . . . . . . . . . 604
10.4.5 Configure the XML data handler meta-object . . . . . . . . . . . . . . . . 606
10.4.6 Configure the connector for SAP XI . . . . . . . . . . . . . . . . . . . . . . . 607
10.4.7 Create WebSphere MQ queues . . . . . . . . . . . . . . . . . . . . . . . . . . 610
10.5 Configure SAP Exchange Infrastructure . . . . . . . . . . . . . . . . . . . . . . . . 611
10.5.1 Overview of SAP XI configuration . . . . . . . . . . . . . . . . . . . . . . . . . 612
10.5.2 Register back-end systems in System Landscape Directory . . . . 614
10.5.3 Configure SAP XI using the Integration Directory . . . . . . . . . . . . . 619
10.5.4 Configure the Integration Server . . . . . . . . . . . . . . . . . . . . . . . . . . 629
10.5.5 Configure the SAP R/3 back-end system . . . . . . . . . . . . . . . . . . . 631
10.5.6 Define the JMS provider for the SAP XI JMS adapter . . . . . . . . . 633
10.5.7 Test configured SAP XI together with WBI adapter for SAP XI . . 634
10.5.8 Import the XML schema for DEBMAS01. . . . . . . . . . . . . . . . . . . . 639
10.6 Run the scenario CustomerDataRepository . . . . . . . . . . . . . . . . . . . . . 641
10.7 Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 642
Chapter 11. Best practices and lessons learned . . . . . . . . . . . . . . . . . . . 643
11.1 General hints and tips . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 644
11.2 Use Case 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 644
11.3 Use Case 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 644
11.4 Use Case 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 645
11.5 Use Case 4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 646

Contents ix
Appendix A. Scripts, source, and test data . . . . . . . . . . . . . . . . . . . . . . . 647
Use Case 1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 648
Use Case 2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 652
Use Case 3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 656
Appendix B. Additional material . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 659
Locating the Web material . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 659
Using the Web material . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 659
System requirements for downloading the Web material . . . . . . . . . . . . . 660
How to use the Web material . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 660
Abbreviations and acronyms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 661
Related publications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 663
IBM Redbooks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 663
Other publications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 663
Online resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 663
How to get IBM Redbooks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 664
Help from IBM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 664
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 665

x WebSphere Business Integration for SAP

© Copyright IBM Corp. 2004. All rights reserved. xi
Figures
2-1 BI Reference Architecture - Overview . . . . . . . . . . . . . . . . . . . . . . . . . . 20
2-2 WBI Reference Architecture - Comprehensive Services . . . . . . . . . . . . 25
2-3 WBI Reference Architecture - Artifacts . . . . . . . . . . . . . . . . . . . . . . . . . 29
2-4 WBI Reference Architecture - Software offerings . . . . . . . . . . . . . . . . . 32
2-5 Adapter architecture. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
2-6 SAP NetWeaver overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
2-7 SAP NetWeaver standards support . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
2-8 SAP Exchange Infrastructure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
2-9 SAP Web Application Server architecture . . . . . . . . . . . . . . . . . . . . . . . 48
2-10 WebSphere Business Integration and SAP Exchange Infrastructure . . 50
3-1 Conceptual model of Company A . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
3-2 Conceptual model of Company B . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
3-3 Conceptual model of the merged enterprise . . . . . . . . . . . . . . . . . . . . . 60
3-4 Business case diagram - Use Case 1 . . . . . . . . . . . . . . . . . . . . . . . . . . 64
4-1 Business Integration with direct connections . . . . . . . . . . . . . . . . . . . . . 74
4-2 Business Integration with a central integration broker . . . . . . . . . . . . . . 75
4-3 Internal structure of an adapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
4-4 Type description driven by data transformation within an adapter. . . . . 76
4-5 Bidirectional communication between an EIS and integration broker . . 77
4-6 Different SAP system releases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
4-7 Typical SAP system landscape . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
4-8 Sketch of a business object Definition “Customer” . . . . . . . . . . . . . . . . 83
4-9 Adapter architecture. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
4-10 Configuration tools for WBI adapters . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
4-11 WebSphere InterChange Server Architecture . . . . . . . . . . . . . . . . . . . . 86
4-12 On demand Integrated Platform Suite . . . . . . . . . . . . . . . . . . . . . . . . . . 88
4-13 Business process execution container architecture. . . . . . . . . . . . . . . . 90
4-14 Adapter based integration in WBISF . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
4-15 WBI Message Broker extends WBI Event Broker . . . . . . . . . . . . . . . . . 91
4-16 WBI Message Broker Architecture. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
4-17 WBI Adapter for mySAP.com architecture, white board style . . . . . . . . 95
4-18 Modules of the WBI Adapter for mySAP.com - detailed view . . . . . . . . 96
4-19 Deployment topology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
4-20 BAPI Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
4-21 HDR Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99

xii WebSphere Business Integration for SAP
4-22 RFC Server Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
4-23 ALE Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
4-24 ABAP Extension Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
4-25 Architecture of WBI adapter for SAP XI V1.0. . . . . . . . . . . . . . . . . . . . 105
4-26 Architecture of WBI Adapter for SAP XI, V2.0 . . . . . . . . . . . . . . . . . . . 106
5-1 Logical architecture of Company A . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
5-2 Logical architecture of Company B . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
5-3 Logical architecture of merged enterprise . . . . . . . . . . . . . . . . . . . . . . 114
5-4 System architecture of merged enterprise . . . . . . . . . . . . . . . . . . . . . . 116
5-5 Communications diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
5-6 Business process flow for Use Case 1a . . . . . . . . . . . . . . . . . . . . . . . 120
5-7 Business process flow for Use Case 1b . . . . . . . . . . . . . . . . . . . . . . . 122
5-8 Solution detail for Use Case 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
5-9 Business process flow for Use Case 2 . . . . . . . . . . . . . . . . . . . . . . . . 127
5-14 Simplified architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
6-1 Run-time environment diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
6-2 IBM DB2 Launchpad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
6-3 Product Installation window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
6-4 IBM DB2 Setup Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
6-5 License Agreement window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
6-6 Installation type selection window . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
6-7 Installation Features window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
6-8 APPC Support Warning window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
6-9 Language Selection window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
6-10 User ID configuration window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
6-11 Set up the administration contact list window . . . . . . . . . . . . . . . . . . . 158
6-12 IBM DB2 instance creation window . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
6-13 IBM DB2 instance configuration window . . . . . . . . . . . . . . . . . . . . . . . 160
6-14 IBM DB2 tools catalog preparation window . . . . . . . . . . . . . . . . . . . . . 161
6-15 Health monitor notification contact window . . . . . . . . . . . . . . . . . . . . . 162
6-16 Satellite system information window . . . . . . . . . . . . . . . . . . . . . . . . . . 163
6-17 Install options review window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
6-18 Installation in progress . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
6-19 Setup completion window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
6-20 IBM DB2 launchpad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
6-21 Product installation window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
6-22 Process warning window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
6-23 IBM DB2 setup wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
6-24 Installation progress window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170

Figures xiii
6-25 Installation completion window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
7-1 Operational model: MaterialSynchronization scenario. . . . . . . . . . . . . 175
7-2 Operational model: OrderEventNotification scenario. . . . . . . . . . . . . . 176
7-3 The Installer language selection dialog . . . . . . . . . . . . . . . . . . . . . . . . 181
7-4 Installer welcome page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182
7-5 The migration prerequisites page . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183
7-6 The Software License Agreement page. . . . . . . . . . . . . . . . . . . . . . . . 184
7-7 The Install location page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185
7-8 Install type selection page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186
7-9 The installation summary page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187
7-10 WebSphere Business Integration Event Broker install progress . . . . . 188
7-11 The Security Wizard. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
7-12 The User Select and Create page . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
7-13 Security Wizard summary page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
7-14 Language selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194
7-15 Welcome screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
7-16 License agreement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
7-17 Installation directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
7-18 Installation summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
7-19 WebSphere MQ library location . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
7-20 Workbench installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
7-21 Program group selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
7-22 Final window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
7-24 Welcome screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199
7-26 WebSphere Adapter Framework location . . . . . . . . . . . . . . . . . . . . . . 200
7-28 Interchange Server name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201
7-30 Final window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
7-31 MQ Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206
7-32 WebSphere MQ Listener properties . . . . . . . . . . . . . . . . . . . . . . . . . . 206
7-33 The install completion screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
7-34 The Message Broker tooling welcome page . . . . . . . . . . . . . . . . . . . . 213
7-35 The Getting Started wizard welcome page . . . . . . . . . . . . . . . . . . . . . 214
7-36 The broker services user account page. . . . . . . . . . . . . . . . . . . . . . . . 215
7-37 Broker domain details page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216
7-38 The broker details page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217
7-39 The Getting Started wizard summary page . . . . . . . . . . . . . . . . . . . . . 218
7-40 Successful default configuration created . . . . . . . . . . . . . . . . . . . . . . . 218
7-41 Standard connector properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
7-42 Connector specific properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223

xiv WebSphere Business Integration for SAP
7-43 Supported Business Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
7-44 Log and trace file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
7-45 Standard properties of the connector. . . . . . . . . . . . . . . . . . . . . . . . . . 228
7-47 Supported Business Objects for the ABAP Extension & ALE Module . 232
7-48 Log and Trace File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232
7-49 Transaction su01: Maintain User . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234
7-50 Transaction sm59: RFC Destination . . . . . . . . . . . . . . . . . . . . . . . . . . 236
7-51 Transaction bd54: Logical systems . . . . . . . . . . . . . . . . . . . . . . . . . . . 237
7-52 Transaction scc4: Link local SAP logical system to a client. . . . . . . . . 238
7-53 Transaction bd64: Create a model view . . . . . . . . . . . . . . . . . . . . . . . 239
7-54 Transaction bd64: Add a message type to the model view . . . . . . . . . 239
7-55 Transaction bd64: Generate Partner Profile . . . . . . . . . . . . . . . . . . . . 240
7-56 Generate partner profile. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240
7-57 Transaction we21: Ports in IDoc processing . . . . . . . . . . . . . . . . . . . . 241
7-58 Transaction we20: Partner profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . 241
7-59 Transaction bd64: Create a model view . . . . . . . . . . . . . . . . . . . . . . . 242
7-60 Transaction bd64: Add a message type to the model view . . . . . . . . . 242
7-61 Transaction se03 - Transport Organizer . . . . . . . . . . . . . . . . . . . . . . . 244
7-62 Repository Namespace view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
7-63 Repository Namespace view - new entries . . . . . . . . . . . . . . . . . . . . . 246
7-64 New Entry details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
7-65 Transaction STMS - Add transport request to the queue . . . . . . . . . . 251
7-66 Transaction STMS - Import Request . . . . . . . . . . . . . . . . . . . . . . . . . . 252
7-67 Transaction STMS - Select Target Client . . . . . . . . . . . . . . . . . . . . . . 253
7-68 Transaction STMS - Confirmation of transport import . . . . . . . . . . . . . 253
7-69 Assign transport layer for the development class . . . . . . . . . . . . . . . . 255
7-70 Transaction se38 - ABAP Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256
7-71 Sales order business object processing . . . . . . . . . . . . . . . . . . . . . . . 257
7-72 Business Object Builder. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259
7-73 Business Object Repository Browser. . . . . . . . . . . . . . . . . . . . . . . . . . 259
7-74 Business Object Repository. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260
7-75 SAP Easy Access main view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
7-76 Event type linkages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262
7-77 Event Type Linkages - Details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263
7-78 Change View “Instance Linkages” - Overview . . . . . . . . . . . . . . . . . . . 264
7-79 Instance Linkages - Details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
7-80 IBM CrossWorld Station - Development Tab . . . . . . . . . . . . . . . . . . . . 266
7-81 CW Configuration Objects - Overview view . . . . . . . . . . . . . . . . . . . . . 267
7-82 Change View “IBM CW Object parameter configuration” - Overview . 268
7-83 Add business object. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
7-84 Add BO_EVENTRIGGER.Retrieve . . . . . . . . . . . . . . . . . . . . . . . . . . . 270
7-85 Add configuration values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271

Figures xv
7-86 Modify BO Metadata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272
7-87 Event distribution - New entry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273
7-88 SAP Object Discovery Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275
7-89 Create a new Integration Component Library . . . . . . . . . . . . . . . . . . . 276
7-90 Create new User Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277
7-91 Select the SAP ODA in the Business Object Wizard . . . . . . . . . . . . . 278
7-92 Properties in the Business Object Wizard . . . . . . . . . . . . . . . . . . . . . . 279
7-93 Select the IDoc in the Business Object Wizard . . . . . . . . . . . . . . . . . . 279
7-94 Verify the selection in the Business Object Wizard . . . . . . . . . . . . . . . 280
7-95 Supply additional information in the Business Object Wizard . . . . . . . 280
7-96 Add the IDoc message type in the application specific information . . . 281
7-97 Business Objects in the Integration Component Library . . . . . . . . . . . 282
7-98 Business Objects in the User Project. . . . . . . . . . . . . . . . . . . . . . . . . . 283
7-99 Business Objects in the Integration Component Library . . . . . . . . . . . 284
7-100 New User Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285
7-101 Business Object for the ABAP Extension module . . . . . . . . . . . . . . . . 286
7-102 Application specific information - Retrieve . . . . . . . . . . . . . . . . . . . . . . 286
7-103 Business Objects in the Integration Library . . . . . . . . . . . . . . . . . . . . . 287
7-104 Business Object in the User Project . . . . . . . . . . . . . . . . . . . . . . . . . . 288
7-105 System Manager - Broker preferences . . . . . . . . . . . . . . . . . . . . . . . . 289
7-106 Deploy to Message Broker workspace . . . . . . . . . . . . . . . . . . . . . . . . 290
7-107 Deploy the Business Objects to the Message Broker Toolkit . . . . . . . 291
7-110 Define the CwXML format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293
7-111 Define the CwXML format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293
7-112 Message set Default Wire Format and Runtime Parser . . . . . . . . . . . 294
7-113 Create a new message flow project. . . . . . . . . . . . . . . . . . . . . . . . . . . 296
7-114 Create a new message flow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297
7-115 The MaterialSynchronization_MsgFlow message flow nodes. . . . . . . 298
7-116 The MaterialSynchronization_MsgFlow message flow validated. . . . . 299
7-117 MQ Input Node Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301
7-118 Create a new message flow project. . . . . . . . . . . . . . . . . . . . . . . . . . . 305
7-119 Create a new message flow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306
7-120 The message flow nodes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307
7-121 The pass through message flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308
7-122 MQ Input Node Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309
7-123 Deploy broker archive file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311
7-124 Transaction bd10 - Send Material . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313
7-125 Transaction we02 - outbound IDoc log information . . . . . . . . . . . . . . . 314
7-126 Transaction we02 - inbound IDoc log information . . . . . . . . . . . . . . . . 315
7-127 Test Connector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316
7-128 Test Connector - Create/Select Profile . . . . . . . . . . . . . . . . . . . . . . . . 317

xvi WebSphere Business Integration for SAP
7-129 Test Connector - Connector Profile . . . . . . . . . . . . . . . . . . . . . . . . . . . 317
7-130 Test Connector - New Profile. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318
7-131 Test Connector - SAP_2Connector profile. . . . . . . . . . . . . . . . . . . . . . 318
7-132 Test Connector - Connect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319
7-133 Transaction va01: Create Sales Order . . . . . . . . . . . . . . . . . . . . . . . . 320
7-134 Creating a Standard sales order . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321
7-135 Standard Order created . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322
7-136 Connector trace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323
7-137 Incoming business object. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324
7-138 Review the business object data in the Test Connector . . . . . . . . . . . 325
7-139 Activate trace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326
8-1 Operational model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329
8-2 WSAD Integration Edition Launchpad . . . . . . . . . . . . . . . . . . . . . . . . . 332
8-3 Welcome window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333
8-6 Installation features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334
8-8 Final window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335
8-9 WebSphere Business Integration Server Foundation Launchpad . . . . 336
8-10 Installation wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337
8-11 License Agreement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337
8-12 Installation type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338
8-13 WebSphere Business Integration Server Foundation Feature . . . . . . 339
8-15 Node name and host name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340
8-16 Run as service feature . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 341
8-18 Registration window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343
8-19 Final installation window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344
8-20 Select language . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344
8-21 Install Shield welcome window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345
8-23 Customer Information window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346
8-24 Installation destination folder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346
8-25 Java Runtime Environment folder . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347
8-26 Security settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347
8-27 Remote Agent Controller access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348
8-28 Ready to install window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348
8-29 Final window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349
8-31 Welcome window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350

Figures xvii
8-35 WebSphere MQ library location . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353
8-36 Workbench installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353
8-38 Final window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354
8-40 Welcome window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355
8-42 WebSphere Adapter Framework location . . . . . . . . . . . . . . . . . . . . . . 356
8-44 Interchange Server name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357
8-46 Final window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358
8-47 Create new local server and configuration. . . . . . . . . . . . . . . . . . . . . . 361
8-48 Local server name and server type . . . . . . . . . . . . . . . . . . . . . . . . . . . 362
8-49 Enable administrative console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363
8-50 Set environment variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364
8-51 Set variable DB2_JDBC_DRIVER_PATH . . . . . . . . . . . . . . . . . . . . . . 365
8-52 Set variable MQ_INSTALL_ROOT . . . . . . . . . . . . . . . . . . . . . . . . . . . 365
8-53 Enable WebSphere security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366
8-54 Run administration console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367
8-55 Create WebSphere MQ JMS connection factory . . . . . . . . . . . . . . . . . 368
8-56 Create WebSphere MQ JMS queue destination . . . . . . . . . . . . . . . . . 369
8-57 Business Process Container database setup . . . . . . . . . . . . . . . . . . . 371
8-58 Business Process Container JMS setup . . . . . . . . . . . . . . . . . . . . . . . 372
8-59 Business Process Container JMS resources. . . . . . . . . . . . . . . . . . . . 373
8-60 New Integration Component Library . . . . . . . . . . . . . . . . . . . . . . . . . . 375
8-61 Integration component library settings . . . . . . . . . . . . . . . . . . . . . . . . . 375
8-62 Create a new business object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 376
8-63 New Business Object using ODA . . . . . . . . . . . . . . . . . . . . . . . . . . . . 376
8-64 ODA detection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 377
8-65 Search a table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378
8-66 Select a table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378
8-67 Business Object properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379
8-68 Save BO configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379
8-69 Browsing the Business Object Repository . . . . . . . . . . . . . . . . . . . . . . 380
8-70 Business Object properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 381
8-71 Create new connector configuration . . . . . . . . . . . . . . . . . . . . . . . . . . 381
8-72 Open connector template. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382
8-75 New User project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385

xviii WebSphere Business Integration for SAP
8-76 New user project settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 386
8-77 Deploy WAS project. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 387
8-78 Component selection page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388
8-79 Select the export directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389
8-80 Select Import data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 390
8-81 Project content directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391
8-82 Import from file system. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392
8-83 Import wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 393
8-84 Generate Deploy Code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394
8-85 Deployment wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 395
8-86 Inbound service files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396
8-87 Select JNDI name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397
8-88 File structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 398
8-89 Import from file system. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 399
8-90 Import wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 400
8-91 Deployment wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401
8-92 Inbound service files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 402
8-93 Select JNDI name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403
8-94 File structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404
8-95 Adjust reference binding for Queue Connection factory . . . . . . . . . . . 405
8-96 Adjust reference binding for Queue Destination . . . . . . . . . . . . . . . . . 406
8-97 Add project to Test Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 407
8-98 Adjust reference binding for Queue Connection factory . . . . . . . . . . . 408
8-99 Adjust reference binding for Queue Destination . . . . . . . . . . . . . . . . . 409
8-100 Add project to Test Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 410
8-101 Create a new Service Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411
8-102 Create a new package . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411
8-103 Folder structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412
8-104 Create a new Service project. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413
8-105 Create a new package . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413
8-106 Create new Service Skeleton. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 414
8-107 Create new port and binding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 415
8-108 Define locations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 416
8-109 Location for generated classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417
8-110 Create Business Process. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 418
8-111 Select Output operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419
8-112 Expand external services tree . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 420
8-113 Drop HR Information Lookup service. . . . . . . . . . . . . . . . . . . . . . . . . . 420
8-114 Drop create internal order service . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421
8-115 Drop Notification service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421
8-116 Connect business process nodes . . . . . . . . . . . . . . . . . . . . . . . . . . . . 422
8-117 Staff activity properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 422
8-118 Select activity owner . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 423

Figures xix
8-119 Properties of getHRData . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 424
8-120 Add variable for request. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 424
8-121 Add variable for response . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 425
8-122 Select staff activity parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 426
8-123 Add variable for staff activity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 426
8-124 Deploy code generation properties . . . . . . . . . . . . . . . . . . . . . . . . . . . 428
8-125 File location window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 429
8-126 JNDI name selection window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 430
8-127 Create a new VTC Profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 431
8-128 VTC profile list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 432
8-129 Virtual Test Connector GUI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 432
8-130 Create remote deployment server . . . . . . . . . . . . . . . . . . . . . . . . . . . . 434
8-131 Remote server host name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 435
8-132 Review installation directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 436
8-133 Remote target directory type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 437
8-134 Remote target directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 438
8-135 Application server HTTP port. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 439
8-136 Add projects to remote server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 440
8-137 Login to Web client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 442
8-138 Select InternalOrder process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 443
8-139 Start InternalOrder process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 444
8-140 Place first internal order . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 446
8-141 Place second internal order . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 447
8-142 Place third internal order . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 448
8-143 Internal order request list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 450
8-144 Processed order details of first order . . . . . . . . . . . . . . . . . . . . . . . . . . 451
8-145 Order details of second order . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 452
8-146 Order details of third order . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 453
8-147 Approvers My To Dos list. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 455
8-148 Second order details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 456
8-149 Second order start approval activity. . . . . . . . . . . . . . . . . . . . . . . . . . . 457
8-150 Approve second order . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 458
8-151 Reject third order . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459
8-152 Internal order request list after approval . . . . . . . . . . . . . . . . . . . . . . . 461
8-153 Second internal order details after approval . . . . . . . . . . . . . . . . . . . . 462
8-154 Third internal order details after rejection . . . . . . . . . . . . . . . . . . . . . . 463
9-1 Operational model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 466
9-2 WebSphere MQ local queue configuration . . . . . . . . . . . . . . . . . . . . . 468
9-3 Creating a queue manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 469
9-4 Modifying the Configure Queue manager shortcut . . . . . . . . . . . . . . . 469
9-5 Configuring the queue manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 470
9-6 Queue manager configuration output . . . . . . . . . . . . . . . . . . . . . . . . . 471
9-7 IBM DB2 administrative group creation . . . . . . . . . . . . . . . . . . . . . . . . 472

xx WebSphere Business Integration for SAP
9-8 IBM DB2 administration configuration . . . . . . . . . . . . . . . . . . . . . . . . . 472
9-9 Startup of IBM DB2 command line processor (CLP) . . . . . . . . . . . . . . 473
9-10 DB2 Instance Attach . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 473
9-11 Create database command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 473
9-12 Database manager configuration update. . . . . . . . . . . . . . . . . . . . . . . 474
9-13 ICSREPOS database configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . 474
9-14 Installation language selection. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 475
9-15 WebSphere InterChange Server InstallShield wizard . . . . . . . . . . . . . 476
9-16 License agreement window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 476
9-17 Installation directory selection window. . . . . . . . . . . . . . . . . . . . . . . . . 477
9-18 Installation options window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 478
9-19 Database selection window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 479
9-20 WebSphere InterChange Server name . . . . . . . . . . . . . . . . . . . . . . . . 479
9-21 IBM DB2 installation location . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 480
9-22 WebSphere InterChange Server service configuration . . . . . . . . . . . . 480
9-23 Start programs folder name selection . . . . . . . . . . . . . . . . . . . . . . . . . 481
9-24 Review installation options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 481
9-25 Installation progress. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 482
9-26 WebSphere InterChange Server configuration wizard launch window 482
9-27 WebSphere InterChange Server configuration . . . . . . . . . . . . . . . . . . 483
9-28 WebSphere InterChange Server configuration - WebSphere MQ . . . . 484
9-29 WebSphere InterChange Server configuration - database . . . . . . . . . 485
9-30 Configuration update confirmation . . . . . . . . . . . . . . . . . . . . . . . . . . . . 486
9-31 WebSphere InterChange Server configuration . . . . . . . . . . . . . . . . . . 486
9-33 Installation completion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 487
9-34 Toolset InstallShield wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 488
9-35 WebSphere InterChange Server installation directory. . . . . . . . . . . . . 489
9-36 Installation options review window. . . . . . . . . . . . . . . . . . . . . . . . . . . . 489
9-38 Installation summary window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 490
9-39 JDBC adapter installation language selection . . . . . . . . . . . . . . . . . . . 491
9-40 JDBC adapter InstallShield wizard. . . . . . . . . . . . . . . . . . . . . . . . . . . . 492
9-42 Adapter installation directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 493
9-43 Installation options review . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 493
9-44 WebSphere InterChange Server name entry window . . . . . . . . . . . . . 494
9-45 Start programs folder name selection . . . . . . . . . . . . . . . . . . . . . . . . . 494
9-47 Installation completion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 495
9-48 start_SAPODA.bat file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 496
9-49 start_SAP.bat file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 497
9-50 Integration process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 498

Figures xxi
9-51 System Manager preferences window. . . . . . . . . . . . . . . . . . . . . . . . . 499
9-52 WebSphere Studio Workbench . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 499
9-53 Warning message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 500
9-54 System Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 500
9-55 Project creation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 500
9-56 New Integration Component Library . . . . . . . . . . . . . . . . . . . . . . . . . . 501
9-57 Launch the SAP Object Discovery Agent (ODA) . . . . . . . . . . . . . . . . . 502
9-58 Create New Business Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 502
9-59 New Business Object dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 502
9-60 Create new Business Object Using ODA. . . . . . . . . . . . . . . . . . . . . . . 503
9-61 Business Object Wizard - agent selection . . . . . . . . . . . . . . . . . . . . . . 503
9-62 Business Object Wizard - configure ODA . . . . . . . . . . . . . . . . . . . . . . 504
9-63 Business Object Wizard - source selection . . . . . . . . . . . . . . . . . . . . . 505
9-64 Business Object Wizard - confirmation of source . . . . . . . . . . . . . . . . 506
9-65 Optional parameter prompt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 506
9-66 Business object generation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 507
9-67 Business Object Wizard - completion . . . . . . . . . . . . . . . . . . . . . . . . . 507
9-68 Application-specific information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 508
9-69 sap_bapi_material_availability business object . . . . . . . . . . . . . . . . . . 509
9-70 Business Object Wizard - agent selection . . . . . . . . . . . . . . . . . . . . . . 510
9-71 Business Object Wizard - agent configuration . . . . . . . . . . . . . . . . . . . 510
9-72 Business Object Wizard - source selection . . . . . . . . . . . . . . . . . . . . . 511
9-73 Business Object Wizard - confirmation of source . . . . . . . . . . . . . . . . 511
9-74 Business object properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 512
9-75 Business object generation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 512
9-76 Business Object Wizard - completion . . . . . . . . . . . . . . . . . . . . . . . . . 513
9-77 db2_AVAILABILITY business object . . . . . . . . . . . . . . . . . . . . . . . . . . 514
9-78 db2_REC_COM business object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 514
9-79 db2_WMDVSX Business Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 515
9-80 New business object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 515
9-81 Generic_Business_Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 516
9-82 Create new map. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 516
9-83 Project selection. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 517
9-84 Source business object selection. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 517
9-85 Destination business object selection . . . . . . . . . . . . . . . . . . . . . . . . . 518
9-86 Map name and mapping direction specification. . . . . . . . . . . . . . . . . . 518
9-87 Mapped: sap_bapi_material_availability to Generic_Business_Object 519
9-88 Activity diagram for custom verb mapping rule . . . . . . . . . . . . . . . . . . 520
9-90 Mapped: Generic_Business_Object to db2_AVAILABILITY object . . . 522
9-92 Mapped: db2_AVAILABILITY object to Generic_Business_Object . . 524
9-93 Custom mapping for db2_AVAILABILITY to Generic_Busines_Object 525

xxii WebSphere Business Integration for SAP
9-95 Generic_Business_Object to sap_bapi_material_availability_object. . 527
9-96 Create new connector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 527
9-97 New connector template selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . 528
9-98 Open file menu. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 528
9-99 JDBC template file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 529
9-100 JDBC connector specific properties. . . . . . . . . . . . . . . . . . . . . . . . . . . 530
9-101 JDBC connector specific properties. . . . . . . . . . . . . . . . . . . . . . . . . . . 531
9-102 JDBC connector supported business objects . . . . . . . . . . . . . . . . . . . 531
9-103 JDBC connector map associations . . . . . . . . . . . . . . . . . . . . . . . . . . . 532
9-104 SAP connector template file. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 532
9-105 SAP connector-specific properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . 533
9-106 SAP connector standard properties . . . . . . . . . . . . . . . . . . . . . . . . . . . 534
9-107 SAP connector supported business objects . . . . . . . . . . . . . . . . . . . . 535
9-108 SAP connector map associations . . . . . . . . . . . . . . . . . . . . . . . . . . . . 535
9-109 Create new collaboration template . . . . . . . . . . . . . . . . . . . . . . . . . . . 535
9-110 New collaboration template creation . . . . . . . . . . . . . . . . . . . . . . . . . . 536
9-111 Edit template definitions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 536
9-112 Port creation and assignments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 536
9-113 Scenario creation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 537
9-114 Scenario naming . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 537
9-115 Collaboration scenario . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 538
9-116 Set collaboration target port. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 539
9-117 Set scenario that triggers collaboration . . . . . . . . . . . . . . . . . . . . . . . . 539
9-118 Launch collaboration creation wizard. . . . . . . . . . . . . . . . . . . . . . . . . . 540
9-119 Create new collaboration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 541
9-120 Port bindings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 542
9-121 Collaboration general properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 543
9-122 WebSphere InterChange Server project creation . . . . . . . . . . . . . . . . 544
9-123 New user project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 544
9-124 Location of PerstentNameServer.bat. . . . . . . . . . . . . . . . . . . . . . . . . . 545
9-125 Persistent Name Server startup. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 545
9-126 WebSphere InterChange Server startup . . . . . . . . . . . . . . . . . . . . . . . 545
9-127 Register a WebSphere InterChange Server . . . . . . . . . . . . . . . . . . . . 546
9-128 Deployment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 547
9-129 Deployment confirmation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 547
9-130 Map compilation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 548
9-131 Collaboration template compilation . . . . . . . . . . . . . . . . . . . . . . . . . . . 548
9-132 RFC destinations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 549
9-133 RFC destination creation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 550
9-134 SAP function module selection screen . . . . . . . . . . . . . . . . . . . . . . . . 551
9-135 Test function module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 551
9-136 Results received as Export parameters . . . . . . . . . . . . . . . . . . . . . . . . 552

Figures xxiii
10-1 Business process model of Use Case CustomerDataRepository . . . . 556
10-2 WebSphere InterChange Server internal processing . . . . . . . . . . . . . 557
10-3 SAP Exchange Infrastructure internal components . . . . . . . . . . . . . . . 557
10-4 Operational model: CustomerDataRepository implementation . . . . . . 558
10-5 Components of a connector. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 560
10-6 Architecture of the adapter for Lotus Domino for event processing. . . 562
10-7 Create the Customer Contacts database. . . . . . . . . . . . . . . . . . . . . . . 564
10-8 Access Control List for Customer Contacts . . . . . . . . . . . . . . . . . . . . . 564
10-9 Open Event Table database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 565
10-10 Event Table configuration document . . . . . . . . . . . . . . . . . . . . . . . . . . 566
10-11 Elements of the WBI system manager. . . . . . . . . . . . . . . . . . . . . . . . . 567
10-12 Create a new integration library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 568
10-13 Name the new integration library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 568
10-14 Business object type DominoDocument . . . . . . . . . . . . . . . . . . . . . . . 569
10-15 Create New Business Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 569
10-16 DominoDocument business object type in Business Object Designer 570
10-17 New business object Customer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 571
10-18 Insert the first row for the business object Customer. . . . . . . . . . . . . . 571
10-19 Customer business object type in the Business Object Designer . . . . 572
10-20 Mapping of a DominoDocument to a Customer business object . . . . . 573
10-21 Create a new map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 574
10-22 Selecting the source of the DominoDocument_Mapping. . . . . . . . . . . 575
10-23 Name the map “DominoDocument_Customer” . . . . . . . . . . . . . . . . . . 575
10-24 Move transformation for the Verb and ObjectId attributes . . . . . . . . . . 576
10-25 Define the initial custom map. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 577
10-26 Execution order of the transformation steps . . . . . . . . . . . . . . . . . . . . 577
10-27 Create connector configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 579
10-28 Standard properties of the connector for Lotus Domino . . . . . . . . . . . 580
10-30 Supported Business Objects properties. . . . . . . . . . . . . . . . . . . . . . . . 581
10-31 Associated Maps properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 581
10-32 Messaging properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 582
10-33 Components of a collaboration template . . . . . . . . . . . . . . . . . . . . . . . 583
10-34 Import from Repository File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 584
10-35 Enter the installation directory of CollaborationFoundation . . . . . . . . . 585
10-36 Associate Customer business object & Collaboration Foundation ports585
10-37 Using the Visual Test Connector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 586
10-38 Get PortConnector as a copy of DominoConnector. . . . . . . . . . . . . . . 587
10-39 Enter PortConnector as ApplicationName . . . . . . . . . . . . . . . . . . . . . . 587
10-40 Create New Collaboration Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . 588
10-41 Bind ports of Domino2PortConnectorCollaboration . . . . . . . . . . . . . . . 589
10-42 Graphical view on Domino2PortConnectorCollaborationObject . . . . . 589
10-43 Start registering the ICS to the system manager . . . . . . . . . . . . . . . . . 590

xxiv WebSphere Business Integration for SAP
10-44 Specify the ICS instance to the system manager . . . . . . . . . . . . . . . . 590
10-45 Connect the System Manager to the InterChange Server instance. . . 591
10-46 Select New ICS Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 591
10-47 Create CustomerDataRepostory_Proj . . . . . . . . . . . . . . . . . . . . . . . . . 591
10-48 Call Deploy user project. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 592
10-49 Deploy CustomerDataRepository_Proj . . . . . . . . . . . . . . . . . . . . . . . . 592
10-50 Shutdown ITSOC_WICS gracefully . . . . . . . . . . . . . . . . . . . . . . . . . . . 593
10-51 Check that components of ITSOC_WICS are activated . . . . . . . . . . . 593
10-52 Create new profile for VTC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 594
10-53 Select profile in VTC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 594
10-54 Connect the VTC to ICS using the selected profile . . . . . . . . . . . . . . . 595
10-55 Create “Contact” document in “Customer Contacts” database . . . . . . 596
10-56 Event in “Event Table” database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 596
10-57 Received business object in VTC . . . . . . . . . . . . . . . . . . . . . . . . . . . . 597
10-58 Attribute values of received business object . . . . . . . . . . . . . . . . . . . . 597
10-59 Request processing of the adapter for SAP XI . . . . . . . . . . . . . . . . . . 598
10-60 Issuing New Using ODA within the Business Object Designer . . . . . . 600
10-61 Select XML ODA Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 600
10-62 Enter the file name of the DEBMAS01 XML schema file . . . . . . . . . . . 601
10-63 Select DEBMAS01 as the source node for ODA generation . . . . . . . . 601
10-64 Save generated business object to CustomerDateRepository library . 601
10-65 Select ROOT attribute as key for business object DEBMAS01 . . . . . . 602
10-66 Definition of map Customer_Debmas01 . . . . . . . . . . . . . . . . . . . . . . . 603
10-67 Name map Customer_Debmas01 and select Mapping Direction . . . . 604
10-68 Name the meta-object MO_SAPXIConnector . . . . . . . . . . . . . . . . . . . 605
10-69 Insert new row in MO_SAPXIConnector . . . . . . . . . . . . . . . . . . . . . . . 605
10-70 Define values for MO_SAPXIConnector . . . . . . . . . . . . . . . . . . . . . . . 605
10-71 Definition of XML data-handler meta-object. . . . . . . . . . . . . . . . . . . . . 607
10-72 Connector specific properties of the SAPXIConnector . . . . . . . . . . . . 608
10-73 Supported business objects for the SAPXIConnector . . . . . . . . . . . . . 609
10-74 Specify “Customer_Debmas01” as associated maps . . . . . . . . . . . . . 609
10-75 Shared queues between SAP XI and WBI Adapter for SAP XI . . . . . . 610
10-76 Overview: SAP XI processing for CustomerDataRepository . . . . . . . . 611
10-77 General components of SAP XI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 612
10-78 Entities to be configured within the Integration Directory. . . . . . . . . . . 613
10-79 SAP Exchange Infrastructure Tools. . . . . . . . . . . . . . . . . . . . . . . . . . . 615
10-80 Links for configuring Technical and Business Landscape in SLD . . . . 615
10-81 New technical system type Web AS ABAP . . . . . . . . . . . . . . . . . . . . . 616
10-82 Technical System Wizard for registering R/3 back end . . . . . . . . . . . . 616
10-83 Register Software in SLD. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 617
10-84 New technical system of type Third-Party . . . . . . . . . . . . . . . . . . . . . . 617
10-85 Technical System Wizard for registering InterChange Server . . . . . . . 617
10-86 New Business System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 618

Figures xxv
10-87 Definition of business system EnterpriseCore in SLD . . . . . . . . . . . . . 618
10-88 Definition of business system MasterDataEntrySystem in SLD. . . . . . 619
10-89 Create scenario CustomerDataRepository . . . . . . . . . . . . . . . . . . . . . 620
10-90 Start assigning Business System to CustomerDataRepository . . . . . . 620
10-91 Assign Business System EnterpriseCore . . . . . . . . . . . . . . . . . . . . . . 621
10-92 Create a new communication channel. . . . . . . . . . . . . . . . . . . . . . . . . 621
10-93 Parameter values for communication channel JMS2XI . . . . . . . . . . . . 622
10-94 XI Settings for communication channel JMS2XI . . . . . . . . . . . . . . . . . 622
10-95 Modules for the communication channel JMS2XI . . . . . . . . . . . . . . . . 623
10-96 Module configuration for communication channel JMS2XI . . . . . . . . . 623
10-97 Parameter values for communication channel IDOC2IDS. . . . . . . . . . 624
10-98 Sender agreement for sender MasterDataEntrySystem . . . . . . . . . . . 625
10-99 Start creating a receiver determination . . . . . . . . . . . . . . . . . . . . . . . . 625
10-100 Specification of the receiver determination . . . . . . . . . . . . . . . . . . . . 626
10-101 Edit Interface Determination. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 627
10-102 Edit receiver agreement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 628
10-103 Activate the Change List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 629
10-104 RFC destination IDS800 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 630
10-105 Create port for IDoc adapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 630
10-106 Load metadata for IDoc type DEBMAS01 . . . . . . . . . . . . . . . . . . . . . 631
10-107 Specify RFC destination C11CLNT800 . . . . . . . . . . . . . . . . . . . . . . . 632
10-108 Create distribution model DEBMASFROMXI . . . . . . . . . . . . . . . . . . . 632
10-109 Add message type to the distribution model . . . . . . . . . . . . . . . . . . . 633
10-110 Test configured SAP XI together with WBI adapter for SAP XI . . . . . 634
10-111 Tree view on PortConnector2SAPXICollaboration. . . . . . . . . . . . . . . 635
10-112 Update user project “CustomerDataRepository_Proj” . . . . . . . . . . . . 635
10-113 Create business object of type Customer within the VTC . . . . . . . . . 636
10-114 Send the business object. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 636
10-115 Check the business object DEBMAS01 in InterChangeSystem.log. . 637
10-116 SAP XI Integration Engine Monitoring . . . . . . . . . . . . . . . . . . . . . . . . 637
10-117 Processed XML Messages within the SAP Integration Server . . . . . 638
10-118 List of processed IDocs within . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 638
10-119 Details of received IDoc within SAP R/3 . . . . . . . . . . . . . . . . . . . . . . 639
10-120 Start importing IDoc from the SAP back end . . . . . . . . . . . . . . . . . . . 640
10-121 Choose DEBMAS01 for import . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 640
10-122 Change list after importing DEBMAS01 . . . . . . . . . . . . . . . . . . . . . . . 641
10-123 Export DEBMAS01 as XSD file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 641
10-124 Collaboration object Domino2SAPXICollaboration . . . . . . . . . . . . . . 642

xxvi WebSphere Business Integration for SAP

© Copyright IBM Corp. 2004. All rights reserved. xxvii
Tables
2-1 Integration styles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
2-2 Integration terminology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
2-3 IBM WebSphere Business Integration product family . . . . . . . . . . . . . . 15
4-1 Integration brokers characteristics matrix . . . . . . . . . . . . . . . . . . . . . . . 93
5-1 Use Case characteristics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
5-2 Integration servers in merged enterprise . . . . . . . . . . . . . . . . . . . . . . . 117
5-3 Communications mechanisms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
6-1 Technology matrix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
6-2 Run-time environment components . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
7-1 Prerequisites: WebSphere Business Integration Message Broker . . . 177
7-2 Product installation directories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
7-3 The security groups that are created by the Security Wizard . . . . . . . 189
7-4 Connector queues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
7-5 Connector queues for the ALE module . . . . . . . . . . . . . . . . . . . . . . . . 208
7-6 Components created by the Getting Started wizard . . . . . . . . . . . . . . 212
7-11 Connector transport files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
7-12 ODA configuration parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278
8-1 Software prerequisite list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330
8-2 Product installation directories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
8-3 Adapter queues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359
8-4 WebSphere Application Server interaction patterns . . . . . . . . . . . . . . 387
8-5 Test data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 445
9-2 Recommended business object property values . . . . . . . . . . . . . . . . . 506
9-4 Mapping: sap_bapi_material_availability to Generic_Business_Object519
9-5 Mapping for Generic_Business_Object to db2_AVAILABILITY. . . . . . 521
9-6 Mapping for db2_AVAILABILITY to Generic_Business_Object. . . . . . 523
9-7 Mapping: Generic_Business_Object to sap_bapi_material_availability526
9-8 JDBC Connector: Connector-Specific tab recommended settings . . . 529
9-9 Standard properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 530
9-10 SAP Connector Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 533
9-11 Standard properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 534
10-1 Host specific configurations: implementation of ICS on node ITSOC . 559

xxviii WebSphere Business Integration for SAP
10-2 Files to copy into the Domino server directories . . . . . . . . . . . . . . . . . 565
10-3 Add-on to NOTES.INI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 566
10-4 Entries within NOTES.INI for HTTP and IIOP . . . . . . . . . . . . . . . . . . . 566
10-5 Copying NCSO.jar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 566
10-6 Standard properties for the connector for SAP XI . . . . . . . . . . . . . . . . 607
10-7 Named entities within the SAP XI configuration. . . . . . . . . . . . . . . . . . 614
10-8 Adding WebSphere MQ Java libraries aii_af_jmsproviderlib.sda . . . . 633
10-9 Modifications within the file server/providerlib . . . . . . . . . . . . . . . . . . . 633

© Copyright IBM Corp. 2004. All rights reserved. xxix
Notices
This information was developed for products and services offered in the U.S.A.
IBM may not offer the products, services, or features discussed in this document in other countries. Consult
your local IBM representative for information on the products and services currently available in your area.
Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM
product, program, or service may be used. Any functionally equivalent product, program, or service that
does not infringe any IBM intellectual property right may be used instead. However, it is the user's
responsibility to evaluate and verify the operation of any non-IBM product, program, or service.
IBM may have patents or pending patent applications covering subject matter described in this document.
The furnishing of this document does not give you any license to these patents. You can send license
inquiries, in writing, to:
IBM Director of Licensing, IBM Corporation, North Castle Drive Armonk, NY 10504-1785 U.S.A.
The following paragraph does not apply to the United Kingdom or any other country where such provisions
are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES
THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED,
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT,
MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer
of express or implied warranties in certain transactions, therefore, this statement may not apply to you.
This information could include technical inaccuracies or typographical errors. Changes are periodically made
to the information herein; these changes will be incorporated in new editions of the publication. IBM may
make improvements and/or changes in the product(s) and/or the program(s) described in this publication at
any time without notice.
Any references in this information to non-IBM Web sites are provided for convenience only and do not in any
manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the
materials for this IBM product and use of those Web sites is at your own risk.
IBM may use or distribute any of the information you supply in any way it believes appropriate without
incurring any obligation to you.
Information concerning non-IBM products was obtained from the suppliers of those products, their published
announcements or other publicly available sources. IBM has not tested those products and cannot confirm
the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on
the capabilities of non-IBM products should be addressed to the suppliers of those products.
This information contains examples of data and reports used in daily business operations. To illustrate them
as completely as possible, the examples include the names of individuals, companies, brands, and products.
All of these names are fictitious and any similarity to the names and addresses used by an actual business
enterprise is entirely coincidental.
COPYRIGHT LICENSE:
This information contains sample application programs in source language, which illustrates programming
techniques on various operating platforms. You may copy, modify, and distribute these sample programs in
any form without payment to IBM, for the purposes of developing, using, marketing or distributing application
programs conforming to the application programming interface for the operating platform for which the
sample programs are written. These examples have not been thoroughly tested under all conditions. IBM,
therefore, cannot guarantee or imply reliability, serviceability, or function of these programs. You may copy,
modify, and distribute these sample programs in any form without payment to IBM for the purposes of
developing, using, marketing, or distributing application programs conforming to IBM's application
programming interfaces.

xxx WebSphere Business Integration for SAP
Trademarks
The following terms are trademarks of the International Business Machines Corporation in the United States,
other countries, or both:
AIX®
CrossWorlds®
DB2®
DB2 Universal Database™
Domino®
Domino Designer®
e-business on demand™
Eserver®
Eserver®
Everyplace®
Holosofx®
IBM®
ibm.com®
Lotus®
Lotus Notes®
MQSeries®
Notes®
Parallel Sysplex®
pSeries®
Rational®
Redbooks™
Redbooks (logo) ™
Sametime®
Tivoli®
WebSphere®
z/OS®
The following terms are trademarks of other companies:
Intel Inside (logos) and Pentium are trademarks of Intel Corporation in the United States, other countries, or
both.
Microsoft, Windows, and the Windows logo are trademarks of Microsoft Corporation in the United States,
other countries, or both.
Java and all Java-based trademarks and logos are trademarks or registered trademarks of Sun
Microsystems, Inc. in the United States, other countries, or both.
UNIX is a registered trademark of The Open Group in the United States and other countries.
Other company, product, and service names may be trademarks or service marks of others.

© Copyright IBM Corp. 2004. All rights reserved. xxxi
Preface
This IBM® Redbook demonstrates the use of WebSphere® Business Integration
products to integrate data and processes located in SAP back-end systems. The
flexible WebSphere Business Integration Server architecture and the wide range
of available application and technology adapters offers the customer a very fast
implementation cycle by protecting already made investments.
After a review of the general challenges that business integration middleware
has to master, the first part of this redbook describes how these requirements
are addressed by the IBM WebSphere Business Integration product suite. The
book explains how WebSphere Business Integration supports the IBM On
Demand strategy and how it relates to Enterprise Service Architectures from
other vendors like SAP NetWeaver.
The second part introduces common business integration drivers and develops
ordinary Use Cases to demonstrate the capabilities of IBM WebSphere Business
Integration servers in general and especially the two actual SAP related IBM
WebSphere Business Integration Adapters. The business cases illustrate how
important it is to have a flexible middleware that can rapidly create new business
processes and connect back-end data within a heterogeneous system
landscape.
The third part describes four of these Use Cases in more technical detail. A
separate environment is created for each Use Case to implement the respective
Use Case scenario. The following WebSphere Business Integration adapters are
utilized to implement the Use Cases:
IBM WebSphere Business Integration Adapter for SAP V5.5.0
IBM WebSphere Business Integration Adapter for SAP Exchange
Infrastructure V1.0
IBM WebSphere Business Integration Adapter for JDBC V2.4.0
IBM WebSphere Business Integration Adapter for JText V5.4.0
IBM WebSphere Business Integration Adapter for Lotus® Domino® V1.1.0
The business case scenario is specifically contrived to illustrate all integration
approaches the above adapters provide, and at the same time, an attempt is
made to avoid any fictitious solutions.
The final chapter discusses “lessons learned”, and the appendixes include the
source code and scripts used to create the Use Case environments.

WebSphere Business Integration for SAP

WebSphere Business Integration for SAP

Recommended

Recommended

More Related Content

What's hot

What's hot (16)

Similar to WebSphere Business Integration for SAP

Similar to WebSphere Business Integration for SAP (20)

Recently uploaded

Recently uploaded (20)

WebSphere Business Integration for SAP