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
- In the Design part of the Rule
Project Map, click Import XOM and
then select PL/I execution object model.
- In the PL/I Execution Object Model pane
on the Properties window, click Add.
- On the Import PL/I XOM page, enter
a name for the PL/I XOM.
- 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.
- 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.
- 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
- Optional: Change the default mapping. For more
information, see Mapping PL/I structures to Java data types
- 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.