Oracle Tuxedo Application Rehosting Workbench Eclipse Plug-in

This chapter contains the following topics:

•

Overview

•	Prerequisites

•	Installing the Plug-in

•	Using the ART Workbench Eclipse Plug-in

Overview

Purpose

ART Workbench is a command line-based collection of tools used to automate and facilitate migration of mainframe applications and data to Oracle Tuxedo and Oracle Database. Initially created for use by experts in services projects, the migration process and the tools are highly complex and create great potential for user errors and support calls.

The current Workbench comes from a long history of use by experts during services engagements. To improve its usability a UI is provided that hides the process complexities, guides you through the process, provides online help, and simplifies the process of specifying the configuration of the tools, executing the tools, and analyzing the results (logs, reports, generated files, etc.).

Product Functions

The objectives of the plug-in are to help address these areas of complexity by providing the following:

•	One migration process is organized by an ART Workbench Project. this enables you to navigate project artifacts in the ART Workbench navigator and perform corresponding actions on the selected project.

•	Help select and specify parameters and options required to define configuration settings for the project as a whole and for specific tools. Most options in the flat configuration files can be configured and modified in the project properties.

•	Execute specific tools/commands required at a particular step in the process, using configuration and other resources for any parameters/options to be specified on the command line. Review output messages in the ART Workbench Console in real time.

•	Review catalog generated reports.

•	Along with the conversion, a progress monitor shows the source file being converted.

•	Guide you through the migration process step-by-step.

Prerequisites

Platform

Linux32/Linux64

Software Environment

J2SE 1.5 or higher

Eclipse IDE for Java Developers Galileo (3.5) or higher

ART Workbench 11.1.1.2.1 or higher

Skills

The following skills are required.

•	Migration Process and Concepts

You must understand the processes, concepts and terminology used by the Rehosting Workbench Cataloger (i.e., know the inputs, outputs and configuration expected by the Cataloger and how it analyzes all the components separately and together to determine whether the asset is consistent and can be migrated).

•	Eclipse Skills

Eclipse skills are required to perform certain actions accompanying the migration process. Users need to know:

•	View, Navigator, Perspective etc.

•	A set of operations to open new project wizard, open project properties page and open view.

Installing the Plug-in

To install the plug-in you must put the com.oracle.tuxedo.wbplugin_1.0.0.0.jar file in the $ECLIPSE_HOME/plugins directory and then restart Eclipse.

Component and Layout

The plug-in has an ART Workbench Perspective which organizes ART Workbench views, menus and toolbars around the eclipse. It also has a navigator made for ART Workbench projects.

The plug-in has Cataloger Report View and Process Monitor View to help you analyze the migration process.

ART Workbench Perspective

In the Eclipse Platform a Perspective determines the visible actions and views within a window.

The ART Workbench Perspective is made up of the following views:

•	Workbench Navigator

•	General Navigator

•

Problems

•

Error Log

•

Console

•

Report

•	Progress Monitor

From the ART Workbench Perspective, ART Workbench specific actions/commands are also shown as menu items and toolbar buttons.

ART Workbench Navigator

The ART Workbench Navigator is very similar to the internal Eclipse General Navigator. The difference is that ART Workbench Navigator only displays ART Projects.

Cataloger Report View

The cataloger output reports are shown in the report view (as shown in Figure 9‑1), with tabs for each report. The view is integrated with ART perspective. Click the Close button to close it or re-open it from main menu.

Figure 9‑1 Report View Example

The report view has following features:

•

Sort

The report contents are organized in a table. You can sort by clicking on the table heading.

•	Colored Warning

The anomaly level of each report is colored by level.

 

Table 9‑1 Color Warning

Anomaly Level	Color
OK	Green
WARING	Yellow
ERROR	Red
FATAL	Red

•

Refresh

The content of report refreshes automatically after the convert operation or create new project operation.

