micro focus data express

Micro Focus®

Data Express

Oracle Module User Guide

Copyright © 2007-2008 Micro Focus (IP) Ltd. All rights reserved. Micro Focus (IP) Ltd. has made every effort to ensure that this book is correct and accurate, but reserves the right to make changes without notice at its sole discretion at any time. The software described in this document is supplied under a license and may be used or copied only in accordance with the terms of such license, and in particular any warranty of fitness of Micro Focus software products for any particular purpose is expressly excluded and in no event will Micro Focus be liable for any consequential loss. Animator®, COBOL Workbench®, EnterpriseLink®, Mainframe Express®, Micro Focus®, Net Express®, REQL®, and Revolve® are registered trademarks, and AAI™, Analyzer™, Application Server™, Application to Application Interface™, AddPack™, AppTrack™, AssetMiner™, CCI™, DataConnect™, Dialog System™, Enterprise Server™, Enterprise Server with MTO™, EuroSmart™, FixPack™, LEVEL II COBOL™, License Server™, Mainframe Access™, Mainframe Manager™, Micro Focus® COBOL™, Micro Focus® Studio™, Micro Focus® Server™, Object COBOL™, OpenESQL™, Personal COBOL™, Professional COBOL™, Server Express™, SmartFind™, SmartFind Plus™, SmartFix™, SourceConnect™, SupportLine™, Toolbox™, VS COBOL™, WebSync™, and Xilerator™ are trademarks of Micro Focus (IP) Ltd. IBM® and CICS® are registered trademarks, and IMS™, DB2, DB2/390, DB2 Connect Enterprise Edition, DB2 Connect Personal Edition, COBOL for OS/390, Enterprise Systems Architecture/390, ESA/390, MVS, MVS/ESA, OS/390, S/390, System/390, VSE/ESA, and MFS are trademarks, of International Business Machines Corporation. Netscape Enterprise Server™ is a trademark of Netscape Communications Corporation. Internet Information Server®, SQL Server®, Visual Studio®, Windows 95®, Windows 98®, Windows NT 4.0®, Windows ME®, Windows 2000®, Windows Server®, Windows XP®, and Windows Vista® are registered trademarks of Microsoft Corporation in the United States and other countries. Pentium® is a registered trademark of INTEL Corporation. Borland Database Engine™ and MIDAS™ are trademarks of Borland Software Corporation. Oracle™ is a trademark of Oracle Corporation Inc. UNIX® is a registered trademark of The Open Group. Solaris™, Ultra Sparc™, and Java™ are trademarks of Sun Microsystems, Inc. Linux, GCC compiler, GNU CTAGS, GNU DIFF, Samba, and KDE/GNOME refer to Open Source tools. This product includes modified versions of software developed by the Apache Software Foundation (as described on the Apache web site). The YGrep Search Engine is Copyright (c) 1992-2004 Yves Roumazeilles. All other trademarks are the property of their respective owners. No part of this publication, with the exception of the software product user documentation contained on a CD-ROM, may be copied, photocopied, reproduced, transmitted, transcribed, or reduced to any electronic medium or machine-readable form without prior written consent of Micro Focus (IP) Ltd. Contact your Micro Focus representative if you require access to the modified Apache Software Foundation source files.

Licensees may duplicate the software product user documentation contained on a CD-ROM, but only to the extent necessary to support the users authorized access to the software under the license agreement. Any reproduction of the documentation, regardless of whether the documentation is reproduced in whole or in part, must be accompanied by this copyright statement in its entirety, without modification. U.S. GOVERNMENT RESTRICTED RIGHTS. It is acknowledged that the Software and the Documentation were developed at private expense, that no part is in the public domain, and that the Software and Documentation are Commercial Computer Software provided with RESTRICTED RIGHTS under Federal Acquisition Regulations and agency supplements to them. Use, duplication or disclosure by the U.S. Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of The Rights in Technical Data and Computer Software clause at DFAR 252.227-7013 et. seq. or subparagraphs (c)(1) and (2) of the Commercial Computer Software Restricted Rights at FAR 52.227-19, as applicable. Contractor is Micro Focus (IP) Ltd, 9420 Key West Avenue, Rockville, Maryland 20850. Rights are reserved under copyright laws of the United States with respect to unpublished portions of the Software.

