Reference Guide

     Previous  Next    Contents    View as PDF - New Window  Get Adobe Reader - New Window
Content starts here

Introduction

Concepts

Cataloger

Overview of the Cataloger

Inputs to the Cataloger Process

Outputs from the Cataloger Process

The Cataloger Process

Description of the input components

COBOL

References

Restrictions

Embedded CICS

References

SQL

References

JCL

References

General Information

Sub-files

JCL syntax

Restrictions

CICS configuration

Description of the configuration files

system description file

General structure

Global options

Special options

Directories

files clause

options-clause

libraries-clause

sql-libraries-clause

Example of system description file

JCL-launcher specification files

Purpose

Syntax

Option List

Usage and default value

Description of the output files

Catalog reports

Format and location

Field Definitions

report-${SYSNAME}-Cobol-Programs

report-${SYSNAME}-Cobol-Copy

report-${SYSNAME}-JCL-Files

report-${SYSNAME}-JCL-Sub-Files

report-${SYSNAME}-JCL-Jobs

report-${SYSNAME}-SQL-Tables

report-${SYSNAME}-SQL-Views

report-${SYSNAME}-Transactions

report-${SYSNAME}-Anomalies

Execution logs

Description of other output files

POB files for ASTs

CDM files for Cobol programs and copy files

The Cataloger Symtab and other miscellaneous files

Detailed Processing

Processing Phases

Command-line syntax

The Oracle Tuxedo Application Rehosting Workbench launcher

System-wide commands

The preparse-files command

Component search operation

Compile-time references

Normal sub-file search

Strict JCL-Sysin search

Run-time reference

Unrestricted search

Directed search

Repetitive and incremental operation

Initial processing: repetitive operation

Changes in the asset: incremental operation

DB2-to-Oracle Convertor

Overview of the DB2-to-Oracle Convertor

Purpose

Structure

See also

Oracle Tuxedo Application Rehosting Workbench schema

Environment variables

Description of the input components

File locations

Location of rdbms.sh

Location of db-param.cfg file

DB2 DDL converted

Conversion of DB2 data types

DB2 column property conversion

Description of the configuration files

POB files

DB2 DDL POB file

Symtab file

sql-system file

system.desc

db-param.cfg

Parameters and syntaxes

Date, time parameters

Index, sort parameters

File modifying generated components

Renaming file

rdbms-template.txt

rdbms_move_assignation.txt

Description of the output files

File locations

Location of temporary files

Locations of log files

Location of generated files

Generated objects

Temporary files

Datamap file

File name

Syntax and parameters

Mapper file

File name

Generation sample

Syntax and parameters

Links to COBOL copy

COBOL Description

Copy file name

Copy file syntax and parameters

Unloading JCL

COBOL transcoding programs

Reloading Korn shell scripts

Transcoding phase

Loading phase

Check phase

Target DDL

TABLE and COLUMNS

INDEX

CONSTRAINT

COMMENT

VIEW

SEQUENCE

SYNONYM

Identity engineering

Ordered list of tables file

COBOL conversion guide file

File name

Generated sample

SQL*LOADER control files

File name

Generated sample

DDL Translator Log File

Execution Reports

Detailed Processing

Command-line syntax

rdbms.sh

Unitary usage sequence

Process Steps

Configuring the environments and installing the components

Installing the unloading components under z/OS

Installing the reloading components on the target platform

Unloading data

Transferring the data

Reloading the data

Transcoding and reloading command

Checking the transfers

File Convertor

Overview of the File Convertor

Purpose

Structure

See also

File organizations processed

Keeping z/OS file organization on the target platform

PDS file organization

GDG file organization

Migrating to Oracle table on the target platform

Oracle Tuxedo Application Rehosting Workbench configuration name

File descriptions and managing files with the same structure

COBOL description

COBOL description format

COBOL description and related discrimination rules

VSAM files becoming Oracle table

Specific Migration rules applied

Rules applied to Picture clauses

Environment variables

Description of the input components

File locations

Location of file.sh

Location of db-param.cfg file

Description of the configuration files

db-param.cfg

Parameters and syntaxes

File modifying generated components

file-template.txt

file_move_assignation.txt

Datamap file

Datamap syntax and parameters

Mapper file

Mapping file clause

Mapping strategy clauses

Mapping strategy clause syntax and parameters

Mapping strategy examples

Discard subfield example

Redefines with default option example

REDEFINES with OPAQUE FIELD option example

REDEFINES with DETAIL TABLE option example

Discrimination rules

Links to COBOL copy

COBOL Description

POB files

Symtab file

Description of the output files

File locations

Location of temporary files

Location of log files

Location of generated files

Generated objects

Unloading JCL

COBOL transcoding programs

Migration of z/OS files to UNIX/Linux files

