Micro Focus. Data Express. Toolkit (Host)

Transcription

1 1 Micro Focus Data Express

2 Copyright 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) 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.

3 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 et. seq. or subparagraphs (c)(1) and (2) of the Commercial Computer Software Restricted Rights at FAR , as applicable. Contractor is Micro Focus (IP) Ltd, 9420 Key West Avenue, Rockville, Maryland Rights are reserved under copyright laws of the United States with respect to unpublished portions of the Software.

4 4

5 5 Table of Contents Table of Contents About this Guide Who Should Read this Guide Micro Focus Data (Host) Considerations Load Sequential File with DB2 Catalog Load IMPSRC for Life Cycle DB2 Catalog Synchronization Create CSV File from Referential Integrity Analyze ADABAS FDT report Appendix A. Toolkit Tables... 23

6 6

7 7 1. About this Guide This guide outlines the concepts and procedures used by the Data Express Toolkit, which is a collection of utilities that help provide input to Data Express processes in order to automate data inventory functionality. It shows how to start and work with the Toolkit in a mainframe environment.

8 8

9 9 2. Who Should Read this Guide This guide is for Micro Focus users who want to verify the integrity of data contained in databases (DB2 or DL/I) or data sets (VSAM, SEQUENTIAL, or GDG) of applications running on MVS, OS/390, or z/os platforms that are either developed internally or purchased by external suppliers. The use of Data Express requires a minimum experience of the mainframe platform MVS, OS/390, or z/os.

10 10

11 11 3. Micro Focus Data (Host) Considerations Bear in mind the following points about Data Express: You do not need to analyze the sources of the programs in the application in order to use Data Express. This product does not perform any operation capable of altering the analyzed data. To use this product, you must have the correct licence. See the Requirements and Installation Procedures guide and the chapter Product Enabling in the Data Express User Guide (Host) for more details. The tables defined during the installation phase and updated by the Toolkit are described in the Appendix A. Toolkit Tables.

12 12

13 4. Load Sequential File with DB2 Catalog The process Load Sequential File reads the DB2 system catalog (starting from the list of tables that need to be loaded into the knowledge base), and then produces the sequential file containing the information needed for the load. After a new Load File From External Interface job is created and scheduled, the sequential file is used when the job executes to perform the load. For more information about the Data Inventory process, see the section Data Inventory in the chapter Project Implementation in the Micro Focus Data Express Process User Guide. For information about the structure of the output sequential file, see the section Direct Access API Load Sequential File in the chapter Sequential Files in the Micro Focus Data Express Data Model User Guide. Note: The filename listed in the FILENAME field can be indicated by a partial name or the special value *ALL. The function will then populate all the DB2 tables with the name in accordance with the value specified. To load the sequential file with the DB2 catalog: 1. From the Main Menu panel, enter the following command: TSO CUINFIL The Select Company panel is displayed as shown below: 13 Figure 4-1: Select Company Panel

14 14 2. Specify the company name and press Enter. The Select Company panel is displayed as shown below: Figure 4-2: Load Sequential File (UINFILR) Panel 3. Insert parameter names into all fields as required: Data Set Name Inp Name of the sequential file which contains the list of the files that must be loaded into Data Express. Data Set Name Out Name of the sequential file which will be created from this function, with all the information about the files that must be loaded into Data Express. Process Id Identifier for the process.

15 15 5. Load IMPSRC for Life Cycle The Life Cycle is a feature that enables automatic updates for file layout information. The Life Cycle process can use a guide file, which is a sequential file with a name that is similar to the project and group specification and followed by the IMPSRC file. It can be completed by the user (using an interface from Endevor, Changeman, or any other change management tool) or directly with the process Load Sequential for Life Cycle. The process Load Sequential for Life Cycle writes the IMPSRC file (starting from a PDS with the copy loaded in the Data Express knowledge base or from a DB2 owner (schema)) with all the copy or the new or changed DB2 tables. After a new Life Cycle job is created and scheduled, the IMPSRC file is used when the job executes to schedule the Life Cycle phases. Note: The Life Cycle process uses only one IMPSRC file. Therefore, we recommend that the process be executed for every DB2 owner (database schema) or for every partitioned data set. For more information about the Life Cycle, see the chapter Life Cycle in the Micro Focus Data Express Process User Guide. To load the IMPSRC file for the Life Cycle: 1. From the Main Menu panel, enter the following command: TSO CUINLIC The Load IMPSRC for Life Cycle (UINLICR) panel is displayed as shown below: Figure 5-1: Load IMPSRC for Life Cycle (UINLICR) Panel 2. Insert parameter names into all fields as required:

16 16 Data Set Type Mode with which you want to work. Data Set Name Name of the partitioned data set or DB2 Owner (schema name) with which you want to work.

