Generating a PL/I XOM

You can generate a PL/I execution object model (XOM) from a PL/I include file. A PL/I XOM provides your rule project with a Java™ representation of the PL/I data structures so that you can write rules in BAL and call your rules from a PL/I application.

About this task

The generated PL/I XOM includes a XOM Java project. You use the XOM to create a business object model (BOM). You also use it to execute the rules on zRule Execution Server for z/OS® or WebSphere® Application Server for z/OS.

Procedure

  1. In the Design part of the Rule Project Map, click Import XOM and then select PL/I execution object model.
  2. In the PL/I Execution Object Model pane on the Properties window, click Add.
  3. On the Import PL/I XOM page, enter a name for the PL/I XOM.
  4. Click Add and select a PL/I include file that you want to use as a basis for the PL/I XOM.

    You can select the include file from the file system or from your Eclipse project. If you are operating from within Rational® Developer for z Systems, you have an extra option, Remote system, to import the include file from a remote system explorer.

    The Package name field indicates the package name of the generated Java class. The XOM entry name is used as the default package name for the class.

    Click Next.

  5. Optional: If an include file contains UNION statements, the Union page is displayed. You can accept the default data item, or select one of the alternative data items. For more information about the UNION statements, see UNION statements in the PL/I include file. Click Next.
  6. Review the mappings on the Configure PL/I XOM Mapping page.

    You see the PL/I structure that is derived from the include file in the PL/I Structure pane. The default Java class and class attributes for a PL/I data item that is selected in the PL/I Structure pane appear in the XOM Mapping pane.

    If you select a PL/I data item, all data items that map to the same Java class as the selected data item are highlighted in bold with an equal sign (=) in the PL/I Structure pane. These data items have an identical structure therefore map to the same Java class by default. If you see a data item in bold italic with an equal sign in the PL/I Structure pane, at least one data item with the identical structure exists when you expand the data item. For more information, see Identical PL/I structures

  7. Optional: Change the default mapping. For more information, see Mapping PL/I structures to Java data types
  8. Click Finish.

    You see the new XOM in the PL/I Execution Object Model pane in the Properties window.

Results

The Rule Explorer now displays a Java project for the PL/I XOM.

You can now use the PL/I XOM to create a BOM.