Topaz Workbench Data Visualizer User Guide

Transcription

1 Topaz Workbench Data Visualizer User Guide

2

3 Table of Contents Displaying Properties... 1 Entering Java Regular Expressions in Filter Fields... 3 Related Topics... 3 Exporting the Extract Trace Events View... 5 Related Topics... 5 Exporting the Graphical View... 7 Related Topics... 7 Getting Started with the Data Visualizer... 9 Related Topics... 9 Importing Data Sources File-AID/RDX File-AID/EX Importing a File-AID/EX Repository - AR Set Importing a File-AID/EX Repository - Extract Importing a File-AID/EX Saved Extract Specification from XML File Importing a File-AID/EX XML File Importing a File-AID/RDX Extract Mainframe Trace File Importing a File-AID/RDX Extract Request File Importing a File-AID/RDX Extract Text Trace File Importing a File-AID/RDX or File-AID for DB2 Relationship File Importing an Exported Visualization File Related Topics Opening the Data Visualizer Related Topics Printing the Graphical View Specifying Data Visualizer Preferences Limiting Node Sizes Line Wrapping Nodes Limiting the History List Related Topics Using the History List i

4 Table of Contents Welcome to the Topaz Workbench Data Visualizer Related Topics Working with Extract Views Related Topics Working with Object Filters Related Topics Working with Relationship Filters Related Topics Working with Relationship Views and Filters Related Topics Working with the Extract Hotspot Filter View Rule-Matching Buttons Hotspot Filters Related Topics Working with the Extract Trace Events View Finding Events Exporting the Extract Trace Events View Related Topics Working with the Graphical View of Extract Trace Files Related Topics Working with the Graphical View of Objects and Relationships Related Topics Working with the Objects Tab File-AID/RDX or File-AID for DB2 Relationship File Saved Extract Requests Saved Visualization Files Processing Filters Object Properties Working with the Relationships Tab ii

5 Displaying Properties When visualizing data objects, relationships, or extract events in the Data Visualizer perspective, object properties, relationship properties, extract event properties, and Graphical View properties can all be displayed in a Properties tab. The Properties tab shares the window used for the Relationship Filters, Object Filters, and Extract Hotspot Filter View tabs. Object properties displayed include: DB type Driving table (true or false) DSN Excluded (true or false) Group ID In scope (true or false) Object ID Schema Table Unrelated (true or false). Relationship properties displayed include: Association 0001 Connection Type (RI or AR) Destination (expandable) Group ID ID Name Source (expandable). Extract event properties displayed include: % of Rows Read Chase Keys Count Columns Count CPU Time (Seconds) Data read from Dependent DPSI Event Number Fetches Index Access Method Index Exact Match Index Partial Match Key Tree Object read from Parent Relationship ID Retrieval Code Rows Extracted Rows Read Rows Used 1

6 Displaying Properties SQL Timeron. Graphical View properties displayed include: Current layout Limit Node Sizes (true or false) Line wrap nodes (true or false) Max chars before trimming Min chars before wrapping Root nodes Total nodes. To display properties 1. To display properties for an object, relationship, or event, right-click the object node or relationship or event line in the Graphical View and select Properties. The Properties tab displays the properties of the selected object, relationship, or event. To view the properties for another object, relationship, or event, simply click on the desired item. 2. To display properties for the Graphical View of objects and relationships itself, right-click in an open area of the view and select Properties. The Properties tab displays the properties of the Graphical View. 2

7 Entering Java Regular Expressions in Filter Fields The following Java regular expression items can be used in the object filter fields for Creator/Schema and Table/DSN and the relationship filter fields for Parent/creator schema, Parent Table/DSN, Dependent Creator/Schema, Dependent Table/DSN, and Relationship Name: Dot, any character (may or may not match. line terminators, read on) \d A digit: [0-9] \D A non-digit: [^0-9] \s A whitespace character: [ \t\n\x0b\f\r] \S A non-whitespace character: [^\s] \w A word character: [a-za-z_0-9] \W A non-word character: [^\w] * Match 0 or more times + Match 1 or more times? Match 1 or 0 times {n} Match exactly n times {n, } Match at least n times {n,m} Match at least n but not more than m times Related Topics Working with Object Filters Working with Relationship Filters 3

8

9 Exporting the Extract Trace Events View The contents of the Extract Trace Events View tab can be exported to a delimited file. The resulting file can then be compared with a later version following code changes. This before vs. after comparison makes it easier to understand the impact of whatever changes have been made. To export an Extract Trace Events View 1. Right-click on the view and select Export. 2. Either enter a name for the exported csv file in the File name field, or click Browse, browse to the desired location, enter a name for the exported csv file in the File name field, and click Save. 3. Choose Comma from the Field delimiter dropdown list. 4. Choose a Text qualifier from the dropdown list. Options are None (the default) and Double quote. 5. Click OK. Related Topics Working with the Extract Trace Events View Exporting the Graphical View 5

10