4


5


Table of Contents

Table of Contents ..................................................................................................................... 5

1. About this Guide .................................................................................................................. 7

2. Who Should Read this Guide ............................................................................................. 9

3. Oracle Module Considerations ......................................................................................... 11

4. Operational Flow ............................................................................................................... 13

5. Installing and Using the Oracle Module.......................................................................... 15 5.1. Requirements .............................................................................................................................. 15 5.1.1. Windows Machine .............................................................................................................. 15 5.1.2. UNIX/Linux Machine ........................................................................................................ 15 5.1.3. Oracle Databases ................................................................................................................ 16 5.2. Installation .................................................................................................................................. 16 5.3. Oracle Module Execution ........................................................................................................... 16 5.4. Error Diagnosis ......................................................................................................................... 17

Appendix A. Oracle Alias Creation ..................................................................................... 19

6


7


1. About this Guide This guide outlines the concepts and procedures used by the Data Express Oracle module. The Oracle module is an extension that adds functionality to the three modules: Data, Data Masking, and Data Subset Extraction in order to use Data Express within the Oracle environment on a UNIX machine. The Oracle module enables usage of the following Data Express functions: • Database Loader

• Database Mapper

• File Exporter for data masking

• File Exporter for data subsetting

8


9


2. Who Should Read this Guide This guide is for Micro Focus users who are interested in managing the privacy of data or in extracting a subset of data contained in Oracle within a UNIX environment. It explains the Oracle module installation procedure, and describes the steps required to configure information and execute the Oracler module. The use of the Oracle module requires a minimum experience of configuring Oracle network connectivity. Before using the Oracle module, we recommend you carefully read the following users guides:

• Micro Focus Data Express – Front End User Guide • Micro Focus Data Express – Data Masking User Guide • Micro Focus Data Express – Data Subset Extraction User Guide

10


11


3. Oracle Module Considerations Bear in mind the following points about the Oracle module for Data Express: • You do not need to analyze the sources of the programs in the application in order to use the

Oracle module. • Non-DB2 database functions do not perform any operation capable of altering the analyzed data.

12


13


4. Operational Flow The following table describes the operational flow for working with Oracle data sources within Data Express:

Step Instruction Reference

1 Configure the Borland Database Engine to catalog your server.

Note: Data Express must be configured in Standard mode to provide direct access to data on the RDBMS from your PC.

Appendix A. Oracle Alias Creation.

2 Use the Non-DB2 Database Mapping window in the Data module to catalog your source and target databases.

Chapter Non-DB2 Database Mapping in the Micro Focus Data Express – Front End User Guide.

3 Use the Non-DB2 Database Loader window in the Data module to define the mapped Oracle tables with which you want to work.

Chapter Non-DB2 Database Loader in the Micro Focus Data Express – Front End User Guide.

4 Define classes and associate them with the appropriate fields. Chapter Work with Classes in the Micro Focus Data Express – Front End User Guide.

5 Use Data Masking to define business protection rules, as required. - or- Use Data Subset Extraction to define subset extraction rules, as required.

Chapter File Exporter for Non-DB2 Database in the Micro Focus Data Express – Data Masking User Guide. Chapter File Exporter for Non-DB2 Database in the Micro Focus Data Express – Data Subset Extraction User Guide.

6 Use the File Exporter for Non-DB2 Database window in Data Masking or in Data Subset Extraction to generate the files required for executing the Oracle module.

Micro Focus Data Express – Data Masking User Guide. Micro Focus Data Express – Data Subset Extraction User Guide.

7 Transfer the files generated by the File Exporter for non-DB2 database function to the UNIX machine.

8 Execute the Oracle module. Section Oracle Module Execution in the chapter Getting Started.

14


15


5. Installing and Using the Oracle Module This chapter provides an overview of the Oracle module. You should read it before using the module.

5.1. Requirements TCP/IP is used on Windows and UNIX/Linux platforms. FTP is required for communications to and from the Windows PC to the UNIX machine. The mainframe is only accessed by Data Express applications to access the repository or knowledge base.

