Load

#### Search Results

Search

# Load

This function loads Migrate data from the Coordinator FDIC. The following types of data can be loaded:

- Predict objects

- XRef data

- Metadata

- Retrieval models

Data to be loaded must pass through all three phases of the Coordinator Check Cycle. See the section Coordinator Check Cycle in this documentation.

This section covers the following topics:

- Calling the Function

- Load Options

- Loading Predict Objects

- Loading Metadata

- Loading Retrieval Models

- Loading Internal IDs

## Calling the Function

The Load Migrate function is called with function code L from the Coordinator Menu or with a `LOAD` command depending on the object type.

The objects to be loaded must meet the following selection criteria before they can pass the Coordinator Check Cycle:

Data type | Type of data to be loaded: O Objects. See Loading Predict Objects. M Metadata. See Loading Metadata. R Retrieval models. See Loading Retrieval Models. I Internal IDs. See Loading Internal IDs.
Object type | Enter a predefined or user-defined object type or blank to load all object types.
from date | Only objects added/modified on or after this date will be loaded.

If an Object Type is specified as a selection criterion, you can specify the following additional criteria:

Object ID | Enter an internal object ID or use asterisk notation to limit the function to a range of objects.
Object of type | A subtype can be specified for some object types. For example, a Load function can be limited to databases of type Adabas.

Additional selection criteria are contained in the Load screen:

    17:25:32             *****  P R E D I C T  *****              2013-05-31
                               - Load All objects -

     Terminate, Help ...............

     Load options

       From date ................... 0000-00-00 00:00 (YYYY-MM-DD HH:II)
       Prefix ......................
       Suffix ......................
       With code ................... N (Y/N)
       With profile ................ N (Y/N)
       Load physical attributes ...* A
       Replace ..................... N (Y/N)
       Create Report listing ....... Y (Y/N)
       Load user def. extensions ... N (Y/N)

    Command ===>
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
           -     -    Stop   -     -    Flip  Print  -     -     -     -     -

## Load Options

### From date

Data created/modified on or after this date will be loaded.

### Prefix, Suffix

Up to 20 characters to be added as prefix/suffix to the object ID of each object loaded (if applicable).

The following rules apply when loading objects with prefix/suffix:

- When an object is loaded, all checks are performed against the composite ID. For example, if object TEST is loaded and parameters Prefix and Suffix are set to "OLD-" and "-32" respectively, checks are performed in the Main FDIC against an object OLD-TEST-32.

- The following objects do not obtain a prefix/suffix:

  - Objects of types Field and User

  - Owners

  - the following files:

    - SAG-ADA-CHECKPOINT

    - SAG-ADA-CONF

    - SAG-ADA-DIST

    - SAG-ADA-LOG

    - SAG-ADA-SECURITY

    - SAG-DISTINCT-TYPE

    - SAG-DT

    - SAG-ADA-LOB

- If a composite object ID (prefix + ID + suffix) exceeds 32 characters, the object is loaded without prefix/suffix and a message is written to the report listing.

  Note
  Checks against rules defined for the object type in Metadata Administration (length, illegal characters) are performed in the Consistency Check phase of the Coordinator Check Cycle.

- Child objects always obtain a prefix/suffix. Exceptions to this rule are listed above.

- A new internal ID is assigned if objects are loaded with prefix/suffix.

### With Code

Only applicable for object type File or All and the following Predict-owned external objects connected to Predict file objects:

- DDMs

- Copy code members

- Card formats such as ADAWAN, ADACMP.

If this parameter is set to Y, the connected external objects will be loaded together with the file object.

### With Profile

Applies to user objects. If this parameter is set to Y, Predict and LIST XREF profiles are also loaded.

### Load physical attributes

Only applicable for object type Database, Dataspace, File, Program, Storagespace or All. The following data will be loaded additionally:

N | Neither physical attributes nor Vista information.
A | Physical attributes.
S | Physical attributes and Vista information.

### Replace

The system behavior depends on whether the objects in the Migrate file have an internal ID or not.

