This document covers the following topics:
Functions compare and connect functions are available both online and in batch mode; the incorporate subfunction is only available online.
For DDMs of type DB2/ESQ, IMS or PROCESS, the functions I and V are not applicable.
See Concepts of Incorporation for basic information on how to use incorporation functions.
Display the Incorporate DDMs screen
with function code I and object code DD in a Predict main menu or with the
10:00:00 ***** P R E D I C T ***** 2007-05-31 Plan 0 - Incorporate DDMs - Current VM ........... HOME DDM ID ............... Select option DDMs of type ......* Processing option Connect automatic .. N (Y/N)
|Parameters for Selecting DDMs to be Incorporated|
|Current VM||If a Predict database object is found that is either linked to the Current VM and of type local or accessible from the network containing the Current VM, the master file incorporated from the DDM is linked to this database. A read-only field. If no current VM is specified in the session profile, the parameter Default current virtual machine in the Miscellaneous section of the General Defaults is used.|
|DDM ID||ID of the DDM. Asterisk notation is allowed.|
|DDMs of type||Limit the function to DDMs that access databases of the type specified. Enter an asterisk to display valid values.|
DDMs which meet the given selection criteria and are not already connected to a Predict file object are then listed as follows.
13:13:32 ***** P R E D I C T ***** 2007-05-31 - Incorporate DDMs - Search-crit.: DDM ID=ALL DDM Predict Cmd DDM ID type file type Remark __ ACCOUNTING PROCESS __ BS2000-COMMAND PROCESS __ CATALOG PROCESS __ CATALOG-UPDATE PROCESS __ CHD-FORMATE1 ADABAS __ CHD-TEST ADABAS Conceptual file Diff. Filetype
|Columns in the List|
|DDM ID||ID of the DDM.|
|DDM type||The type of database that can be accessed by using the DDM with this ID: Adabas or VSAM or DB2 or IMS or Entire System Server.|
|Predict file type||The type of any data dictionary object for a file with this ID.|
|Remark||Any of the following type-specific remarks or blank. For type-independent remarks see Remarks which apply to all Object Types.|
Compares DDMs and corresponding Predict file objects. Differences between field lists and file attributes are reported.
If no differences are found and Connect automatic is set to Y, the DDM and the Predict file object are connected.
Connects DDMs to Predict file object and writes to the generation log of the Predict file object that a corresponding DDM existed when the connection was established.
If the message No related object the IDs of the related DDM or DDMs that must be incorporated first can be displayed with the function V. The DDMs are listed in the order in which they have to be incorporated.
Incorporates information from the DDM to a new Predict file object of type A, F, L, R, U, T, V, W, 1 and 2 as appropriate and connects the DDM and the new Predict file object.
Before an object for a file of type W or L can be created, an object for the related file of type V must exist;
Before an object for a file of type R can be created, an object for the related file of type L must exist.
Before an object for a file of type U can be created, an object for the related file of type A must exist.
Incorporate DDM can only be executed online.
The V function (see above) can be used to identify related DDMs that must be incorporated first.
One Predict object of the type file will be created: The new file object has the DDM name as ID.
The Predict file object is linked to a Predict database that is either linked to the Current VM and of type local or accessible from the network containing the Current VM.
One field object will be created for each field of the DDM. Each new field object will be assigned the name of the field in the DDM. Any prefix specified by the user and present in all field names will be removed to create the corresponding field IDs.
One relationship object is created for each coupling definition.
Before the function is executed the following parameters can/must be specified for each file in an additional input screen.
|Related master file||ID of the Predict file object describing the file for which the specified DDM is a userview|
|Truncation prefix||If the names of all fields of the DDM have a common prefix and that prefix is specified here, it is removed from the field names to create the IDs of the field objects in the data dictionary.|
|Remark as abstract||
|Old synonym mode||
|List incorporated code||
Enter parameters on the next line in positional or keyword form.
|DDMs of type||DDM-TYPE||2|
To connect the DDM with the name "TEST-DDM" to the corresponding file object in Predict, code the command:
INCORPORATE DDM FILE-ID=TEST-DDM,SUB-FUNCTION=C
INCORPORATE DDM TEST-DDM,,,C
The example above uses the Natural parameters