11 Exporting the Graphical View The Graphical View of data objects and relationships can each be exported to the following formats: Portable Document Format (.pdf) file for later viewing and printing. Visio Drawing (.vsdx) file for later use in Microsoft Visio. Text (.txt) file. Data Visualizer XML (.xml) for later import back into the Data Visualizer. Portable Network Graphic format (.png) or JPEG format (.jpg) for later viewing. To export the Graphical View 1. Use Data Visualizer functions to tailor the content of the Graphical View before exporting. For more information, see Working with the Graphical View of Objects and Relationships. 2. Right click the Graphical View and select Export. The Export Visualization dialog box appears. 3. Select the desired output file format from the Format list. 4. Click Browse and browse to the desired location for the exported Data Visualization. 5. If Export Image (PNG, JPEG) was chosen from the Format list, select *.png or *.jpg from the Save as type drop-down list. 6. Enter a file name for the exported Data Visualization and click Save. 7. To open the saved file automatically after export, select the View document after export check box. 8. To optionally include the current date, select the Include date check box. 9. To optionally include a watermark, select the Include watermark check box. 10. To optionally include a title for the exported Data Visualization, type the desired title in the Title field. The name of the data source is the default. 11. Click Finish. If a file with the specified name already exists, a prompt will appear to confirm overwriting the existing file. The file is generated and -- if the View document after export check box was selected -- opened in your system's default viewing application for the exported file type. Note: Multiple self-referencing relationships may appear as one relationship in VSDX files. Bold highlighting indicates the presence of more than one self-referencing relationship. You can separate these manually in Visio. Related Topics Printing the Graphical View Importing a Saved Visualization File 7

12

13 Getting Started with the Data Visualizer This topic will help you prepare to start using the Data Visualizer. To use the Data Visualizer for mainframe data, you must define an HCI host connection and connect Topaz Workbench or Eclipse/RDz to a mainframe system. To define your connection, click Window > Preferences. Then expand Compuware > Host Connections and add an HCI host connection before continuing. A host connection between the mainframe host and Topaz Workbench should have already been defined during the installation and configuration of Topaz Workbench. If you do not have host connection information (typically a port number and a host name), contact your system administrator to obtain specific connection configurations for your site for establishing Host Connections. (For system administrators, see the Topaz Workbench Installation Guide for additional information on installing Topaz Workbench). Note: When using File-AID Services in support of File-AID Data Privacy in Topaz Workbench, Host connections are centrally configured on the server where File-AID Services is running and available to all users that define File-AID Services in their Compuware preferences. Related Topics Opening the Data Visualizer 9

14

15 Importing Data Sources The topics in this section describe how to import supported data relationship sources into the Data Visualizer. They are listed in the order in which they appear in the Import view. Go to the topic for the type of data relationship source you would like to import: File-AID/RDX Importing a File-AID/RDX or File-AID for DB2 Relationship File Importing a File-AID/RDX Extract Mainframe Trace File Importing a File-AID/RDX Extract Text Trace File Importing an Exported Visualization File Importing a File-AID/RDX Extract Request File File-AID/EX Importing a File-AID/EX Repository - AR Set Importing an Exported Visualization File Importing a File-AID/EX Repository - Extract Importing a File-AID/EX XML File 11

16

17 Importing a File-AID/EX Repository - AR Set If File-AID/EX is installed on your PC, you can import application relationship (AR) sets from the File-AID/EX repository. The content of the application relationship is read and both related and unrelated information is formatted as required for the Data Visualizer. To import a File-AID/EX repository - AR set 1. In the Import view, click File-AID/EX to view the Import source list. 2. From the Import source list, select Repository - AR set and click Import. 3. On the Open Application Relationship dialog box, click the Repository dropdown and select the desired File-AID/EX repository. 4. Select the desired AR set and click OK. The AR set is imported into the Data Visualizer. 13

18

19 Importing a File-AID/EX Repository - Extract If File-AID/EX is installed on your PC, you can import extract specifications from the File-AID/EX repository. The content of the extract specification is read and both related and unrelated information is formatted as required for the Data Visualizer. To import a File-AID/EX extract specification from repository 1. In the Import view, click File-AID/EX to view the Import source list. 2. From the Import source list, select Repository - Extract and click Import. 3. On the Open Extract Specification dialog box, click the Repository dropdown and select the desired File- AID/EX repository. 4. Select the desired extract specification and click OK. The extract specification is imported into the Data Visualizer. 15

20

21 Importing a File-AID/EX Saved Extract Specification from XML File File-AID/EX includes the option to save an extract specification as XML. Relationships stored within these files can be visualized in the Data Visualizer. When the option for File-AID/EX related extract specification is selected, the standard Open File dialog and processing is used to navigate the local file system to find the file containing the XML version of the related extract specification. The content of this file is then read, and both related and unrelated information is formatted as required for visualization. To import a File-AID/EX saved extract specification from XML file 1. In the Import view, click Extract. 2. From the Available sources list, select File-AID/EX XML file and click Import. 3. In the Open dialog box, browse to and select the desired saved extract specification XML file, then click Open. The XML file is imported into the Data Visualizer. 17

