Creating an Integration-Process for retrieving JMS attribute values

Procedure

After you create the Integration-Process

Procedure

Phase 1: Create an Integration-Process

  1. Open the Composer Integration workbench, then select the Integration tab and Mapping Manager sub-tab.
  2. Composer displays the Integration-Process properties window.
  3. In the General tab of the Integration Process properties window, in the Name field, enter a name for this Integration-Process. For example: ip_get_jms_attrib
  4. In the Graph tab, add a Receive Activity to the worksheet.
    5. ClosedView procedure
    1. On the Graph tab toolbar, click the down arrow next to the Create Receive Activity icon, and then from the context menu select Create Receive Activity.
    2. Click once on the worksheet to place the Receive Activity.
    3. Right-click the Receive Activity on the worksheet and from the context menu select Properties.
    4. In the Properties window Name field, enter a name for the Activity. For example: receive_from_websphere
    5. Close the properties window.
  5. In the Graph tab, add a Send Activity to the worksheet.
    6. ClosedView procedure
    1. On the Graph tab toolbar, click the down arrow next to the Create Send Activity icon and then from the context menu select Create Send Activity.
    2. Click once on the worksheet to place the Send Activity.
    3. Right-click the Send Activity on the worksheet and from the context menu select Properties.
    4. In the Properties window Name field enter a name for the Activity. For example: send_to_ftp
    5. Close the Properties window.

Save this object. You will later be adding a Sequential Activity.

Phase 2: Create a Map-Broker and associated Business-Documents

In this example you use instances of the same Business-Document for Map-Broker input and output. You require an additional Business-Document to manage the values you extract from an JMS message.

Create the Business-Document for the transferred message

  1. Open Composer and in the Integration Manager tab of the Integration Services workbench select New > Integration > Business-Document from the File menu.
  2. Composer displays the Business-Document properties window.
  3. In the General tab: 
  4. In the Definition tab, develop a Business-Document structure as in the following illustration:
  6. Save, check and close the object.

Create the Business-Document for the extracted attributes

  1. Open Composer and in the Integration Manager tab of the Integration Services workbench select New > Integration > Business-Document from the File menu.
  2. Composer displays the Business-Document properties window.
  3. In the General tab: 
  4. In the Definition tab, develop an XML Business-Document structure as in the following illustration. Note that you need to add leaf nodes to contain any JMS attribute values that you wish to extract from the transiting JMS message:
  6. Save, check and close the object.

Create the Map-Broker

  1. In the Composer Integration Services workbench, select New > Integration > Map-Broker from the File menu.
  2. Composer displays the DML Map-Broker properties window.
  3. In the General tab of the Map-Broker properties window:
    • Enter a name for the Map-Broker. For example: mb_get_jms_attribs
    • Select the bd_jms Business-Document as the input Business-Document
  4. In the DecisionPath tab of the Map-Broker properties window, build a Decision Path that includes a Mapping-Rule step.
  5. Double-click the Mapping-Rule step to open the Mapping-Rule properties window.
  6. In the General tab of the Mapping-Rule properties window:
    • Enter a name for the Mapping-Rule. For example: mr_get_jms_attribs
    • Select bd_jms_attributes as the output Business-Document.
  7. In the Mapping Rule tab of the Mapping Rule properties window, enter getAttribute functions to retrieve data for output nodes, as illustrated in the following figure:
  9. Composer automatically appends an And route to step to the Mapping Rule step of the Decision Rule. For the output Activity of the And route to step, select send_to_ftp.
  10. In the DecisionPath tab of the Map-Broker properties window, now add an Output step.
  11. For the output of the Output step, select send_to_ftp.
  13. Check, save and close the Map-Broker object.

Phase 3: Add the Map-Broker to the Integration-Process

  1. In the Composer Integration Services workbench, open the Integration-Process you created in Phase 1 of this procedure.
  2. Composer displays the Integration-Process properties window.
  3. Select the Graph tab.
  4. In the Composer Integration tab, Mapping Manager sub-tab, click to display the content of the DML Map-Broker directory.
  5. Drag the Map-Broker you created in Phase 2 of this procedure to the worksheet of the Graph tab.
  6. Composer creates a Sequential Activity and in it a Map-Stage that holds the Map-Broker and its associated input and output Business-Documents.
  8. In the Graph tab, select the Create new link tool, and use the tool to link the Receive Activity to the Sequential Activity, and the output Business-Documents of the Map Stage to the Send Activity.
  10. Check, save and close the object.

After you create the Integration-Process

Create an Integration-Task to link the Activities to processes on a specific Integrator Server.

View procedure