This article will show you how to migrate a business integration solution containing an IBM® WebSphere® Business Integration Adapter for Enterprise JavaBeans (hereafter called a WebSphere EJB Adapter) into an Enterprise JavaBeans binding (hereafter called an EJB binding) in an IBM WebSphere Process Server environment.
The WebSphere EJB Adapter enables the integration broker to exchange business objects with enterprise beans that have been designed using the EJB architecture and deployed on an application server. Similarly, in a WebSphere Process Server environment, EJB bindings enable Service Component Architecture (SCA) components to invoke services provided by EJBs deployed on an application server.
In the existing environment, the WebSphere EJB Adapter receives a business object from the integration broker -- WebSphere InterChange Server. Using the information contained in the business object, the Adapter invokes the EJB deployed on a J2EE application server and returns the response back to the integration broker:
Figure 1. Existing solution using WebSphere EJB Adapter

Migrating to EJB bindings has several advantages:
- EJB bindings support import and export bindings, while WebSphere EJB Adapter supports only request processing.
- EJB bindings support transactions, while WebSphere EJB Adapter does not.
Figure 2. EJB bindings in WebSphere Process Server interacting with an EJB

Migration in IBM Integration Designer
Using the Migration Wizard in IBM Integration Designer, you can migrate WebSphere InterChange Server artifacts into deployable artifacts and place them in projects within an IBM Integration Designer workspace:
- In IBM Integration Designer, open the Import Wizard and select File => Import. Under Business Integration, select WebSphere InterChange Server Repository and then click Next:
Figure 3. Import Wizard in IBM Integration Designer

- In the Import Wizard, browse and select the InterChange Server Repository project:
Figure 4. Select WebSphere InterChange Server repository

- In the IBM Integration Designer Library Name field, enter the name of a new designer library or select an existing one and then click Next.
- The Configure Connector Migration screen lists the connector files in the InterChange Server repository. For the EJB Connector select EJB binding.
- Click Add and browse to choose the EJB JAR file that is referenced by the InterChange Server repository. Click Next:
Figure 5. Configure connector migration

- Choose the recommended options in the Select the Conversion Options screen and then click Next:
Figure 6. Conversion options in wizard

- The Migration Summary page is displayed with the options chosen. If you need to change the entries, click Back, otherwise click Finish to close the wizard:
Figure 7. Migration summary

- The migration is now completed, and the artifacts are generated and placed in different modules:
Figure 8. Modules in IBM Integration Designer

You can test the migrated application by implementing the output component in the EJBConnector project.
- Deploy the generated modules in WebSphere Process Server and ensure that the required EJB service is deployed and running.
- Test the flow by invoking the Test Component from the CustomerRetrieve module and sending the input request. Then you can invoke the service and examine the results:
Figure 9. Sample request

Figure 10. Response