22

23 Importing a File-AID/EX XML File If File-AID/EX is installed on your PC, you can import application relationships from File-AID/EX XML files and visualize them in the Data Visualizer.. File-AID/EX also includes the option to save an extract specification as XML. Relationships stored within these files can also be imported and visualized in the Data Visualizer. For both application relationship and extract specification XML files, the content of the XML file is read, and both related and unrelated information is formatted as required for the Data Visualizer. To import a File-AID/EX XML file 1. In the Import view, click File-AID/EX to view the Import source list. 2. From the Import source list, select XML file and click Import. 3. In the Open dialog box, browse to and select the desired saved XML file, then click Open. The XML file is imported into the Data Visualizer. 19

24

25 Importing a File-AID/RDX Extract Mainframe Trace File When File-AID/RDX creates a mainframe extract, it produces a trace file logging all of the events in the extraction process. Data Visualizer enables you examine what occurred during extraction and optimize your extract specification to produce the desired data. To import a File-AID/RDX extract mainframe trace file 1. In the Import view, click File-AID/RDX to view the Import source list. 2. From the Import source list, select Extract mainframe trace file and click Import.. The Dataset Selection dialog box appears. 3. Select a host from the Host drop-down list. If prompted, enter host login credentials and click OK. 4. In the Name field, enter filter criteria for dataset selection and click List. Note: The Datasets Name field may be pre-filled with the name of the most recently used extract mainframe trace file. 5. Select a mainframe extract trace file from the list and click OK. The Data Visualizer will appear with the selected trace file displayed in the Data Visualizer window 21

26

27 Importing a File-AID/RDX Extract Request File When visualization of a File-AID/RDX extract request file is selected, you locate the extract request using Host Services processing for Dataset Selection. A request is made to File-AID/RDX to return the relationship information contained within the extract request. File- AID/RDX reads the request and formats three kinds of information to return to the Data Visualizer. Objects in the related thread, including excluded objects Unrelated objects Relationship information for the related thread. The formatted information is sent to the Data Visualizer display, and no further interaction with File-AID/RDX is required. To import a File-AID/RDX extract request file 1. In the Import view, click File-AID/RDX to view the Import source list. 2. From the Import source list, select Extract request file and click Import. The Dataset Selection dialog box appears. 3. In the Datasets Name field, enter filter criteria for dataset selection and click List. If prompted, enter host login credentials and click OK. Note: The Datasets Name field may be pre-filled with the name of the most recently used extract request file. 4. Select a dataset from the list. To select a specific member, enter filter criteria in the Members Name field, then select the desired member from the list. 5. Click OK. The Data Visualizer will appear with the selected extract request displayed in the Data Visualizer window. 23

28

29 Importing a File-AID/RDX Extract Text Trace File When File-AID/RDX creates a mainframe extract, it produces a trace file logging all of the events in the extraction process. Data Visualizer enables you examine what occurred during extraction and optimize your extract specification to produce the desired data. If you previously exported a visualized extract mainframe trace file to a text file, you can import that file back into Data Visualizer without needing to access the original extract mainframe trace file. To import a File-AID/RDX extract text trace file 1. In the Import view, click File-AID/RDX to view the Import source list. 2. From the Import source list, select Extract text trace file and click Import.. The Open dialog box appears. 3. Select a host from the Host drop-down list. If prompted, enter host login credentials and click OK. 4. In the Name field, enter filter criteria for dataset selection and click List. 5. Browse to and select the desired extract text trace file, then click OK. The Data Visualizer will appear with the selected trace file displayed in the Data Visualizer window 25

30

31 Importing a File-AID/RDX or File-AID for DB2 Relationship File When visualization of a relationship file is selected, you use the Import Visualization Data dialog box to locate the desired relationship file using Host Services processing for Dataset Selection. Filtering options are included at download time for relationship files only. Filter options are available within the Data Visualizer which apply to all relationship sources. Filtering is provided to filter on SSID/Location, DB2 creator, and file name high level qualifier. To import a File-AID/RDX or File-AID for DB2 relationship file 1. In the Import view, click File-AID/RDX to view the Import source list. 2. From the Import source list, select Relationship file and click Import. The Import Visualization Data dialog box appears with the Product and Relationship source fields pre-filled. 3. Click Browse. The Dataset Selection dialog box appears. 4. Select a host from the Host drop-down list. If prompted, enter host login credentials and click OK. 5. In the Name field, enter filter criteria for dataset selection and click List. Note: The Datasets Name field may be pre-filled with the name of the most recently used relationship file. 6. Select a relationship file from the list and click OK. 7. On the DB2 Object Filter tab, select the desired DB2 SSID from the drop down list. A list of creators appears below the SSID. 8. Select and/or deselect items from the Creator list to limit data being brought into the Data Visualizer. 9. Click the File Object Filter tab, then select and/or deselect items from the File HLQ list to limit data being brought into the Data Visualizer. 10. Click Finish. The Data Visualizer will appear with the selected file displayed in the Data Visualizer window. 27

