This document describes the wizard that is used for schema incorporation.

The wizard provides several pages in which you have to specify information. The number of pages and the information on these pages depends on the object type that has been selected on the first page of the wizard.

For detailed information on the object type-specific information that can be specified using this wizard, see Incorporation in External Objects in Predict.

The wizard uses edit controls such as text boxes, check boxes or drop-down list boxes. For the description of check boxes, the reference documentation External Objects in Predict uses the abbreviations Y (yes) and N (no). Y means that the check box is selected, and N means that the check box is not selected.

To incorporate an external schema

1. From the Tools > Development Tools > Schema Generation menu, choose Schema Incorporation.

   Or:
   Choose the following toolbar button:

   

   The schema incorporation wizard appears, providing several pages.

   

   Note:
   If DB2 is not installed at your site, the incorporation functions for DB2 objects are not available.

2. Select the option button for the type of external object that you want to incorporate.

3. Choose the Next button to proceed to the next page.

   The information on the next pages depends on the object type that has been selected on the first page.

   Example - incorporate Adabas file:

   

4. Specify the selection criteria and choose the Next button to proceed to the next page.

   Example - incorporate Adabas file:

   

   The incorporation functions that are available on this page depend on the object type that has been selected on the first page.

5. From the drop-down list box, select the object that you want to incorporate.

   When an object has been selected, the option button(s) for the incorporation function(s) that can be executed for this object are no longer dimmed.

   For general information on these buttons, see Overview of Incorporation Options in External Objects in Predict.

6. Select the option button for the incorporation function that you want to execute and choose the Next button to proceed to the next page.

   An additional page appears when you have selected the incorporation function Incorporate or Connect. You can then specify the incorporation or connect options.

   Example - incorporation options for an Adabas file:

   

   Note:
   Such a page does not appear for the incorporation functions Test and Display Masters.

7. Specify the required information and choose the Next button to proceed to the next page.

   Example - incorporate Adabas file:

   

   This page shows only the settings which have been modified on the previous pages.

8. If all required information has been specified, choose the Finish button to start incorporation.

   Note:
   As long as you do not choose the Finish button, you can go back to the previous pages by choosing the Back button.

   When the incorporation process has completed, the last page of the wizard is shown. If the List incorporated code option has been selected previously, a report is shown. If this option has not been selected, the corresponding text box is empty.

   However, if an error occurs during the generation process, an error report is shown in the text box. The error report is always shown. The setting of the List incorporated code option is not considered in this case.

   Example - incorporate Adabas file:

   

   When you choose the Print button, you can print the report on a printer that is defined under Windows.

9. Choose the OK button to close the dialog box.

   Or:
   If you want to start incorporation for another object, choose the New Start button and proceed as described above.