Compuware Test Drive File and Data Management Drive... · 1 Compuware Test Drive File and Data...

1

Compuware Test Drive

File and Data Management Revised: 10/7/2020

This tutorial will introduce you to the File-AID Data Editor and Topaz for Enterprise Data that enable you to manage various file types and understand data relationships.

The Mainframe Software Partner for the Next 50 Years2

Contents

GETTING STARTED ........................................................................................................................... 3

FILE-AID DATA EDITOR ..................................................................................................................... 4

Build Criteria Sets ......................................................................................................................... 8

Find and Replace Data ............................................................................................................... 13

Column Chooser ......................................................................................................................... 21

Add a Filter to Data .................................................................................................................... 24

Freeze Columns .......................................................................................................................... 25

Remove a Filter from Data ......................................................................................................... 26

Row Navigation Menu ............................................................................................................... 26

COMPARE for z/OS Files................................................................................................................. 27

DATA VISUALIZER ........................................................................................................................... 32

Data Visualizer Perspective ........................................................................................................ 32

Relationship Visualizer Object Filters ........................................................................................ 37

SEARCH ........................................................................................................................................... 38

NEXT STEPS .................................................................................................................................... 44


GETTING STARTED Instructions: • This guide contains many screenshots to provide a visual reference • Every action you must take is Highlighted • Please note each place that you must enter your own specific ID or number • You must complete each step before proceeding to the next to successfully follow the test

drive script.

This script requires that you first complete the "Getting Started" script. If, at any point during your experience, your host connection times out, you may need to log back in to the TestDrive host connection.


FILE-AID DATA EDITOR The File-AID Data Editor enables you to edit data files and provides similar functionality to the edit and browse functions in File-AID MVS, DB2 and IMS. Topaz Workbench takes a “data is data” design approach: If you know how to use the Data Editor for VSAM files, you also know how to use it for DB2 tables. In Part 4A, you will learn the basic functionality of the File-AID Data Editor. 1. Open the File-AID Data Editor by going to the Compuware menu and selecting File-AID Data Editor. 2.


3. Open a dataset in the File-AID Data Editor by right-clicking on yourid.WBSAMP.EMPLOYEE and choosing Open with File-AID Data Editor.

Note: Instead of “CWEZXXX.WBSAMP,” you should see “yourid.WBSAMP” as the first two nodes of the dataset names.


4. View the dataset in a formatted mode using a record layout by entering yourid.WBSAMP.LAYOUTS(EMPLOYEE) and clicking Get Layout in the “Layout dataset” area.

Note for future reference: If you do not have a layout and want to view your data unformatted, uncheck Use record layouts.

We are defining a request to see the dataset. Naming this request allows you to reuse it in the future.


5. Add “Employee” to the “Request name field” then click Run.

File-AID opens the file for display:


6. Click Return to request to modify the request with some selection criteria.

Build Criteria Sets

1. Select the Conditions tab. 2. Click <select field> to view the column list.


We are using a record layout, so we will build formatted conditions. 3. Select the Formatted radio button and click OK.

4. Click on EMP-NUMBER and then OK.


5. Under the Operator column, select the dropdown menu, and choose the is greater than option.

6. In the Value column, type “0”


7. Run the request by clicking Save and then Run.

The File-AID Data Editor within Topaz Workbench displays the data in Table Mode by default. You can also view data in Row Mode at the same time.


8. Click Show/Hide the Row Editor to toggle Row Mode on and off.

The table and row stay in sync when different fields are selected. Click around to see how it works. Use the vertical scroll bar and border drag with cursor to adjust screen for optimal viewing if needed.


9. Select Display Mode to toggle between Normal and Hex mode. Hex mode displays the data with up-down hex.

Toggle Hex mode Off.

Find and Replace Data

1. Open the Find/Replace dialog by clicking the Binoculars toolbar icon or pressing Ctrl+F on your keyboard.


2. Open the Numeric tab.


3. Type a value in the “Find” field and click Find All.

Note: The number of occurrences is displayed at the top of the Find/Replace dialog box above the tabs.

4. Type a replacement value in the “Replace with” field and click Replace All. Note: The number of occurrences replaced is displayed in the message area.


5. Click Close.


Changed rows are marked with an icon in the far left column. This column allows you to select an entire row and issue row commands with a right-click. An editor icon also appears in the left-hand column when data in the row changes.


6. Click on the fourth row then right-click on the left-hand column.

For a changed row, the Undo command will be available. You can undo changes in any order, even out of sequence of how the changes were made.


7. Simultaneously press the F and Ctrl keys on your keyboard. 8. Open the Numeric tab. 9. Click the dropdown next to “Find operators” to select Invalid.


10. Type “0” in the “Replace with” field and click Replace All.

Observe that the value field next to Find is disabled. Notice the message: “3 occurrences replaced” and click Close.


Column Chooser

This section investigates the Column Chooser function, which allows you to eliminate and reorder columns in the display. 1. Right-click on the column header to display the column commands. 2. Select Choose Columns.

3. Click on one of the column names and simultaneously hold down the Ctrl and A keys on your keyboard.

4. Click the left arrow to move your selections into the Available Columns area.


5. Select the columns shown in the screenshot below, holding down the Ctrl key while clicking the column names.


6. Click the right arrow, and press Done.

Now the File-AID Data Editor shows just the columns chosen.


7. Reset the display to show all columns by right-clicking on the column header and selecting Show All Columns.

Add a Filter to Data

The filter row is located between the headers and the data. Within the filter row, type a name under EMP-LAST-NAME and hit enter.