This article showed you how to use the Migration Wizard in IBM Integration Designer V7.5 to migrate from a WebSphere EJB Adapter to an EJB binding.
- IBM Integration Designer resources
- IBM Integration Designer V7.5 information center
A single Web portal where you can find all of the information that you need to install, maintain, and use IBM Integration Designer for Linux and Windows. - IBM Integration Designer features and benefits
Explanation of features and functions, including a table of features and benefits for business managers, IT managers, and programmers. - IBM Integration Designer V7.5 library
Announcement letters, Quick Start Guide, Installation Guide, and tutorials for IBM Integration Designer for Linux and Windows. - Business Process Management samples
These samples will help BPM practitioners get started with IBM BPM software, by demonstrating how specific BPM requirements are first modelled and then implemented using IBM BPM software.
- IBM Integration Designer V7.5 information center
- WebSphere Adapters resources
- WebSphere Adapters information center
A single Web portal to all WebSphere Adapters documentation, with conceptual, task, and reference information on installing, configuring, and using WebSphere Adapters. - WebSphere Adapters product page
Product benefits, product descriptions, product news, case studies, training information, support information, and more. - WebSphere Adapters product library
Product demos, Redbooks, white papers, and more. - WebSphere Adapters support
A searchable database of support problems and their solutions, plus downloads, fixes, and problem tracking. - Business process management samples and tutorials using WebSphere Adapters
These samples show you how to use WebSphere Adapters in solutions developed with WebSphere Integration Developer and deployed on WebSphere Process Server or WebSphere ESB. - WebSphere Business Integration Adapter for Enterprise JavaBeans
Information on the WebSphere EJB Adapter. - EJB bindings
An introduction to EJB import and export bindings and binding properties, from the WebSphere ESB information center.
- WebSphere Adapters information center
- WebSphere Integration Developer resources
- WebSphere Integration Developer information center
A single Web portal to all WebSphere Integration Developer documentation, with conceptual, task, and reference information on installing, configuring, and using WebSphere Integration Developer. - WebSphere Integration Developer developer resources page
Technical resources to help you use the WebSphere Integration Developer IDE to render your existing IT assets as service components, encouraging reuse and efficiency as you build SOA-based integration solutions across WebSphere Process Server, WebSphere ESB, and WebSphere Adapters. - WebSphere Integration Developer product page
Product descriptions, product news, training information, support information, and more. -
WebSphere Integration Developer documentation library
WebSphere Integration Developer product manuals. - WebSphere Integration Developer support
A searchable database of support problems and their solutions, plus downloads, fixes, problem tracking, and more.
- WebSphere Integration Developer information center
- WebSphere resources
- developerWorks WebSphere developer resources
Technical information and resources for developers who use WebSphere products. developerWorks WebSphere provides product downloads, how-to information, support resources, and a free technical library of more than 2000 technical articles, tutorials, best practices, IBM Redbooks, and online product manuals. - developerWorks WebSphere application integration developer resources
How-to articles, downloads, tutorials, education, product info, and other resources to help you build WebSphere application integration and business integration solutions. - developerWorks WebSphere business process management developer resources
WebSphere BPM how-to articles, downloads, tutorials, education, product info, and other resources to help you model, assemble, deploy, and manage business processes. - Most popular WebSphere trial downloads
No-charge trial downloads for key WebSphere products. - WebSphere forums
Product-specific forums where you can get answers to your technical questions and share your expertise with other WebSphere users. - WebSphere on-demand demos
Download and watch these self-running demos, and learn how WebSphere products and technologies can help your company respond to the rapidly changing and increasingly complex business environment. - developerWorks WebSphere weekly newsletter
The developerWorks newsletter gives you the latest articles and information only on those topics that interest you. In addition to WebSphere, you can select from Java, Linux, Open source, Rational, SOA, Web services, and other topics. Subscribe now and design your custom mailing. - WebSphere-related books from IBM Press
Convenient online ordering through Barnes & Noble. - WebSphere-related events
Conferences, trade shows, Webcasts, and other events around the world of interest to WebSphere developers.
- developerWorks WebSphere developer resources
- developerWorks resources
- Trial downloads for IBM software products
No-charge trial downloads for selected IBM® DB2®, Lotus®, Rational®, Tivoli®, and WebSphere® products. - developerWorks blogs
Join a conversation with developerWorks users and authors, and IBM editors and developers. - developerWorks tech briefings
Free technical sessions by IBM experts to accelerate your learning curve and help you succeed in your most challenging software projects. Sessions range from one-hour virtual briefings to half-day and full-day live sessions in cities worldwide. - developerWorks podcasts
Listen to interesting and offbeat interviews and discussions with software innovators. - developerWorks on Twitter
Check out recent Twitter messages and URLs. - IBM Education Assistant
A collection of multimedia educational modules that will help you better understand IBM software products and use them more effectively to meet your business requirements.
- Trial downloads for IBM software products

Bharathi Manian is a Software Developer on the WebSphere Adapters team at the IBM India Software Lab in Bangalore, India. She has six years of experience and her areas of expertise include Java, J2EE, and Web technologies. She received a Bachelor's degree in Computer Engineering from Birla Institute of Technology and Science in Pilani, India. You can contact Bharathi at bharathi.manian@in.ibm.com.