32

33 Importing an Exported Visualization File Following are the instructions for importing a previously exported Data Visualizer XML file into the Data Visualizer. To import a saved visualization file 1. In the Import view, click either File-AID/RDX or File-AID/EX. to view the Import source list. 2. From the Import source list, select Exported visualization file and click Import. 3. In the Open dialog box, browse to and select the desired visualization file, then click Open. The visualization file is imported into the Data Visualizer. Related Topics Exporting the Graphical View 29

34

35 Opening the Data Visualizer Following are the instructions for opening the Data Visualizer for data objects and relationships. Note: To access and visualize any of the supported data sources in the Data Visualizer, you must have a Topaz for Enterprise Data license. A license is also needed for any product used to create those data sources, such as File-AID/RDX, File-AID/EX, or File-AID for DB2. To open the Data Visualizer for data objects and relationships 1. Start Topaz Workbench, then do one of the following: From the Compuware menu, select Data Visualizer. Click the Open Perspective button or Window > Open Perspective > Other. In the Open Perspective dialog box, click Data Visualizer, then click OK. From the File menu: o o o o o o Select File > Import. On the Import dialog box, expand Compuware, click Data Visualization, then click Next. From the Product drop-down, select either File-AID/RDX or File-AID/EX. From the Relationship source drop-down, select the desired source. Click Browse, browse to and select the desired Dataset/file, then click Open. When you click Finish, the Data Visualizer perspective will appear with a graphical view of the selected dataset or file. Related Topics Importing Data Sources Working with Views and Filters Working with the Graphical View of Objects and Relationships Working with the Graphical View of Extract Trace Files 31

36

37 Printing the Graphical View The Graphical View of data objects and relationships can be printed for later offline viewing. To print the Graphical View 1. Use Data Visualizer functions to tailor the content of the Graphical View before printing. For more information, see Working with the Graphical View of Objects and Relationships. 2. With the desired Graphical View selected, click File>Print or the toolbar printer button. The Print dialog box appears. 3. Select the desired printer from the Select Printer list. 4. Click Print. The Graphical View will be rendered by the selected printer. Large views will be rendered on multiple pages as required. 33

38

39 Specifying Data Visualizer Preferences Data Visualizer preferences allow you to adjust the way nodes are presented in the Graphical View, as well as the number of entries maintained in the History list. To change your preferences, click Window>Preferences. The Preferences dialog box appears. Expand Compuware and select Data Visualizer. The Preferences for the Data Visualizer are shown. When you change your preferences settings, the updated preferences will be remembered the next time you start the Data Visualizer. To restore the default settings, click Restore Defaults. Then click Apply or OK to accept your changes. Limiting Node Sizes To limit the horizontal size of nodes, select the Limit node sizes checkbox and specify a limit in the Maximum displayed characters before trimming field. Valid values are from 8 to 512 with a default value of 16. Characters beyond the specified value are indicated by an ellipsis (...) at the end of the name. The Limit node sizes checkbox is deselected by default. Click Apply or OK to accept your changes. Line Wrapping Nodes To enable names to wrap to additional lines in each node, select the Line wrap nodes checkbox and specify a limit in the Minimum displayed characters before line wrap field. Valid values are from 8 to 512 with a default value of 16. Names will wrap to a new line each time a line reaches the specified number of characters, and the node will expand vertically as needed to hold the wrapped name. The Line wrap nodes checkbox is selected by default. Click Apply or OK to accept your changes. Limiting the History List To limit the number of entries in the Data Visualizer History list, specify the desired list size in the Maximum size of visualizer history list field. Related Topics Using the History List 35

40

41 Using the History List The Data Visualizer perspective maintains a History list of data sources that have been imported. The list can be used to quickly reopen a data source that you worked with previously. By default, entries are sorted by Last Accessed date and time, but they can also be sorted by Source or Location by clicking the corresponding column heading. One or more entries in the History list can be deleted, and entries in the list can be saved as import configurations and reopened from the File-AID/RDX or File-AID/EX Data Visualizer import configuration list. The maximum number of entries in the History list can be set as described in Specifying Data Visualizer Preferences. To reopen a data source 1. In the Import view, click History. 2. From the History list, click the desired data source, then click Import. The data source will be opened in the Data Visualizer. To save a history list entry 1. In the Import view, click History. 2. Select an entry from the History list and click Save. 3. Browse to the desired save location, optionally revise the default name, and click Save. The entry becomes a saved Data Visualizer import configuration. To open a saved Data Visualizer import configuration 1. In the Import view, click File-AID/RDX or File-AID/EX. 2. From the Import source list, select Data Visualizer import configuration and click Import. 3. Browse to and select the desired import configuration, then click Open. The data source will be opened in the Data Visualizer. To delete history list entries 1. In the Import view, click History. 2. Click the entry to be deleted, then optionally Ctrl+click any additional entries for deletion or right-click and choose Select All. 3. Press the Delete key or right-click the selected entries and choose Delete. The Delete Selected Entries confirmation dialog appears. 4. To continue and delete the selected History entries, click Yes. Otherwise click No, and the History entries will be retained. 37

