User Guide

Previous

Next

Contents

Introduction

Oracle Tuxedo Application Rehosting Workbench

Sequence of the Rehosting Workbench processes

Oracle Tuxedo Application Rehosting Workbench Cataloger

Overview

Purpose

Skills

Migration process and concepts

UNIX/Linux skills

See also

Organization

Requirements & Prerequisites

Preparing the migration platform

Overview of the Cataloger in the replatforming process

Simple Sample Application

Cataloging migration steps

Cataloging steps

Building-up an asset

Initialization and configuring the working environment

Configuration objectives

Recommended file structure

Setting environment and working variables

Project initialization summary

Configuration

System description file

Executing the Cataloger

Result analysis and validation

Anomaly analysis

Completion criteria

Using the make utility

Make configuration

Parsing

Parsing all programs

Check need to be parsed

Parsing of one program

Cataloging

Advanced usage of make

To add or update a target

Debugging the make target

Using the command with option VERIF=TRUE

Oracle Tuxedo Application Rehosting Workbench File-to-File Converter

Overview

Purpose

Skills

See also

Organization

The File-to-File Migration Process

File Organizations Processed

PDS file organization

GDG file organization

Migration Process Steps

Initializing the process

Requirements

Listing the files to be migrated

File descriptions and managing files with the same structure

COBOL description

COBOL description format

COBOL description and related discrimination rules

Redefinition examples

Non-equivalent redefinition

Equivalent redefinition called technical redefinition

Preparing the environment

Initializing environment variables

Implementing the configuration files

Configuring the files

Database Parameter File (db-param.cfg)

Datamap parameter file (Datamap-<configuration name>.re)

Mapping parameter file (mapper-<configuration name>.re)

Installing the copy files

Generating the components

file.sh

Locations of generated files

Modifying generated components

Using the make utility

Configuring a make file

Using a makefile with the Rehosting Workbench File-To-File Converter

Performing the migration

Preparation

Configuring the environments and installing the components

Installing the unloading components under z/OS

Installing the reloading components on target platform

Transferring the files

Compiling the transcoding programs

Sequential files

VSAM KSDS files

Executing the transcoding and reloading scripts

Checking the transfers

Troubleshooting

Overview

Common problems and solutions

Error: Unknown file organization *UNDEFINED*

Error: Record... not found

Error: Record... not found

Error: External Variable PARAM is not set

Oracle Tuxedo Application Rehosting Workbench DB2 to Oracle Converter

Overview

Purpose

Skills

See also

Organization

The DB2- to-Oracle Migration Process

File Organizations Processed

Migration Process Steps

Interaction with other Oracle Tuxedo Application Rehosting Workbench tools

Reengineering rules to implement

Migration rules applied

DB2-to-Oracle data type migration rules

DB2-to-Oracle column property migration rules

Preparing and implementing renaming rules

Example of a migration of DB2 objects

Preparing the environment

Implementing the cataloging of the DB2 DDL source files

system.desc file parameters

Schemas

Implementing the configuration files

Initializing environment variables

Generation parameters

Generating the components

rdbms.sh

Generation options

Modification options

Installation Option

Generate configuration files for COBOL conversion

Using the make utility

Configuring a make file

Using a makefile with the Rehosting Workbench DB2-To-Oracle Converter

Locations of generated files

Modifying generated components

Performing the migration

Preparation

Configuring the environments and installing the components

Installing the unloading components under z/OS

Installing the reloading components on the target platform

Transferring the files

Creating the Oracle objects

Compiling the transcoding programs

Executing the transcoding and reloading scripts

Transcoding and reloading command

Checking the transfers

Troubleshooting

Overview

Common problems and solutions

Error: RDBMS-0105

Error: conversion aborted. Can not read

Error: Configuration file /db-param.cfg is missing!

Error: Target output directory... is missing

Oracle Tuxedo Application Rehosting Workbench File-to-Oracle Converter

Overview

Purpose

Skills

See also

Organization

The File-to-Oracle migration process

File organizations processed

Migration Process Steps

Interaction with other Oracle Tuxedo Application Rehosting Workbench tools

Initializing the process

Listing the files to be migrated

File descriptions and managing files with the same structure

COBOL description

COBOL description format

COBOL description and related discrimination rules

Redefinition examples

Non-equivalent redefinition

Equivalent redefinition called technical redefinition

Reengineering rules to implement

Migration rules applied

Rules applied to Picture clauses

Rules applied to Occurs and Redefines clauses

Example VSAM file migration to Oracle table

Preparing the environment

Initializing environment variables

Implementing the configuration files

Configuring the files

Database Parameter File (db-param.cfg)

Datamap parameter file (Datamap-<configuration name>.re)

Mapping parameter file (mapper-<configuration name>.re)

Installing the copy files

Generating the components

file.sh

Using the make utility

Configuring a make file

Using a makefile with the Rehosting Workbench File-To-Oracle Converter

Locations of generated files

Examples of generated components

Modifying generated components

Performing the migration

Preparation

Configuring the environments and installing the components

Installing the unloading components under z/OS

Installing the reloading components under UNIX

Installing the Oracle object creation components

Setting the target platform environment variables

Unloading the JCL

Transferring the files

Compiling the transcoding programs

Executing the Oracle object creation scripts

Executing the transcoding and reloading scripts

Checking the transfers

Compiling the access routines and utilities

Troubleshooting

Overview

Common problems and solutions

Error: External Variable PARAM is not set

Error: Target directory does not exist

Error: Unknown file organization

Error: The illegal text is: "converted

Error: Can't find file in file table named PJ01AAA.SS.VSAM.CUSTOMERS

the Rehosting Workbench Cobol Converter

Overview

Purpose

Skills

See also

Organization

Requirements & Prerequisites

Cataloguing requirements

Data Conversion

Overview of the Cobol Converter in the replatforming process

Conversion steps

Building and setting the configuration files

Configuring config-cobol

rename-call-map-file

Conversion

Translation of Batch, CICS programs and sub-programs

Reconciling copybooks

Checking results

Compiling

Compilation options and settings

Compilation command

Using a make file

Configuration

Cobol conversion

Reconciling copybooks

Troubleshooting the Cobol Converter

Configuration file does not exist

Missing POB file

POB file too old

Parsing error encountered

Oracle Tuxedo Application Rehosting Workbench JCL Converter

Overview

Purpose

Skills

See also

Organization

Requirements & Prerequisites

Cataloguing requirements

Data Conversion

Overview of the JCL Translator in the replatforming process

Translation steps

Building and setting the configuration files

Top skeleton and Bottom skeleton

List of data files converted to Oracle tables

Full example configuration

Full example configuration

Translation steps

Set environment variables

Translation commands

Command line to translate one JCL file

Command line to translate a list of JCL files

Command line to translate all JCL files

Checking results

Using a make file

Configuration

JCL translation

Previous

Next