Setting up the User-defined Extension sample

You might find it easier to follow these instructions if you print them out before you start because you must close the Message Brokers Toolkit before you can perform Step 3.

To set up both the SearchFilter and the NumCompute samples, do the following:

  1. Import the two samples. This adds the following directories to the workspace: Please be aware that upon importing and setting up the UDE sample, there will be approximately 9 errors in the toolkit, relating to the UDESampleMessageFlowProject. This is to be expected, and will be resolved after Step 5 is completed.
  2. Close the Message Brokers Toolkit.
  3. Copy the UDESamplePlugInNodeProject folder from: to:

    This enables the nodes to appear in the message flows and the node palette.

    For Linux only, if running the Toolkit as a non-root user, you must set the file permissions as follows:
    1. cd /opt/ibm/WMBT610/plugins/UDESamplePlugInNodeProject
    2. chmod 666 *
    3. chmod 755 icons
  4. Re-start the Message Brokers Toolkit with the "-clean" option. This can be done from the command line, or by modifying the menu shortcut. The "-clean" option must be used whenever any changes are made to UDEs, in order for them to be picked up by the message flow node palette.
  5. If the errors remain in the Message Brokers Toolkit, clean all projects in the workspace: click Project > Clean... In the dialog that opens, ensure the Clean all projects radio button is selected and click OK.
  6. Switch to the Broker Application Development perspective.
  7. Locate the sample libraries folder in the Broker Development view.
  8. Expand the appropriate platform specific subfolder until you can see both the .jar file and the relevant .lil file.
  9. Press and hold Ctrl, then select the .lil and .jar files.
  10. Click File > Export then expand General and click File system, to export the UDESampleJavaCode.jar file and the relevant NumComputeNode.lil file into a directory. When you are asked to specify a directory into which you want to export the files and you enter the name of a directory that has not been created, the directory can be created for you automatically; for example, C:\UserLibraries
  11. In the command console, at the command prompt type the following command:

    mqsistop WBRK61_DEFAULT_BROKER

  12. In the command console, at the command prompt type the following command:

    mqsichangebroker WBRK61_DEFAULT_BROKER -l directory from step 10

  13. In the command console, at the command prompt type the following command:

    mqsistart WBRK61_DEFAULT_BROKER

  14. Switch to the Broker Administration perspective.
  15. Connect to the Domain:
    1. In the Domains view, right-click the WBRK61_DEFAULT_CONFIGURATION_MANAGER domain.
    2. Click Connect.
      1. Expand WBRK61_DEFAULT_BROKER.
      2. Click Broker archives>UDESampleMessageFlowProject.
      3. Deploy the UDESampleArchive.bar file by dragging it onto the UDESampleExecutionGroup execution group.

The .bar file contains compiled message flows for both the SearchFilter and the NumCompute samples. You should see two deployed message flows within UDESampleExecutionGroup.

You can now run the samples. See Running the user-defined extension sample

Back to sample home