42

43 Welcome to the Topaz Workbench Data Visualizer The Topaz Workbench Data Visualizer is an Eclipse plug-in you can use to create, view, manipulate, export, and print graphical representations of data objects and the relationships between them. The Data Visualizer plug-in includes the Data Visualizer perspective for working with objects and relationships. Data relationships for visualization can be imported from nine sources originating in two different File-AID products: File-AID/RDX: o o o o o Relationship file (including File-AID for DB2 relationship files) Extract mainframe trace file Extract text trace file Exported visualization file Extract request file. File/AID/EX: o o o o Repository - AR set Exported visualization file Repository - Extract XML file. Previous visualizations can be imported from the History list. Related Topics Getting Started with the Data Visualizer 39

44

45 Working with Extract Views When visualizing extract trace files, the Data Visualizer perspective includes a view with an Extract Hotspot Filter View tab. Hotspot filters are used to identify areas of interest in an extract trace file. The Extract Hotspot Filter View tab shares the same view used for the Object Filters and Relationship Filters tabs. The Extract Hotspot Filter View tab is only visible when visualizing an extract mainframe trace file or an extract text trace file. The Data Visualizer perspective also includes a view with an Extract Trace Events View tab. Events which occurred during the extraction process are listed in tabular format and sync with the Graphical View. The Extract Trace Events View tab shares the same view used for the Objects and Relationships tabs. The Extract Trace Events View tab is only visible when visualizing an extract mainframe trace file or an extract text trace file. Related Topics Working with the Extract Hotspot Filter View Working with the Extract Trace Events View Importing a File-AID/RDX Extract Mainframe Trace File Importing a File-AID/RDX Extract Text Trace File 41

46

47 Working with Object Filters The Object Filters tab is used to create filters that exclude objects based on specific fields on the Objects tab. The excluded objects are hidden on the Objects tab and in the Graphical View. Hiding an object from the Graphical View automatically creates a corresponding object filter. Filters can be created using the Object Filters tab based on: ID Group ID Type Creator/Schema Table/DSN. Filters are also used to hide excluded or unrelated objects. To create, enable, disable, or delete an object filter 1. Either click the radio button for the desired filter and type your filter criteria in the adjacent field or use the field drop-down list to select an item. If Hide excluded objects or Hide unrelated objects is selected, there are no additional criteria to enter. Java regular expressions can also be used in filter fields. See Entering Java Regular Expressions in Filter Fields for more information. Note: A Hide unrelated objects filter is created automatically when the source data is a saved File-AID/RDX extract request that includes unrelated objects. To view the hidden unrelated objects, disable the filter. Note: A Hide excluded objects filter is created automatically when the source data is a saved File-AID/RDX extract request that includes excluded objects. To view the hidden excluded objects, disable the filter. 2. Click Add. The specified filter is created and displayed in the Existing filters list. Objects tab fields and Graphical View object nodes matching the filter are hidden from view. 3. To create a filter based on Object ID, either right-click the desired node in the Graphical View and select Hide Object, or right-click the desired object in the Object View and select Hide>Hide Object. The node and its relationships are hidden, and an object filter corresponding to the selected node is automatically created and enabled. 4. To disable an existing enabled filter, either double-click it in the Existing filters list, or right-click it and select Disable. To disable multiple filters, Ctrl+click the desired filters, then right-click and select Disable. 5. To enable a disabled filter, either double-click it in the Existing filters list, or right-click it and select Enable. To enable multiple disabled filters, Ctrl+click the desired filters, then right-click and select Enable. 6. To toggle the enabled/disabled status of a filter, right-click the filter in the Existing filters list and select Flip status. To toggle the status of multiple filters, Ctrl+click the desired filters, then right-click and select Flip status. 7. To delete an existing filter, right-click the filter in the Existing filters list and select Delete. To delete multiple filters, Ctrl+click the desired filters, then right-click and select Delete. Related Topics Working with the Objects Tab Entering Java Regular Expressions in Filter Fields 43

48

