Extract

This document covers the following topics:

Extract Maintenance

The Extract Maintenance Menu is called with the command MAINTAIN EXTRACT.

Overview of Functions and Commands

Function Code Command
Add an Extract A ADD EXTRACT
Copy Extract C COPY EXTRACT
Modify Extract M MODIFY EXTRACT
Rename Extract N RENAME EXTRACT
Purge Extract P PURGE EXTRACT
Operate on Extracts T OPERATE EXTRACT
Export an Extract U  
Display Extract D DISPLAY EXTRACT
Link children L LINK EXTRACT <active-association-type>
Edit owners of a Extract O EDIT EXTRACT OWNER
Select Extract from a list S DISPLAY EXTRACT
Edit description W EDIT EXTRACT DESCRIPTION
Edit/link objects E EDIT EXTRACT OBJECTS
Build/extend an Extract B BUILD EXTRACT

Parameters

Keyword Field Position
ID Extract ID 1
<> Copy ID 2
DROP-OBJECTS Drop existing objects 3
LIST-OBJECTS List objects 4

Extract-specific Maintenance Commands

See also Standard Maintenance Commands.

OPERATE EXTRACT <Extract-ID> Executes the function Operate on Extracts. See the section Extract in the Predefined Object Types in Predict documentation.
EDIT EXTRACT OBJECTS <Extract-ID> With this command you skip the Modify Extract screen and access the object list directly. The system behavior depends on the editor you are using.

  • If you are using the Software AG Editor, the Object List Editor is called.

  • If you are not using the Software AG Editor, the function Link Keyword to Object is called.

BUILD EXTRACT <Extract-ID> This command is only used online. It calls the function Build/extend an Extract for the specified extract.
BUILD EXTRACT <Extract-ID> <Retrieval Command> This command is only used in batch mode.
If you execute this command with object type all, the only keyword that is valid is ID.

Extract Retrieval

The Extract Retrieval Menu is called with command RETRIEVE EXTRACT.

Overview of Functions and Commands

Retrieval Type Code Default
Output
Mode 		Command
Extracts D D DISPLAY EXTRACT
"   L LIST EXTRACT
"   S SELECT EXTRACT
"   D SHOW EXTRACT
Execute retrieval models E T EXECMODEL EXTRACT
Dummy Extracts C L DUMMY EXTRACT<passive-association-type>
Extracts related to no object Y L UNUSED EXTRACT
Extracts related to objects X X XREF EXTRACT
Extracts with parents B D PARENTS EXTRACT <passive-association-type>
Extracts with no parent O L FREE EXTRACT ANY| ALL| <passive-association-type>
Extracts with children T D CHILDREN EXTRACT <active-association-type>
Extracts with no child U L EMPTY EXTRACT ANY| ALL| <active-association-type>

Parameters

Keyword Field Position
ID Extract ID 1
RES Restrictions 2
OUT Output options 3
MODEL Model 4
MODE Output mode 5

Extract-specific Retrieval Commands

See also Standard Retrieval Commands.

UNUSED EXTRACT This function lists extracts that have no objects assigned to them.
XREF EXTRACT Lists all objects contained in the specified extract or - if asterisk notation is used - in the specified extracts.