Migration of z/OS files to Oracle tables

Reloading Korn shell scripts

Reloading Korn shell scripts for migrating z/OS files to UNIX/Linux files

Transcoding and loading phases

Check phase

Reloading Korn shell scripts for migrating z/OS files to Oracle tables

Creating Oracle DDL phase

Transcoding and loading phases

Check phase

Target DDL

Access functions and utility programs

Access functions

Access function call arguments

Call arguments used

OPEN

CLOSE

CLOSE-LOCK

DELETE

READ

REWRITE

START

WRITE

Copy files to be implemented

Korn shell utilities

Oracle Tuxedo Application Runtime for CICS configuration files

COBOL and JCL conversion guide files

.rdb files

Parameters and syntax

Example of .rdb file

Execution Reports

Detailed Processing

Command-line syntax

file.sh

Unitary usage sequence

Process Steps

Configuring the environments and installing the components

Installing the unloading components under z/OS

Installing the reloading components on the target platform

Compiling COBOL transcoding programs

Unloading data

Transferring the data

Reloading the data

Transcoding and reloading command for files and tables

Synopsis

Options

Checking the transfers

JCL Translator

Overview

JCL Translator Definitions

General description and operation

General information

Behavior coverage

Description of input components

Description of the configuration files

The system description file

The JCL-translation configuration file

Description of output files

Translated KSH scripts and sub-files

KSH version

File structure, naming scheme and sub-file handling

Handling of JCL and KSH variables

Script structure

Script layout

Execution logs

Detailed operation

General information

Command-line syntax

The Refine launcher interface

The jclz-unix command

Repetitive and incremental operation

Initial processing: repetitive operation

Changes in the asset: incremental operation

Concurrent operation

Use through make

Frequently Asked Questions

When do I translate anew some JCL?

How do I force the (re)translation of a JCL?

I deleted a JCL. Why is the corresponding KSH still present?

I run the translator but it produces no translation

The procedures are not included in the JCLs, and hence in the KSH

Where do I find the translated procedures?

Why are some FSNs lost during translation?

Cobol Converter

Overview of the Cobol Converter

Scope

Inputs

Outputs

Conversion phases

Restrictions and limitations

Use of COMP-5 type on Linux platforms

Use of COMP-5 type and the TRUNC compiler option

EBCDIC-to-ASCII conversion issues

Literal constants: characters or numbers?

Use of floating-point variables

REWRITE operations on LINE SEQUENTIAL files

Pointer manipulation

Pointer size changes: beware of redefinitions

Linkage-section arguments with NULL address

Representation of the NULL pointer value

Description of the input components, prerequisites

Description of the configuration files

System description file

Main conversion configuration file

General syntax

target-dir clause

keep-same-file-names, target-program-extension and target-copy-extension clauses

verbosity-level clause

deferred-copy-reconcil clause

force-translation clause

rename-copy-map-file clause

rename-call-map-file clause

post-translation-file clause

on-size-error-call clause

hexa-map-file clause

conv-ctrl-file clause and alt-key-file clause

RDBMS-conversion-file clause

keywords-file clause

accept-date and accept-day clauses

sql-stored-procedures-file clause

remove-sql-qualifier clause

activate-cics-rules clause

pure-seq-map-file clause

dont-print-what-string clause

remove-empty-copies clause

sql-return-codes-file clause

copy-renaming configuration file

call-renaming configuration file

post-translation configuration file

hexadecimal conversion configuration file

file-to-RDBMS configuration files

RDBMS-conversion configuration files

keywords file

stored-procedure file

purely-sequential configuration file

sql-return-codes configuration file

Description of output files

Converted programs and copy files

Naming scheme

Transformation comments

Modified code

Added code

Deleted code

Moved code

Other comment rules

Layout

Miscellaneous issues

Compiler options

Detailed processing

Overview

Command-line syntax

Refine launcher interface

cobol-convert command

Repetitive and incremental operation

Initial processing: repetitive operation

Changes in the asset: incremental operation

Oracle Tuxedo Application Rehosting Workbench Messages

DB2-to-Oracle Converter messages

Overview

DB2-to-Oracle Convertor error messages and translation issues

Overview

DB2-to-Oracle Convertor set-up error messages

Setup translation-issue messages

Translation Error Messages

Translation Issue Messages

Output Error Messages

Output Translation-Issue Messages

Miscellaneous Error Messages

Miscellaneous Translation-Issue Messages:

RDBMS script error messages

RDBMS and File internally called script Messages

Reloading error messages

File-to-Oracle Convertor Messages

File script error messages

File internally called script Messages

Reloading error messages

JCL Translator Messages

JCL Translator error messages

JCL Translator Log errors

Common Information

COBOL reloading programs reserved words list


  Back to Top       Previous  Next