Running samples from the Samples Console

The Samples Console is an Eclipse perspective that you use to build and run samples.

About this task

You do the following operations in the Samples Console:

  • Find the samples, import projects, and view documentation.

  • Run Ant targets to use samples.

  • Start and stop the sample server.

  • Open the Rule Execution Server console, and the Decision Center Business console.

  • Display trace messages.

To use the samples and tutorials, you must set the locale of your Eclipse development environment to en_US.

Procedure

To run a sample from the Samples Console:

  1. Start the Samples Console in one of the following ways:
    • On Windows:
      • Windows 10 or later: Start > All Programs > <ODM> > Samples Console (en_US)
      • Windows 11: Start > All apps > <ODM> > Samples Console (en_US)

      The variable <ODM> refers to the package group specified in IBM® Installation Manager during installation. The default package group is Operational Decision Manager V9.6.0.

      This shortcut opens Designer in the en_US (American English) locale.

    • On all platforms, start Rule Designer by using the Eclipse start command: <InstallDir>. You must run Eclipse in the en_US locale. To open the Sample Console in the correct locale from a command line, use the following parameters in the Eclipse command:

      -init -nl en_US -perspective ilog.rules.studio.samples.console.perspectives.SamplesPerspective

      For example, for the Mac OS:

      <InstallDir>/Eclipse.app/Contents/MacOS/eclipse --init -nl en_US -perspective ilog.rules.studio.samples.console.perspectives.SamplesPerspective

      Otherwise, when Rule Designer opens, select Window > Open Perspective > Other, select Samples Console, and then click OK.

  2. In the Sample Server view, click the Start the Sample Server button "":
    Image shows the server view.
  3. After the sample server starts, click the Samples and Tutorials view to locate the sample or tutorial that you want to run:
    Image shows samples and tutorials.
  4. Expand a section, for example, Rule Execution Server > Samples. A list of all the Rule Execution Server samples is displayed.
  5. Under each sample is a View Instructions link. Click the link to display the documentation corresponding to the sample.
  6. Under most samples is the View sample commands link. Click the link under, for example, the Simple Execution sample. It displays the commands for the sample:
    Image shows sample commends.
  7. In the image, the Samples Commands view displays the Ant commands for compiling and executing the Simple execution sample.
    Each command is indicated with a green target icon. When working on a sample, follow the documentation for the sample and double-click a command when instructed to launch it.