5.1.1. Windows Machine We strongly recommend that you have a Windows machine with a connection to Oracle (Oracle client) and DB2 (DB2 Connect), although there is no need to have a direct connection to the mainframe and UNIX machine. For additional software requirements, see the section Software in the chapter Requirements in the Micro Focus Data Express – Requirements and Installation Procedures. The following Windows software items are required for the Oracle module: • An Oracle client installation, including the Oracle Programmer option (specifically Oracle Call

Interface), configured to communicate with an Oracle Server.

• A telnet/ssh client for the connection to the UNIX machine, for example, PuTTY

5.1.2. UNIX/Linux Machine

The following UNIX and Linux platforms are supported: • pSeries running AIX

• x86 running Red Hat Linux

• SPARC running Solaris 8 or 9

No special profiles are required. The UNIX machine should be configured with the environment variable settings needed to connect to the Oracle database, for example: • ORACLE_HOME

• ORACLE_SID

• PATH

• LD_LIBRARY_PATH (Linux, Solaris) or LIBPATH (AIX)

The following UNIX software items are required for the Oracle module: • An Oracle client installation, including the Oracle Programmer option (specifically Oracle Call

Interface), configured to communicate with an Oracle Server

16


• GCC, the GNU C compiler version 3.2

• FTP application or client to allow Data Express applications to write configuration information to the UNIX environment, for example Samba

5.1.3. Oracle Databases

Information for the following database items is required during configuration of the Oracle module:

• Source database – Name of the database containing the original data.

• Target database – Name of the database where the reduced data is written. • Repository – Name of the database where the tables containing configuration information for

Oracle module are written. The collection of tables is also referred to as the Oracle module knowledge base.

Note: The specified user must have insert/update access to the repository. Typically, the target database is used to store the repository.

For each database, the following information is required: • Oracle server name

• database name

• user ID

• password

5.2. Installation To install the Oracle module, extract the files contained in the DE35_Oracle.tar file of the installation media into an empty directory.

5.3. Oracle Module Execution By default, the Oracle module will attempt to insert the processed data into the target database. For testing purposes, it is possible to configure the Oracle module to instead write the processed data into text files as comma separated values (.csv). To execute the Oracle module: 1. If you intend to use Data Masking to conceal data, execute the following command:

BPStart

2. If you intend to use Data Subset Extraction, execute the following command:

DSEStart

17


Note: If the data has already been masked, the masking rules are processed as part of the class definition for Data Subset Extraction.

3. The Oracle module processes all the tables previously specified within Data Express, and reports

a status for each table, for example:

Table Table1: n records transferred. Done.Table Table2: n records transferred. Done.Table Table3: n records transferred. Done.KbXDSE finished OK

If you have changed the Oracle module configuration to write the processed data into text files, upon executing the Oracle module, data is written to the output_csv subdirectory as TABLENAME.csv, and the script TABLENAME.ctl is generated. You can then subsequently execute the script TABLENAME.ctl to load the data into your target database.

5.4. Error Diagnosis When errors occur during the execution of the Oracle module, messages are written to the file KbXDataErrorLog.txt, which is located in the log directory. If you are unable to resolve errors, contact Micro Focus SupportLine for technical assistance: provide the KbXDataErrorLog.txt file, along with the files in the config directory and the DDL for the tables being processed.

18


19


Appendix A. Oracle Alias Creation In order to use the Oracle module, you must first create an alias in the Borland Database Engine to communicate with the Oracle client installed on your machine. To create an Oracle alias: 1. Open BDE Administrator (from the Control Panel).

2. Click the Configuration tab, and then select ORACLE from the Native Drivers list as shown in

Figure A-1:

Figure A-1: BDE Administrator –Definition of ORACLE

20


3. In the Definition of ORACLE pane, click in the second column for DLL32 to display a list of DLLs. Select SQLORA8.DLL, and click Object > Apply as shown in Figure A-2:

Figure A-2: BDE Administrator – DLL32

4. In the Definition of ORACLE pane, click in the second column for VENDOR INIT, and enter

OCI.DLL as the Vendor DLL file name as shown in Figure A-3:

Figure A-3: BDE Administrator – VENDOR INIT

21


5. If the database within which you intend to store the processed data is not your source database, repeat steps 1-4 for the target database.

22


micro focus data express

Documents