Implementing WebSphere Business Integration Express for Item Synchronization

102 Implementing WebSphere BI Express for Item Synchronization

Figure 8-5 Create new business object

21.Add the attributes as shown in Figure 8-6. The value in the field App Spec Info

is:

OutputQueue=queue://<queue manager name>/<queue name>;DataEncoding=Text

For our configuration, this is:

OutputQueue=queue://SUPPLIER/OUTBOX;DataEncoding=Text

Figure 8-6 The business object MO_ISoftAdapterConfig

22.Save and close the business object.

23.Using WebSphere MQ Explorer, create the local queue that you used in the

business object MO_ISoftAdapterConfig (making the default persistence

YES).

8.4 Create and configure connectors

A number of connectors are required for runtime and/or development and testing

purposes. The following instructions will guide you in the creation and

configuration of those connectors.

Chapter 8. WebSphere BI Express configuration 103

8.4.1 JTextRWLConnector

This is the connector used for the Request Work List function. It is a JText

connector.

For this connector, we need to first create a new short-cut in the Start Programs

folder.

1. Using Explorer, go to the following folder:

C:\Documents and Settings\All Users\Start Menu\Programs\IBM WebSphere

Business Integration Express for Item Sync \Adapters\Connectors

2. Copy the existing short-cut JText Connector and paste it as

JTextRWLConnector.

3. Open the properties of this new short-cut.

4. Update the field Target to reflect the name of this connector (JTextRWL) and

the name of your ICS (SUPPLIER in our case), as shown in Figure 8-7. The

value in the field Target should then be like this:

C:\IBM\WebSphereItemSync\connectors\JText\start_JText.bat JTextRWL SUPPLIER

Figure 8-7 Properties of the short-cut to start the JTextRWL connector

104 Implementing WebSphere BI Express for Item Synchronization

5. Switch back to the System Manager. Right-click the folder Connectors in the

ICL ItemSyncLibrary and select Create New Connector.

6. The tool Connector Configurator Express will start and present you the new

connector window. Set the name to JTextRWLConnector (one word, case

sensitive) and select JText for template name. See Figure 8-8.

Figure 8-8 Create new connector

7. After clicking OK, the Connector Configurator Express shows the standard

properties for this connector.

8. Update the properties shown in Figure 8-9 on page 105, as follows:

AgentTraceLevel to 5

ControllerTraceLevel to 5

LogAtInterChangeEnd property to true

This will provide maximum tracing capabilities at runtime for debugging

purposes.

Chapter 8. WebSphere BI Express configuration 105

9. Update the property MessageFileName to:

C:\IBM\WebSphereItemSync\connectors\messages\JTextConnector.txt

Figure 8-9 Standard properties of the JTextRWL connector

10.Add business objects on the tab Supported Business Objects, as shown in

Figure 8-10 on page 106. Mark required Agent Support as shown.

Note: It is worth mentioning again here that everything in your configuration is

case sensitive. (Remember that this is all a Java application under the

covers.)

Note: Agent Support indicates that this is to be a Business Object known to

the Connector Agent. That is, the part of the connector that recognizes

ASBOs (Application Specific Business Objects) and the meta-objects required

to serialize and de-serialize the data streams for processing. The GBO is used

at the Connector Controller end and, as such, does not require Agent Support.

106 Implementing WebSphere BI Express for Item Synchronization

Figure 8-10 Supported business objects for the JTextRWL connector

11.Select File → Save → To Project before switching to the tab Associated

Maps.

12.Select Explicit Binding and then select the maps from the drop-down listbox,

as shown in Figure 8-11 on page 107.

13.At this point also set the logging and tracing to go to both the console and a

file, we choose, as follows:

C:\IBM\WebSphereItemSync\connectors\JText\JTextRWL.log

for both the log and trace output.