Generating the PL/I include file

After you configure the BOM to PL/I mapping, you specify the top-level objects for the PL/I include file generation.

Procedure

  1. On the PL/I Enabled BOM page, click Manage next to the PL/I include file setting field.

    On the Include File Generation pane, you see an include file with its top-level data items that correspond to the ruleset parameter values by default.

  2. Optional: On the Include File Generation pane, you can do the following actions:
    • Add an include file:
      1. Click Add Include File.
      2. Specify the name and path of the include file to be generated.
    • Add a top-level object:
      1. Select the include file for which you want to add a top-level object.
      2. Click Add Top Level Object and then select the top-level object type.

    You can add, remove, or reorder (use Up and Down buttons) the top-level objects of the include file. You can change the default item names. You can also add another include file and specify its top-level objects.

  3. Click Next. A preview of the include file to be generated is displayed. You must fix errors in the preview page before you continue.

    If there are structures in the BOM that are not compatible with PL/I or if some BOM to PL/I mappings are not enabled, you see errors in the preview page. These errors prevent the generation of the include file. Hover over the errors to find out details about them.

    To fix the BOM class without valid PL/I mapping errors:
    1. Enable the BOM to PL/I mapping for related BOM entries.
    2. Manage the include file generation based on the enabled BOM entries.
    To fix the incompatible BOM structure errors:
    1. Update the BOM with PL/I compatible Java™ structures.
    2. Update the BOM by using the PL/I BOM setting wizard. Select the BOM and then click Update.

    If you have no errors, the preview table lists each Java object and shows the default mapping of each attribute with its corresponding PL/I data item. Click Finish.

    The generated include file is shown in the PL/I include file setting field on the PL/I Enabled BOM pane.