Note
For functions Load and Test, this parameter is also handled like a selection criterion. If this parameter is set to N and an object with the same internal ID or object ID exists in the target environment, the object is rejected and the transfer operation continues.

Two factors determine whether an object is replaced during a load operation:

- the load parameter Replace and

- whether the object has an internal ID.

#### Replacing Objects with Internal ID

This is the default for data unloaded from a 4.1 or above environment (the Unload parameter with internal ID is set to Y as standard).

- If Replace is set to Y, an existing Predict object with the same internal ID is replaced during load - even if the object ID is different.

- If Replace is set to N, an object with the same internal ID in the target environment is not overwritten. This is the default value.

#### Replacing Objects without Internal ID

Objects without an internal ID can occur in the following instances:

- data was exported/unloaded from a 4.1 or above environment with parameter With internal ID set to N.

### Create Report Listing

If this parameter is set to Y (default), a report listing of type LOA is created on the Coordinator FDIC. It is moved to the Main FDIC together with the data to be loaded.

### Load user def. extensions

Applies to predefined object types.

- If Load user def. extensions is set to Y, user-defined attributes are loaded.

- If Load user def. extensions is set to N, no user-defined attributes are loaded. This is the default.

## Loading Predict Objects

With Load commands you can load objects of different types selectively. The command used depends on the object type.

An overview of the keywords is given in the section Overview of Command Keywords.

### Loading All Object Types

Enter command

    LOAD OBJECTTYPE ALL <parameters>

Loads Predict objects from transfer medium.

Keyword | Field | Position
--- | --- | ---
FROM-DATE | From date | 1
PREFIX | Prefix | 2
SUFFIX | Suffix | 3
CODE | With code/profile | 4
PROFILE | With profile | 5
ADA | Load physical attributes | 6
REPLACE | Replace | 7
CREATE-RT | Create report listing | 8
UDE-EXTENSIONS | Load user def. extensions | 9

### Loading Databases, Dataspaces, Programs

Enter command

    LOAD OBJECTTYPE <object type> <parameters>

``

Keyword | Field | Position
--- | --- | ---
ID | Object ID | 1
TYPE | Object of type | 2
FROM-DATE | From date | 3
PREFIX | Prefix | 4
SUFFIX | Suffix | 5
ADA | Load physical attributes | 6
REPLACE | Replace | 7
CREATE-RT | Create report listing | 8
UDE-EXTENSIONS | Load user def. extensions | 9

### Loading Packagelists, Relationships, Systems

Enter command

    LOAD OBJECTTYPE <object type> <parameters>

Keyword | Field | Position
--- | --- | ---
ID | Object ID | 1
TYPE | Object of type | 2
FROM-DATE | From date | 3
PREFIX | Prefix | 4
SUFFIX | Suffix | 5
REPLACE | Replace | 6
CREATE-RT | Create report listing | 7
UDE-EXTENSIONS | Load user def. extensions | 8

### Loading Files

Enter command

    LOAD OBJECTTYPE FI <parameters>

Keyword | Field | Position
--- | --- | ---
ID | File ID | 1
TYPE | File of type | 2
FROM-DATE | From date | 3
PREFIX | Prefix | 4
SUFFIX | Suffix | 5
CODE | With code | 6
ADA | Load physical attributes | 7
REPLACE | Replace | 8
CREATE-RT | Create report listing | 9
UDE-EXTENSIONS | Load user def. extensions | 10

### Loading Interfaces, Keywords, Methods, Networks, Properties, Triggers, Virtual Machines and User-Defined Object Types

Enter command

    LOAD OBJECTTYPE <object type> <parameters>

Keyword | Field | Position
--- | --- | ---
ID | Object ID | 1
FROM-DATE | From date | 2
PREFIX | Prefix | 3
SUFFIX | Suffix | 4
REPLACE | Replace | 5
CREATE-RT | Create report listing | 6
UDE-EXTENSIONS | Load user def. extensions | 7

### Loading Storagespaces

Enter command

    LOAD OBJECTTYPE SC <parameters>