49 Working with Relationship Filters The Relationship Filters tab is used to create filters that exclude specific fields from the Relationships tab. The excluded relationships are hidden on the Relationships tab and in the Graphical View. Hiding a relationship from the Graphical View automatically creates a corresponding relationship filter. Filters can be created using the Relationship Filters tab based on: ID Group ID Parent source Parent creator/schema Parent table/dsn Dependent source Dependent creator/schema Dependent table/dsn Name Type. Filters are also used to hide excluded relationships. To create, enable, disable, or delete a relationship filter 1. Either click the radio button for the desired filter and type your filter criteria in the adjacent field or use the field drop-down list to select an item. If Type is selected, use the field drop-down list to select AR or RI. If Hide excluded relationships is selected, there are no additional criteria to enter. Java regular expressions can also be used in filter fields. See Entering Java Regular Expressions in Filter Fields for more information. 2. Click Add. The specified filter is created and displayed in the Existing filters list. Relationships tab fields matching the filter are excluded from view. 3. To create a filter based on Relationship ID, either right-click the desired relationship line in the Graphical View and select Hide Object, or right-click the desired relationship in the Relationship View and select Hide Relationship. The relationship and its related nodes are hidden, and a relationship filter corresponding to the selected relationship is automatically created and enabled. 4. To disable an existing enabled filter, either double-click it in the Existing filters list, or right-click it and select Disable. To disable multiple filters, Ctrl+click the desired filters, then right-click and select Disable. 5. To enable a disabled filter, either double-click it in the Existing filters list, or right-click it and select Enable. To enable multiple disabled filters, Ctrl+click the desired filters, then right-click and select Enable. 6. To toggle the enabled/disabled status of a filter, right-click the filter in the Existing filters list and select Flip status. To toggle the status of multiple filters, Ctrl+click the desired filters, then right-click and select Flip status. 7. To delete an existing filter, right-click the filter in the Existing filters list and select Delete. To delete multiple filters, Ctrl+click the desired filters, then right-click and select Delete. Related Topics Working with the Relationships Tab Entering Java Regular Expressions in Filter Fields 45

50

51 Working with Relationship Views and Filters When visualizing data objects and their relationships, the Data Visualizer perspective includes a view with Objects and Relationships tabs. The Objects tab lists the object ID, Group ID, Type, Creator/Schema, and Table/DSN for each object in the data source. The Relationships tab lists ID, Group ID, Parent Source, Parent Creator/Schema, Parent Table/DSN, Parent Column, Dependent Source, Dependent Creator/Schema, Dependent Table/DSN, Dependent Column, Name, and Type. A search field on each tab can be used to locate items by shortening the list displayed. The Data Visualizer perspective also includes a filter view with Object Filters and Relationship Filters tabs. You can create and save filters used to exclude objects and relationships from the corresponding Objects and Relationships tabs. Saved filters can be disabled, enabled, and deleted. Because each Filters tab is paired with its corresponding Objects or Relationships tab, selecting one automatically selects the other. Note: Filtering can also be done when a data source is imported into the Data Visualizer. For more information, see Importing Data Sources. Related Topics Working with Relationship Filters Working with the Relationships Tab Working with Object Filters Working with the Objects Tab 47

52

53 Working with the Extract Hotspot Filter View When you use File-AID/RDX to create a mainframe related data extract, it also produces an extract trace file. This file logs all of the events that occurred during the File-AID/RDX extraction process. To help you focus in on areas of interest in your extract trace file, the Extract Hotspot Filter View tab includes a number of pre-configured and customizable rules. These rules function as filters that control what is actively displayed in the Graphical View. By identifying where unexpected or undesirable extraction results have occurred, Data Visualizer provides insights that can be used to improve subsequent extracts. Rule-Matching Buttons Near the top of the Extract Hotspot Filter View tab are two radio buttons: Match any rule and Match all rules. These buttons function as follows: Match any rule: Nodes that match any rule specified are highlighted in the Graphical View. Nodes that don't match any rule are filtered out of the Graphical View and appear grayed out. The default is to match any rule. Match all rules: Nodes that match all of the rules specified are selected in the Graphical View. Nodes that don't match all of the rules are filtered out of the Graphical View and appear grayed out. Hotspot Filters "Hotspots" are areas in an extract trace file where the amount of data read or extracted, for example, is either more or less than expected. By specifying a rule or combination of rules on the Extract Hotspot Filter View, you can visually identify areas of the extraction process that are candidates for optimization. The following rules are provided: No rows read from object: Select this rule to highlight only objects from which no rows were read. No rows read from object in any event: Select this rule to highlight only objects from which no rows were read during any of the events involving that object. No rows extracted from object: Select this rule to highlight only objects from which no rows were extracted. No rows extracted from object in any event: Select this rule to highlight only objects from which no rows were extracted during any of the events involving that object. Objects with more than rows read: Select this rule and type a number in the box to highlight only objects from which more than the specified number of rows were read. Objects with more than rows extracted: Select this rule and type a number in the box to highlight only objects from which more than the specified number of rows were extracted. Greater than percent of rows read: Select this rule and type a number in the box to highlight only objects from which more than the specified percentage of rows were read. Greater than percent of rows extracted: Select this rule and type a number in the box to highlight only objects from which more than the specified percentage of rows were extracted. Objects with more than one parent: Select this rule to highlight only objects that have two or more parents. Objects that reference themselves: Select this rule to highlight only self-referencing objects. Objects visited more than times: Select this rule and type a number in the box to highlight only those objects that were accessed more than the specified number of times during the extraction process. Top percent by CPU consumption: Select this rule and type a number in the box to highlight only the specified percentage of those events that consumed the most CPU time. Tables that may need RUNSTATS run: Select this rule to highlight only objects for which the RUNSTATS utility may need to be run. Rule selections generally take effect immediately. To apply a rule in which a value has been typed, either press Enter or click the Apply button at the bottom of the view. To reset all of the rules in the Extract Hotspot Filter View, click the Clear button at the bottom of the view. 49