You can also refresh the content by clicking the Refresh button on the menu bar of report view.

Progress Monitor View

The progress monitor view allows you to see which source file or schema is being processed. A source tree is initially displayed to show the structure of sources or schemas in the current project organized by source types as shown in Figure 9‑2.

Along with the Cataloging, JCL conversion and COBOL conversion processes, the current processing source file is highlighted in the source tree. During the migration process, each file is processed twice,:one for cataloging and the other for converting.

For DB conversion and File conversion, the current processing db schema or file schema is highlighted in the schema list.

Figure 9‑2 Sample of Progress Monitor View

Migration Process Cheat Sheet

The Plug-in has a Migration Process Cheat Sheet to guide you though the conversion tasks step-by-step. To open the cheat sheet click “Help->Cheat Sheets” on main menu, and then select the cheat sheet Create ART migration project for STDB2ORA sample under ART group.

This cheat sheet demonstrates how to perform Mainframe artifacts migration by using the ART Workbench Eclipse Plug-in. After ART project creation, all ART Workbench functions (including cataloging, converting VSAM files, converting DB2 schemas, converting COBOL and JCL sources), can be done in Eclipse.

Eclipse Preferences

Some ART Workbench global options are set in the Eclipse Preference page. Include following:

Workbench Installation Directory

This global preference will take effect to all ART projects by default.

Using the ART Workbench Eclipse Plug-in

Creating ART Project

You must create a new ART Project though New Project Wizard. Do the following:

Note:

The free-format code files are required for Eclipse conversion. If you use the samples of ART Workbench 11.1.1.2.2 or later, in which each COBOL code are given in the fixed format, you must run script f2f.wb to generate free-format copies before creating the ART project in Eclipse.

1.	Designate the project name as shown in Figure 9‑3.

Figure 9‑3 Project Name

2.	Specify the root directory which contains source files as shown in Figure 9‑4.

Figure 9‑4 Root Directory

3.	Specify the source file sub-directory as shown in Figure 9‑5.

Figure 9‑5 Sample of Select Source Sub-Directory Page

4.	Fill in the VSAM file description table if there are VSAM files to be migrated as shown in Figure 9‑6.

•	All information in the table is required to generated the datamap file and mapper file used by file converter.

•	To make the clear meaning of each column in the table, refer to “Datamap file” and “mapper file” section in the Oracle Tuxedo Application Rehosting Workbench Reference Guide.

Figure 9‑6 Input File Schema Definition Page

When project creation is completed, the files in the Migration source folder are imported into the Eclipse workspace. Configuration files are generated in the “param” folder. If you are in another perspective, the ART Workbench Perspective is automatically activated.

Note:

This only applies if you are migrating from Mainframe to Oracle Tuxedo from scratch. Reuse of the user written ART Workbench configuration files during project creation is not supported.

Configuring Project Properties

After creating a new ART project, you must configure the project properties in the project properties page as shown in Figure 9‑7.

Figure 9‑7 Project Properties Page

Most of the configurable options in ART Workbench can be configured in the project properties pages. It provides an easy way for to view and modify ART Workbench configuration options. Those options are organized by type.

Executing Conversion

When all the steps are completed, you can use ART Workbench Commands for migration conversations.

Each ART Workbench command can be triggered by using main menu items, toolbar buttons and the project context menu. The following ART Workbench commands are available:

•

Catalog

•	Convert File

•	Convert DB2

•	Convert COBOL

•	Convert JCL

•	Convert All

Eexecutes the previous five commands)

•	Pack Target

Generates a .tar file that contains converted artifacts including the files under the Target Files Directory, Root Skeleton and Target Skeleton.

Note:

The Target Files Directory is configured on the COBOL Converter page. Both the Root Skeleton and Target Skeleton are configured on the JCL Converter page.

•

Clean Pob

Removes the pob files generated by the cataloging tool

•	Clean Translate

Removes converted programs/scripts