IBM WebSphere Business Integration Adapter, User Manual

Page: 7 / 92

Contents
Integration broker compatibility . . . . . . . . . . . . . . . . . . . . . . . . . iii
About this document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
Related documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
Typographic conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
Chapter 1. Overview of the connector . . . . . . . . . . . . . . . . . . . . . . . 1
Connector architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
How the connector works . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Chapter 2. Installing and configuring the connector . . . . . . . . . . . . . . . . . 7
Prerequisites for installing the connector . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Installing the connector on a Windows or UNIX system . . . . . . . . . . . . . . . . . . . . . 7
Configuring the connector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Starting the connector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Chapter 3. Understanding business objects for the connector . . . . . . . . . . . . 11
Defining connector metadata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Overview of business object structure. . . . . . . . . . . . . . . . . . . . . . . . . . . 11
i2 business object structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Specifying business object attribute properties . . . . . . . . . . . . . . . . . . . . . . . . 14
Identifying business object application-specific information . . . . . . . . . . . . . . . . . . . 15
Chapter 4. Generating business objects using i2 ODA . . . . . . . . . . . . . . . 17
Overview of i2 ODA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Installing i2 ODA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Using i2 ODA in Business Object Designer . . . . . . . . . . . . . . . . . . . . . . . . . 19
Create the metaobject for polling . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Chapter 5. Troubleshooting and error handling . . . . . . . . . . . . . . . . . . 27
Logging error messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Tracing messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Tips for troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Appendix A. Standard configuration properties for connectors . . . . . . . . . . . 33
New and deleted properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Configuring standard connector properties for WebSphere InterChange Server . . . . . . . . . . . . . 34
Configuring standard connector properties for WebSphere MQ Integrator . . . . . . . . . . . . . . 46
Appendix B. Connector Configurator . . . . . . . . . . . . . . . . . . . . . . . 55
Using Connector Configurator in an internationalized environment. . . . . . . . . . . . . . . . . 55
Starting Connector Configurator . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Choosing your broker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Using a connector-specific property template . . . . . . . . . . . . . . . . . . . . . . . . 58
Using Connector Configurator with ICS as the broker . . . . . . . . . . . . . . . . . . . . . 61
Setting the configuration file properties (ICS) . . . . . . . . . . . . . . . . . . . . . . . . 63
Setting the configuration file properties (WebSphere MQ Integrator Broker) . . . . . . . . . . . . . . 68
Using standard and connector-specific properties with Connector Configurator. . . . . . . . . . . . . 71
Completing the configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Appendix C. Connector feature list . . . . . . . . . . . . . . . . . . . . . . . 73
Event notification features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
© Copyright IBM Corp. 2002, 2003
v