54 Working with the Extract Hotspot Filter View Related Topics Importing a File-AID/RDX Extract Mainframe Trace File Importing a File-AID/RDX Extract Text Trace File Working with the Graphical View of Extract Trace Files 50

55 Working with the Extract Trace Events View The Extract Trace Events View tab includes an entry for each event that occurred during the File-AID/RDX extraction process, as recorded in the extract trace file. Each event is represented by a row in the view, and each event row is synchronized with the corresponding connecting line that represents it in the Graphical View. The event number is assigned sequentially to provide an easy way to reference the event. Other data available for each event varies by object type. The Extract Trace Events View tab contains the following columns: Event Number % of Rows Read % of Rows Extracted Rows Read Rows Extracted # of Chase Keys Fetches Rows in Object (RUNSTATS) CPU Time (Seconds) Index Access Method Index Exact Match Index Partial Match Data Extracted From Requesting Object. Depending on your selection, the Graphical View's connecting line boxes each display the number of Rows Read, number of Rows Extracted, or # of Chase Keys for the corresponding event in the Extract Trace Events View. For details, see Working with the Graphical View of Extract Trace Files. The contents of the Extract Trace Events View tab can be filtered using rules specified on the Extract Hotspot Filter View. For details, see Working with the Extract Hotspot Filter View. The events in the Extract Trace Events View tab can be sorted by clicking the column headings. Clicking a column heading a second time reverses the sort order. The default sort order is ascending by Event Number. Finding Events To find extraction events in the Extract Trace Events View 1. To highlight the event associated with a connecting line in the Graphical View, simply click the line. 2. To manually locate an event value, begin typing the value in the text box at the top of the Extract Trace Events View tab. As you type, the view is filtered to list only those events that match the entered text. 3. To clear the text box, click the Clear button to the right. Exporting the Extract Trace Events View The contents of the Extract Trace Events View can be exported to a delimited text file for analysis outside Data Visualizer. For details, see Exporting the Extract Trace Events View. Related Topics Working with the Extract Hotspot Filter View 51

56 Working with the Extract Trace Events View Working with the Graphical View of Extract Trace Files 52

57 Working with the Graphical View of Extract Trace Files The Data Visualizer perspective is used to present information about data objects and their relationships, including the objects and events recorded in a File-AID/RDX extract trace file. The perspective includes a Graphical View of extract trace files that presents the selected file as a collection of object nodes, rounded rectangular boxes that display the name of the object. Object nodes are connected by lines representing the extraction events in the extract trace file, with arrowheads indicating the direction of data extraction and connecting line boxes showing your choice of number of Rows Read, number of Rows Extracted, or # of Chase Keys. Each node in the Graphical View can be moved to a new location by dragging it with the left mouse button pressed. The contents of the entire Graphical View can also be moved either by using the scroll bars or by placing the cursor on an open area then dragging with the left mouse button pressed. Each extract trace file you open is displayed in a separate tab labeled with the file name. If the extract trace file cannot be visualized for some reason, an error message will appear. The data displayed in the Graphical View can be limited by using the Extract Hotspot Filter View. For details, see Working with the Extract Hotspot Filter View. The Graphical View can be zoomed in and out, and the spacing between nodes can be increased and decreased, independent of the zoom level. Nodes can be arranged top to bottom (the default), left to right, or bottom to top by right-clicking anywhere in the Graphical View and selecting Layout > Top Down, Layout > Left to Right, or Layout > Bottom Up. Nodes can be collapsed to hide subsequent nodes by right-clicking and selecting Collapse. The collapsed node includes a red indicator in the lower right corner showing the number of levels that have been collapsed. To redisplay nodes hidden under a collapsed node, right-click the node and select Expand, Expand All, or Expand Levels. Selecting Expand expands the collapsed node one level. Selecting Expand All fully expands all nodes under the collapsed node. Expand Levels provides sub-menu choices to expand the collapsed node by 3, 5, or 7 levels. If the node has been collapsed more levels than it is expanded, subsequent nodes that remain collapsed include a red indicator showing the number of levels that could still be expanded. For easier viewing after the desired nodes have been collapsed, the Graphical View can be redrawn without the hidden nodes by right-clicking anywhere in the view and selecting the desired Layout > option. The type of object node is indicated visually with an icon for MVS, DB2, or IMS. Clicking on an object node selects it and highlights it with a bold, blue border around the node. Clicking on an event connection line selects the line and the two data sources it connects, while the line is highlighted with a bold, blue dash pattern. Right-clicking on an object node representing an MVS file or a DB2 table displays a menu with choices for Edit with File-AID and Browse with File-AID. Choosing Edit with File-AID creates a File-AID Data Editor request that can be submitted to edit the selected object, and choosing Browse with File-AID creates a request for browsing the object. For more information, see the Topaz Workbench File-AID/Eclipse User Guide. Hovering the cursor over an object node displays a tooltip listing the object name, the total number of rows read, and the total number of rows extracted for that object. Hovering the cursor over an event connecting line displays a tooltip listing the event number, the extract objects, the direction of the extract, the rows read, and the rows extracted during that event. The following tasks are described below: Locating an event Selecting children and parents Specifying the value for connecting line boxes Viewing event properties Visualizing an associated File-AID/RDX request Zooming 53