Keyword | Field | Position
--- | --- | ---
ID | Storagespace ID | 1
FROM-DATE | From date | 2
PREFIX | Prefix | 3
SUFFIX | Suffix | 4
ADA | Load physical attributes | 5
REPLACE | Replace | 6
CREATE-RT | Create report listing | 7
UDE-EXTENSIONS | Load user def. extensions | 8

### Loading Users

Enter command

    LOAD OBJECTTYPE US <parameters>

Keyword | Field | Position
--- | --- | ---
ID | User ID | 1
FROM-DATE | From date | 2
PREFIX | Prefix | 3
SUFFIX | Suffix | 4
PROFILE | With profile | 5
REPLACE | Replace | 6
CREATE-RT | Create report listing | 7
UDE-EXTENSIONS | Load user def. extensions | 8

### Loading Verifications

Enter command

    LOAD OBJECTTYPE VE <parameters>

Keyword | Field | Position
--- | --- | ---
ID | Verification ID | 1
STATUS | Verification of status | 2
FROM-DATE | From date | 3
PREFIX | Prefix | 4
SUFFIX | Suffix | 5
CODE | With code | 6
REPLACE | Replace | 7
CREATE-RT | Create report listing | 8
UDE-EXTENSIONS | Load user def. extensions | 9

### Loading XRef Data

Enter command

    LOAD OBJECTTYPE XR <parameters>

Keyword | Field | Position
--- | --- | ---
MEM | Member | 1
LIB | Library | 2
FNR | User system Fnr | 3
DBNR | User system DBnr | 4
FROM-DATE | From catalog date | 5
REPLACE | Replace | 6
CREATE-RT | Create report listing | 7

## Loading Metadata

Loads metadata from a Migrate file.

- To load metadata of a specific type, enter command

      LOAD METADATA <object type> <parameters>

  where <object type> is any Predict object type (predefined or user-defined). See Unloading Objects with Commands.

- To load metadata of all object types, enter command

      LOAD METADATA ALL <parameters>

  Keyword | Field | Position
  --- | --- | ---
  FROM-DATE | From date | 1
  REPLACE | Replace | 2
  CREATE-RT | Create report listing | 3

## Loading Retrieval Models

Loads retrieval models from a Migrate file.

- To load retrieval models of a specific type, enter command

      LOAD RETRIEVALMODEL <object type> <parameters>

  where <object type> is any Predict object type (predefined or user-defined). See Unloading Objects with Commands.

  Keyword | Field | Position
  --- | --- | ---
  ID | Retrieval model | 1
  FROM-DATE | From date | 2
  REPLACE | Replace | 3
  CREATE-RT | Create Report Listing | 4

- To load retrieval models of all object types, enter command

      LOAD RETRIEVALMODEL ALL <parameters>

  Keyword | Field | Position
  --- | --- | ---
  FROM-DATE | From date | 1
  REPLACE | Replace | 2
  CREATE-RT | Create Report Listing | 3

A retrieval model can be loaded only if the parent object, all child objects and links to these objects exist.

## Loading Internal IDs

This function is used to consolidate Internal IDs if you have your Predict data in separate FDIC files (see Consolidating Internal IDs in Batch Mode). Before you execute this load function, you must first unload objects with their Internal IDs.

Note
It is not possible to load selectively: all objects on the transfer medium are loaded with their Internal IDs.

#### Calling the Function

Enter function code L and data type L in the Coordinator main menu. In batch mode, the function is called with the following command in library SYSDICBE:

    LOAD INTERNAL-ID ALL UPDATE=Y

        13:57:04             *****  P R E D I C T  *****             2013-05-31
                                   - Load Internal ID -

         Terminate, Help ...............

         Load options
           With update ................. N (Y/N)
           Create Report listing ....... Y (N/Y)

Parameters
Load options
With update | Y All objects on transfer medium are loaded together with their Internal IDs. N Objects that would be transferred are listed.
Create Report listing | Y A report listing of type LOA is created. Default.

### On this page

- Calling the Function
- Load Options
- Loading Predict Objects
- Loading Metadata
- Loading Retrieval Models
- Loading Internal IDs