Front cover -- Contents -- Notices -- Trademarks -- Preface -- The team that wrote this redbook -- Become a published author -- Comments welcome -- Part 1 Adapter development: The theory -- Chapter 1. Adapter development -- 1.1 Technical assessment -- 1.2 Getting started with the development -- 1.2.1 Understanding the application -- 1.2.2 Identifying the directionality of the connector -- 1.2.3 Identifying the application-specific business objects -- 1.2.4 Investigating the application data interaction interface -- 1.2.5 Investigating the event management and notification mechanism -- 1.2.6 Investigating communication across operating systems -- 1.3 Getting started with the development project -- Chapter 2. Business objects -- 2.1 Overview of business objects -- 2.2 Types of business objects -- 2.2.1 Application-specific business object -- 2.2.2 Generic business object -- 2.3 Business object design -- 2.3.1 Flat business object -- 2.3.2 Hierarchical business object -- 2.3.3 Business object structure -- 2.3.4 Wrapper business objects -- 2.4 Application-specific information and metadata -- 2.5 Metadata and metaobjects -- Chapter 3. Object Discovery Agents -- 3.1 Overview of ODA -- 3.2 Design considerations -- 3.3 Setting up the development environment -- 3.4 Object Discovery Agent process flows -- 3.4.1 Obtaining ODA configuration properties -- 3.4.2 Selecting and confirming source data -- 3.4.3 Generating content -- 3.4.4 Saving content -- 3.5 Object Discovery Agent data sources -- Chapter 4. Agent initialization and termination -- 4.1 Connector startup -- 4.1.1 WebSphere InterChange Server -- 4.1.2 Business Integration Message Broker or Application Server -- 4.2 Connector initialization -- 4.2.1 Establishing a connection -- 4.2.2 Checking the connector version -- 4.2.3 Recovering In-Progress events -- 4.3 Obtaining the business object handler.

4.4 Connector termination -- 4.5 Extending the connector base class -- Chapter 5. Data handlers and name handlers -- 5.1 Design decisions for data handlers -- 5.1.1 Determining whether the data is metadata-driven -- 5.2 The development process -- 5.3 Creating the custom data handler -- 5.4 Converting data -- 5.5 Name handler development overview -- 5.6 Implementing a name handler -- 5.7 Name handler requirements -- 5.8 Reuse -- 5.9 Configuration requirements -- Chapter 6. Business object handlers -- 6.1 Overview of request processing -- 6.2 Metadata -- 6.2.1 Metadata-driven connectors -- 6.2.2 Partially metadata-driven connectors -- 6.2.3 Connectors that do not use metadata -- 6.3 One generic business object handler for all business objects -- 6.4 Multiple business object handlers -- 6.5 Designing the doVerbFor() method -- 6.5.1 Performing the verb action -- 6.5.2 Handling the Create verb -- 6.5.3 Handling the Retrieve verb -- 6.5.4 Handling the RetrieveByContent verb -- 6.6 Handling the Update verb -- 6.6.1 Handling the Delete verb -- 6.7 Business object processing and cardinality -- 6.7.1 Processing flat business objects -- 6.7.2 Processing hierarchical business objects -- 6.8 Custom business object handlers -- 6.8.1 Creating the class for the custom business object handler -- 6.8.2 Implementing the doVerbForCustom() method -- Chapter 7. Connector configuration properties -- 7.1 Overview of connector configuration property -- 7.1.1 Standard connector configuration properties -- 7.1.2 Connector-specific configuration properties -- 7.2 Using properties in your adapter -- 7.3 Retrieving properties -- 7.3.1 Single-valued simple properties -- 7.3.2 Hierarchical properties -- 7.4 Some last thoughts about standard properties -- 7.4.1 RepositoryDirectory -- 7.4.2 DeliveryTransport -- Chapter 8. Asynchronous event processing and notification.

8.1 Overview of event notification -- 8.1.1 Subscription to a business object -- 8.2 Event and archive stores -- 8.2.1 Content of an event store -- 8.2.2 Implementing an event store -- 8.2.3 Accessing the event store -- 8.2.4 Creating an archive store -- 8.3 Polling -- 8.3.1 Standard behavior -- 8.3.2 Basic logic for the poll method -- 8.3.3 Archiving events -- 8.3.4 Multithreaded -- 8.3.5 Processing events by event priority -- 8.3.6 Event distribution -- 8.4 Custom pollForEvents() method -- 8.4.1 Accessing a subscription manager -- 8.4.2 Verifying the connection -- 8.4.3 Retrieving event records -- 8.4.4 Getting the business object name, verb, and key -- 8.4.5 Checking for subscriptions to the event -- 8.4.6 Retrieving application data -- 8.4.7 Sending the business object to Adapter Framework -- 8.4.8 Completing the processing of an event -- 8.4.9 Archiving the event -- 8.4.10 Releasing event store resources -- 8.5 Processing delete events -- 8.5.1 Setting the verb in the event record -- 8.5.2 Setting the verb in the business object -- 8.5.3 Setting the verb during mapping -- 8.6 Guaranteed event delivery -- 8.6.1 Container-managed events -- 8.6.2 Duplicate event elimination -- Chapter 9. Synchronous event processing (callback) -- 9.1 Overview of the executeCollaboration method -- 9.1.1 Parameters -- 9.2 Using the executeCollaboration method -- 9.3 Single or multithreaded support for sequential event processing -- 9.4 Adapter termination and sequential event processing -- 9.4.1 Normal termination -- 9.4.2 Abnormal termination or no neat adapter shutdown situations -- Chapter 10. Local versus remote deployment -- 10.1 Overview of adapter deployment -- 10.2 Local deployment -- 10.2.1 Configuring startup in the Windows environment -- 10.2.2 Configuring startup in a UNIX environment -- 10.3 Remote deployment.

