Reference Guide

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

Introduction

Concepts

Codeset Conversion

Overview of Codeset Conversion

Purpose

Audience

z/OS – Displaying Graphical Characters

Reference Monitor

REFCOD80 File

Viewing Characters Under z/OS

UNIX/Linux: Displaying Graphical Characters

Reference Monitor

COBOL CONVERTMW.cpy

Validating and Adapting the Transcoding Copy File

Validation

Adapting the COBOL CONVERTMW.cpy Copy File

Finding the z/OS Character

Finding the UNIX Characters to Replace

Replacing the UNIX Character

Remarks Concerning the Example

Special Characters

Using the COBOL CONVERTMW.cpy File

Error Messages

See Also

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

BMS screen definition

CICS Configuration

Description of the Configuration Files

System Description File

General Structure

Global Options

Special Options

Directories

files Clause

logical-name 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}-Screens

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

MVS Utility Parameters

LOBS 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

Locations of Warning 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

Unloading JCL: DSNTIAUL

Unloading JCL: DSNUPROC

Unloading JCL: DSNUTILB

COBOL Transcoding Programs

COBOL Programs MOD_<table_name>.cbl

COBOL Programs CLOB_<table_name>_<column_name>.cbl

Reloading Korn Shell Scripts

Transcoding Phase: First Step

Transcoding Phase: Next Step for BLOB Columns

Transcoding Phase: Next Step for CLOB Columns

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 Example

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

Installing the MWDB2ORA Package Component on the Target Platform

Unloading Data

Transferring the Data

Transferring the SBCS Data

Transferring the MBCS Data

Reloading the Data

Transcoding and Reloading Command

Checking the Transfers

File Convertor: Introduction

Overview of the File Convertor

Purpose

Structure

See Also

File Organizations Processed

z/OS File Organizations

File Conversion to File or to RDBMS Table

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

List of the Input Components

Datamap File

Datamap Syntax and Parameters

Mapper File

Mapping File Clause

COBOL Description

POB Files

Symtab File

File-to-File Converter

Overview of the File-to-File Converter

Purpose

Structure

See Also

File Organizations Processed

Keeping z/OS File Organization on the Target Platform

PDS File Organization

GDG File Organization

Oracle Tuxedo Application Rehosting Workbench Configuration Name

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.pgm

Datamap File

Mapper File

Discrimination Rules

COBOL Description

Description of the Output Files

File Locations

Location of Temporary Files

Location of Log Files

Location of Generated Files

Generated Objects

Unloading JCL

Unloading JCL for QSAM and VSAM files

Unloading JCL for Generation Data Group

COBOL Transcoding Programs

Migration of z/OS Files to UNIX/Linux Files

Reloading Korn Shell Scripts

Reloading Korn Shell Scripts for Migrating z/OS QSAM/VSAM Files to UNIX/Linux Files

Reloading Korn Shell Scripts for Migrating z/OS Generation Data Set to UNIX/Linux Files

Transcoding and Loading Phases

Check Phase

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

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

Transcoding and reloading command for Generation Data Group files

Synopsis

Options

Checking the Transfers

File-to-Oracle Converter

Overview of the File-to-Oracle Converter

Purpose

Structure

See Also

File Organizations Processed

Migrating to Oracle Table on the Target Platform

Oracle Tuxedo Application Rehosting Workbench Configuration Name

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.pgm

Datamap File

Mapper File

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

COBOL Description

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 Oracle Tables

Reloading Korn Shell Scripts

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 Tables

Checking the Transfers

File-to-Db2/luw (udb) Converter

Overview of the File-to-Db2/luw (udb) Converter

Purpose

Structure

See Also

File Organizations Process

Migrating to Db2/luw (udb) Table on the Target Platform

Oracle Tuxedo Application Rehosting Workbench Configuration Name

VSAM Files Becoming Db2/luw (udb) 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-db2luw.txt

file-move-assignation-db2luw.pgm

Datamap File

Mapper File

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

COBOL Description

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 Db2/luw (udb) Tables

Reloading Korn Shell Scripts

Reloading Korn Shell Scripts for Migrating z/OS Files to Db2/luw (udb) 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 Tables

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

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

Sql-rules 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

How to Generate the hexa-map File

Error Messages

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

MicroFocus

Mandatory Options

Installation-dependent Options

1.1.1.3 Options Depending on Customer Choice

1.1.1.4 Options Influencing Compile-Time Operation

Mandatory Options

Installation-dependent options

Options depending on customer choice

Options influencing compile-time operation

COBOL-IT

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 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