Migrate Conversion

#### Search Results

Search

# Migrate Conversion

Users that have to load Migrate data that are versioned in Predict Application Control and created with Predict Version 3.4 or below are now able to load such Migrate data sets using the Migrate Conversion function.

The Migrate Conversion function transforms these old Migrate data (3.1, 3.2 and 3.4) to Predict Migrate 4.1 format. The input workfile can contain several different Migrate formats. Those records in the input workfile that are in Predict Migrate 4.1 format or above are transferred without conversion.

The function can also be used when customers want to upgrade directly from Predict Version 3.4 or below to the current Predict version.

The programs required for the Migrate Conversion tool are delivered in library SYSDICBE in source form.

This section covers the following topics:

- Calling the Function

- Options

- Limitations

- Sample Output Protocol

## Calling the Function

The Migrate Conversion function is called with command `PRDM41` from the Coordinator Menu or with command `PRDM41` on the NEXT prompt in library SYSDICBE.

## Options

### Workfiles

Workfile 1 is the default input workfile and workfile 6 the default output workfile.

### Output

The command `PRDM41` has an optional parameter that can be set to either REP or NOREP.

REP | Replace. After a successful conversion the content of workfile 6 is copied to workfile 1.
NOREP | No replace. The content in workfile 1 remains untouched. This is the default.

#### Example

    LOGON SYSDICBE
    MENU
    PRDM41 NOREP
    FIN

### User Exits

#### U-MTOT

This user exit translates the codes that are reserved in Predict Version 4.1. For user-defined object type codes and object typ names of earlier versions, you must enter a new code and/or name or you can use the assigned defaults.

Reserved object type codes: MD, IE and PY.

Reserved object type names: METHOD, INTERFACE, PROPERTY.

#### U-MOBJ

Migrate objects of the versions 3.1, 3.2 and 3.4 can be explicitly excluded from the conversion based on:

- Migrate version,

- Current object type,

- Current object ID,

- Current object subtype.

These excluded objects are not written to output workfile 6.

Refer to U-MTOT and U-MOBJ in section User Exits of the Predict Administration documentation for further details.

## Limitations

The following limitations apply depending on the Migrate format:

- Limitations for Migrate Formats 3.4, 3.2 and 3.1

- Limitations for Migrate Formats below 3.4

### Limitations for Migrate Formats 3.4, 3.2 and 3.1

- Xref data are not converted
  Corresponding message: Xref data not converted.

### Limitations for Migrate Formats below 3.4

- DDM records are not converted.
  Corresponding message: `DDM records not converted. File must be regenerated.`

- UDE’s (Meta data / Data) are not converted.
  Corresponding message: `Object ID: TST-FL (FL) not converted.`

- Retrieval models are not converted.
  Corresponding message: `Retrieval model data not converted.`

## Sample Output Protocol

    ----------------------------------------------------------------------------
    Start of migrate format conversion at 09:59:43.3 on 2013-05-31
    -----------------------------------------------------------------------------
    Migrate 34 format to migrate 41 format.
     Object type: M4 (METHOD) converted.
    Migrate 34 format to migrate 41 format.
     Object type: FL (FLUX_NAME) converted.
     Object ID: TST-FL (FL) converted.
     Object ID: TST-FL-2 (FL) converted.
    Migrate 32 format to migrate 41 format.
     Object ID: TST-Z (PR) converted.
     Object ID: TST-R (PR) converted.
    Migrate 32 format to migrate 41 format.
     Object ID: TST-FL (FL) not converted.
     Object ID: TST-FL-2 (FL) not converted.
    Migrate 34 format to migrate 41 format.
     Object ID: TST-S (VE) converted.
     Object ID: TST-S-1 (VE) converted.
    Migrate 34 format to migrate 41 format.
     Object ID: TST-DDM-34 (FI) converted.
    Conversion of migrate format 42 not necessary.
    Migrate 32 format to migrate 41 format.
     Object ID: TST-DDM-32 (FI) converted.
                DDM records not converted must be regenerated.
     Object ID: TST-UDE1 (T1) not converted.
    ---------------------------------------------------------------------------
    End of migrate format conversion at 09:59:48.9 on 2013-05-03
    ---------------------------------------------------------------------------
    Summary
      Objects converted ........ 8
      Objects not converted .... 3
      Object types converted ... 2
    Migrate format conversion terminated successfully.

### On this page

- Calling the Function
- Options
- Limitations
- Sample Output Protocol