10.4 Setting up the communication between a remote agent and a broker -- 10.4.1 Native WebSphere MQ -- 10.4.2 HTTP/HTTPS -- 10.4.3 Configuring the adapter startup in remote environments -- Chapter 11. Component deployment -- 11.1 Specifics about component deployment -- 11.1.1 WebSphere InterChange Server -- 11.1.2 WebSphere Business Integration Message Broker -- 11.1.3 WebSphere Application Server -- Part 2 Developing our custom adapter -- Chapter 12. Setting up the development environment -- 12.1 Installing the necessary components -- 12.1.1 Installing WebSphere Studio Application Developer Integration Edition V5.0.1 -- 12.1.2 Installing IBM JDK 1.3.1 -- 12.1.3 Installing WebSphere MQ v5.3.0.2 -- 12.1.4 Installing WebSphere Business Integration Adapter Framework V2.4 -- 12.1.5 Installing WebSphere Business Integration Adapter Development Kit V2.4 -- 12.2 Developing the adapter -- 12.2.1 Adapter Framework -- 12.2.2 Application-specific component -- 12.2.3 Developing the application-specific component -- Chapter 13. Adapter design and environment -- 13.1 Understanding our scenario environment -- 13.1.1 The requirements -- 13.2 Examining the application environment -- 13.3 Examining the API -- 13.4 Designing application-specific business objects -- 13.5 Conclusion -- Chapter 14. Object Discovery Agent -- 14.1 Developing the ODA -- 14.1.1 Setting up the development environment -- 14.1.2 Naming conventions for the ODA -- 14.2 Implementing the ODA -- 14.2.1 Extending the ODA base class -- 14.2.2 Obtaining the handle to the ODKUtility object -- 14.2.3 Initializing the configuration-property array -- 14.2.4 Initializing ODA metadata -- 14.2.5 Initializing the ODA startup -- 14.2.6 Choosing the ODA content protocol -- 14.2.7 Generating source nodes -- 14.2.8 Generating business object definitions.

14.2.9 Providing access to generated business object definitions -- 14.3 Testing the ODA -- 14.3.1 Setting up the test environment -- 14.4 Deploying the ODA -- 14.4.1 Exporting the ODA -- 14.4.2 Creating the startup scripts -- 14.5 Generating business objects using the ODA -- 14.5.1 Completing the business objects -- Chapter 15. Initializing and terminating the adapter agent -- 15.1 Extending the connector base class -- 15.2 Initializing the adapter agent -- 15.2.1 Retrieving connector configuration properties -- 15.2.2 Establishing a connection to the application -- 15.2.3 Checking the connector version -- 15.2.4 Terminating the adapter agent -- Chapter 16. Implementing a business object handler -- 16.1 Extending the business-object-handler base class -- 16.2 Implementing the doVerbFor() method -- 16.2.1 Obtaining the active verb -- 16.2.2 Verifying the connection before processing the verb -- 16.2.3 Branching on the active verb -- 16.3 Performing the verb operation -- 16.3.1 Accessing the business object -- 16.3.2 Implementing our verb operation -- Chapter 17. Implementing event notification -- 17.1 Extending the event store class -- 17.1.1 Implementing methods to in the CWConnectoreEventStore -- 17.2 Implementing the fetchEvents() method -- 17.3 Implementing the deleteEvents() method -- 17.4 Implementing the setEventStatus() method -- 17.5 Implementing the archiveEvents() method -- 17.6 Implementing the recoverInProgress() method -- Chapter 18. Polling for events -- 18.1 Using the pollForEvents() method -- Part 3 Setting up applications for our scenario -- Chapter 19. Overview of our scenario and applications -- 19.1 Understanding our scenario environment -- 19.2 The requirements -- Chapter 20. Installing and configuring the scenario infrastructure -- 20.1 Messaging infrastructure -- 20.2 The RedTenant Web application.

20.3 Installing the RedTenant application.