58 Working with the Graphical View of Extract Trace Files Increasing/Decreasing node spacing. To locate an event in the Graphical View 1. Simply click the desired event in the Extract Trace Events View. The two object nodes connected by the event are highlighted with a bold, blue border, while the connection line itself is highlighted with a bold, blue dash pattern.. To select children and parents of objects in the Graphical View 1. Select one or more object nodes, then right-click the selected node(s) and choose Select>Select Children, Select>Select Parents, or Select>Select Children and Parents. The children and/or parents of the selected object node(s) are added to the selected items in the Graphical View. To specify the display value for connecting line boxes 1. Right-click anywhere in the Graphical View and select Show Extracted Row Count, Show Read Row Count, or Show Chase Key Count. Until this setting is changed, the connecting line boxes will display the chosen value for each event. To visualize an associated File-AID/RDX extract request 1. Right-click anywhere in the Graphical View and select Visualize RDX Request. The extract request embedded in the extract trace file is opened in the Graphical View of objects and relationships. This provides a convenient way to compare an extract request with the actual results of the extraction process. To zoom the Graphical View 1. Click the toolbar zoom percentage and select the desired zoom level. Choices include Page, Width, and Height, as well as various numeric percentages. 2. You can also Ctrl+scroll to zoom in and out through all of the predefined zoom levels. 3. To zoom larger by one increment, Alt+click anywhere in the Graphical View. To zoom smaller by one increment, use Alt+Shift+click. 4. To view an object name while zoomed out smaller than 100%, hover over the desired node. A full-size view of the node is temporarily displayed. To increase or decrease spacing between nodes 1. Click the up arrow on the spacing spinner (adjacent to the zoom percentage) to increase the space between nodes in the Graphical View. Click the down arrow to decrease spacing. Spacing is independent of zoom percentage. 2. A spacing value of 0 to 50 can also be entered directly in the spacing spinner. Related Topics Working with the Extract Hotspot Filter View Working with the Extract Trace Events View Displaying Properties Printing the Graphical View Exporting the Graphical View 54

59 Working with the Graphical View of Objects and Relationships The Data Visualizer perspective is used to present information about data objects and their relationships. The perspective includes a Graphical View of objects and relationships that presents the data source as a collection of object nodes, rounded rectangular boxes that display the name of the object. Object nodes are connected by lines representing their relationship, with arrowheads pointing from parent to dependent objects. Solid lines indicate RI relationships, and dashed lines indicate AR relationships. Each node in the Graphical View can be moved to a new location by dragging it with the left mouse button pressed. The contents of the entire Graphical View can also be moved either by using the scroll bars or by placing the cursor on an open area then dragging with the left mouse button pressed. Each data source you open is displayed in a separate tab labeled with the source name. If the data source cannot be visualized for some reason, an error message will appear. The data displayed in the Graphical View can be limited by using filters on the Object Filters and Relationship Filters tabs. Nodes can also be expanded and collapsed to limit the data being displayed. The Graphical View can be zoomed in and out, and the spacing between nodes can be increased and decreased, independent of the zoom level. The type of object node is indicated visually as follows: Nodes for MVS files are tinted yellow. Nodes for DBMS files are tinted blue. Driving objects are indicated with a bold green border around the node. By default, excluded objects and relationships are hidden by an automatic object or relationship filter and can be displayed by disabling or deleting the filter. The status of visible excluded objects and relationships is indicated visually as follows: Excluded object nodes are tinted light gray with grayed-out text. On the Objects tab and the Relationships tab, the excluded object is indicated with light gray text. Objects nodes with all associated relationships excluded are tinted gray with black text. Excluded relationships are marked with a bold red X. Clicking on an object node selects it and highlights it with a bold red border around the node. Any dependent objects are also selected and their nodes are tinted dark gray. Clicking on a relationship line selects it, and the line is highlighted in bold with a red arrowhead. Clicking on an excluded relationship line selects it, and the line is highlighted in bold red. Right-clicking on an object node representing an MVS file or a DB2 table displays a menu with choices for Edit with File-AID and Browse with File-AID. Choosing Edit with File-AID creates a File-AID Data Editor request that can be submitted to edit the selected object, and choosing Browse with File-AID creates a request for browsing the object. For more information, see the Topaz Workbench File-AID/Eclipse User Guide. The Graphical View title bar displays the specification name of the data source. The following tasks are described below: Changing the layout Locating an object Locating a relationship Searching for an object or its relationships Searching for a relationship Expanding/collapsing and showing/hiding nodes Showing/hiding relationships Zooming 55