Standard Retrieval Types

Standard retrieval types can be applied to all types of Predict objects.

This document covers the following topics:

The effect of different output modes on standard retrieval types is described in the section Output Mode.


Objects - Code D

This type retrieves information on all individual objects that meet the specified selection criteria.

Note:
The Display objects and Select objects operation can also be invoked from all maintenance menus. If called from a maintenance menu, however, output options have no effect and the maximum amount of information is always displayed.

Commands: DISPLAY, LIST, SELECT
(depending on the output mode)
Valid output modes: Display, List, Select.
Limit scope of report: Output options

Objects with Parents - Code B, Objects with Children - Code T

These types retrieve information on objects and on the parent or child objects of the objects. Only those objects linked to another object by a passive/active association are included in the report.

The retrieval types will also report on the attributes of objects included in the report because they are related to the objects that meet the specified selection criteria. The amount of information displayed on related objects can be restricted with output options (in the column related). 

When retrieving information on an Adabas database and the file objects contained in it, Predict checks if the physical attributes of all files in a database correspond to the respective physical definitions in the database.

Commands: Commands: PARENTS, CHILDREN
Valid output modes: Display, List.
Limit scope of report: The parameter Association and output options can be used to restrict the scope of a report on both the current objects and the related objects.
All is valid for Association.

Objects with No Parent - Code O , Objects with No Child - Code U

These retrieval types report on objects that have no parent or child for a given association or for any association.

Commands: FREE, EMPTY
Valid output modes: Display, List, Select.
Limit scope of report: The parameter Association and output options can be used to restrict the scope of the report.
Any and All are valid for Association.

Indicating which Associations are Valid

If for a valid passive/active association no objects are linked, the respective association is displayed in a column no parent or no child. The parameter Association can be used to specify which objects are included in a report (see below).

With the output mode Select, either one association type or of some types is displayed (because Select displays only one line of information per object).

Association for Objects with no child and Objects with no parent

An Association must be entered for these functions. Valid values:

Association Result
association code (FI, DA ...) All objects without a passive/active association of the specified type are included in the report.
blank (all) Objects that do not have a passive/active association to at least one object of each and every other type are included in the report.
For example: The object type database can be linked via an active association to objects of type file, dataspace, user.
If it is linked to a file object and a user object but not to a dataspace object, it is included in the report.
AY (any) All objects without a passive/active association to any other object are included in the report. In other words:
Objects having at least one passive/active association to another object (regardless of type) are not included in the report.
For example: The object type database can be linked via an active association to objects of type file, dataspace, user. It is linked to a file object and therefore not included in the report.

Note:
AY (any) will only be contained in the selection window of Association when code U (Objects with no child) or O (Object with no parent) have been entered as the retrieval type.

Dummy/Placeholder Objects - Code C

The retrieval type Dummy/Placeholder objects together with the output option Dummy/Placeholder for current objects is used to find all dummies/placeholders.

If a dummy/placeholder is contained in an extract, the ID of this extract is also displayed (with output mode Display).

Objects which are associated with a dummy/placeholder are also included in the report. The scope of the report can be limited by specifying an Association. Only parent objects of a certain type will then be included in the report.

Command: DUMMY
Valid output modes: List, Display, Select.
Limit scope of report: The parameter Association can be used to restrict the scope of the report.

Finding Objects with Dummy Children

To list objects that have links to child objects that do not yet exist (dummies), use the retrieval type T and set the output option Dummy/Placeholder (related) to D.

Finding Objects with Placeholder Children

When an object that is linked to another object is imported with the Predict Coordinator with internal ID, and the referenced object is not imported and does not exist in the target environment, a Placeholder is added in the target environment for the referenced object.

The job of this placeholder is to reserve the object ID of the referenced object in the target environment so that the link in the old environment can be recreated in the new environment at a later time.

To list placeholder objects, use the retrieval type T and set the output option Dummy/Placeholder (related) to P.

Execute Retrieval Model - Code E

Execute Retrieval Model displays information on the associations of objects in the form of a structured list. A retrieval model must be specified in the input field model.

Command: EXECMODEL
Valid output modes: Structured list, Cross reference.
Limit scope of report: The scope of a report is determined by the retrieval model. In addition to the settings in a retrieval model, output options can be used to restrict the scope of a report further.

The following rules apply to this retrieval type:

  • The retrieval type Execute Retrieval Model does not apply to owners. Associations of owners can be evaluated with the retrieval type Cross reference. See Type-Specific Retrieval.

  • Retrieval models determine

    • which objects related to an object are included in a report

    • which information is displayed for each individual object. This setting can be restricted with output options.

    • the layout of the report (only with output mode Structured list).

  • The properties of a retrieval model are displayed in the cover page of reports if the parameter Cover page of the output options is set to Y.