Mapping identical PL/I structures to the same BOM class

You can map PL/I group items with identical structures to a single Java™ class when you generate the XOM.

About this task

By default, when you map PL/I group items to Java classes, they are mapped to different classes. If the PL/I structure of some group items is identical, you can map these group items to the same Java class. Two PL/I structures are considered identical if they have the same children and the same memory layout.

In the following example, the Borrower and CoBorrower group items have the same children and memory layout.

dcl 01 Loan,
       02 Borrower,
          05 name char(5),
          05 age fixed bin(31),
       02 CoBorrower,
          05 name char(5),
          05 age fixed bin(31);

The following restrictions apply:

The PL/I top-level item cannot reference another top-level item even if they have identical PL/I structures.
If a PL/I group item contains an array and the array reference item (or inherited object) is not under the same group item, then the two PL/I group items cannot be mapped to the same Java class.

Procedure

In the Rule Explorer of Rule Designer, right-click your rule project and select Properties.
Under PL/I Management, click PL/I Execution Object Model.
Click Add.
On the Import PL/I XOM page:
1. In the Execution object model name field, type a name of your PL/I XOM.
2. Click Add.
On the Select Include File page, select a PL/I include file to use, and then click OK.
On the Import PL/I XOM page, click Next.
On the Configure PL/I XOM Mapping page, click the Reference column of the group item that you want to map to another group item. A button with three dots (ellipsis) is displayed.
Click the button with the ellipsis, select the existing group item, then click OK.
Click Finish, and click OK.

Results

The two group items with the identical PL/I structure are mapped to the same Java class.