The display filters all but that row.


Freeze Columns

1. Right-click on the header row and select Freeze Columns.

2. Using the yellow arrows, select and move the two fields shown below to the Frozen Columns area.

3. Click OK to return to the file display. 4. Scroll left and right to see the effect.


Remove a Filter from Data

Click the Clear Filter icon next to the text in the filter row to display all the data.

Row Navigation Menu

1. Select a row and then click the Navigation (Paging) menu in the toolbar or right click for the command menu and select Navigation. 2. Select Go To Specific Row.

3. Type a row number and select OK.


4. Close the file by clicking the “X” on the tab with the file name.

5. Click Save to save your changes.

COMPARE for z/OS Files You can run previous requests, organize favorites and manage requests using the File-AID toolbar icon, denoted with the blue File-AID icon.

Notice that you can also launch the Compare functionality from this dropdown menu.


Another way to launch the Compare functionality: 1. Select yourid.WBSAMP.COMPARE and yourid.WBSAMP.EMPLOYEE by holding down the Ctrl key while clicking the names. 2. Right-click on one of the files, select Compare With and then Each Other Using File-AID.

3. Format the compare by selecting Browse, which is next to the Layout (optional) field.

4. Type yourid.WBSAMP.LAYOUTS and click List.


5. Click the Employee member and then OK.

6. Choose Run.

The Comparison Summary will open.


7. Maximize the view by clicking the square in the top right corner of the window or by double clicking the tab.

8. Click on the Differences bar within the Comparison Summary chart to display Comparison Details.


9. Explore and play with the filter controls for File Differences and Record Differences. Your results may vary depending on changes made to your data.

10. Select a Changed Record in the top section to see differences highlighted below. Change vertical to horizontal view with buttons on right of that section. To finish close the window by clicking the X in the tab. This completes the File-AID Compare section.


DATA VISUALIZER The Topaz Workbench Data Visualizer allows you to see relationships that you have defined between DB2 tables and VSAM files. This is equivalent to the File-AID for DB2 and File-AID/RDX functionality, where you can display relationships between files in the ISPF interface. In this section, you will bring up a relationship file visualization containing sample tables.

Data Visualizer Perspective

1. Open the Data Visualizer Perspective by opening the Compuware menu and selecting Data Visualizer.


2. On the Import tab, click Relationship file.

3. Select the Import button. Choose the Visualizer Data Source 1. Click Browse to view the file list mechanism.


2. In the Name field, type yourid.WBSAMP.RELATION.

3. Click List and then OK.


4. In the DB2 Location dropdown menu, select DB01CW01.

Note: DB01 is a subsystem on the LPAR CW01 where this relation file was created. The relationship information itself is self-contained and independent of the fact that you are currently connected to a different LPAR.

5. Click Finish.


Topaz displays all the relationships defined in this file.

Note: you may wish to change the way the visualization is laid out, either for readability or to ensure everything is on the screen. On the graph, you can right-click and select a different layout to see alternative ways to lay out the information.


Relationship Visualizer Object Filters

We can filter out parts of this chart to see only the section in which we are interested. 1. Click the Group ID option, and type “2-29.”

2. Select Add. 3. Maximize the visualizer by clicking the square icon in the top right corner.


The Relationship Visualizer shows: • Application relationships (dashed lines) • Referential integrity (solid lines) To finish close the window by clicking the X in the tab. This completes the Data Visualizer section.

SEARCH Search within Topaz Workbench allows you to locate the contents of multiple datasets simultaneously. This is similar functionality to File-AID/MVS option 3.6 or ISPF option 3.14 (SEARCH) or 3.15 (SEARCHE). 1. Open the Host Explorer perspective by opening the Compuware menu and selecting Host Explorer or by selecting the Host Explorer perspective switcher.


2. Reset the Host Explorer Perspective by right-clicking the perspective name, selecting Reset and confirming.

1. Select both WBSAMP.COBOL and WBSAMP.JCL. Right-click WBSAMP.JCL and select Search.

At the top of the Search window, the first two tabs are for the File-AID and Host Explorer dataset searches.

File-AID Search

Host Explorer Search

Search

Option

sequential, PDS and

to process as JCL

VSAM Files Search sequential or PDS files only

Does not provide the JCL processing capability

We will use the File-AID search.

Tip: Hold the Ctrl key on your keyboard while selecting your items.


2. Type “Salary” in the Search for text field and click Search.


3. Maximize the search view by double clicking the search tab.

4. Click Expand All within the Search tab.


The first section of the search results shows the COBOL source code where salary is a part of a data name or is a constant. Another section shows where salary is part of a comment in the JCL.

5. Double-click on Employee Salary Data.


The member opens with the cursor position at the search result.

6. Click on the X on the toolbar in the search tab window to remove the highlighted line from the search results.

7. Close the JCL member.


,

You may choose to reset the Host Explorer perspective at this point. This completes the Search section. NEXT STEPS Click on the link below to return to the Compuware Test Drive main page and choose your next road trip!

NEXT STEPS Click on the link below to return to the Compuware Test Drive main page and choose your next road trip!

COMPUWARE TEST DRIVE

NOTE: if you wish to rerun this Test Drive Script, simply restart the Test Drive script from page 4. To regenerate the files and libraries return to the Build Your Environment script

Tip: You can use search results like a checklist, removing results as tasks are completed.

Compuware Test Drive File and Data Management Drive... · 1 Compuware Test Drive File and Data...

Documents

Transcript of Compuware Test Drive File and Data Management Drive... · 1 Compuware Test Drive File and Data...