Printed in the U.S.A. Lotus Domino R5.0 Enterprise Integration: Architecture and Products SG24-5593-00 Part No. CT6QUNA Lotus Domino R5.0R5.0 EnterEnterpriseprise Integration:Integration: ArArchitecturechitecture andand PrProductsoducts Søren Peter Nielsen, Theo Barkhuizen, Laurisa G. Maldonado, Robert Perron, Peter Sing International Technical Support Organization http://www.redbooks.ibm.com SG24-5593-00 22 SG24-5593-00 International Technical Support Organization Lotus Domino R5.0 Enterprise Integration: Architecture and Products July 1999 Take Note! Before using this information and the product it supports, be sure to read the general information in the Special Notices section at the back of this book. First Edition (July 1999) This edition applies to Lotus Domino Release 5.0 and Lotus Enterprise Integrator Release 3.0. Comments may be addressed to: IBM Corporation, International Technical Support Organization Dept. JN9B Building 045 Internal Zip 2834 11400 Burnet Road Austin, Texas 78758-3493 When you send information to IBM, you grant IBM a non-exclusive right to use or distribute the information in any way it believes appropriate without incurring any obligation to you. © International Business Machines Corporation 1999. All rights reserved. Note to U.S. Government Users: Documentation related to restricted rights. Use, duplication or disclosure is subject to restrictions set forth in GSA ADP Schedule Contract with IBM Corp. Contents Preface ........................ ix Loading the Connector Classes ........17 The Team That Wrote This Redbook ....... x Coding a Program Using the Connector Classes ...............18 Comments Welcome ................. xi Additional Enterprise Integration Tools .....19 1 Overview .................... 1 Lotus Connector Toolkit .............19 Lotus Connectors ................... 2 ActiveX Data Object ...............20 Relational Database Management Systems . 2 MQSeries Enterprise Integrator ........20 Enterprise Resource Planning Applications . 3 JDBC .........................20 Transaction Processing Systems ........ 3 NotesSQL ......................20 Directory Services ................. 4 Domino Driver for JDBC ............21 Other Services ................... 4 Documentation ....................21 Platforms ...................... 4 Summary ........................21 MetaConnectors .................. 5 2 Domino Enterprise Connection Character Sets ................... 5 Services (DECS) ................23 Domino Enterprise Connection Services .... 5 Installing DECS ....................23 Administration .................. 6 Domino Quick and Easy Configuration ...25 Connections .................... 6 Advanced Configuration ............27 Activities ...................... 7 Starting and Controlling DECS ..........30 Lotus Enterprise Integrator ............. 8 DECS Variables in the NOTES.INI File ...31 Administration .................. 9 DECS Administration ................33 Connections ....................10 Supported Data Sources .............33 Activities ......................11 The DECS Navigator ...............34 Development Client ...............12 The DECS Connections View ..........37 Lotus Connector LotusScript Extension .....12 The DECS Activities View ...........37 Loading the Connector Classes ........13 DECS Administrator Menu Commands ...38 Coding a Script Using the LC LSX ......14 Defining Connections in DECS ..........39 LEI Extensions ...................16 Creating Connections with the wizard ....39 System-Specific LotusScript Extensions ...16 Creating Connections without the wizard . 42 Java Classes .......................17 Building the Notes Application ........43 Contents iii Defining Activities in DECS ............46 LEI Administrator Documents ........ 104 Creating Activities with the wizard ......46 LEI Navigator .................. 104 Creating Activities without the wizard ...52 LEI Administrator Menu Commands ... 106 Activity Options ..................55 LEI Connector Documents ............ 108 DECS and the Domino Architecture .......66 Connectors and Supported Data Sources . 109 Clustering ......................66 Constructing Connectors ........... 109 Partitioning .....................67 Testing Connectors ............... 110 HTTP Server ....................67 MetaConnectors ................. 111 DECS and LEI Real time .............67 Constructing MetaConnectors ........ 112 DECS Examples ....................68 LEI Activities ..................... 112 Dynamic Queries .................68 Admin-Backup Activity ............ 112 Running DECS ...................76 Admin-Purge Log Activity .......... 113 Summary ........................84 Archive Activity ................. 113 3 Lotus Enterprise Integrator .....85 Command Activity ............... 113 Lotus Enterprise Integrator Overview ......85 Direct Transfer Activity ............ 114 LEI Server ......................85 DPROPR Activity ................ 114 LEI Development Client .............86 Polling Activity ................. 114 LEI Databases ...................86 RealTime Activity ................ 115 Installation of Lotus Enterprise Integrator ...87 Replication Activity ............... 115 Server Installation Requirements .......87 Java Activity ................... 118 Installing LEI Server ...............87 Scripted Activity ................. 118 Verifying Installation and Connectivity ...95 Constructing an Activity ........... 119 Installing the Enterprise Integrator Using Action Buttons to Development Client .............96 Construct Activities ............. 119 Migration from NotesPump to LEI ........97 Running Activities ............... 126 Starting and Running the LEI Server .......98 LEI LotusScript Extensions and Java Classes . 128 Running LEI as a Domino Add-In Task ...98 LC LSX Extensions with LEI ......... 128 Running LEI as a Standalone LEI Server ..99 Java Classes .................... 128 Server Console Commands .......... 100 LEI Examples .................... 129 LEI Administrator Database Commands . 101 Direct Transfer and RealTime Access to Relational Data ............... 129 Changing LEI Run Mode ........... 101 Replication to Relational Data ........ 135 Comparing Server Run Modes ........ 102 Direct Transfer and RealTime Using the Development Client .......... 102 Access to SAP ................ 142 Using the LEI Administrator Database .... 103 Summary ....................... 148 iv Lotus Domino R5.0 Enterprise Integration: Architecture and Products 4 Connector Programming MQSeries Trigger Monitor (MQTM) for Interfaces ..................... 149 Lotus Notes Agents ............. 206 LotusScript Extension for Lotus Connectors . 149 MQSeries Enterprise Integrator for Lotus Notes (MQEI) ................ 210 Software Requirements ............ 149 MQLSX or MQEI? ................ 214 Terms and Concepts .............. 150 SAP R/3 Integration ................ 215 LC LSX Classes ................. 151 SAP R/3 Connector ............... 215 Working with LC LSX ............. 160 SAP R/3 2.0 LotusScript Extension ..... 215 Error Handling ................. 163 Lotus Domino Integration for SAP R/3 Example Using LCSession to Determine Business Workflow ............. 218 the Installed Connectors .......... 163 Mail Integration ................. 219 Example Using SQL to Generate a Result Set ................... 164 Summary ....................... 220 Example Using the Select Method to 6 Additional Integration Methods . 221 Generate a Result Set ........... 165 Java and Domino R5.0 ............... 221 Java Classes for Lotus Connectors ....... 166 What is JDBC? .................. 221 Software Requirements ............ 166 Domino Driver for JDBC ........... 222 LC Java Classes ................. 166 Servlets ...................... 223 Examples for LC Java Classes ........ 177 CORBA and Domino ................ 224 Lotus Connector Toolkit .............. 181 ADO and OLEDB .................. 225 Design Overview ................ 181 ActiveX Data Objects (ADO) ......... 225 Installation .................... 181 NotesSQL ....................... 229 Support Files and Templates ......... 181 ODBC Conformance .............. 229 Summary ....................... 182 Downloading and Installing NotesSQL .. 230 5 Lotus EI Product Updates ..... 183 Setting up a NotesSQL Data Source .... 230 LotusScript Data Object and ODBC ....... 183 Connecting to a Domino Data Source ... 231 What is ODBC? ................. 183 Mapping SQL Components to Domino .. 231 LotusScript:DataObject (LS:DO) ....... 184 Example Using Personal Address Book .. 232 Using @DB Functions to Access Other Summary of Supported SQL Grammar .. 233 Databases through ODBC ......... 196 Using the RunOnServer to Connect to DB2LSX ........................ 198 Enterprise Data ............... 234 DB2 LotusScript Data Objects DB2 Summary ....................... 236 LSX Update .................. 200 7 Which Tool to Use When ...... 237 MQSeries Integration ............... 201 Relational Data Transfer ............ 237 MQSeries Link LotusScript Extension (MQLSX) ................... 201 Transaction Services .............. 239 Contents v Enterprise Relationship Planning Oracle Financial Applications .......... 259 (ERP) Systems ................ 241 Product Status .................. 259 Other Services .................. 242 Platforms ..................... 259 Scenarios ....................... 243 PeopleSoft ....................... 260 Example 1: Access to SAP R/3 ........ 243 Product Status .................. 260 Example 2: Access to PeopleSoft ....... 244 Platforms ....................