17 17 6. DB2 Catalog Synchronization Use the host process DB2 Catalog Synchronization to produce the sequential file containing the information needed for the load, unless the file can be produced in another manner. After a new DB2 Catalog Synchronization (client) job is created and scheduled, the sequential file is used when the job executes to load information for the cardinality for DB2 tables and the existence of a key or the existence of an image copy into the Data Express knowledge base. The DB2 Catalog Synchronization (client) job should be executed before beginning the data subset extraction process, so that all the information is synchronized and this process can be independent of the system tables. For more information about the job, see the section DB2 Catalog Synchronization Job in the chapter Work with Jobs in the Micro Focus Data Express Front End User Guide. Note: For information about the structure of the output sequential files for HEADER, INTERNAL KEY, EXTERNAL KEY, and IMAGE COPY, see the section DB2 Catalog Synchronization Information in the chapter Sequential Files in the Micro Focus Data Express Data Model User Guide. To synchronize the DB2 catalog: 1. From the Main Menu panel, enter the following command: TSO CUINSYNC The DB2 Catalog Synchronization (UINSYNC) panel is displayed as shown below: Figure 6-1: DB2 Catalog Synchronization (UINSYNC) Panel 2. Indicate the scope of the process by specifying the DB2 tables you need in the DB2 Owner and Table Name fields, and the name of the sequential file in the Data Set Name field. Note: For the DB2 Owner and Table Name fields, you can specify *ALL if you want to process all owner names or all table names.

18 18

19 19 7. Create CSV File from Referential Integrity The process Create CSV file from Referential Integrity analyzes a SQL DDL generated by the Erwin Data Modeler that describes the referential integrity relation using the IBM DB2 standard, and then creates a CSV file that contains all relations described in the DDL. After a new Import Method From Referential Integrity job is created and scheduled, the CSV file is used when the job executes to create the method needed to generate the test environment. For more information about method creation, see the chapter Data Subsetting in the Micro Focus Data Express Process User Guide. To create the CSV file from referential integrity: 1. From the Main Menu panel, enter the following command: TSO CVTEARI The Create CSV File from referential integrity analysis (VTEARI) panel is displayed as shown below: Figure 7-1: Create CSV File from referential integrity analysis (VTEARI) Panel 2. Insert parameter names into fields as required: PDS or Data set name Name of the DDL source data set or PDS containing the referential integrity Relation generated by the Erwin Data Modeler. Source Name Name of the member of PDS that contains the DDL generated by the Erwin Data Modeler. CSV data set name Name of the CSV data set that will contain the referential integrity relation. The CSV data set will be created if it does not exist. If it already exists, it will be written in append mode.

20 20

21 21 8. Analyze ADABAS FDT report Use the process Analyze ADABAS FDT report to load and analyze an ADABAS file from a FDT report, and directly update the Data Express knowledge base. For more information about the Data Inventory process, see the section Data Inventory in the chapter Project Implementation in the Micro Focus Data Express Process User Guide. To analyze an ADABAS file from the FDT report: 1. From the Main Menu panel, enter the following command: TSO CVURAAD The Select Company panel is displayed as shown below: Figure 8-1: Select Company Panel

22 22 2. Verify the parameters and press Enter. The Analyze ADABAS FDT report (BURAAD) panel is displayed as shown below: Figure 8-2: Analyze ADABAS FDT report (BURAAD) Panel 3. Insert parameter names into fields as required: PDS or data set name Name of the sequential file that contains the FDT report of ADABAS files. Source Name Name of the member that contains the FDT report of ADABAS files.

23 23 Appendix A. Toolkit Tables During Toolkit installation, the following tables are created: Table Name HSSYSCKS HSSYSCOL HSSYSDAU HSSYSDBA HSSYSDEP HSSYSFKE HSSYSIND HSSYSIPA HSSYSKEY HSSYSRAU HSSYSREL HSSYSSYN HSSYSTAB HSSYSTAU HSSYSTPA HSSYSTSP HSSYSVDE HSSYSVIE HSURDCOL HSURDSYC Description View of SYSIBM.SYSCHECKS View of SYSIBM.SYSCOLUMNS View of SYSIBM.SYSDBAUTH View of SYSIBM.SYSDATABASE View of SYSIBM.SYSCHECKDEP View of SYSIBM.SYSFOREIGNKEYS View of SYSIBM.SYSINDEXES View of SYSIBM.SYSINDEXPART View of SYSIBM.SYSKEYS View of SYSIBM.SYSRESAUTH View of SYSIBM.SYSRELS View of SYSIBM.SYSSYNONYMS View of SYSIBM.SYSTABLES View of SYSIBM.SYSTABAUTH View of SYSIBM.SYSTABLEPART View of SYSIBM.SYSTABLESPACE View of SYSIBM.SYSVIEWDEP View of SYSIBM.SYSVIEWS View of SYSIBM.SYSCOLUMNS View of SYSIBM.SYSCOPY

24 24