dba/m Database Manager V7.1 User s Guide

Transcription

1 dba/m Database Manager V7.1 User s Guide Release 7.1. May, 2005

2 Copyright Information Copyright by Genus Software, Incorporated. All rights reserved. Trademark Acknowledgments NonStop dba/m Database Manager, NonStop SQL/MP are trademarks of Hewlett-Packard Devlopment Company L. P. Microsoft is a registered trademark of the Microsoft Corporation. Windows is a trademark of Microsoft Corporation. Copying and Use Restrictions No part of this manual can be reproduced or transmitted in any form or by any means, electronic or mechanical, including photocopying and recording, for any purpose without the express written permission of Genus Software, Inc. dba/m Database Manager V7.1 User's Guide

3 PREFACE Welcome to dba/m Database Manager, a client-server product designed to manage HP NonStop SQL/MP databases. This manual provides procedures for using dba/m Database Manager to manage database operations as well as database objects such as catalogs, tables, views, indexes, partitions, and programs. How This Manual Is Organized The dba/m Database Manager User s Guide contains procedures for using dba/m Database Manager, and managing database operations and database objects. Part no. of this manula is For information on tasks such as installing, upgrading, or starting and stopping dba/m Database Manager on the server, refer to the dba/m Database Manager Installation & Operations Manual. Use on-line Help for information on NonStop SQL/MP commands. For more detailed information on NonStop SQL/MP concepts, commands, and operations, refer to the documents published by HP Computer Corporation listed in the Reference section in this preface. This manual is organized as follows: Part I, Using dba/m Database Manager. The chapters in Part I explain how to invoke dba/m Database Manager and manage dba/m Database Manager users. It also describes how to use dba/m Database Manager features such as the Object Tree, Custom Tree and session profiles. Part II, Managing Database Operations. The chapters in Part II explain how to use dba/m Database Manager to perform database management tasks such as monitoring disk space usage, analyzing and tuning query performance, and creating and scheduling batch jobs. Part III, Managing SQL Objects. The chapters in Part III provide procedures for managing NonStop SQL/MP objects: catalogs, tables, views, indexes, partitions, and programs. NonStop dba/m Database Manager for NonStop SQL/MP User s Guide iii

4 Conventions and Definitions Used in This Manual Most dba/m Database Manager tasks are executed by completing the fields in a full-screen window. Window names are capitalized, for example, the Create Table window. A pane is the portion of a widow that contains related fields. The fields in a pane are often grouped inside a box and a name. Pane names are capitalized, for example, the Security pane. Fields in a window or pane are identified by names or by icons. Field names are capitalized, for example, the Column Name field. dba/m Database Manager uses the following field types: Field, into which you type a value. Check-box, a yes/no field. A yes value is indicated by a checkmark. A no value is indicated by a blank box. Option buttons, a set of related yes/no fields. One field can be set to yes; all of the other related fields are automatically set to no. Drop-down list, which contains a list of options. Tabular, a collection of related fields arranged in a table of rows and columns. The name of a column is used to refer to the name of the field. A row consists of a row header and column values. You select a row in a tabular field by clicking on one of the column values; the row is highlighted. The selected row can be used in three scenarios: If... If the next operation will be performed only on the selected row The next operation will be performed on a set of rows The next operation is a delete-rows operation Then... The row header is blank. A checkmark is displayed in the row headers of the selected rows. An x is displayed in the row headers of the selected rows. Click on buttons to perform operations on data in a window. Names of buttons are capitalized, for example, the Execute button. dba/m Database Manager V7.1 User's Guide

5 Variable names are italicized and enclosed in brackets, for example, <volumename>. Substitute the appropriate name for your installation. Technical Support For technical assistance, Contact GCSC by calling or by going to Tandem Support site References This manual does not provide information on NonStop SQL/MP. For additional information on HP NonStop SQL/MP, refer to the following manuals: NonStop SQL/MP Reference Manual NonStop SQL/MP Installation and Management Guide NonStop SQL/MP Message Manual NonStop SQL/MP Programming Manual for COBOL85 NonStop SQL/MP Programming Manual for C NonStop SQL/MP Programming Manual for TAL NonStop SQL/MP Programming Manual for PASCAL NonStop SQL Quick Start NonStop dba/m Database Manager for NonStop SQL/MP User s Guide v

6

7 CONTENTS AT A GLANCE PART I: USING dba/m Database Manager Chapter 1. Invoking dba/m Database Manager Chapter 2. Using the Main Window Chapter 3. Using the Object Tree Chapter 4. Managing dba/m Database Manager Profiles Chapter 5. Using dba/m Database Manager Commands PART II: MANAGING DATABASE OPERATIONS Chapter 6. Chapter 7. Chapter 8. Chapter 9. Chapter 10. Monitoring Disk Space Usage Analyzing and Tuning Query Performance Managing Data Auditing Command Execution Managing Jobs and Batches PART III: MANAGING SQL OBJECTS Chapter 11. Managing Catalogs Chapter 12. Managing Tables Chapter 13. Managing Views Chapter 14. Managing Indexes Chapter 15. Managing Table Partitions Chapter 16 Managing Enscribe Chapter 17. Managing Index Partitions Chapter 18. Managing Programs dba/m Database Manager V7.1 User's Guide vii

8 CONTENTS CHAPTER 1. INVOKING dba/m Database Manager Logging On Setting Logging Off (Exit) Licensing Issues CHAPTER 2. USING THE MAIN WINDOW Using dba/m Database Manager Commands Error Button Find Button Using the dba/m Database Manager Menu CHAPTER 3. USING THE OBJECT TREE Displaying Items in the Object Tree Volumes Catalogs Tables Views Partitions Indexes Programs Working with Objects Refresh Nodes Manage Volumes Manage Catalogs Manage Tables Manage Views Manage Indexes Manage Programs Manage Partitions Customizing the Object Tree Add an Object Delete custom tree CHAPTER 4. MANAGING dba/m Database Manager PROFILES Profile Menu The dba/m Database Manager profile menu has 4 menu-items viii Contents

9 Managing the dba/m Database Manager Profile Change dba/m Database Manager Profile Add Nodes Delete Nodes Managing User Profiles Add Users Change Users Delete Users Volume Display Attributes Display Order Notifier information Pager Information Notification Interval Add, Edit, Remove User SQL Inventory Default Logon Map Defines Add Map Defines Change Map Defines Delete Defines CHAPTER 5. USING dba/m Database Manager COMMANDS Saving Commands Displaying Commands Executing Commands Queuing Commands Retrieving Commands CHAPTER 6. MONITORING DISK-SPACE USAGE Displaying Volume Usage Customizing the Volume Display Monitoring Objects Choosing Objects Managing the Objects Displaying Alarms CHAPTER 7. ANALYZING AND TUNING QUERY PERFORMANCE Analyzing Queries in Programs Choose a Program dba/m Database Manager V7.1 User's Guide ix

10 Choose a Query Display Plan Details Display Statistics Table Statistics Simulate Production Statistics Tune the Query Modify Control Options View Explain Plans Execute the Query Analyzing Ad Hoc Queries Create a Query Modify Control Options View Explain Plan Display Statistics Simulate Production Statistics Execute Query Save the Query CHAPTER 8. MANAGING DATA Querying Data Querying a Database Copying Data Define Source and Destination Specify Control Options Define Input-File Options Define Output-File Options Specify Display Options Specify Move Options Perform the Copy Loading Data Define Source and Destination Specify Control Options Define Input-File Options Specify Key Sequence Options Enable Parallel Execution Specify Move Options Load the Data CHAPTER 9. AUDITING COMMAND EXECUTION Choose Users Choose Object Choose Period Display Audit Trail x Contents

11 Delete History Display Commands CHAPTER 10. MANAGING ITEMS AND BATCHES Managing Items Create an Item Edit an Item Managing Batches Create a Batch Assign Batch Attributes Delete a Batch Submit a Batch Stop a Batch Refresh Status Monitoring Batch Results Display Results Display Batch Output Batch Results Delete Batch Stop Batch Resubmit a Batch CHAPTER 11. MANAGING CATALOGS Creating a User Catalog Assign a Name and Volume Save the Catalog Altering a User Catalog Choose the Catalog Change the Security Change the Purge Attributes Save the Catalog Dropping a User Catalog Choose the Catalog Drop the Catalog Upgrading a Catalog Choose the Catalog Upgrade the Catalog CHAPTER 12. MANAGING TABLES Creating a Table Assign Name and Location Assign Security Choose the Table Organization dba/m Database Manager V7.1 User's Guide xi

12 Define File Attributes Choose Table Format Choose Partition Array: Add Columns Change Column Attributes Delete Columns Change Column Sequence Creating Table Partitions Creating Table Constraints Save the Table Altering a Table Choose a Table Display Dependencies Change File Attributes Choose Table Format Choose Partition Array: Change Security Add Columns Dropping a Table Choose the Table Display Dependencies Drop the Table Renaming a Table Choose a Table Display Dependencies Enter the New Name Rename the Table Managing Table Constraints Adding Constraints Modifying Constraints Dropping Constraints Managing Constraint Comments Managing Help Text Choose the Column Add, Change, or Delete Help Text Save the Help Text Managing Table Comments Choose a Table Add, Change, or Delete Table Comments Save the Table Comment Managing Column Comments Choose the Column Add, Change, or Delete the Column Comment Save the Column Comment xii Contents

13 Managing Table Statistics Choose the Tables Display the Statistics Display Dependencies Update the Statistics Invoking a Table Choose a Table Set Invoke Options Specify Output-File Attributes Invoke the Table Display the Output Recreating Tables CHAPTER 13. MANAGING VIEWS Creating a View Assign Name and Location Choose the Type of View Assign a Security Choose a Base Table Display Indexes on Base Tables Add Columns Delete Columns Insert Columns Change Column Attributes Add, Change, or Delete a WHERE Clause Save the View Altering a View Choose the View Display Dependencies Change the Column Heading Change Security Change Similarity Check Save the View Dropping a View Choose the View Display Dependencies Drop the View Invoke View Choose the View Recreate the View Create Like Choose the View Display Dependencies Create New View dba/m Database Manager V7.1 User's Guide xiii

14 Save New View Renaming a View Choose the View Display Dependencies Change the Name Save the View Managing Help Text Choose the View Choose the Column Add, Change, or Delete Help Text Save the Help Text Managing View Comments Choose the View Add, Change, or Delete Comment Save the View Comment Managing Column Comments Choose the Columns Add, Change, or Delete Comment Save the Column Comment Invoking a View Choose a View Set Invocation Options Specify Output-File Attributes Invoke the View Display the Output CHAPTER 14. MANAGING INDEXES Creating an Index Assign Name and Location Choose the Table Assign Index Columns Assign File Attributes Choose Index Format Assign Additional Attributes Save the Index Altering an Index Choose an Index Display Dependencies Change Security Change File Attributes Partitions Choose Index Format Save the Index xiv Contents

15 Dropping an Index Choose an Index Display Dependencies Drop the Index Renaming an Index Choose an Index Display Dependencies Assign the New Name Managing Index Comments Choose an Index Add, Change, or Delete Index Comments Save the Index Comment Viewing Index Statistics CHAPTER 15. MANAGING TABLE PARTITIONS Designing Table Partitions Choose Base Table Choose Table Partition Choose Partonly Manual Design Auto Design Manual Design Automatic Design Display Dependencies View Partitions Choose Base Table Assign Sample Rate Compute Row Distribution Adding Partitions Assign the Number of Partitions Assign Volumes Assign Catalogs Assign File Attributes Display Dependencies Add the Partitions Altering Partitions Display Dependencies Alter the Partitions Drop Partitions Choose Partition: Display Dependencies Drop the Partitions Perform a Simple Move dba/m Database Manager V7.1 User's Guide xv

16 Choose a Table Select the Partition Assign Name and Location Assign File Attributes Display Dependencies Move the Partition Performing a One-Way Split Choose Table Assign Name and Location Assign File Attributes Display Dependencies Move the Partition Performing a Two-Way Split Choose Table Assign Names and Locations Assign File Attributes Assign Primary-Key Values Display Dependencies Move the Partition CHAPTER 16. MANAGING ENSCRIBE Designing Enscribe Partitions Choose Enscribe Table Auto Design Monitor Enscribe Partitions CHAPTER 17. MANAGING INDEX PARTITIONS Designing Index Partitions Choose Base Index Choose Index Partition Choose Partonly Manual Design Auto Design Manual Design Automatic Design Display Dependencies View Partitions Choose Index Assign Sample Rate Compute Row Distribution Adding Partitions Assign the Number of Partitions Assign Volumes xvi Contents

17 Assign Catalogs Assign File Attributes Display Dependencies Add the Partitions Altering Partitions Display Dependencies Alter the Partitions Drop Partitions Choose Partition: Display Dependencies Drop the Partitions Perform a Simple Move Choose a Index Select the Partition Assign Name and Location Assign File Attributes Display Dependencies Move the Partition Performing a One-Way Split Choose Index Assign Name and Location Assign File Format Assign File Attributes Display Dependencies Move the Partition Performing a Two-Way Split Choose Index Assign Names and Locations Assign File Attributes Assign Primary-Key Values Display Dependencies Move the Partition CHAPTER 18. MANAGING PROGRAMS Altering a Program Choose a Program Change the Security Save the Program Dropping a Program Choose a Program Drop the Program Compiling a Program Compiling Old Programs Compiling New Programs dba/m Database Manager V7.1 User's Guide xvii

18 Copy or Move Programs Choose Programs Define the Target Location Choose the Copy or Move Operation Choose Compiler Options Assign Catalog Perform the Copy or Move Renaming Programs Choose the Program Enter the Name Save the Program Name xviii Contents

19 PART I: USING dba/m Database Manager Part I is organized as follows: Chapter 1, Invoking dba/m Database Manager. Describes how to log on to and off of dba/m Database Manager. Chapter 2, Using the Main Window. Describes the dba/m Database Manager command buttons and menu buttons. Chapter 3, Using the Object Tree. Describes the Object Tree and explains how to display nodes, volumes, and objects in the Object Tree. Describes how perform database administration functions using the Object Tree. Chapter 4, Managing dba/m Database Manager Profiles. Describes the procedures for managing user profiles, map defines, and customization of object trees. Chapter 5, Executing Commands. Describes the use of SaveCmd, RetrieveCmd, Show, Execute, Queue, and Error buttons that are available in and from almost all dba/m Database Manager windows. For information on managing database operations such as monitoring diskspace usage, batch executions, or query performance, refer to Part II, Managing Database Operations. For information on managing catalogs, tables, views, indexes, partitions, and programs, refer to Part III, Managing SQL Objects. dba/m Database Manager V7.1 User's Guide iii

20

21 CHAPTER 1. INVOKING dba/m Database Manager To invoke dba/m Database Manager, double-click on the dba/m Database Manager icon in the DBAM program group. To perform any dba/m Database Manager functions, you must establish a session with the HP Nonstop SQL/MP database. Logging On When you invoke dba/m Database Manager, the Logon window is displayed, as shown in Figure 1-1. To establish a session Figure 1-1. Logon Window. dba/m Database Manager V7.1 User's Guide

22 1. In the User ID field, enter your Guardian user ID in the format <usergroup>.<username>. 2. In the Password field, enter your password. Asterisks are displayed as you type, instead of the actual password. 3. Choose a refresh mode by clicking on one of the following buttons: Refresh: dba/m Database Manager retrieves SQL-object information stored on the Tandem node. The refresh operation might take a long time, based on the number of objects on the node. NoRefresh: dba/m Database Manager retrieves SQL-object information from files stored on the workstation. When you log on for the first time, SQL-object information is retrieved from the node regardless of which button you choose. 4. Click OK to establish a dba/m Database Manager session. If you typed your user ID or password incorrectly, a message appears indicating that you entered an invalid username or password. Click OK, then repeat steps 1 through 3 to establish a dba/m Database Manager session. After validating your name and password, dba/m Database Manager loads all information about the SQL objects in your environment. The progress of the loading is displayed, as shown in Figure 1-2. This window provides an inventory of all SQL objects in your environment. The time required to load the object information depends on the number of objects stored on the node. When the loading is complete, you can use dba/m s database-management tools. 1-2 Invoking dba/m Database Manager

23 Figure 1-2. Loading Object Tree Window Deleted: 1 Setting When user click on Setting button Setting window will appear as shown below. dba/m Database Manager V7.1 User's Guide

24 Figure 1-3 Logon Settings Window Deleted: 1 User can enter following information as a part of settings User Information Setting 1. IP Address. Enter IP-Address of system. 2. Port. Enter Port on which Dba/m pathway servers are configured. 3. Reply buffer size. Enter reply buffer size. 4. Batch Retention Time. Enter Batch Retention time. 5. Monitor Polling time. Enter Monitor Polling time interval here. Notifier Information 1. id. Enter default user id 2. Password. Enter password here. 3. Port. Enter port number here. Click on Update to update this information. Click on Close to close this window. 1-4 Invoking dba/m Database Manager

25 Logging Off (Exit) To end a dba/m Database Manager session, click on Exit at the top left corner of the Main window. When you log off, the following events occur: If you are monitoring disk-space usage, the monitor process ends. If you are working within an active transaction, you are asked to abort (roll back) or end (commit) the transaction. Refer to Chapter 6, Managing Transactions, for more information. All batches are executed as scheduled. Licensing Issues Trial version expires after one month of installation. After expiring, logon fails with following message Figure 1-4 Evaluation Copy License expire message. If user gets above message, user needs to buy dba/m and get license key from HP Order Desk. After getting new license, user needs to enter it in following window. Figure 1-5 Dbam License Key window. dba/m Database Manager V7.1 User's Guide

26 1-6 Invoking dba/m Database Manager

27 CHAPTER 2. USING THE MAIN WINDOW When you successfully establish a session, dba/m s Main window is displayed, as shown in Figure 2-1. The Main window has two sets of buttons: Command buttons, displayed across the top of the window Menu buttons, displayed down the left side of the window Figure 2-1 dba/m Database Manager Main Window. Using dba/m Database Manager Commands Command buttons are displayed across the top of the Main window. When you click on these buttons, they do the following: Exit. Ends the current dba/m Database Manager session. Object Tree. Displays the Object Tree, a graphical representation of all SQL objects. You perform most database administration functions from the Object Tree. Refer to Chapter 3, Using the Object Tree, for detailed instructions. dba/m Database Manager V7.1 User's Guide

28 Custom Tree. Displays a customized version of the Object Tree. You may perform most of the database administration functions on the objects in the Custom Tree from this display. Refer to Chapter 3, Using the Object Tree, for detailed instructions. DirectCmd. Displays a window that allows you to enter and execute most of the commands processed by Tandem s SQLCI utility. CreateBatch. Submits commands generated by dba/m Database Manager as batches. Refer to Chapter 10, Managing Items and Batches, for detailed instructions. ViewBatch. Displays the results of previously executed batch commands. You can display the batch status and the results of completed batch jobs. Refer to Chapter 10, Managing Items and Batches, for detailed instructions. Monitor. Manages the monitoring of disk space used by SQL objects. Refer to Chapter 6, Monitoring Disk-Space Usage, for detailed instructions. Alarm. When disk-space thresholds are exceeded by objects that you are monitoring, the Alarm command button changes from dark yellow to red. Click on this command button for detailed information about the alarms. Refer to Chapter 6, Monitoring Disk- Space Usage, for detailed instructions. Volumes. Displays the amount of disk space used by volumes in all nodes in your environment. Refer to Chapter 6, Monitoring Disk- Space Usage, for detailed instructions. Cmd History. Displays the audit trail of actions that were performed using dba/m Database Manager. Refer to Chapter 9, Auditing Command Execution, for detailed instructions. Error. Displays the details of SQL error codes. Detailed instructions are described in this chapter. Find. Finds objects in the database. Detailed instructions are described in this chapter. Error Button Use the Error command button in the Main window to display the explanation for error codes returned by NonStop SQL. 2-2 Using the Main Window

29 When you click on Error, the Error window is displayed, as shown in Figure 2-2. Figure 2-2. Error Message Window. Use the Error Code Input pane to get detailed information on error codes. To get an explanation of your error code 1. Enter the error code in the Error Number field. 2. Choose the source of Tandem Subsystem reporting the error by clicking on one of the buttons in the Error Type pane at the top of the window. SQL, for NonStop SQL FS, for file system SORT, for sort function DP, for disk process OS, for operating system SIO, for serial I/O subsystem 3. Choose the output level you want by clicking on either Detail or Brief in the Listing Type pane. 4. Click OK. The explanation for the error is displayed. dba/m Database Manager V7.1 User's Guide

30 Find Button Use the Find command button in the Main window to find the object in the database. This is usual find menu item as shown in Figure below 2.3. Press Help button for getting help on this item. Figure 2-3. Find Pane. Using the dba/m Database Manager Menu dba/m Database Manager menu buttons are located on the left side of the dba/m Database Manager Main window. Clicking on menu buttons displays additional menu buttons from which you can access functional windows. The menu buttons and what they do are described as follows: File. This is usual File Menu button having following options. 1. Find. This is used for finding object in database. 2. PrintForm. This is used for printing form. 3. PrintSetup. This is for usual printer setup. 4. Logoff. Logoffs present dba/m session. 5. Exit. Exits present dba/m session. 2-4 Using the Main Window

31 Custom Tress.. Displays a customized version of the Object Tree. You may perform most of the database administration functions on the objects in the Custom Tree from this display. User can create multiple custom trees. Refer to Chapter 3, Using the Object Tree, for detailed instructions. Catalogs. Displays catalog-management menu buttons that allow you to create, alter, drop, and upgrade catalogs. Refer to Chapter 11, Managing Catalogs, for detailed instructions. Tables. Displays table-management menu buttons that you can use to create, alter, drop, tables, and more. Refer to Chapter 12, Managing Tables, for detailed instructions. Views. Displays view-management menu buttons that you can use to create, alter, drop, and rename views, and more. Refer to Chapter 13, Managing Views, for detailed instructions. Indexes. Displays index-management menu buttons that you can use to create, alter, drop, and rename indexes, and more. Refer to Chapter 14, Managing Indexes, for detailed instructions. Programs. Displays program-management menu buttons that you can use to alter, drop, compile, copy, move, and rename programs. Refer to Chapter 17, Managing Programs, for detailed instructions. Table Partitions. Displays table partition-management buttons that you can use to design, view, add, alter, drop, and move table partitions. Refer to Chapter 15, Managing Table Partitions, for detailed instructions. Index Partitions. Displays index partition-management buttons that you can use to design, view, add, alter, drop, and move index partitions. Refer to Chapter 16, Managing Index Partitions, for detailed instructions. QueryAnalysis. Analyzes the performance of ad hoc queries or queries used in existing programs. Refer to Chapter 7, Analyzing and Tuning Query Performance, for detailed instructions Data. Manages stored data. You can query the data, copy data between tables and files, or load data between tables and files. Refer to Chapter 8, Managing Data, for detailed instructions. dba/m Database Manager V7.1 User's Guide

32

33 CHAPTER 3. USING THE OBJECT TREE When you log on to dba/m Database Manager for the first time, all SQL Objects in your environment are retrieved from the Nonstop SQL/MP database and stored on the client in the form of an Object Tree. To display the Object Tree, click on Object Tree in the Main window. The Object Tree consists of A graphic representation of nodes with their volumes and database objects such as catalogs, tables, views, indexes, partitions, and programs. An example of the Object Tree is shown in Figure 3-1. A list of the names of tables, views, indexes, partitions, and programs within a catalog. For example, clicking on the Tables icon in the Object Tree displays a list of table names within the parent catalog, as shown in Figure 3-1. Figure 3-1. Object Tree. dba/m Database Manager V7.1 User's Guide

34 Figure 3-2. Table Names in the Object Tree. Displaying Items in the Object Tree You can display all of the volumes in a node, catalogs in a volume, or objects in a catalog. You can also erase the display of all volumes, catalogs, or objects. Volumes If the volumes in a node are not displayed double click on the Node icon to view all of the volumes in the node. To erase the display of the volumes, double click on the Node icon. The icon for the Non Audited volumes is shown with Red background, icon for Audited volumes is shown with Grey background, icon for SMF volumes is shown with Green background and the one with mirrored volumes is shown in Grey background with blue shade. Catalogs If the catalogs in a volume are not displayed, double-click on the Volumes icon to view all of the catalogs. To erase the display of the catalogs, double-click on the Volumes icon. 3-2 Using the Object Tree

35 Tables If the tables in a catalog are not displayed, click on the Tables icon under the catalog icon. The names of all the tables in the catalog are displayed in tabular form, as shown in Figure 3-2. To erase the display of all table names, click on the volume or catalog icon. Views If the views in a catalog are not displayed, click on the Views icon under the catalog icon. The names of all the views in the catalog are displayed in tabular form. Partitions If the partitions in a catalog are not displayed, click on the Partitions icon under the catalog icon. The names of the partitions in the catalog are displayed in tabular form. Indexes If the indexes in a catalog are not displayed, click on the Indexes icon under the catalog icon. The names of the indexes in the catalog are displayed in tabular form. Programs If the programs in a catalog are not displayed, click on the Programs icon under the catalog icon. The names of the programs in the catalog are displayed in tabular form. Working with Objects You can perform the following tasks in the Object Tree: Manage catalogs, tables, views, indexes, partitions and programs, for example move or alter a table. Refresh objects in the Object Tree by retrieving the objects from the node. dba/m Database Manager V7.1 User's Guide

36 Monitor disk-space use of volumes, tables, indexes, and partitions. You must select an object before you can work with it. To select an object, click on the object icons for nodes, volumes, and catalogs as shown in Figure 3-1. When an object icon is selected, the background color is blue. For tables, views, indexes, and programs, you must click on the name of the object shown in the tabular field, as shown in Figure 3-2 Refresh Nodes When you log on to dba/m Database Manager, you can refresh the entire Object Tree. Once logged on, you can refresh volumes within a node, and all of the objects in the volumes. This operation might take a long time, depending on the number of objects on the node and the processing load on the node. To refresh the objects in a node, 1. Right click on the Node icon. The Refresh button is highlighted in the Object window. 2. Click on Refresh to refresh the objects from all volumes in the node and update the Object Tree. When the refresh operation is completed, a completion message is displayed. Manage Volumes You can refresh the objects in the volume or monitor the volume s diskspace usage. Right click on the Volumes icon in the Object Tree. The Refresh and Monitor buttons are highlighted in the Object Tree. Click on one of the following: To retrieve the objects from the volume and update the Object Tree, click on Refresh. When the refresh operation is completed, a completion message is displayed. This operation may take a long time depending on the number of objects in the volume and the processing load on the server. To monitor the volume s disk-space usage, click on Monitor in the Main window. The Object Monitoring window is displayed. Refer to Chapter 6, Monitoring Disk-Space Usage, for more information. 3-4 Using the Object Tree

37 Manage Catalogs You can refresh catalogs in the Object tree, or you can perform catalogmanagement functions such as alter, create, alter, drop, and upgrade catalogs. If the catalog is not already selected, click on the Catalog icon in the Object Tree. The following buttons in the Object window are highlighted: Refresh, Create, Alter, Drop and Upgrade. Perform one of the following: To retrieve the objects from the catalog and update the Object Tree, click on Refresh. When the refresh operation is completed, a completion message is displayed. This operation may take a long time depending on the number of objects in the catalog and the processing load on the node. To perform any catalog-management function, click on the appropriate button at the bottom of the window. Refer to Chapter 11, Managing Catalogs, for more information. Manage Tables You can monitor disk-space usage of a table, or perform table-management functions such as create, alter, drop, move, rename, statistics, invoke, help text, table comments, column comments. 1. If the Table icon under the Catalog icon which contains the table is not already selected, click on the Table icon. The names of all of the tables in the catalog are displayed. 2. Select one of the table and right click on it, and the following buttons in the Object window are highlighted: Monitor, Create, Alter, Drop, Move, Rename, Statistics, Invoke, Help Text, Table Comments, and Column Comments. 3. Click on one of the following: To monitor the table s disk-space usage, click on the Monitor button. The Object Monitoring window is displayed. Refer to Chapter 6, Monitoring Disk-Space Usage, for more information. To perform any table-management function, click on the appropriate button at the bottom of the window. Refer to Chapter 12, Managing Tables, for more information. dba/m Database Manager V7.1 User's Guide

38 Manage Views Using the Object Tree, you can perform all view-management functions such as create, alter, drop, invoke, or rename a view. You can also add, change, or delete help text, view comments, and column comments for a view. 1. If the View icon under the Catalog icon that contains the view is not already selected, click on the View icon. The names of all views in the catalog are displayed. 2. Select one of the view and right click on it, and the following buttons are highlighted in the Object window: Create, Alter, Drop, Invoke, Rename, Help Text, View Comments, Column Comments. 3. Click on the appropriate button at the bottom of the window to perform any view-management function. Refer to Chapter 13, Managing Views, for information on the view-management windows. Manage Indexes You can refresh or monitor disk-space usage of an index, or perform index-management functions such as create, alter, drop, move, view statistics, or rename. You can also add, change, or delete comments for an index. 1. If the Index icon under the Catalog icon that contains the index is not already selected, click on the Index icon. The names of all of the indexes in the catalog are displayed. 2. Select one of the index and right click on it, and the following buttons in the Object window are highlighted: Refresh, Monitor, Create, Alter, Drop, Move, Rename, Statistics, Index Comments. 3. Click on one of the following: To monitor the index s disk-space usage, click on Monitor. The Object Monitoring window is displayed. Refer to Chapter 8, Monitoring Disk-Space Usage, for more information. To perform any index-management function, click on the appropriate button at the bottom of the Object window. Refer to Chapter 14, Managing Indexes, for more information. 3-6 Using the Object Tree

39 Manage Programs Using the Object Tree, you can perform the program management functions such as alter, drop, compile, rename, copy, or move a program. 1. If the Program icon under the Catalog icon that contains the program is not already selected, click on the Program icon. The names of the programs in the catalog are displayed. 2. Select one of the program and right click on it, and the following buttons are highlighted in the Object window: Alter, Drop, Compile, Rename, Copy/Move. 3. Click on the appropriate button at the bottom of the window to perform any program-management function. Refer to Chapter 17, Managing Programs, for information on the program-management windows. Manage Partitions You can monitor disk-space usage of a partition as follows: 1. If the Partition icon under the Catalog icon that contains the program is not already selected, click on the Partition icon. The names of the programs in the catalog are displayed. 2. To monitor the partition s disk-space usage, click on Monitor. The Object Monitoring window is displayed. Refer to Chapter 6, Monitoring Disk-Space Usage, for more information. Customizing the Object Tree You can create a custom version of the Object Tree that displays a subset of the objects displayed in the Object Tree. After you have created the Custom Tree, you can click on Custom Tree to display the objects you chose for the Custom Tree. You can perform all of the tasks on the Custom Tree that you can on the standard Object Tree. To create a Custom Tree, click on Custom Trees in the Main window, then click on the Open button. The Tree Selection window is displayed, as shown in Figure 3-3. dba/m Database Manager V7.1 User's Guide

40 Figure 3-3. Custom Tree Selection Option Window To create a new custom tree select option, Create New Custom Tree, and click OK command button. The Custom Tree Selection Window is displayed as shown in Figure 3-4. Figure 3-4. Custom Tree Selection Window Add an Object To add an object to your Custom Tree 1. Click on the custom Trees, Then Click on Open. 2. Custom Tree Selection window will appear. 3. Select existing custom tree if any or Select create new custom tree and click Ok. 4. Click on the object you want to add in custom tree. 3-8 Using the Object Tree

41 5. Repeat Step 1 to include additional objects in the Custom Tree. 6. Click on Save button in custom Trees menu to save custom tree. Delete custom tree To delete custom tree Click on delete button in Custom Trees. dba/m Database Manager V7.1 User's Guide

42

43 CHAPTER 4. MANAGING dba/m Database Manager PROFILES For ease of use, dba/m Database Manager provides windows for super users to manage dba/m Database Manager configurations. A super user is any user with a group ID of SUPER. If you log on to dba/m Database Manager as a super user, you can add or delete nodes change dba/m Database Manager profile add or delete users change user profile defaults add and delete nodes assigned to users If you log on to dba/m Database Manager as any other user, you only can change your profile default values You can access the profile management windows from the Profile menu in the Main window. Profile Menu The dba/m Database Manager profile menu has 4 menu-items 1. Options. This menu-item allows to set different dba/m options. 2. SQl Inventory. This menu-item displays present SQL Inventory. 3. DefaultLogon. This menu-item allows user to set default logon options. dba/m Database Manager V7.1 User's Guide

44 Managing the dba/m Database Manager Profile The dba/m Database Manager profile contains configuration parameters. Use the dba/m Database Manager Profile window to change the dba/m Database Manager profile and add or delete nodes. You must be a super user to access the dba/m Database Manager Profile window. To display the dba/m Database Manager Profile window, click on Profile in the Main window, then click on Options. The dba/m Database Manager Profile window is displayed, as shown in Figure 4-1. Figure 4-1. dba/m Database Manager Profile Window. Change dba/m Database Manager Profile You can change only the SQL Operation Cost in the System. The other attributes in this pane cannot be changed. If the cost to perform an SQL operation is greater than the value you specify, the user performing the operation is warned that the actual cost is higher than the maximum cost allowed. This capability is available only if queries are performed under dba/m Database Manager control. Use the dba/m Database Manager Profile window as shown in figure 4-1 to change the maximum cost for an SQL operation. 4-2 Managing dba/m Profiles

45 1. Click on Change Profile at the bottom of the Profile window. 2. Enter a value in the SQL Operation Cost field. 3. Click OK. Add Nodes You can add nodes to dba/m Database Manager using the System Profile Attributes pane, shown in Figure 4-1. The primary node is the node on which dba/m Database Manager was installed. The new node is accessible from the dba/m Database Manager primary node. 1. Click on Add Node at the bottom of the Profile window. 2. Enter the name of the node in the Node Name field. 3. Enter the name of the system catalog for this node in the System Catalog field. 4. Click OK. Delete Nodes You can delete nodes to dba/m Database Manager using the Node Attribute pane as shown in Figure Click on Delete Node at the bottom of the Profile window. 2. Click on the drop-down list in the Node name field to display all nodes. Double-click on the name of the node you want to delete. 3. Click OK. Managing User Profiles Use the User Profile tab to add, change or delete user profiles. Add Users You must log on to dba/m Database Manager as super user to add users. To display the User Profile window, click on Profile in the Main window, then click on User Profile. The User Profile window is displayed, as shown in Figure 4-2. dba/m Database Manager V7.1 User's Guide

46 Figure 4-2. User Profile Window. To add a user 1. In the Mode pane at the bottom of the User Profile window, click on Add. 2. In the Guardian UserID field, enter the user s user-group name and user name in the format <usergroupname>.<username>. 3. In the Default Volume.Subvolume field, enter the user s default volume and subvolume in the format <$volumename>.<subvolumename>. 4. In the Default Catalog field, enter the user s default catalog in the format <\nodename>.<$volumename>.<catalogname>. 5. Place the cursor in the next available empty row in the Nodes field. 6. Enter the name of the node which the new user can access. 7. Repeat Steps 5 and 6 to add other nodes. 8. When you have filled in all of the fields in the User Profile window, click OK to add the user to dba/m Database Manager. 4-4 Managing dba/m Profiles

47 Change Users You must be logged on to dba/m Database Manager as a super user to modify a user profile other than your own, or to add or delete entries in the Nodes field. To display the User Profile window, click on Profile in the Main window, then click on User. The User Profile window is displayed, as shown in Figure 4-2. To change a user profile 1. In the Mode pane at the bottom of the User Profile window, click on Change. 2. If you are not a super user, the Guardian UserID is set to your user identifier and you cannot change it. If you are the super user, you have two ways to enter user identifiers: Enter the user-group name and user name in the Guardian UserID field, in the format <usergroupname>.<username>. Choose the user from the drop-down list in the Guardian UserID field. 3. To change the default volume and subvolume, enter new volume and subvolume names in the Default Volume.Subvolume field, in the format <$volumename>.<subvolumename>. 4. To change the default catalog, enter the new catalog name in the Default Catalog field, in the format <\nodename>.<$volumename>.<catalogname>. 5. To add a node, place the cursor in the next available row in the Node field and type in a node name. 6. To delete a node, place the cursor in the row containing the name in the Node field and delete the node name. 7. When you are finished changing the user profile, click OK to change the user s profile. The next time the user logs on to dba/m Database Manager, the new attributes will take affect. Delete Users You must log on to dba/m Database Manager as a super user to add users. To display the User Profile window, click on Profile in the Main window, dba/m Database Manager V7.1 User's Guide

48 then click on User. The User Profile window is displayed, as shown in Figure 4-2. To delete a user 1. In the Mode pane at the bottom of the User Profile window, click on Delete. 2. Use one of the following methods to choose a user: Enter the user-group name and user name in the Guardian UserID field, in the format <usergroupname>.<username>. Choose the user from the drop-down list in the Guardian UserID field. 3. To delete the user, click OK. Volume Use the Volume tab of Profile window to get information about the present disk volume usage. Figure 4-3. Volume window. 4-6 Managing dba/m Profiles

49 Display Attributes Use the Volume tab of profile window to get the present disk volume usage. In Display attribute there are 4 option buttons. 1. Space used. This will show space used by each disk volume. 2. Space Free. This will show available space for each disk volume 3. Used/Free. This will show used as well as free space. 4. % Free. This will show % Free space for each disk volume. Display Order Display Order has 3 option buttons 1. Volume Name. It displays disk volume name. 2. Ascending. This will display volumes in ascending order. 3. Descending. This will display volumes in ascending order Notifier User Notifier Tab of Profile window to get Notifier window. Notifier can be used to send information or page to the concerned person working with database. To get Notifier window Click Profile on main menu, Click options and then click on Notifier Tab. Notifer window will appear as shown below in figure Figure 4-4 dba/m Database Manager V7.1 User's Guide

50 Figure 4-4. Notifier window. information. information has username and ed. You can add this to list by clicking option button Add to TO list(this is default). You can add this to CC list by clicking option button Add to CC list. Pager Information. Pager number can be added in textbox Pager Number. Page me Anytime is default. User can enter start time and End time. Notification Interval. User can set notification interval by entering values in textbox hour and minutes. 4-8 Managing dba/m Profiles

51 Add, Edit, Remove User. User can Add, Edit or Remove notifier by using Add, Edit or Delete buttons respectively. SQL Inventory This will give SQL Inventory at the present time. Click on Profile in the main window and then click on SQL_Inventory to get SQL Inventory display as shown in Figure below 4.5 Figure 4-5. SQL Inventory Default Logon To set default logon use Default Logon screen. 1. Click on Profile dba/m Database Manager V7.1 User's Guide

52 2. Click on DefaultLogon. DefaultLogon screen will appear as shown below 3. Enter username and password 4. Click on Update 5. Click on Ok. Figure 4-6. Default Logon Map Defines Use the Map Defines window shown in Figure 4-7 to add, change, or delete map defines. To display Map Defines window, 1. Click on Query Analysis in Main window 2. Click on Adhoc Query 3. On Adhoc Query window, click on Define command button Managing dba/m Profiles

53 Figure 4-7. Map Defines window. Add Map Defines Use the Map Define window to add map defines. To display the Map Defines window, click on Query Analysis in the Main window, then click on Adhoc Query. Then Click on Query_Analysis. Query Analysis window will appear. Click on Define button get Define window. The Map Define window is displayed, as shown in Figure In the Mode pane at the bottom of the Map Defines window, click option button Add. The cursor is placed in the next available Define Name field. Refer to Figure 4-7 for the location of the Mode pane and the Define Name fields. 2. In the Define Name field, enter the name of the new map define. 3. In the File Name field, enter the define file name in the format <\nodename>.<$volumename>.<subvolumename>.<filename>. 4. Repeat steps 2 and 3 to add more map defines. 5. To save the map defines for the current session, click Execute Cmd. dba/m Database Manager V7.1 User's Guide

54 Change Map Defines You can change only the to the map define. click on Query Analysis in the Main window, then click on Adhoc Query. Then Click on Query_Analysis. Query Analysis window will appear. Click on Define button get Define window The Map Define window is displayed, as shown in Figure 4-7. To change the file name 1. In the Mode pane at the bottom of the Map Defines window, click on Change. 2. In the Define Name field, click on the name of the map define. 3. In the File Name field, edit the name of the corresponding file. The changed map define is indicated by a checkmark in the row header. 4. Repeat steps 2 and 3 to change any other map defines. 5. To change the map defines, click Execute Cmd. Delete Defines To display the Map Defines window. click on Query Analysis in the Main window, then click on Adhoc Query. Then Click on Query_Analysis. Query Analysis window will appear. Click on Define button get Define window. The Map Define window is displayed, as shown in Figure 4-7. To delete a map define 1. In the Mode pane at the bottom of the Map Defines window, click option button Delete. 2. In the Define Name field, click on the row header of the map define that you want to delete. An X is displayed in the row header, indicating that the map define will be deleted. 3. Repeat step 2 to choose additional map defines for deletion. To delete the selected map defines, click Execute Cmd 4-12 Managing dba/m Profiles

55 dba/m Database Manager V7.1 User's Guide

56

57 CHAPTER 5. USING dba/m Database Manager COMMANDS When you work with the object management windows described in this manual, dba/m Database Manager generates commands to perform the functions you request. You can view, save, execute and queue commands. You can retrieve save commands to execute or queue items. These operations are executed by clicking on the corresponding button, as follows: SaveCommand saves the command so that you can use it later. Show allows you to display the commands that are generated to perform an SQL operation. Execute executes the SQL commands to perform an on-line database-management task. Queue stores SQL commands so that you can create a batch from the queued commands. RetrieveCmd allows you to retrieve a set of commands you saved using SaveCommand, and execute them. These command operations are described in this chapter and used throughout this manual. Saving Commands You can save commands in three windows: Show, Direct Command, and Adhoc Query Analysis. Save the SQL commands by clicking on SaveCommand in these windows. When you click on Save Command, the Save Command As pane is displayed, as shown in Figure 5-1. To save a command 1. In the Directories field, click on the directory in which you want to store the commands. 2. In the File Name field, type in a file name for the commands. dba/m Database Manager V7.1 User's Guide

58 3. To save the command, click OK. To cancel the save command, click Cancel. Note: Refer to your Windows documentation for more information on how to use this window. Figure 5-1. Save Command As Pane. Displaying Commands To view the SQL commands generated by dba/m Database Manager, click on Show in the window in which you are working. The SQL Command window is displayed, as shown in Figure 5-2. Click Close to exit from the SQL Command window. 5-2 Using dba/m Database Manager Commands

59 Figure 5-2. SQL Command Window. Executing Commands To execute the SQL commands generated by dba/m Database Manager, click on Execute. To execute the command, click OK. The commands shown in the window are executed immediately on the node. You cannot perform any other tasks on the client while the SQL commands are being executed. When the commands have been executed, a message is displayed indicating whether the commands failed or succeeded. To cancel a command, click Cancel. dba/m Database Manager V7.1 User's Guide

60 Queuing Commands You can queue SQL commands generated by dba/m Database Manager by clicking on Queue. The Quick Batch window is displayed, as shown in Figure 7-3. You can either execute the command immediately, or you can queue it for execution at a later time. Figure 5-3. Queue Batch Window. To submit the command for immediate execution 1. Enter the name of the command in the Queue Command Name pane 2. Click on Submit. To execute the command later 1. Enter the name of the command in the Queue Command Name pane 5-4 Using dba/m Database Manager Commands

61 2. Click on Queue. NOTE: You can change the name of the queue command by entering a new name in the Queue Command Name pane. You can change the parameters of the queue command in the Batch Parameter pane. Retrieving Commands Use the RetrieveCmd command button in the Direct Command or the Adhoc Query Analysis windows to retrieve SQL commands you saved using the SaveCommand button. When you click on RetrieveCmd, the Retrieve Command window is displayed, as shown in Figure 5-4. To retrieve a command 1. In the Directories field, choose the directory in which you stored the commands. 2. In the File Name field, click on or type the name of the file containing the commands, and click OK. 3. To cancel the retrieve command, click Cancel. Note: Refer to your Windows documentation for more information on how to use this window. Figure 5-4. Retrieve Command Window. The commands stored in the file are retrieved into the window. You may perform all operations pertaining to the window on the retrieved commands. dba/m Database Manager V7.1 User's Guide

62 5-6 Using dba/m Database Manager Commands

63 PART II: MANAGING DATABASE OPERATIONS The chapters in Part II explain how to use dba/m Database Manager to perform higher-level management tasks, such as monitoring disk-space usage, analyzing and tuning query performance, and creating and scheduling batches. Part II is organized as follows: Chapter 6, Monitoring Space Usage. Describes how to display disk space used by volume. Includes procedures for monitoring objects, setting alarm thresholds, and displaying alarms. Chapter 7, Analyzing and Tuning Query Performance. Provides procedures for analyzing ad hoc queries or queries in programs, and tuning queries using table, column, and index statistics. Chapter 8, Managing Data. Explains how to query, copy, and move data stored in tables. Chapter 9, Auditing dba/m Database Manager Activities. Provides instructions on displaying a history of commands executed by users of dba/m Database Manager. Chapter 10, Managing Jobs and Batches. Defines jobs and batches. Describes how to create and schedule batch jobs, and how to monitor the execution of batch jobs. For information on using dba/m Database Manager features, such as the Object Tree, Custom Tree, System and User Profile, refer to Part I, Using dba/m Database Manager. For information on managing catalogs, tables, views, indexes, and programs, refer to Part III, Managing SQL Objects. dba/m Database Manager V7.1 User's Guide

64

65 CHAPTER 6. MONITORING DISK-SPACE USAGE Using dba/m Manager, you can monitor disk-space usage by volumes, tables, indexes, or partitions. When monitoring disk-space usage, you can set alarm thresholds. If disk-space usage exceeds the thresholds you set, dba/m Database Manager generates audible and visual alarms to notify you. Displaying Volume Usage You can display a volume s total disk space, amount of space used, amount of free space available, and percentage of free space available. You can display disk-space usage for any volume in any node in your environment. To display volume usage, click on Volumes Information in the Main window. The Disk Volumes window is displayed, as shown in Figure 6-1. Figure 6-1. Disk Volumes Window. dba/m Database Manager V7.1 User's Guide

66 Customizing the Volume Display You can display the amount of used disk space, free disk space, the combination of free and used disk space, or the percentage of free space. You can also display the volumes in ascending order of their names or in ascending or descending order by one of the attributes selected for display. Use the Display Attribute and Display Order panes to choose the display attributes and order you want, as shown in Figure 6-2. Figure 6-2. Display Attribute and Display Order Panes. To customize the volume display 1. In the Display Attribute pane, click on one of the following: Used Space. Displays the amount of used disk space. Free Space. Displays the amount of free disk space. Used v/s FreeSpace. Displays the amount of used disk space and free disk space. Percent Free Space. Displays the percentage of free disk space. 2. In the Display Order pane, click on one of the following: By Volume Name. Displays volumes by name. Ascending. Displays volumes in ascending order of the attribute you chose in step 1. Descending. Displays volumes in descending order of the attribute you chose in step 1. Monitoring Objects You can monitor disk space used by objects such as disk volumes, tables, partitions, and indexes. 6-2 Monitoring Disk Space Usage

67 Choosing Objects To choose the objects to monitor, use the Object Tree window, as shown in Figure 6-3. To display the Object Tree window, click on Object Tree in the Main window. Figure 6-3. Object Tree Window. Choose Volumes To choose volumes to monitor 1. If the volume you want to monitor is not displayed, double-click on the Node icon that contains the volume. 2. Click on Volume. 3. Right Click mouse button and it will display on Monitor option. Click on monitor and monitor window, is displayed as shown in Figure To select more volumes, click the object tree icon at the top of the window. The Object Tree window is displayed. 5. Repeat Steps 1 through 4 to select additional volumes. dba/m Database Manager V7.1 User's Guide

68 Figure 6-4. Monitor Window. Choose Tables To choose tables to monitor 1. Choose the catalog that contains the tables you want to monitor as follows: If the volume that contains the catalog is not displayed, click on the Node icon that contains the catalog Click on the Catalog icon that contains the tables. 2. Click on the Tables icon displayed under the Catalog icon. All the tables in the catalog are displayed in the Tables, Indexes, or Partition Names pane, as shown in Figure Click on the names of the tables to select all the tables. The selected tables are identified by the checkmark in the row header of the selected table. The Monitor button is also highlighted. To select a table, click on the row header again. 6-4 Monitoring Disk Space Usage

69 4. Right Click mouse button and menu will appear, select Monitor. The Monitor window is displayed, as shown in Figure To select additional tables, click object tree icon at the top of the window. The Object Tree window is displayed. 6. Repeat Steps 1 through 5 to select additional tables. Figure 6-5. Tables, Indexes, or Partition Names. Choose Indexes To choose indexes to monitor 1. Choose the catalog that contains the indexes you want to monitor as follows: If the volume that contains the catalog is not displayed, click on the Node icon that contains the catalog Click on the Catalog icon that contains the indexes. 2. Click on the Index icon displayed under the Catalog icon. All the indexes in the catalog are displayed in the Table-Index-Partition Names pane, as shown in Figure Click on the names of the indexes to select all the indexes. The selected indexes are identified by the checkmark in the row header of the dba/m Database Manager V7.1 User's Guide

70 selected index. The Monitor button is also highlighted. To deselect an index, click on the row header again. 4. Right Click mouse button and menu will appear, select Monitor. The Monitor window is displayed, as shown in Figure To select additional indexes, click Close in the Object Monitoring window. The Object Tree window is displayed. 6. Repeat Steps 1 through 5 to select additional indexes. Choose Partitions To choose the partitions to monitor 1. Choose the catalog that contains the partitions you want to monitor as follows: If the volume that contains the catalog is not displayed, click on the Node icon that contains the catalog Click on the Catalog icon that contains the partitions. 2. Click on the Partition icon displayed under the Catalog icon. All the partitions in the catalog are displayed in the Tables, Indexes, or Partition Names pane, as shown in Figure Click on the names of the partitions to select all the partitions. The selected partitions are identified by the checkmark in the row header of the selected partitions. The Monitor button is also highlighted. To deselect a partition, click on the row header again. 4. Right Click mouse button and menu will appear. Select Monitor. The Monitor window is displayed, as shown in Figure To select additional partitions, click on the object tree icon at the top of the window. The Object Tree window is displayed. 6. Repeat Steps 1 through 5 to select additional partitions. Managing the Objects You can control the following monitoring functions: Alarm thresholds, based on percentage of disk space used Start and stop monitoring on any selected object 6-6 Monitoring Disk Space Usage

71 To control these monitoring functions, use the Object Monitoring window, as shown in figure 6-4. Choose Objects You must choose objects to start monitoring the objects, stop monitoring the objects or set alarm thresholds for the objects. Use the Selected Objects pane in the Monitor window to choose the objects, as shown in Figure 6-6. Use one of the following methods to choose objects: To choose one object at a time, double-click on the name of the object in the list of objects. To deselect an object, double-click on the name of the object. To choose all displayed objects, click on SelectAll. The background color of the selected objects is set to blue. Figure 6-6. Selected Objects Pane. dba/m Database Manager V7.1 User's Guide

72 Setting Alarm Thresholds Each object you choose is associated with a horizontal slide bar and a meter: The position of the red marker on the slide bar identifies the threshold of percentage usage at which to raise an alarm. The numeric value is shown in the % Threshold field. The percentage value shown by the blue meter indicates the current usage of the disk by that object. If the threshold indicated by the slide bar is exceeded, an audible alarm is generated and the Alarm button in the Main window turns red. To change the alarm threshold of a selected object, use one of the following methods: Drag the red marker on the slide bar to the appropriate point on the slide bar. Enter a new threshold value in the % Threshold field to the right of the slide bar. Click on the right-arrow or left-arrow button at either end of the slide to move the red marker. Start and Stop Monitoring To start monitoring the selected objects, click on Start. The circular icon turns red, indicating that monitoring has started. To stop monitoring, click on Stop. The circular icon turns black, indicating that monitoring has stopped. Obtain a Snapshot You can obtain a snapshot of the disk space used by an object. To obtain a snapshot, click on GetNow in the Monitor window. Disk-space usage is measured immediately, then displayed. Obtain Historical Data You can obtain a graph of the historical data of objects by clicking on the historical data button. This graph allows you to predict the future trend of the monitored object. For example, if we are monitoring a data volume and 6-8 Monitoring Disk Space Usage

73 want to look at the free space available over a period of time and predict the future disk space needs based on historical trend. Figure 6-7. Historical and Predicted Data. Displaying Alarms If alarm thresholds are exceeded by objects you have chosen to monitor, the Alarm button in the Main window turns red and an audible alarm is generated. To display the alarms you have set, click on Alarm. The Alarms pane is displayed, as shown in Figure 6-8. dba/m Database Manager V7.1 User's Guide

74 Figure 6-8. Alarms Pane Monitoring Disk Space Usage

75 CHAPTER 7. ANALYZING AND TUNING QUERY PERFORMANCE Query performance depends on two major factors: the structure of the queries, and the statistics of the tables referred to in the queries. Using dba/m Database Manager, you can correlate the query to the statistics of tables that are stored in NonStop SQL catalogs. Using dba/m Database Manager, you also can study the impact of the structure of the query using the methods identified by NonStop SQL s explain function to retrieve data. dba/m Database Manager provides an easy-to-use facility to fine-tune queries by iteratively modifying queries and analyzing the performance of the modified queries using the explain functions. With the appropriate permission, you can use dba/m Database Manager to simulate production statistics in a test or development environment. Using this facility, you can predict performance in a production environment. You can use dba/m Database Manager to analyze queries embedded in programs or ad hoc queries. Analyzing Queries in Programs Use the Program Query Performance Analysis window to display the Explain output for all of the queries in a program. Each time you compile a program within dba/m Database Manager, a new version of the Explain output is created. You can display the Explain output for any version of a program. You must compile programs under dba/m Database Manager control in order to analyze queries in a program. Refer to Chapter 17, Managing Programs, for instructions on compiling programs using dba/m Database Manager. To display the Program Query Performance analysis window, click on the QueryAnalysis button in the Main Window, then click on Program. The Program Query Performance Analysis window is displayed, as shown in Figure 7-1. dba/m Database Manager V7.1 User's Guide

76 Figure 7-1. Program Query Performance Analysis Window. Choose a Program Use the Catalogs and Programs pane to choose the program for analysis, as shown in Figure 7-2. Figure 7-2. Catalogs and Programs To choose a program 1. In the Catalogs field, double-click on the name of the catalog that contains the program. All of the programs in the selected catalog are displayed in the Programs field. 2. In the Programs field, double-click on the name of the program that contains the query or queries. The versions of Explain output are displayed in the Versions pane, as shown in Figure 7-3. The compilation date and version number of each version is displayed. 7-2 Analyzing and Tuning Query Performance

77 Figure CHAPTER 7-3. Versions Pane. Choose a Query To choose a query 1. In the Versions pane, double-click on the version number of the program you want to analyze. A list of source files in the program are displayed in the Source field. 2. double-click on the name of the source file that contains the SQL statement. The SLT index of the SQL statements and the corresponding cost of the query are displayed in the SLT field and the TotalCost field. 3. In the SLT field, choose a statement number by double-clicking on the SLT index number. The SQL statement text is displayed in the SQL Statement pane to the left, as shown in Figure 7-4. dba/m Database Manager V7.1 User's Guide

78 Figure CHAPTER 7-4. SQL Statement Pane. The step number, operation number, operation type, and operation cost are displayed in the Operations/Steps pane, as shown in Figure 7-5. Figure 7-5. Operations/Steps Pane. Display Plan Details Use the Operations/Steps pane to display the details of each operation. To display plan details, click on an operation number in the Operations/Steps pane, and then click on Details command button. The details of the operation are displayed in the Operation Details pane, as shown in Figure 7-6. The following attributes of the operation are 7-4 Analyzing and Tuning Query Performance

79 displayed: step number, operation number, operation type, operation cost, and the query plan as created by the Explain function. Figure 7-6. Operation Details Pane. Display Statistics You can display the statistical characteristics of the tables used in the query by clicking on Statistics in the Program Query Analysis window. The Table Statistics window is displayed, as shown in Figure 7-7. dba/m Database Manager V7.1 User's Guide

80 Figure 7-7. Table Statistics Window. Table Statistics Table statistics for all of the tables used in the query are displayed in the Table Statistics pane, as shown in Figure 7-8. Figure 7-8. Table Statistics Pane. Column Statistics To display column statistics of a table, double-click on the name of the table in the Table Statistics pane. The column statistics of the selected table are displayed in the Column Statistics pane, as shown in Figure Analyzing and Tuning Query Performance

81 Figure 7-9. Column Statistics Pane. Index Statistics To display index statistics of a table, click on Index statistics Tab. The Index Statistics pane, id shown in Figure Figure Index Statistics Pane. Partition Statistics To display partition statistics of a table, click on Partition statistics Tab. The Index Statistics pane, id shown in Figure dba/m Database Manager V7.1 User's Guide

82 Figure Partition Statistics Pane. Update Statistics If the statistics on any of the tables have not been updated recently, you may perform Update Statistics on any of the tables. To update statistics on a table 1. Click on the cell identified by the name of the table and the Update Statistics column. The cell will display the character y. You may deselect a table by clicking on the cell again. 2. Click on Update Statistics. 3. Use the Update Statistics window described in Chapter 12, Managing Tables - Statistics. Display Dependencies Before updating statistics, you can analyze the impact of the changes on other programs and objects in the Table Statistics window. To display all programs that depend on the table you want to modify, click on the Dependent Programs button. 7-8 Analyzing and Tuning Query Performance

83 To display all objects, including programs, that depend on the table you want to modify, click on the Objects button. Simulate Production Statistics You can manually update statistics to simulate different production environments. To simulate production statistics, your copy of dba/m Database Manager must be licensed to update table statistics. Check with the HP NonStop Himalaya System administrator to determine if you have the appropriate license. Warning: Genus Software strongly recommends that you perform simulations in a user-controlled transaction mode, so that you can roll back the changes to the statistics. Otherwise, statistics data in the catalogs is permanently changed. Change Table Statistics Table statistics of all of the selected tables are displayed in the Table Statistics pane shown in Figure 7-7. You can update the following attributes: Number of Rows and End Of File Position. To change table statistics 1. In the Table field, click on the name of the table. Column and index statistics of the table are displayed. 2. Place the cursor in the # of Rows field and edit the field. 3. Place the cursor in the EOF Position field and edit the field. Change Column Statistics You can update the Second Highest Value and the Second Lowest Value in the Column Statistics pane. To change column statistics 1. In the Column Name field, click on the name of the column you want to change. 2. Place the cursor in the column s Second Highest Value field and edit the field. 3. Place the cursor in the column s Second Lowest Value field and edit the field. dba/m Database Manager V7.1 User's Guide

84 Change Index Statistics You can update the number of index levels for an index in the Index Statistics pane. To choose the index, click on the name of the index in the Index field. Place the cursor in its Index Level field and edit the field. Update Catalogs Click on Manual Stats Update at the bottom of the Table Statistics window to update the table, column, and index statistics stored in system catalogs. Tune the Query You can tune the selected query by modifying the query and generating Explain output for the modified query. To tune the query, click on Query Analysis in the Main window, then click on Adhoc Query. The Adhoc Query Performance Analysis window is displayed, as shown in Figure Figure Adhoc Query Performance Analysis Window Analyzing and Tuning Query Performance

85 Modify the Query The SQL statement is displayed in the SQL Statement pane, as shown in Figure The total cost of the original query is displayed in the Original Total Cost field. Edit the query to create a new query. Figure SQL Statement Pane. Modify Control Options You can change the control options for tables and queries in the Current Control Options pane as shown in Figure To view the active control options, click on Execute Cmd. The active control options are shown in the Current Control options window. dba/m Database Manager V7.1 User's Guide

86 Figure Current Control Options pane. The Current Control Options pane shown in Figure 7-14 displays the active control options for tables and queries. You can change these control options using the Control Query, Control Executor, or Control Table buttons. To change control table options Click on the Control Table button in the Adhoc Query Performance Analysis window, Press the tab Control_Table to display the Control Table window as shown in Figure Edit the control options in the Control Table window Analyzing and Tuning Query Performance

87 Figure Control Table Window. To change control query options Click tab Ctrl Query button in the Adhoc Query Performance Analysis window to display the Control Options window as shown in Figure Edit the control options in the Current Control Options pane. To change control executor options, click on the Ctrl Executor button. dba/m Database Manager V7.1 User's Guide

88 Figure Control Query Window. View Explain Plans Once you have modified the query and/or Control Options, click on Execute Cmd. The query plan will be displayed in the Query Plan pane. Execute the Query Click on the Query Results button to execute the query. The query will be executed and the data retrieved will be displayed in the Query Analysis pane Analyzing and Tuning Query Performance

89 Figure Query Analysis Window. Analyzing Ad Hoc Queries Use the Query Performance Analysis window to display the Explain output for ad hoc queries. You can enter queries in this window, retrieve queries stored in files, or move queries from the Program Query Analysis window. To display the Query Analysis window, click on QueryAnalysis in the Main window, then click on AdhocQuery. The Query Analysis window is displayed, as shown in Figure Create a Query You can type a new query or retrieve a query stored in a file. If you entered the Query Analysis window from the Program Query Analysis window, the query is imported automatically. To create the query, enter an SQL statement in the SQL Statement pane shown in Figure 7-18, or click on Retrieve to retrieve a query that was previously stored using SaveCommand. dba/m Database Manager V7.1 User's Guide

90 Figure SQL Statement Pane. Modify Control Options You can change the control options for queries and the Executor in the Current Control Options pane as shown in Figure To view the active control options, click on Execute Cmd. The active control options are shown in the Current Control Options window. View Explain Plan Click on Execute to execute the query. The Explain output is displayed in the Explain output window, as shown in Figure Analyzing and Tuning Query Performance

91 Figure Explain Output Window. Display Statistics Click on the Statistics button to display the statistics stored in the catalogs. Refer to the Display Statistics section of Analyzing Queries in Programs at the beginning of this chapter for instructions on displaying table, column, and index statistics. Simulate Production Statistics You can manually update statistics to simulate different production environments. To simulate production statistics, your copy of dba/m Database Manager must be licensed to update table statistics. Check with the HP NonStop System administrator to determine if you have the appropriate license. Warning: Genus Software strongly recommends that you perform simulations in a user transaction mode, so that you can roll back the changes to the statistics. Otherwise, statistics data in the catalogs is permanently changed. To simulate production statistics, refer to Simulating Production Statistics earlier in this chapter. dba/m Database Manager V7.1 User's Guide

92 Execute Query Click on the Query Results button to execute the query. The query will be executed and the data retrieved will be displayed in the Query Results pane. Save the Query You can save the ad hoc query for future use by clicking on SaveCommand Analyzing and Tuning Query Performance

93 CHAPTER 8. MANAGING DATA Using dba/m Database Manager, you can Query a database Copy data to or from Enscribe files and SQL tables, appending the data to the files or tables Load data in an existing database, overwriting the existing data Display the contents of a file You can perform these functions by accessing windows from the Data button in the Main window. The menu hierarchy is shown in Figure Figure 8-1. Diagram of Data Management Menus. Querying Data Using the Query Data window, you can execute simple queries on tables and views. You can also insert, update, and delete data. You must be authorized to perform the query, add, change, or delete operations. When you display the Query Data window, the window is automatically placed in select mode so that you can create a query. After you have queried a database, you can change the mode to Add, Delete, or Update mode by clicking on the appropriate button in the Mode pane at the bottom of the window. dba/m Database Manager V7.1 User's Guide

94 To view the Query Data window, click on Data - Query in the Main window. An example of the Query Data window is shown in Figure 8-2. Figure 8-2. Query Data Window. Querying a Database To query a database, you choose the tables or views, then choose the columns and search criteria. Choose Tables or Views To choose tables or views to query, use the Catalogs, Tables, and Views pane, as shown in Figure 8-3. Figure 8-3. Catalogs, Tables, and Views Pane. To choose tables or views to query 8-2 Managing Data

95 1. In the Catalogs field, double-click on the name of the catalog. Tables located in the catalog are displayed in the Tables field. Views located in the catalog are displayed in the Views field. To choose a table, double-click on its name in the Tables field. To choose a view, double-click on its name in the Views field. 2. The columns in the table or view are displayed in the Columns pane, as shown in Figure 8-4. The following attributes of the columns are also displayed: table name, table alias, column name, data type, whether the column is part of the primary key, and whether the column accepts null values. 3. Repeat steps 1 and 2 to choose additional tables or views. Figure 8-4. Columns Pane. Create the Columns List Use the Columns pane shown in Figure 8-4 to create the columns list in the SELECT statement. 1. In the Columns pane, click on the name of the column you want to add to the columns list. The column is displayed in the Select Columns field of the Columns pane. If you want to remove a column from the columns list, double-click on the name of the column. The column is removed from the Projection Elements field. 2. Edit the Projection Elements field to create any expressions you want. 3. Repeat Steps 1 and 2 to add more elements to the columns list. 4. To complete creation of the columns list, click on Predicate. A partial SELECT statement is displayed in the Select Text pane, as shown in Figure 8-5. dba/m Database Manager V7.1 User's Guide

96 Figure 8-5. Select Text Pane. Specify Search Criteria If you want to specify search criteria, you can add WHERE statements to the Select Text pane shown in Figure 8-5. Using search criteria is optional. 1. Click on Predicate Tab. 2. Type the search criteria in Predicate pane. Figure 8-6. Predicate Pane. Execute the Query To execute the query, click on Execute. 8-4 Managing Data

97 If the query cost to retrieve the rows from the selected table is higher than the cost configured in the user profile, a warning message appears. You can continue or cancel the query. The progress of the selection of rows is displayed in the Query Status window, as shown in Figure 8-7. In this window, you do one of the following: To terminate execution of the query, click Cancel. To stop the retrieval to view the data, click on Stop. To continue execution after stopping the retrieval, click on Continue. When the query is completed or the dba/m Database Manager buffer is full, the results of the query are displayed in the Results window. You can maximize the Results window to a full screen, and use the scroll bars to move up or down, or left or right. Figure 8-7. dba/m Database Manager V7.1 User's Guide

98 Copying Data You can copy data to or from Enscribe files and SQL tables. The data you copy is appended to the existing data. You can also display the contents of a file or table. Use the Copy window to add data. To display the Copy window, click on Data in the Main window, then click on Copy. The Copy window is displayed, as shown in Figure 8-8. Figure Copy Window. Define Source and Destination Define the source and destination objects in the Source-Destination pane, as shown in Figure 8-9. The source can be an Enscribe file or an SQL table. The destination can be an Enscribe file or an SQL table. Figure 8-9. Source-Destination Pane. To specify the source and destination of a copy operation 8-6 Managing Data

99 1. In the Source field, double-click on the type of source object. 2. Enter the name of the source object in the Source field. 3. In the Target field, double-click on the type of destination object. 4. Enter the name of the destination object in the Target field. Specify Control Options Specify the control options for the copy operation in the Control Options pane, as shown in Figure Figure Control Options Pane. To specify the control options 1. To allow errors, click on the Allow Errors check-box. If errors are not allowed, leave the check-box blank. 2. If you allow errors in the Allow Errors check-box, enter the number of errors allowed in the Allow Errors field. 3. Enter the number of records to be copied in the Count field. To copy all records, leave the Count field blank. 4. In the Replace spaces pane, specify whether spaces should be replaced with zeroes or with defaults by clicking either on With Zeroes or on With Defaults. 5. Enable or disable the unstructured-disk-file option by clicking on Unstructured. 6. Enable or disable the upshift option by clicking on Upshift. dba/m Database Manager V7.1 User's Guide

100 7. To copy null values from Enscribe files to null values in an SQL table, click on Use SQL Nulls. 8. In the First pane, click on one of the following: OrdinalRecNum. Then enter the number of records to be skipped in the OrdinalRecNum field. RecordSpec. Enter the primary-key value for the starting record of an unstructured, relative, or entry-sequenced file in the RecordSpec field. KeyValue. Then enter the approximate position of the starting record for key-sequenced files in the KeyValues field. KeySpecifier. Then enter the positions of the record with the specified alternate key value in the KeyValue field. Define Input-File Options Set input-file options using the In Option pane, as shown in Figure Not all options are applicable to all object types. Figure In Option, Out Option, and Display Option Panes. To define input-file options 1. Enter the input block length in the Blockin field. 2. Set the compact or no compact option by clicking on Compact. 3. Enable translation to EBCDIC by clicking on EBCDICin. 4. To open an input field in shared exclusion mode, click on Share. 5. Set the trim-character option in the Trim check-box; then enter the trim character in the Trim field. 6. Set the variable length option by clicking on Varin. 8-8 Managing Data

101 7. Enter the maximum length of input records, in bytes, in the RECin field. Define Output-File Options Set output-file options using the Out Option pane, as shown in Figure Not all options are applicable to all object types. To define output-file options 1. Enter the output block length in the Blockout field. 2. Enable translation to EBCDIC by clicking in EBCDICout. 3. Allow dividing of long input records into multiple records by clicking on Fold. 4. Set the pad-character option in the Pad check-box, then enter the pad character in the Pad field. 5. Set the variable-length option by clicking on Varout. 6. Enter the maximum length of output records, in bytes, in the RECout field. Specify Display Options Specify display options using the Display Option pane, as shown in Figure Not all options are applicable to all object types. To specify display options 1. Set the display in octal, decimal, or hexadecimal mode by clicking on the corresponding check-box. 2. Set the display-byte option by clicking on Byte. 3. Set the display ASCII option by clicking on Ascii. 4. Set the No Head option by clicking on No Head. Specify Move Options You specify move options to map source columns to destination columns. Specify move options in the Move Option pane by clicking on Move dba/m Database Manager V7.1 User's Guide

102 Options tab the top of the Copy window. The Move Options pane is shown in Figure Not all options are applicable to all object types. Figure Move Options Pane. To specify move options 1. In the Source Dictionary field, enter the name of the subvolume that contains the DDL dictionary or DEF definition for an Enscribe input file. 2. In the Source Record field, enter the name of the DDL record definition for an Enscribe input file. 3. In the Move fields, enter the source column names and corresponding target column names. 4. Choose one of the move types, as follows: To move by name, click on MoveByName. To move by order, click on MoveByOrder. 5. Set the truncation option by clicking on Truncation. 6. Enter the original qualified names and corresponding target qualified names in the Redefine fields Managing Data

103 Perform the Copy To copy the data, click on one of the following: Execute. Executes the command immediately. Show. Displays the SQL commands created by dba/m Database Manager without executing them. Queue. Queues the command to be submitted in a batch later. Loading Data When you copy data using the Load window, you can copy data to or from Enscribe files and SQL tables. The data you copy overwrites any existing data. You can also display the contents of a file or table. Use the Load window to copy data and overwrite existing data. To display the Load window, click on Data in the Main window, then click on Load. The Load window is displayed, as shown in Figure Figure Load Window. dba/m Database Manager V7.1 User's Guide

104 Define Source and Destination Define the source and destination objects in the Source-Destination pane, as shown in Figure The source can be an Enscribe file or an SQL table. The destination can be an Enscribe file or an SQL table. Figure Source-Destination Pane. To specify the source and destination of a copy operation 1. In the Source field, double-click on the type of source object. 2. Enter the name of the source object in the Source field. 3. In the Target field, double-click on the type of destination object. 4. Enter the name of the destination object in the Target field. Specify Control Options Specify the control options for the copy operation in the Control Options pane, as shown in Figure Figure Control Options Pane. To specify the control options 1. To allow errors, click on the Allow Errors check-box. If errors are not allowed, leave the check-box blank. 2. If you allow errors in the Allow Errors check-box, enter the number of errors allowed in the Allow Errors field. 3. Enter the number of records to be copied in the Count field. To copy all records, leave the Count field blank Managing Data

105 4. In the Replace spaces pane, specify whether spaces should be replaced with zeroes or with defaults by clicking either on With Zeroes or on With Defaults. 5. Turn the unstructured-disk-file option on or off by clicking on Unstructured. 6. Turn the upshift option on or off by clicking on Upshift. 7. To copy null values from Enscribe files to null values in an SQL table, click on Use SQL Nulls. 8. In the First pane, click on one of the following: OrdinalRecNum. Then enter the number of records to be skipped in the OrdinalRecNum field. RecordSpec. Then enter the primary-key value for the starting record of an unstructured, relative or entry-sequenced file in the RecordSpec field. KeyValue. Then enter the approximate position of the starting record for key-sequenced files in the KeyValue field. KeySpecifier. Then enter the positions of the record with the specified alternate key value in the KeyValue field. Define Input-File Options Set input-file options using the In Option pane, as shown in Figure Not all options are applicable to all object types. To define input-file options Figure In Option Pane. 1. Enter the input block length in the Blockin field. dba/m Database Manager V7.1 User's Guide

106 2. Set the compact or no compact option by clicking on Compact. 3. Enable translation to EBCDIC by clicking on EBCDICin. 4. Enter the maximum length of input records, in bytes, in the RECin field. 5. To open an input field in shared exclusion mode, click on Share. 6. Set the trim-character option by clicking on Trim; then enter the trim character in the Trim field. 7. Set the variable length option by clicking on Varin. Specify Key Sequence Options Specify key sequence options in the Key Sequence Option pane, as shown in Figure These options apply only to key sequenced objects. Figure Key-Sequence Option Pane. To specify key sequence options 1. Set the load-partition option by clicking on PartOnly. 2. Enter the name of the volume for the partition in the Partof field. 3. To indicate that input data is already sorted, click on Sorted. 4. Enter the maximum number of input records in the Max Num-records field. 5. Enter the name of the field used for sorting in the Scratch File field. 6. Enter the minimum percentage of space to be left in data blocks in the Dslack field Managing Data

107 7. Enter the minimum percentage of space to be left in index blocks in the Islack field. 8. Enter the minimum percentage of space to be left in index and data blocks in the Slack field. Enable Parallel Execution To enable parallel execution and specify configuration files and indexes, use the Parallel Execution pane, as shown in Figure This option is applicable only for indexes. To enable parallel execution, click on On. For each index, enter the name of the configuration file and corresponding index name in the ConfigFileName and IndexName fields. Figure Parallel Execution Options Pane. Specify Move Options You specify move options to map source columns to destination columns. Specify move options in the Move Options pane, as shown in Figure Not all options are applicable to all object types. dba/m Database Manager V7.1 User's Guide

108 To specify move options Figure Move Options Pane. 1. In the Source Dictionary field, enter the name of the subvolume that contains the DDL dictionary or DEF definition for an Enscribe input file. 2. In the Source Record field, enter the name of the DDL record definition for an Enscribe input file. 3. In the Move fields, enter the source column names and corresponding target column names. 4. Choose one of the move types, as follows: To move by name, click on MoveByName. To move by order, click on MoveByOrder. 5. Set the truncation option by clicking on Truncation. 6. Enter the original qualified names and corresponding target qualified names in the Redefine fields Managing Data

109 Load the Data To copy the data and overwrite existing data, click on one of the following in the Copy window: Execute. Executes the command immediately. Show. Displays the SQL commands created by dba/m Database Manager without executing them. Queue. Queues the command to be submitted in a batch later. dba/m Database Manager V7.1 User's Guide

110

111 CHAPTER 9. AUDITING COMMAND EXECUTION All operations performed in dba/m Database Manager are logged, so you can display a history of user operations. SQL operations performed outside of dba/m Database Manager are not tracked by dba/m Database Manager. dba/m Database Manager supports three types commands: on-line commands, batch commands, and direct commands. On-line commands are executed using the Execute in dba/m Database Manager windows. When these commands are executed, the start time of execution and the results of execution are logged. Batch commands are executed using the Create Batch window. Only the scheduled execution time and the batch number are logged. The results of execution are not logged. Direct commands are executed in the Direct Command window. These commands are not logged. To display command histories, click on History in the Main window. The Command History window is displayed, as shown in Figure 9-1. dba/m Database Manager V7.1 User's Guide

112 Figure 9-1. Command History Window. Choose Users You can display commands executed by all users, a single user, or a single object. To choose users 1. Click on one of the following: All Users. Displays commands executed by all dba/m Database Manager users. Single User. Displays commands executed by a single dba/m Database Manager user. 2. If you selected the Single User option, enter the group name in the Group Name field, and the user name in the User Name field. Choose Object To choose an object 9-2 Auditing Command Execution

113 1. Click on Single Object. 2. Enter the Object Name to see commands executed by that object. You may also enter partial names of objects. Choose Period You can display only the commands executed after a specific date. To choose period Enter the date and time in the Date and Time field. Display Audit Trail To display the history, click on Get History at the bottom of the window. Delete History You can delete the history of all commands by date and time. To delete the history of all commands before a specific date and time 1. Enter the date and time in the Date and Time field. 2. Click on Delete History 3. The Confirm Request window will be displayed. 4. Click OK to delete or Cancel to return without deleting. Display Commands You can display the details of each command by selecting on the command shown in the Command field and clicking on Get Detail button. Details of the operation are displayed in the Direct Command window, as shown in Figure 9-2. dba/m Database Manager V7.1 User's Guide

114 Figure 9-2. Direct Command Window. 9-4 Auditing Command Execution

115 CHAPTER 10. MANAGING ITEMS AND BATCHES Using dba/m Database Manager, you can manage items and batches: An item is a unit of work that consists of SQL commands and operations, such as SQLCOMP. You create items in windows such as Create Table, Create Index, and Compile Programs. An item is executed as a single transaction. A batch is a collection of one or more items that you execute in a user defined sequence. A batch is also executed as a single transaction. Managing Items You can create, edit, or delete items. Create an Item You create an item by clicking on Queue in an object management window such as catalog-management, table-management, view-management, indexmanagement, program-management, or in the copy or load data windows. The item is queued for later execution and is given a numeric identifier. Once the item is queued, you can manipulate it in the Create Batch window. Edit an Item After you have queued an item for later execution, you can edit it in the Create Batch window. To display the Create Batch window, click on CreateBatch in the Main window. The Create Batch window is displayed, as shown in Figure dba/m Database Manager V7.1 User's Guide

116 Figure Create Batch Window. To select an item and edit its commands 1. In the Batch Item pane, choose the item by clicking on the item number. Use the > button to move the items to the Selected Batch Item pane. The commands in the item are displayed in the Batch Item Edit pane. 2. Choose the command you want to edit by placing the cursor on the command line in the Batch Item Edit pane. 3. Edit the command. 4. Click OK to save the changes, or click Cancel to cancel the changes. Managing Batches Using the Create Batch window you can Create a batch containing a set of queued items Define the attributes of a batch Delete a batch Submit a batch for execution 10-2 Auditing Command Execution

117 Stop a batch from execution Refresh the status of a batch To display the Create Batch window, click on CreateBatch in the Main window. The Create Batch window is displayed, as shown in Figure Create a Batch Use the Batch Items pane to combine queued items into a batch, as shown in Figure Figure Batch Items Pane. To create a batch 1. Select the item name or number of each item you want to include in the batch in the Batch Items pane. 2. Move it to the Selected Batch Items pane by clicking on the > button. 3. You can change the sequence of an item by highlighting the item, then clicking on the Up button in the Selected Batch Items pane. 4. Click on Create Batch to create the batch. You can undo the batch by clicking on Undo Batch. Assign Batch Attributes The following table provides a description of the batch attributes that you can modify. dba/m Database Manager V7.1 User's Guide

118 Attribute Name Description Usage Batch name CPU # Provides identification in addition to the batch number in the Batch Results window. Number of the CPU under which the batch should be executed. Optional Required Priority Process priority for batch execution. Required Execution date/time Spooler destination/location Date and time that the batch should be executed. Spool file location where the output of the batch should be stored for later review. Required Optional Swap disk Swap disk to be used during batch execution. Optional Comment TACL output-to-file flag Comment text stored in the dba/m Database Manager log tables and that can be used for review later. Option to save the TACL output in an file. The file is created with the batch number as the file name, and is stored in the GENTACL subvolume in the dba/m Database Manager volume. Optional Optional Use the Batches pane shown in Figure 10-3 to edit the attributes of a batch. Figure Batches Pane. To edit the attributes of a batch 1. In the Batches pane, choose a batch to edit by clicking on the batch name in the Batch Name column. 2. Click on SetAttrib. The Batch Attributes window is displayed, as shown in Figure Change any of the batch attributes as desired. 4. Click OK to save the attributes. To cancel all changes, click Cancel Auditing Command Execution

119 Figure Batch Attributes Window. Delete a Batch Use the Batches pane, shown in Figure 10-3, to delete a batch. 1. To select a batch, click on the batch name for the batch you want to delete. 2. Click on DelBatch. 3. Repeat Steps 1 and 2 to delete additional batches. Submit a Batch Use the Batches pane, shown in Figure 10-3, to submit a batch for execution. 1. To select a batch, click on the batch name. 2. Click on Submit. 3. Repeat Steps 1 and 2 to submit additional batches for execution. dba/m Database Manager V7.1 User's Guide

120 Stop a Batch You can stop execution of a batch only if the batch has not started execution. Check the status of a batch in the Batch window, in the Status field. The status of the batch can be one of the following: Created, for newly created batch Scheduled, for submitted for execution Executing, for started execution Exec Error, for execution completed with errors Exec Done, for successful completion Exec Stopped, for execution stopped by user If the batch status is Created or Scheduled, you can stop execution. Use the Batches pane, shown in Figure 10-3, to stop a batch 1. To select a batch, click on the batch number or name. 2. Click on Stop. 3. Repeat Steps 1 and 2 for stopping additional batches. Refresh Status After you have scheduled a batch for execution, click on the Refresh Status button to see the status of batches. You can set the Refresh Status button to display the status of batches in intervals of one second. Monitoring Batch Results After you have scheduled a batch for execution, you can check the status of the batch or the results of execution in the Results window. To display the Results window, click on ViewBatch in the Main window. The Results window is displayed, as shown in Figure Auditing Command Execution

121 Figure Results Window. Display Results You can check the status of a batch (created, scheduled, errored, completed) by displaying the details of the batch execution. To choose the batches you want to display, specify the beginning and ending date and time in the Select Date Range pane. Any batches submitted within the specified range are displayed, as shown in Figure The default dates displayed in the Select Date Range pane are today s plus three previous days, or a total of four days. To display results for another date and time range 1. Enter the starting date and time in the Start date field. 2. Enter the ending date and time in the End date field. 3. Click on Start Refresh at the bottom of the Results window. The status of batches submitted during the specified date and time range is displayed. To update results status for the same date and time range, click on Start Refresh. The latest results status is displayed. dba/m Database Manager V7.1 User's Guide

122 Figure Select Date Range Pane. Display Batch Output To display detailed batch results, click on the row of the batch for which you want details. The Batch Results window is displayed, as shown in Figure Note. Only results for batches which have executed will be displayed. Click on Batch Results to view the results. Batch Results Delete Batch If the batch has been created, scheduled, or has executed with errors, you can delete it by clicking on the Delete Batch button. Stop Batch If the batch has not already been executed, you can stop it by clicking on the Stop Batch button Auditing Command Execution

123 Resubmit a Batch After viewing the results, you may resubmit a batch. To resubmit a batch 1. Select the batch to be replicated. 2. Click on Replicate. 3. The Quick Batch window is displayed. 4. Modify the commands or batch parameters 5. Enter a new name in the Queue Command pane if desired. 6. Choose either Submit or Queue. dba/m Database Manager V7.1 User's Guide

124

125 dba/m Database Manager V7.1 User's Guide

126

127 CHAPTER 11. MANAGING CATALOGS dba/m Database Manager provides tools for managing user catalogs. Using dba/m Database Manager, you can Create new user catalogs in the current node Alter the attributes of an existing catalog Drop user catalogs in a node Upgrade user catalogs in a node You cannot use dba/m Database Manager to manage system catalogs. You must manage system catalogs using the SQLCI utility. You can manage catalogs by accessing windows from the Object Tree button, the Custom Tree button, or the Tables button in the Main window as shown in Figure The procedures in this chapter only describe how to access catalog management windows from the Catalogs menu button. Refer to Chapter 3 for information about managing catalogs from the Object Tree, and Chapter 4 for information about the Custom Tree. dba/m Database Manager V7.1 User's Guide

128 Catalog Menu Create Catalog Alter Catalog Drop Catalog Upgrade Catalog Figure Diagram of Catalog Management Menus Managing Catalogs

129 Creating a User Catalog To create a user catalog you must assign the catalog name, location, and security string. To display the Create Catalog window, click on Catalogs in the Main window, then click on Create. The Create Catalog window is displayed, as shown in Figure Figure Create Catalog Window. Assign a Name and Volume To create a new user catalog 1. Type the new catalog name in the first field next to the Catalogs icon. 2. To choose the volume and node where the catalog is located, do one of the following: Enter the node name and volume in the second field next to the Catalogs icon. dba/m Database Manager V7.1 User's Guide

130 Click on Volumes at the bottom of the window to display the Select Volume window, as shown in Figure To select the volume, click on the volume name in the Volume Name field and click OK. Figure Select Volume Window. Save the Catalog To save the catalog you just created, click on one of the following: Execute. Executes the command immediately. Show. Displays the SQL commands created by dba/m Database Manager without executing them. Queue. Queues the command to be submitted later in a batch. Altering a User Catalog You can alter the following attributes of a user catalog: Security string Owner and group IDs 11-4 Managing Catalogs

131 Clear-on-purge flag Date and time after which the catalog can be purged To display the Alter Catalog window, click on Catalogs in the Main window, then click on Alter. The Alter Catalog window is displayed, as shown in Figure Figure Alter Catalog Window. Choose the Catalog To choose a catalog to alter, in the Catalogs field, double-click on the catalog you want to alter. The security attributes of the selected catalog are displayed in the Security pane. Change the Security Use the Security pane to change security. Change the security string using the drop-down list in the R, W, E, and P fields. Change the group ID in the first Owner ID field, and the user ID in the second Owner ID field. dba/m Database Manager V7.1 User's Guide

132 Change the Purge Attributes 1. Type an expiration date in the NoPurgeUntil field. 2. Click on ClearOnPurge to change the clear-on purge flag. Save the Catalog To save changes to a catalog, click on one of the following: Execute. Executes the command immediately. Show. Displays the SQL commands created by dba/m Database Manager without executing them. Queue. Queues the command to be submitted later in a batch. Dropping a User Catalog The Drop Catalog function allows you to delete a user catalog. To display the Drop Catalog window, click on Catalogs in the Main window, then click on Drop. The Drop Catalog window is displayed, as shown in Figure Choose the Catalog To choose a catalog to drop 1. From the Catalogs field, double-click on the name of the catalog you want to drop. The names and types of objects in the selected catalog are displayed. 2. Set the cascaded-delete option by clicking on Cascaded Delete. Note: If the catalog is not empty, the delete command will fail if you do not specify the cascaded-delete option Managing Catalogs

133 Figure Drop Catalog Window. Drop the Catalog To drop a catalog, click on one of the following: Execute. Executes the command immediately Show. Displays the SQL commands created by dba/m Database Manager without executing them. Queue. Queues the command to be submitted in a batch later. Upgrading a Catalog The Upgrade Catalog function allows you upgrade a catalog to another version of catalogs. To display the Upgrade Catalog window, click on Catalogs in the Main window, then click on Upgrade. The Upgrade Catalog window is displayed, as shown in Figure dba/m Database Manager V7.1 User's Guide

134 Figure Upgrade Catalog Window. Choose the Catalog To choose a catalog to upgrade 1. Enter the name of the catalog in the Catalog Name field. 2. Enter the new catalog-version number in the Catalog Version field. Upgrade the Catalog To upgrade the catalog, click on one of the following: Execute. Executes the command immediately. Show. Displays the SQL commands created by dba/m Database Manager without executing them. Queue. Queues the command to be submitted in a batch later Managing Catalogs

135 CHAPTER 12. MANAGING TABLES Using dba/m Database Manager, you can perform the following operations on tables: Create table Alter the attributes of table Rename a table Drop a table Display statistics of a table Update statistics of a table Invoke the definition of a table Add, change, or delete constraints on a table Add, change, or delete help text of the columns of a table Add, change, or delete table comments Add, change, or delete comments for columns in a table Add, change, or delete constraint comments You can manage tables by accessing windows from the Object Tree button, the Custom Tree button, or the Tables button in the Main window. The procedures in this chapter only describe how to access table management windows from the Tables menu button. Refer to Chapter 3 for information about managing tables from the Object Tree, and Chapter 4 for information about the Custom Tree. Creating a Table You can create a table by entering all of the attributes of a table, or by copying the attributes of an existing table and modifying them for the new table. You can also create partitions for the table. When creating a table, you perform the following tasks: Assign the table name, location, and security string Define the table s organization dba/m Database Manager V7.1 User's Guide

136 Define file attributes Define the table columns Define table partitions To display the Create Table window, click on Tables in the main window, then click on Create. The Create Table window is displayed, as shown in Figure Figure Create Table Window. Assign Name and Location As you assign the name and location of the table you are creating. To assign the table s name and location 1. Enter the name of the new table in the Tables field. 2. In the Node Icon field, enter the name of the node where the table will be created. 3. Enter the name of the volume in the Volumes field or click on the Volume button to display the Select Volumes window, then click on the volume name Managing Tables

137 4. Enter the name of the subvolume in the Subvolume Icon field. 5. In the Catalogs field, click on the arrow to display all catalogs. Click on the name of the catalog in which you want the table to be created. Assign Security Assign security using the drop-down lists in the R, W, E, and P fields in the Security pane. Although Owner ID and group ID are displayed, you cannot alter them. After you have created the table, use Alter Table to alter the owner ID or group ID. Choose the Table Organization Use the Organization and Key panes to specify the key type and key organization. 1. Choose the key organization by clicking on one of the buttons in the Organization pane. 2. Choose the type of key by clicking on one of the buttons in the Key pane. Define File Attributes To define file attributes 1. Enter the number of extends in the Allocate field. 2. Enter the block size in the Block Size field. 3. In the Extend in Pages pane, perform one of the following: To enter the primary and secondary extent sies, click on Pri, then enter the primary extent size in the Pri field and the secondary extent size in the Sec field. To enter the number of extents, click on Ext, then enter the number of extents in the Ext field. 4. Enter the lock length in the Lock Length field. dba/m Database Manager V7.1 User's Guide

138 5. Enter the maximum number of extents in the Max Extents field. 6. Enter the data and time until which the table cannot be purged in the NoPureUntil field. 7. Enter the numeric table code in the Table Code field. 8. Enable or disable audit by licking on Audit. 9. Enable or disable audit compression by clicking on Audit Compress. 10. Enable or disable buffered disk-writes by clicking on Buffered. 11. Enable or disable clear-on-purge by cliking on Clear On Purge. 12. Enable or disable data compression by clicking on Dcompress. 13. Enable or disable index compression by clicking on Icompress. 14. Enable or disable serial writes by clicking on Serial Writes. 15. Enable or disable verified-writes by clicking on Verified Write. 16. Enable or disable similarity checks by clicking on Similarity Check. Choose Table Format Choose Format of a table by clicking either Format1 or Format2 in Format Pane. Choose Partition Array: You can choose anyone partition Array by clicking any of the option buttons in Partition Array Pane Managing Tables

139 Add Columns After you have defined the new table s attributes, you must add columns to the table. When you add a column you assign the following to the column: Column name and heading Data type Data-value attributes Primary key To add a column to the new table, click on Columns Tab in the Create Table window. The Columns window is displayed, as shown in Fig Figure Columns Window. Assign the Name and Heading Enter the column name in the Column Name field. Enter text for the column heading in the Column Header field. dba/m Database Manager V7.1 User's Guide

140 Assign a Data Type Specify the data type for column using the Type pane, as shown in Figure Figure 12-3 Data Type Pane. To assign a data type 1. Choose the data type for the column by clicking on one of the following: Char, PicX, Varchar, DateTime, Interval, Decimal, Numeric, Pic9, Smallint, Integer, Largeint, or Float. Depending on the data type you choose, additional attributes of the data types can be specified. For example, if you choose Decimal, the Length, Scale, and Signed check-boxes are displayed in the pane. 2. Click on the appropriate check-boxes to define the attributes of the data type. Assign Value Attributes Use the Defaults pane shown in Figure 12-4 to specify the default value for the column. Figure: Defaults Pane. To assign default attributes 1. If the new column should allow null values, click on NULL Managing Tables

141 2. Choose the type of default value by clicking on one of the following: System, User, Current, or No Default. 3. If you click on User, enter the default value in the User field. Assign a Primary Key Use the Key pane shown in Figure 12-5 to specify the primary key for the column. Figure: Key Pane. To assign a primary key 1. Click on Key. 2. Choose the order of the key by clicking on Ascending or Descending. Note: Key-sequence numbers are generated automatically as you add new columns. Refer to Change Column Attributes to change the key sequence. Save the Column To save the new column, click on Add. The column and its attributes are displayed in the Column pane. Change Column Attributes After you have added a column, you can change any attribute of the column in the Edit Columns window. dba/m Database Manager V7.1 User's Guide

142 1. In the Columns pane, click on the name of the column in the list in the Column Name field. The attributes of the column are displayed in the Edit Columns window. 2. Change any of the column attributes. 3. Click on Change to display the column s new attributes in the Column pane. Note: If you change the primary key attribute, the key-sequence number of all primary-key columns will be changed. 4. Repeat steps 1 through 3 to change the attributes of the any other columns in the new table. 5. When you are finished changing column attributes, click OK. The Edit Columns window closes and the column list appears in the Create Table window. Delete Columns You can delete a column in the new table by using the Edit Columns window. 1. From the Columns pane, click on the name of the column in the Column Name field. The attributes of the column are displayed in the Edit Columns window. 2. Click on Delete. The column is deleted from the Columns pane. Note: If you delete a primary-key column, the key-sequence number of all primary key columns will be changed. 3. Repeat steps 1 and 2 to delete columns from the new table. 4. When you are finished deleting columns, click OK. The Edit Columns window closes and the column list appears in the Create Table window. Change Column Sequence You can change the sequence of columns in the Column Name pane. 1. Click on the name of the column in the Column Name field. 2. Click on Up. The column will move up one row. 3. Repeat steps 1 and 2 to sequence additional columns Managing Tables

143 Creating Table Partitions Click on partition in the Create Table window. The Add Partition window is displayed. See Add Partition in Managing Table Partitions for detail. Creating Table Constraints If you want add constraints to a table, click on Table menu in Main window, click on constraint menu, and then click on the Create Constraint window shown in Figure 12-6 is displayed. Figure Create Constraint Window. Add a Constraint When you add a table constraint, you assign the constraint name, define the constraint, then save the constraint. 1. Enter the name in the Constraint Name field. 2. Enter the constraint text in the Constraint Text pane. Use one of the following methods to enter the constraint: dba/m Database Manager V7.1 User's Guide

144 Place the cursor in the Constraint Text field and enter the constraint text, or Click on the name of an existing constraint in the Constraints Name field to display the text in the Constraint Text field. Edit the constraint text to create a new one. 3. To save the new constraint, click on Execute. Alter a Constraint If you want alter a constraint, click on Table menu in Main window, click on constraint menu, and then click on Alter menu, the Alter Constraint window shown in Figure 12-7 is displayed. Figure Alter Constraint Window. To alter a constraint, choose the constraint, edit it, then save it. 1. In the Constraint pane, click on the name of the constraint you want to alter. The constraint text is displayed in the Constraint Text pane. Place the cursor in the constraint Text field and edit the text. 2. Save the modified constraint by clicking on Execute Managing Tables

145 Drop a Constraint If you want drop a constraint, click on Table menu in Main window, click on constraint menu, and then click on Drop menu, the Drop Constraint window shown in Figure 12-8 is displayed. Figure Drop Constraint Window. To drop a constraint, you choose the constraint, then delete it. In the Constraint pane click on the name of the constraint you want to delete. The constraint text is displayed in the Constraint Text pane, click on Execute. Save the Table To save the table you created, click on one of the following: Execute. Executes the command immediately. Show. Displays the SQL commands created by dba/m Database Manager without executing them. dba/m Database Manager V7.1 User's Guide

146 Queue. Queues the command to be submitted in a batch later. Altering a Table The alter-table function allows you to Change a table s file attributes or security Add columns To display the Alter Table window, click on Tables in the Main window, then click on Alter. The Alter Table window is displayed, as shown in Figure Figure Alter Table Window. Choose a Table Use the Catalogs and Tables pane to choose a table to modify. To choose a table Managing Tables

147 1. In the Catalogs field, click on the name of the catalog that contains the table you want to modify. The tables in the selected catalog are displayed in the Tables field. 2. In the Tables field, click on the table you want to modify. The attributes for the selected table are displayed. Display Dependencies Before altering a table, you can analyze the impact of the changes on other objects: To display all programs that depend on the table, click on Dependent Programs. To display all objects, including programs, that depend on the table you want to modify, click on Objects. Change File Attributes Use the File Attributes pane to change the file attributes of a table. To change a table s file attributes 1. To change extent allocation, perform one of the following: To allocate extents, click on Allocate, then enter the number of extents in the Allocate field. To de-allocate unused extents, click on Allocate to remove the checkmark. 2. Enter the lock length in the Lock Length field. 3. Enter the maximum number of extents in the Max Extents field. 4. Enter the date and time that the table cannot be purged until in the NoPurgeUntil field. 5. Enter the numeric table code in the Table Code field. 6. Enable or disable audit by clicking on Audit. 7. Enable or disable audit compression by clicking on Audit Compress. 8. Enable or disable buffered disk writes by clicking on Buffered. 9. Enable or disable clear-on purge by clicking on Clear On Purge. 10. Enable or disable field label broken flag by clicking on Reset Broken. dba/m Database Manager V7.1 User's Guide

148 11. Enable or disable serial writes by clicking on Serial Writes. 12. Enable or disable verified writes by clicking on Verified Write. 13. Enable or disable similarity check by clicking on Similarity Check. Choose Table Format Choose Format of a table by clicking either Format1 or Format2 in Format Pane. Choose Partition Array: You can choose anyone partition Array by clicking any of the option buttons in Partition Array Pane. Change Security Use the Security pane to change the security or owner and group Ids of the table. Figure Security Pane. To change the security of the table, use the drop-down lists in the R,W, E and P fields Managing Tables

149 Change the owner ID by typing a new group ID in the first Owner ID field, and a new user ID in the second field. Add Columns To add columns, click on Columns Tab of the Alter Table window. The Columns window is displayed. Refer to Add Columns on page 14-4 for instructions on adding columns to a table. Dropping a Table Use the Drop Table window to delete the definition of a table. Before dropping a table, you can analyze the impact of dropping the table by displaying all of the objects that depend on the view. To display the Drop Table window, click on Tables in the Main window, then click on Drop. The Drop Table window is displayed, as shown in Figure Figure Drop Table Window. dba/m Database Manager V7.1 User's Guide

150 Choose the Table Use the Catalogs and Tables pane to choose the table to drop. To choose the table to drop 1. In the Catalogs field, click on the catalog that contains the table you want to drop. The tables contained in the catalog you selected are displayed in the Tables field. 2. In the Tables field, Click on the table you want to drop. The attributes of the table are displayed in the Drop Table window. Display Dependencies You can display a list of objects that will be affected if you drop the selected table. Use one of the following methods to display dependent objects: To display programs that depend on the table, click on Dependent Programs. To display all SQL objects that depend on the table, including programs, click on Dependent Objects. Drop the Table When you are sure you want to drop a table, click on one of the following: Execute. Executes the command immediately. Show. Displays the SQL commands created by dba/m Database Manager. Queue. Queues the command to be submitted in a batch later. Renaming a Table Use the Rename Table window to change the name of a table. You can also analyze the impact of changing the table s name by displaying all objects that depend on the table Managing Tables

151 To display the Rename Tables window, click on Tables in the Main window, then click on Rename. The Rename Table window is displayed, as shown in Figure Figure Rename Table Window. Choose a Table Use the Catalogs and Tables pane to choose a table to rename. To choose a table 1. In the Catalogs field, click on the name of the catalog that contains the table. The tables in the selected catalog are displayed in the Tables field. 2. In the Tables field, click on the table you want to rename. The attributes of the selected table are displayed. Display Dependencies Before renaming a table, you can analyze the impact that renaming the table might have on other objects: dba/m Database Manager V7.1 User's Guide

152 To display all programs that depend on the table, click on Dependent Programs. To display all objects, including programs that depend on the table, click on Dependent Objects. Enter the New Name Use the Rename pane to change the table name, as shown in Figure To rename the table, type the new name in the Rename field. Figure Rename Pane. Rename the Table To rename the table, click on one of the following: Execute. Executes the command immediately. Show. Displays the SQL commands created by dba/m Database Manager without executing them. Queue. Queues the command to be submitted in a batch later. Managing Table Constraints Using dba/m Database Manager you can Create, change or drop constraints Add, change, or delete comment text on constraints Perform these constraint operations from the Tables Menu. Adding Constraints Use the Create Constraint window to add constraints to a table. To display the Create Constraint window Managing Tables

153 1. Click on Tables in the Main window. 2. Click on Constraint. 3. Click on Create. The Create Constraint window is displayed, as shown in Figure Figure Create Constraint Window. Choose a Table Use the Catalogs and Tables pane to choose a table to add constraints. To choose the table 1. In the Catalogs field, click on the name of the catalog that contains the table. The tables in the selected catalog are displayed in the Tables field. 2. In the Tables field, click on the name of the table. The constraints for the selected table are displayed. dba/m Database Manager V7.1 User's Guide

154 Assign a Name Assign a name for the constraint using the Constraint Name pane. Enter the constraint name in the Constraint Name field. Enter the Constraint Use the Constraint Text pane to enter the constraint. To enter the constraint, place the cursor in the Constraint Text field. You can Enter the text of the new constraint, or Click on a constraint displayed in the Constraints field. The constraint text is displayed in the Constraint Text field. Edit the constraint text as necessary. Save the Constraint To save the constraint, click on one of the following: Execute. Executes the command immediately. Show. Displays the SQL commands created by dba/m Database Manager without executing them. Queue. Queues the command to be submitted in a batch later. Modifying Constraints Use the Alter Constraint window to modify constraints. To display the Alter Constraint window 1. Click on Tables in the Main window. 2. Click on Constraint. 3. Click on Alter. The Alter Constraint window is displayed, as shown in Figure Managing Tables

155 Figure Alter Constraint Window. Choose a Table Use the Catalogs and Tables pane to choose a table. To choose the table 1. In the Catalogs field, click on the name of the catalog that contains the table. The tables in the selected catalog are displayed in the Tables field. 2. In the Tables field, click on the name of the table. The constraints for the table are displayed. Choose a Constraint Use the Constraint Name pane to choose the constraint to modify. To choose the constraint, click on the constraint in the Constraint Name field. The constraint text is displayed in the Constraint Text pane. Modify the Constraint To modify the constraint, place the cursor in the Constraint Text field and edit the text. dba/m Database Manager V7.1 User's Guide

156 Save the Constraint To save the constraint, click on one of the following: Show. Displays the SQL commands created by dba/m Database Manager without executing them. Execute. Executes the command immediately. Queue. Queues the command to be submitted in a batch later. Dropping Constraints Use the Drop Constraint window to delete constraints. To display the Drop Constraint window 1. Click on Tables in the Main window. 2. Click on Constraint. 3. Click on Drop. The Drop Constraint window is displayed, as shown in Figure Figure Drop Constraint Window Managing Tables

157 Choose a Table Use the Catalogs and Tables pane to choose a table. To choose the table 1. In the Catalogs field, click on the name of the catalog that contains the table. The tables in the selected catalog are displayed in the Tables field. 2. In the Tables field, click on the name of the table. The constraints for the table are displayed. Choose a Constraint Use the Constraint Name pane to choose a constraint to drop. Click on the constraint in the Constraint Name field. The constraint text is displayed in the Constraint Text pane. Drop the Constraint To drop the constraint, click on one of the following: Execute. Executes the command immediately. Show. Displays the SQL commands created by dba/m Database Manager without executing them. Queue. Queues the command to be submitted in a batch later. Managing Constraint Comments Using the Comments for Table Constraints window, you can add, change, or delete constraint comments. Constraint comments consist of one or more lines of text. To display the Comment on Constraint window 1. Click on Tables in the Main window. 2. Click on Constraint. 3. Click on Comment. The Comments for Table Constraints window is displayed, as shown in Figure dba/m Database Manager V7.1 User's Guide

158 Figure Comments for Table Constraints Window. Choose a Table Use the Catalogs and Tables pane to choose a table. To choose a table 1. In the Catalogs field, click on the name of the catalog that contains the table. The tables in the selected catalog are displayed in the Tables field. 2. In the Tables field, click on the name of the table. The constraints for the table are displayed. Choose a Constraint Use the List of Constraints pane to choose a constraint. To choose a constraint, click on the name of the constraint. The text of the constraint comment is displayed in the Comment Text pane. Add, Change, or Delete the Comment To add comments to a constraint 1. Click on Add Line. The cursor is placed on the next available line in the Comment Text pane. 2. Enter the comment. 3. Repeat steps 1 and 2 to add comments Managing Tables

159 To change a comment, click on the line you want to modify. The cursor is placed on the line; edit the comment as desired. To delete a comment, click on the line of comment you want to delete, then click on Delete Line. Save the Constraint Comment To save the constraint, click on one of the following: Execute. Executes the command immediately. Show. Displays the SQL commands created by dba/m Database Manager without executing them. Queue. Queues the command to be submitted in a batch later. Managing Help Text You can add, change, or delete help text for columns in a table. The help text consists of one or more lines of text. To display the Help Text for Tables window, click on Tables in the Main window, then click on Help Text. The Help Text for Tables window is displayed, as shown in Figure dba/m Database Manager V7.1 User's Guide

160 Figure Help Text for Tables Window. Choose the Column Use the Catalogs, Tables, and Columns pane to choose the column. To choose the column 1. In the Catalogs field, click on the name of the catalog that contains the table. The tables in the catalog are displayed in the Tables field. 2. In the Tables field, click on the name of the table. The columns in the table are displayed in the Column Name field. 3. In the Column Name field, click on the column. If there is any help text associated with the column, the help text is displayed in the Help Text pane. Add, Change, or Delete Help Text To add help text 1. Click on Add Line. The cursor is placed on the next available line in the Help Text pane. 2. Enter the comment. 3. Repeat steps 1 and 2 to add additional help text. To change help text, click on the line you want to modify. The cursor is placed on the line; edit the help text as desired. To delete help text, click on the line of text you want to delete, then click on Delete Line. Save the Help Text To save new or modified help text, or to delete it, click on one of the following buttons: Execute. Executes the command immediately. Show. Displays the SQL commands created by dba/m Database Manager without executing them. Queue. Queues the command to be submitted in a batch later Managing Tables

161 Managing Table Comments You can add, change, or delete comments in a table. Table comments consist of one or more lines of text. To display the Table Comment window, click on Tables in the Main window, then click on Table Comment. The Table Comment Text window is displayed, as shown in Figure Figure Table Comment Window. Choose a Table Use the Catalogs and Tables pane to choose a table. To choose the table 1. In the Catalogs field, click on the name of the catalog that contains the table. The tables in the catalog are displayed in the Tables field. 2. In the Tables field, click on the name of the table. If there is a comment associated with the table, it is displayed in the Comment Text pane. Add, Change, or Delete Table Comments To add table comments dba/m Database Manager V7.1 User's Guide

162 1. Click on Add Line. The cursor is placed on the next available line in the Comment Text pane. 2. Enter the comment. 3. Repeat steps 1 and 2 to add additional comments. To change table comments, click on the line you want to modify. The cursor is placed on the line; edit the table comment as desired. To delete table comments, click on the line of text you want to delete, then click on Delete Line. Save the Table Comment To save new or modified table comments, or to delete them, click on one of the following buttons: Execute. Executes the command immediately. Show. Displays the SQL commands created by dba/m Database Manager without executing them. Queue. Queues the command to be submitted in a batch later. Managing Column Comments You can add, change, or delete comments in the columns of a table. Column-comment text consists of one or more lines of text. To display the Comments for Table Columns window, click on Tables in the Main window, then click on Column Comment. The Comments for Table Columns window is displayed, as shown in Figure Managing Tables

163 Figure Comments for Table Columns Window. Choose the Column Use the Catalogs, Tables, and Columns pane to choose the columns of a table. To choose a column 1. In the Catalogs field, click on the name of the catalog that contains the table. The tables in the catalog are displayed in the Tables field. 2. In the Tables field, click on the name of the table. The columns in the table are displayed in the Column Name field. 3. In the Column Name field, click on the name of the column. If there is any comment text associated with the column, it is displayed in the Comment Text pane. Add, Change, or Delete the Column Comment Use the Comment Text pane to add, change, or delete comment text. To add column comments 1. Click on Add Line. The cursor is placed on the next available line in the Comment Text pane. 2. Enter the comment. 3. Repeat steps 1 and 2 to add additional comments. dba/m Database Manager V7.1 User's Guide

164 To change column comments, click on the line you want to modify. The cursor is placed on the line; edit the column comment as desired. To delete column comments, click on the line of text you want to delete, then click on Delete Line. Save the Column Comment To save new or modified column-comments, or to delete them, click on one of the following: Execute. Executes the command immediately. Show. Displays the SQL commands created by dba/m Database Manager without executing them. Queue. Queues the command to be submitted in a batch later. Managing Table Statistics You can display or update four types of statistics: table, partition, column, and index. To display the Table Statistics window, click on Tables in the Main window, then click on Statistics. The Table Statistics window is displayed, as shown in Figure Managing Tables

165 Figure Table Statistics Window. Choose the Tables Use the Catalogs and Tables pane to choose one or more tables. To choose tables 1. In the Catalogs field, click on the name of the catalog that contains the tables. The tables in the catalog are displayed in the Tables field. 2. In the Tables field, choose tables using one of the following methods: Choose one or more tables by clicking on each table, or Choose all tables in the catalog shown by clicking on SelectAllTables. The table statistics for all of the selected tables, column statistics for the first table, and index statistics for the first table are displayed. Display the Statistics You can display table, column, or index statistics: dba/m Database Manager V7.1 User's Guide

166 Table statistics. Table statistics are automatically displayed for all selected tables. Column, partition, and Index statistics. To display column and index statistics, double-click on the name of the table. The column statistics are displayed in the Column Statistics pane, as shown in Figure The index statistics are displayed in the Index Statistics pane, as shown in Figure Figure Column Statistics Pane. Figure Index Statistics Pane Managing Tables

167 Display Dependencies Before updating table statistics, you can analyze the impact that the changes might have on other objects; To display all programs that depend on the statistics, click on Dependent Programs. To display all objects, including programs, that depend on the statistics, click on Dependent Objects. Update the Statistics Using the Table Statistics pane, you can update the statistics of a subset of tables. Choose Tables To choose tables 1. You can choose a subset of tables, or all tables: To choose a table, click on Update Statistics for the table whose name is displayed in the Table field. The Update Statistics field changes to Y (for yes), indicating that statistics for the selected table will be updated. To deselect a selected table, click on the Update Statistics again. Repeat this process for all tables you want to update. To choose all tables, click on SelectAllTables. The Update Statistics field for all tables changes to Y(for Yes), indicating that the update will be performed on all tables. To deselect all the selected tables, click on DeSelectAll. Click on UpdateStatistics. The Update Statistics window is displayed, as shown in Figure dba/m Database Manager V7.1 User's Guide

168 Figure Update Statistics Window. Choose Update Options Use the Update Statistics window to update the statistics on a set of tables as shown in Figure The selected tables are shown in the Table Name field. The Update Statistics field for each table is set to Y (for yes). If you do not want to update statistics for a table, click on the corresponding Update Statistics field. The value of the field changes to N (for no), indicating that the table s statistics will not be updated. Before updating the statistics, set the following statistics options. Refer to Figure as needed. 1. Enable or disable the recompile option: To enable or disable the option for one table, click on Recompile for the table. The value of the Recompile field changes to Y if it was N and vice versa. To enable the option for all tables, click on SetRecompileOptionToYes. The Recompile field changes to Y in all tables Managing Tables

169 To disable the option for all tables, click on SetRecompileOptionToNo. The Recompile changes to N in all tables. 2. Enable or disable the All Columns option: To enable or disable the option for one table, click on the All Columns field for the table. The value of the All Columns field changes to Y if it was N and vice versa. To enable the option for all tables, click on SetAllColumnsOptionToYes. The All Columns field changes to Y in all tables. To disable the option for all tables, click on SetAllColumnsOptionToNo. The All Column changes to N in all tables. Perform the Update To perform a statistics update, click on one of the following: Execute. Executes the command immediately. Show. Displays the SQL commands created by dba/m Database Manager without executing them. Queue. Queues the command to be submitted in a batch later. Invoking a Table The invoke table function allows you to create the DDL of a table for the following languages: SQL, TAL, COBOL, or C. To display the Invoke Table window, click on Tables in the Main window, then click on Invoke. The Invoke Table window is displayed, as shown in Figure dba/m Database Manager V7.1 User's Guide

170 Figure Invoke Table Window. Choose a Table Use the Catalogs and Tables pane to choose a table. To choose a table 1. In the Catalogs field, click on the name of the catalog that contains the table. The tables in the selected catalog are displayed in the Tables field. 2. In the Tables field, click on the name of the table you want to invoke. Set Invoke Options Use the Options pane to specify invocation options, as shown in Figure All of the options do not apply to all of the languages Managing Tables

171 Figure Options Pane. To set invocation options 1. In the Format field, click on the arrow to display the target languages. Click on the name of the target language. 2. Enter the name of the record in the As Recordname field. 3. Choose the date format by clicking on Default, European, or USA. 4. Enter the prefix-indicator variable name in the Prefix field. 5. Enter the suffix-indicator variable name in the Suffix field. 6. Use the Null Structure check-box to specify a structure declaration for data and null indicators. 7. Enter the base level in the Base Level field. 8. Enter the increment in the Increment field. Specify Output-File Attributes Use the Output File pane to specify attributes of the output file, as shown in Figure dba/m Database Manager V7.1 User's Guide

172 Figure Output File Pane. To specify output file attributes 1. Enter the name of the node in the Node field. 2. Enter the name of the volume in the Volume field. 3. Enter the name of the subvolume in the Subvolume field. 4. Enter a file name in the File field. 5. Enter the host identifier to be used in the SECTION directive in the Section field. 6. Use the Clear check-box to indicate whether the invoke output replaces the contents of the output file or is appended to it. Invoke the Table To invoke the table immediately, click on Execute. Display the Output Output of the invoke is displayed in the Invoke Output window, as shown in Figure Managing Tables

173 Figure Invoke Output Window You can use the Edit and Print menus in the Invoke Output window to work with the results, as follows: To select all or part of the output, use the Select option in the Edit menu. To copy the selected text to the MS Windows clipboard, use the Copy option in the Edit menu. To define printer options, use the Printer Setup option in the Print menu. To print the selected text, use the Print option in the Print menu. dba/m Database Manager V7.1 User's Guide

174 Figure Recreate Tables Window. Recreating Tables The Recreate Table function allows you to create an SQL script that will create the table, partitions of the table, and indexes on the table as it exists on the Tandem at the time you execute this function. You can save the script for later use by clicking Save Command. To recreate a table 1. Select the table to be recreated from the Catalogs and Tables pane 2. Commands, columns names and statistics for the table selected will be displayed 3. Click on SaveCommand to save the SQL script, or click on Close to cancel Managing Tables

175 CHAPTER 13. MANAGING VIEWS Managing views is simple with dba/m Database Manager. Using the procedures in this chapter you can Create views Alter views Drop views Invoke views Recreate view Rename views Add, change, or delete help text Add, change, or delete view comments Add, change, or delete column comments in a view Create-Like views You manage views by accessing windows from the Object Tree button, the Custom Tree button, or the Views button. The procedures in this chapter describe how to access view management windows from the Views button. Refer to Chapter 3 for information about managing views from the Object Tree, and Chapter 4 for information about the Custom Tree. dba/m Database Manager V7.1 User's Guide

176 Invoke Help Text View Comment Column Comment Recreate Creating a View When you create a view, you define the view name, location, type, and security string. Then you choose the base table and table columns and define WHERE clauses for the view. Click on Views in the Main window, then click on Create. The Create View window is displayed, as shown in Figure Figure Create View Window. Assign Name and Location Use the first portion of the Create View window to assign the new view s name and location. An example of the Name and Location pane is shown in Figure Managing Indexes

177 Figure Name and Location Pane. To assign the name and location of the view 1. Type the name of node in the Node field. 2. Type the name of the volume in the Volumes field. 3. Type the name of the subvolume in the Subvolumes field. 4. Type the name of the new view in the Views field. Choose the Type of View Use the Name and Location pane in Figure 13-2 to specify the type of view. To choose the view type, click on Protection or Shorthand. If you choose Protection, choose the additional attributes, Check Option, Headings, Help Text, or Similarity Check, by clicking on the desired box. If you choose Shorthand, choose the attributes, Headings, Help Text, or Similarity Check, by clicking on the desired box. Assign a Security Assign a security string for the view in the Security pane, as shown in Figure Set the security string using the drop-down lists in the R, W, E, and P fields. Note: The owner ID and group ID of the view cannot be changed. dba/m Database Manager V7.1 User's Guide

178 Figure Security Pane. Choose a Base Table Use the Base Table Catalog and Base Table panes to choose base tables for the view, as shown in Figure Figure Base Table Catalogs and Base Tables Pane. 1. In the list of catalogs shown in the Catalog field, double-click on the catalog that contains the base table for the view. The tables in the catalog are displayed in the Table field, as shown in Figure Double-click on the table you want to use as a base table. The table name, alias, and column names and their data types are displayed in the Create View window, as shown in Figure Repeat Steps 1 and 2 to choose all base tables and their columns. Figure Base Tables and Columns Pane Managing Indexes

179 The fields shown in the Base Tables and Columns pane are defined as follows: Table Name, name of the base table. Alias, correlation name used in the view definition. Table Column Name, name of the column in the base table. Type, data type of the columns in the base table. View Column Name, name of the column in the view. Heading, the heading text for the column in the view. Display Indexes on Base Tables You display the indexes on the base table by clicking on the Show Index button. All indexes and index columns are displayed in the Indexes View window. Add Columns Use the fields in the Base Tables and Columns pane to add columns to the view. To add a column to the base table 1. In the Table Column Name field, double-click on the name of the column you want to add to the view. The selected column name is displayed in the View Column Name field. To select all columns, click on the Select All button. 2. Place the cursor in the View Column Name field to edit the name of the column. 3. Place the cursor in the Heading field to enter the name of the column. 4. Repeat Steps 1 through 3 to add more columns. 5. After you have selected all columns for the view and edited their names and headings, click on Projection to create the columns list for the view. Part of the CREATE VIEW statement appears in the View Text pane. An example of the View Text pane is shown in Figure To clear all columns, click on the Clear All button. dba/m Database Manager V7.1 User's Guide

180 Figure View Text Pane. Delete Columns To delete columns from the view, perform the following steps using the Base Tables and Columns pane. 1. In the View Column Name field, click on the row header of the column you want to delete. The corresponding Table Column Name field is highlighted. To deselect a column, click on the row header again. 2. In the Table Column Name field, click on the name of the column. The column is deleted from the View Column Name field. 3. Click on Projection. The View Text pane displays the modified columns list. Insert Columns To insert a new column in the view, perform the following steps. To insert a new column before an existing column, click on the row header of an existing column name in the View Column Name field. To deselect a column, click on the row header again. 1. In the Table Column Name field, click on the column name you want to insert in the view. The column is inserted in the View Column Name field. 2. Click on Projection. The View Text pane displays the modified columns list. Change Column Attributes To change a column name or heading 13-6 Managing Indexes

181 1. Select the column you want to change by clicking on the column name shown in the View Column Name field. The corresponding Table Column Name field is highlighted. 2. Place the cursor in the View Column Name field to edit the name of the column. 3. Place the cursor in the Heading field to enter the name of the column. 4. Click on Projection. The View Text pane displays the new columns list. Add, Change, or Delete a WHERE Clause You can complete the definition of the view by adding a WHERE clause to the View Text pane. An example of the View Text pane is shown in Figure You can also change or delete a WHERE clause. To add a WHERE clause 1. Click on Predicate. The following statement is added after CREATE VIEW statement in the View Text pane. CREATE VIEW... AS SELECT... FROM... WHERE 2. Type the WHERE clause after the word WHERE. Note: You can use the alias name of the base tables in the WHERE clause. To delete a WHERE clause, click on Predicate. The clause after the word WHERE is deleted. To change a WHERE clause, edit an existing WHERE clause in the View Text pane. To display the table indexes in the View window, click on the Show Index button. Save the View After you have defined the new view, click on one of the following: Execute. Executes the command immediately. Show. Displays the SQL commands created by dba/m Database Manager without executing them. Queue. Queues the command to be submitted in a batch later. dba/m Database Manager V7.1 User's Guide

182 Altering a View The Alter View function allows you to change the name, column headings, or security of a view. You can also analyze the impact of the changes on the view by displaying the objects that depend on the view. To display the Alter View window, click on Views, then click on Alter. The Alter View window is displayed, as shown in Figure Choose the View To choose a view, perform the following steps. In the Catalogs field, double-click on the catalog that contains the view you want to alter. The list of views in the catalog is displayed in the Views field. 1. Double-click on the view you want to alter. The attributes of the view are displayed in the Alter View window. Figure Alter View Window Managing Indexes

183 Figure Catalog and View Pane. Display Dependencies Before altering a view, you can analyze the impact of altering it: To display the programs that depend on the table, click tab Dependent Programs. Programs which would be invalidated by moving the partition are displayed. To display all objects, including programs, that depend on the table, click tab Dependent Objects. All SQL objects that depend on the table are displayed. Change the Column Heading To change a column heading in the view, perform the following steps. Refer to Figure 13-9 for an example of the Column pane in the Alter View window. Place the cursor in the Heading field and edit the text. Figure Column Pane in Alter View Window. Change Security Assign a security string in the Security pane, as shown in Figure You cannot change a protection view s group ID or owner ID. 1. Use the drop-down lists in the R, W, E, and P fields in the Security pane. dba/m Database Manager V7.1 User's Guide

184 2. For a shorthand view, change the group ID in the first Owner ID field, and the user ID in the second Owner ID field. Figure Security Pane. Change Similarity Check You can choose Similarity Check by clicking in the Similarity Check field in the View pane. Save the View After you have altered a view, click on one of the following: Execute. Executes the command immediately. Show. Displays the SQL commands created by dba/m Database Manager. Queue. Queues the command to be submitted in a batch later. Dropping a View Use the Drop View window to delete the definition of a view. Before dropping a view, you can analyze the impact of dropping the view by displaying all of the objects that depend on the view. To display the Drop View window, click on Views in the Main window, then click on Drop. The Drop View window is displayed, as shown in Figure Managing Indexes

185 Figure Drop View Window. Choose the View Use the Catalogs and Views pane to choose the view to drop. To choose the view to drop 3. In the Catalogs field, double-click on the catalog that contains the view you want to drop. The views contained in the catalog you selected are displayed in the Views field. 4. In the Views field, Double-click on the view you want to drop. The attributes of the view are displayed in the Drop View window. Display Dependencies You can display a list of objects that will be affected if you drop the selected view. Use one of the following methods to display dependent objects: To display programs that depend on the view, click on Dependent Programs. To display all SQL objects that depend on the view, including programs, click on Dependent Objects. dba/m Database Manager V7.1 User's Guide

186 Drop the View When you are sure you want to drop a view, click on one of the following: Execute. Executes the command immediately. Show. Displays the SQL commands created by dba/m Database Manager. Queue. Queues the command to be submitted in a batch later. Invoke View To invoke a view, click on Invoke in the Views menu in the Main window. The Invoke View window, as shown in Figure 13-12, will be displayed. Figure Invoke Window. Choose the View 1. In the Catalogs field, double-click on the catalog that contains the view you want to invoke. The list of views in the catalog is displayed in the Views field. 2. Double-click on the view you want to invoke. The attributes of the view are displayed in the Invoke window Managing Indexes

187 3. Edit the Generations Options List, Date, Indicator Designation and Levels panes. 4. When you have finished, click Execute to execute the new command, or click Close to cancel. Recreate the View To recreate the view, click on Recreate in the Views menu in the Main window. The Recreate window, as shown in Figure 13-13, is displayed. Figure Recreate View Window. Once the view is selected, dba/m Database Manager will display the script used to create the view. Click on SaveCommand to save the Create View command. dba/m Database Manager V7.1 User's Guide

188 Create Like You can edit the script used to create a similar view with the Create Like feature. To create a new script, select Create Like from the View menu in the Main window. The Create Like window, as displayed in Figure 13-14, will be shown. Figure Create Like Window. Choose the View 1. In the Catalogs field, double-click on the catalog that contains the view you want to use. The views contained in the catalog you selected are displayed in the Views field. 2. In the Views field, Double-click on the view you want to use. The attributes of the view are displayed in the Drop View window. The view columns and headings will be shown in the Columns pane of the Create Like window. The definition for the view will be shown in the Definition pane. Display Dependencies You can analyze the impact of creating another view: Managing Indexes

189 To display the programs that depend on the script, click on Dependent Programs. Programs that would be invalidated by the change are displayed. To display all objects, includin programs that depend on the script, click on Dependent Objects. All SQL objects that depend on the script are displayed. Create New View You may edit the script shown to create a new view. Save New View After you have defined the new view, click on one of the following: Execute. Executes the command immediately. Show. Displays the SQL commands created by dba/m Database Manager without executing them. Queue. Queues the command to be submitted in a batch later. Renaming a View Use the Rename window to change the name of a view. You can also analyze the impact of changing the view s name by displaying the objects that depend on the view. To display the Rename window, click on Views in the Main window, then click on Rename. The Rename View window is displayed, as shown in Figure dba/m Database Manager V7.1 User's Guide

190 Figure Rename View Window. Choose the View Use the Catalog and View pane shown in Figure to choose a view. To choose the view Figure Catalog and View Pane. 1. In the Catalogs field, double-click on the catalog that contains the view you want to rename. The list of views in the catalog is displayed in the Views field. 2. Double-click on the view in the Views field. The attributes of the view are displayed in the Rename View window. Display Dependencies Before moving a partition in a table, you can analyze the impact of moving it: Managing Indexes

191 To display the programs that depend on the table, click on Dependent Programs. Programs that would be invalidated by moving the partition are displayed. To display all objects, including programs, that depend on the table, click on Dependent Objects. All SQL objects that depend on the table are displayed. Change the Name In the Rename pane, type the new view name in the Rename field. Figure shows an example of the Rename pane. Figure Rename Pane Save the View To save the new name of the view, click on one of the following: Execute. Executes the command immediately. Show. Displays the SQL commands created by dba/m Database Manager. Queue. Queues the command to be submitted in a batch later. Managing Help Text You can add, change, or delete help text for columns in a view. Help text consists of one or more lines of text. To display the Help Text window, click on Views in the Main window, then click on Help Text. The Help Text for Views window is displayed, as shown in Figure dba/m Database Manager V7.1 User's Guide

192 Figure View Help Text Window Choose the View Use the Catalogs and Views pane to choose the column for which you want to modify the help text, as shown in Figure Figure Catalogs and Views Pane. To choose the view 1. In the Catalogs field, double-click on the catalog that contains the view you want to modify. The list of views in the catalog is displayed in the Views field. 2. In the Views field, double-click on the view you want to modify. The columns in the view are displayed in the Column Attributes pane, as shown in Figure Managing Indexes

193 Choose the Column Use the Column Attributes pane to choose the column for which you want to modify the help text. An example of this pane is shown in Figure In the Column Name field, click on the name of the column to select it. If the column has help text, the help text is displayed in the Help Text pane, as shown in Figure Figure Column Attributes Pane. Add, Change, or Delete Help Text Refer to Figure for an example of the Help Text pane. To add help text Figure Help Text Pane. 1. Click on Add Line. The cursor is placed on the next available line in the Help Text pane. 2. Enter the help text. 3. Repeat steps 1 and 2 to add additional lines. To change help text, click on the line you want to modify. The cursor is placed on the line; edit the help text as desired. To delete help text, click on the line of text you want to delete, then click on Delete Line. dba/m Database Manager V7.1 User's Guide

194 Save the Help Text To save new or changed help text, click on one of the following: Execute. Executes the command immediately. Show. Displays the SQL commands created by dba/m Database Manager. Queue. Queues the command to be submitted in a batch later. Managing View Comments You can add, change, or delete comment text in a view. Comments consist of one or more lines of text. To display comment text, click on Views in the Main window, then click on View Comment. The View Comment Text window is displayed, as shown in Figure Figure View Comment Text Window Managing Indexes

195 Choose the View Use the Catalogs and Views pane to choose a view. Figure is an example of the Catalogs and Views pane. To choose the view Figure Catalogs and Views Pane. 1. In the Catalogs field, double-click on the catalog that contains the view you want to modify. The list of views in the catalog is displayed in the Views field. 2. Double-click on the view you want to modify. If the view has any comment text, the comment text is displayed in the Comment Text pane, as shown in Figure Figure Comment Text Pane Add, Change, or Delete Comment Use the Comment Text pane to add, change, or delete comments. An example of the Comment Text pane is shown in Figure Click on Add Line. The cursor is placed on the next available line in the Comment Text pane. 2. Enter the comment. 3. Repeat steps 1 and 2 to add additional lines. dba/m Database Manager V7.1 User's Guide

196 To change help text, click on the line you want to modify. The cursor is placed on the line; edit the help text as desired. To delete help text, click on the line of text you want to delete, then click on Delete Line. Save the View Comment To save changes to the comment text, click on one of the following: Execute. Executes the command immediately. Show. Displays the SQL commands created by dba/m Database Manager. Queue. Queues the command to be submitted in a batch later. Managing Column Comments You can add, change, or delete comment text in the columns of a view. Comments consists of one or more lines of text. To display the Column Comment window, click on Views in the Main window, then click on Column Comment. The Column Comment window is displayed, as shown in Figure Figure Column Comment Window Managing Indexes

197 Choose the Columns Use the Catalogs, Views, and Columns pane to choose the columns of a view. Figure shows an example of this pane. Figure Catalogs, Views and Columns. To choose the columns of a view 1. In the Catalogs field, double-click on the catalog name that contains the view you want to modify. The list of views in the catalog is displayed in the Views field. 2. Double-click on the view you want to modify. The columns in the view are displayed in the Column Icon field. 3. In the Column Icon field, double-click on the column you want to modify. If there is any comment text associated with the column, the text is displayed in the Comment Text window. Add, Change, or Delete Comment Use the Comment Text pane to add, change, or delete comment text. An example of the Comment Text pane is shown in Figure Figure Comment Text Pane. 1. Click on Add Line. The cursor is placed on the next available line in the Comment Text pane. 2. Enter the comment. 3. Repeat steps 1 and 2 to add additional lines. dba/m Database Manager V7.1 User's Guide

198 To change help text, click on the line you want to modify. The cursor is placed on the line; edit the help text as desired. To delete help text, click on the line of text you want to delete, then click on Delete Line. Save the Column Comment To save changes to the comment text, click on one of the following: Execute. Executes the command immediately. Show. Displays the SQL commands created by dba/m Database Manager. Queue. Queues the command to be submitted in a batch later. Invoking a View You can create the DDL of a view for the following languages: SQL, TACL, COBOL, and C. To display the Invoke View window, click on Views in the Main window, then click on Invoke. The Invoke View window is displayed, as shown in Figure Managing Indexes

199 Figure Invoke View Window. Choose a View Use the Catalogs and Views pane to choose a view, as shown in Figure Figure Catalogs and Views Pane. To choose a view 1. In the Catalogs field, double-click on the name of the catalog that contains the view. The views in the selected catalog are displayed in the Views field. 2. In the Views field, double-click on the name of the view you want to invoke. Set Invocation Options Use the Generation Option List pane to specify the invocation options, as shown in Figure The options do not apply to all languages. Figure Generation Option List Pane. To set invocation options dba/m Database Manager V7.1 User's Guide

200 1. In the drop-down list in the Format field, double-click on the target language. 2. Enter the name of the record in the As Recordname field. 3. Choose the date format by clicking on Default, European, or USA. 4. Enter the prefix-indicator variable name in the Prefix field. 5. Enter the suffix-indicator variable name in the Suffix field. 6. To specify a structure declaration for data and null indicators, click on Null Structure. 7. Enter the base level in the Base Level field. 8. Enter the increment in the Increment field. Specify Output-File Attributes Use the Output File pane to specify the output file s attributes, as shown in Figure Figure Output File Pane. To specify output-file attributes 1. Enter the name of the node in the Nodes field. 2. Enter the name of the volume in the Volumes field. 3. Enter the name of the subvolume in the Subvolumes field Managing Indexes

201 4. Enter the host identifier to be used in the SECTION directive in the Section field. 5. Click on Clear to indicate whether the invoke output replaces the contents of the output file or is appended to it. A blank box means invoke output appends the output file. A checked box means invoke output replaces the contents of the output file. Invoke the View To invoke the view immediately, click on Execute. Display the Output Output of the invoke is displayed in the Invoke Output window, as shown in Figure Figure Invoke Output Window. You can use the Edit and Print menus in the Invoke Output window to work with the results, as follows: To select all or part of the output, use the Select option in the Edit menu. To copy the selected text to the MS Windows clipboard, use the Copy option in the Edit menu. To define printer options, use the Printer Setup option in the Print menu. To print the selected text, use the Print option in the Print menu. dba/m Database Manager V7.1 User's Guide

202

203 CHAPTER 14. MANAGING INDEXES Using dba/m Database Manager index-management windows, you can Create indexes Alter indexes Drop indexes Rename indexes Add comments to an index Display index statistics You can manage indexes by accessing windows from the Object Tree, the Custom Tree, or the Indexes button. The procedures in this chapter only describe how to access index management windows from the Index button. Refer to Chapter 3 for information about managing indexes from the Object Tree, and Chapter 4 for information about the Custom Tree. Creating an Index Using the Create Index window, you can create an index on a table. You can define all of the attributes of an index, including the index partitions. To display the Create Index window, click on Index in the Main window, then click on Create. The Create Index window is displayed, as shown in Figure dba/m Database Manager V7.1 User's Guide

204 Figure14-1. Create Index Window. Assign Name and Location You must assign a name to the new index. You can use the default location or assign a location. If you do not assign a location, the index is created in your default node, volume, subvolume, and catalog. The default location is displayed in the Name and Location pane. To assign the name and location of the index 1. Enter the name of node in the Node field. 2. Enter the name of the volume in the Volumes field. 3. Enter the name of the subvolume in the Subvolume field. 4. Type a name for the index in the Indexes field. 5. Indicate whether the index is unique by clicking on Unique. 6. Click on the name of the catalog to choose the catalog to contain the index Managing Indexes

205 Choose the Table Use the Catalogs and Table pane to choose the table. 1. In the Catalog pane, double-click on the catalog that contains the table, the tables in the catalog are displayed. 2. Double-click on the name of the table. The columns of the base table are displayed in the Columns pane. Assign Index Columns Use the Column pane to choose the index columns. To define index columns 1. Choose the first column of the index by clicking on the name of the column. 2. Click in the Key checkbox to indicate the selected column is an index column. The order of the index columns is displayed in the Sequence field of the Columns pane. 3. Set the index order by clicking on Ascending or Descending. The order is displayed in the Ascending field of the Columns pane. 4. For collation specification, first click on the Collate checkbox and type the collate specification in the CollateSpec field of the Columns pane. 5. Repeat Steps 2 and 3 to define all columns in the index. Note: If the order shown in the Sequence Number field is not correct, click on ClearKey to cancel the selected columns. Repeat Steps 1-5 in the order that the columns must appear in the index. Assign File Attributes Use the File Attributes pane to define file attributes for the index. To define file attributes 1. Enter the number of extents in the Allocate field. 2. Enter the size of index block in the Block Size field. dba/m Database Manager V7.1 User's Guide

206 3. Enter the maximum number of extents in the Max Extents field. 4. Enter the earliest date and time that the index can be purged in the NoPurgeUntil field. 5. Enter the numeric table code in the Table Code field. 6. Enter the minimum percentage of space to be left in a data block in the DSlack field. 7. Enter the minimum percentage of space to be left in an index block in the ISlack field. 8. Enter the minimum percentage of space to be left in data and index blocks in the Slack field. 9. Enable or disable audit compression by clicking on Audit Compress. 10. Enable or disable the buffered option by clicking on Buffered. 11. Enable or disable the clear-on-purge option by clicking on Clear On Purge. 12. Enable or disable data compression by clicking on DCompress. 13. Enable or disable index compression by clicking on ICompress. 14. Enable or disable serial writes by clicking on Serial Writes. 15. Enable or disable the verified-write option by clicking on Verified Write. Choose Index Format Choose Format of a index by clicking either Format1 or Format2 in File Format Pane. Assign Additional Attributes Define additional attributes, such as key tag, configuration file, shared access and compiling options Managing Indexes

207 To assign miscellaneous attributes 1. Enter the key tag in the Key Tag field.. 2. Enable or disable the invalidate-programs option by clicking on Invalidate. 3. Enable or disable parallel execution by clicking on Parallel Execution. If enabled, enter the configuration file name in the Configuration field. 4. Enable or disable shared access by clicking on Shared Access. Save the Index To save the index, click on one of the following: Execute. Executes the command immediately. Show. Displays the SQL commands created by dba/m Database Manager without executing them. Queue. Queues the command to be submitted in a batch later. Altering an Index Using the Alter Index window, you can change an index s security or file attributes, or add, change, or delete partitions in the index. You can also analyze the impact of the changes on other SQL objects before you save the changes. To display the Alter Index window, click on Indexes in the main window, then click on Alter. The Alter Index window is displayed, as shown in Figure dba/m Database Manager V7.1 User's Guide

208 Figure Alter Index Window. Choose an Index To choose an index to alter 1. In the Catalogs field, double-click on the name of the catalog that contains the index. The indexes in the catalog are displayed in the Catalogs and Indexes pane. 2. In the Indexes field, double-click on the index you want to alter. The attributes of the index are displayed in the File Attributes pane. Display Dependencies Before altering an index, you can analyze the impact that the changes will have: To display the programs that depend on the index, click on Dependent Programs. Programs which would be invalidated by altering the index are displayed. To display all objects, including programs, that depend on the index, click on Dependent Objects. All SQL objects that depend on the index are displayed Managing Indexes

209 Change Security To change the security of an index, use the drop-down lists in the R, W, E, and P fields in the Security pane. You cannot change the owner ID or group ID of an index. Change File Attributes You can changes any of the attributes in the File Attributes pane. To change the file attributes of an index 1. To change extent allocation, perform one of the following: To allocate extents, click on Allocate, then enter the initial number of extents in the Allocate field. To deallocate unused extents, click on Allocate to remove the checkmark. 2. To change the lock length, enter the new number in the Lock length field. 3. Enter the maximum number of extents in the Max Extents field. 4. Enter the date and time after which the table can be purged in the NoPurgeUntil field. 5. Enter the table code in the Table Code field. 6. Enable or disable audit by clicking on Audit. 7. Enable or disable audit compression by clicking on Audit Compress. 8. Enable or disable the buffered option by clicking on Buffered. 9. Enable or disable the clear-on-purge option by clicking on Clear On Purge. 10. Enable or disable the reset-broken option by clicking on Reset Broken. 11. Enable or disable serial writes by clicking on Serial Writes. 12. Enable or disable the verified-write option by clicking on Verified Write. dba/m Database Manager V7.1 User's Guide

210 Partitions The name of partitions for the altered index is displayed in the Partitions pane. Choose Index Format Choose Format of a index by clicking either Format1 or Format2 in File Format Pane. Save the Index To save the modified index attributes, click on one of the following: Execute. Executes the command immediately. Show. Displays the SQL commands created by dba/m Database Manager without executing them. Queue. Queues the command to be submitted in a batch later. Dropping an Index Use the Drop Index window to delete an index. Before dropping an index, you can analyze the impact of dropping it by displaying a list of SQL objects that depend on the index. To display the Drop Index window, click on Indexes in the Main window, then click on Drop. The Drop Index window is displayed, as shown in Figure Managing Indexes

211 Figure Drop Index Window. Choose an Index Use the Catalogs and Index pane to choose the index for deletion. To choose an index to drop 1. In the Catalogs field, double-click on the name of the catalog that contains the index. The indexes in the catalog are displayed in the Indexes field. 2. In the Indexes field, double-click on the name of the index you want to drop. The attributes of the index are displayed. Display Dependencies Before dropping an index, you can analyze the impact of dropping it: To display the programs that depend on the index, click on Dependent Programs. Programs that would be invalidated by dropping the index are displayed. To display all objects, including programs, that depend on the index, click on Dependent Objects. All SQL objects that depend on the index are displayed. dba/m Database Manager V7.1 User's Guide

212 Drop the Index To drop the index, click on one of the following: Execute. Executes the command immediately. Show. Displays the SQL commands created by dba/m Database Manager without executing them. Queue. Queues the command to be submitted in a batch later. Renaming an Index Use the Rename Index window to rename an index. You can also analyze the impact of changing the index s name by displaying all objects that depend on the index. To display the Rename Index window, click on Indexes in the Main window, then click on Rename. The Rename Index window appears, as shown in Figure Figure Rename Index Window Managing Indexes

213 Choose an Index Use the Catalogs and Indexes pane to choose an index to rename. To choose an index 1. In the Catalogs field, double-click on the name of the catalog that contains the index. The indexes in the selected catalog are displayed in the Indexes field. 2. Double-click on the index you want to rename. The attributes of the selected index are displayed. Display Dependencies Before renaming an index, you can analyze the impact of renaming: To display the programs that depend on the index, click on Dependent Programs. Programs that would be invalidated by renaming the index are displayed. To display all objects, including programs, that depend on the index, click on Objects. All SQL objects that depend on the index are displayed. Assign the New Name Use the Rename pane to change the index name. To rename the index, type the new name in the Rename field. Managing Index Comments You can add, modify, or delete comments for an index. Index comments consist of one or more lines of text. To display the Index Comment window, click on Indexes in the Main window, then click on Index Comments. The Index Comments window is displayed, as shown in Figure dba/m Database Manager V7.1 User's Guide

214 Figure Index Comments Window. Choose an Index Use the Catalog and Index pane to choose an index. To choose the index 1. In the Catalogs field, double-click on the name of the catalog that contains the index. The indexes in the catalog are displayed in the Indexes field. 2. Double-click on the name of the index. If there is a comment associated with the index, the comment text is displayed in the Comment Text pane. Add, Change, or Delete Index Comments To add index comments 1. Click on Add Line. The cursor is placed on the next available line in the Comment Text pane. 2. Enter the comment. 3. Repeat steps 1 and 2 to add additional lines Managing Indexes

215 To change index comments, click on the line you want to modify. The cursor is placed on the line; edit the index comment as desired. To delete index comments, click on the line of text you want to delete, then click on Delete Line. Save the Index Comment To save new or modified index comments, or to delete them, click on one of the following: Execute. Executes the command immediately. Show. Displays the SQL commands created by dba/m Database Manager without executing them. Queue. Queues the command to be submitted in a batch later. Viewing Index Statistics Using the Index Statistics window, you can display the statistics of an index. To display the Index Statistics window, click on Indexes in the Main window, then click on ViewStats. The Index Statistics window is displayed, as shown in Figure Figure Index Statistics Window. dba/m Database Manager V7.1 User's Guide

216 To display indexes 1. In the Catalogs field, double-click on the catalog that contains the indexes. The indexes in the catalog are displayed in the Indexes field. 2. Use one of the following methods to display index statistics: To display statistics for one or more indexes, double-click on the name of each index To display statistics for all indexes in the catalog, click on SelectAllIndexes. Statistics for the selected indexes are automatically displayed in the Index Statistics pane. 3. To exit from Index Statistics window, click Close Managing Indexes

217 dba/m Database Manager V7.1 User's Guide

218

219 CHAPTER 15. MANAGING TABLE PARTITIONS A partition is a portion of the table residing on a volume different from the volume on which the table was initially created. When creating partitions of a table, you specify the number of partitions and the volume, catalog, and primary-key values for each partition. Using dba/m Database Manager table partition management windows, you can Design partitions View partitions Add partitions Alter partitions Drop partitions Perform a simple move on a partition Perform a one-way split on a partition Perform a two-way split on a partition Designing Table Partitions Partition design computes the primary key values for a given distribution of rows across partitions. To design a table partition, click on Table Partitions in the Main window, then click on Design. The Partition Selection window will be displayed, as shown in Figure dba/m Database Manager V7.1 User's Guide

220 Figure Partition Selection window. Choose Base Table Use the Base Table Catalog and Base Table panes to choose base tables. 1. In the list of catalogs shown in the Base Table Catalog field, doubleclick on the catalog that contains the base table for the partition. The tables in the catalog are displayed in the Base Table field. 2. Double-click on the table you want to use as a base table. Choose Table Partition Use the Base Table Catalog and Base Table panes to choose base tables. 1. In the list of catalogs shown in the Base Table Catalog field, doubleclick on the catalog that contains the base table for the partition. The tables in the catalog are displayed in the Base Table field. 2. Double-click on the table you want to use as a base table. The Partitions in the tables will be displayed in the Table Partition field. 3. Select the Partition by double clicking the partition. Selected partition will be displayed in the Text field. Also partonly option will be clicked. User will not be able to Manual design option, once partition of table is 15-2 Managing Index Partitions

221 selected. User can select base partition for partonly by clicking partonly checkbox. Choose Partonly To design individual partition of a table or Base partition of a table, use Partonly option by clicking checkbox partonly. Partonly option is only for Auto Design of a table partition. Manual Design To create partitions with an unequal number of rows, click on Manual Design, as shown in Figure Auto Design To create partitions with the same number of rows across all partitions 1. Enter the desired number of partitions in the Number of Partitions field in the Auto Design pane. 2. Enter the sampling rate. The lower the sample rate number is, the more precise the result will be, and the longer the time required for calculation will be. 3. Click on Auto Design. The time required to complete partition design depends on the size of the table and the sample rate. A message box with this message is displayed. Manual Design When you click on Manual Design in the Partition Selection window, the Manual Design window is displayed, as shown in Figure dba/m Database Manager V7.1 User's Guide

222 Figure Manual Design Window. To redesign the table partitions manually 1. Specify the new number of partitions wanted in the Number of Partitions field. 2. Specify the new sample rate in the Sample Rate field. 3. Specify the new primary-key values in the Primary-Key pane. The New Row button allows you to add more primary-key values to the partitions. 4. Click on Recompute to calculate and display the new number of rows and percentages in each partition. The time required to complete automatic partition design depends on the size of the table and the sample rate. A message box is displayed. 5. Click on Get Results to see the results in tabular form or Click on Graph to see the results in graphical form, as displayed in Figure Note: You may switch to Auto Design mode at any time by clicking on the Auto Design button. In this mode, you specify the number of partitions 15-4 Managing Index Partitions

223 and the sampling rate and dba/m Database Manager will compute the primary key values when you press the Recompute button. Figure Graphical Window. Automatic Design To have dba/m Database Manager automatically design table partitions 1. Specify the number of partitions in the Number of Partitions pane in the Auto Design pane as shown in Figure Specify the sample rate. 3. If you want Partonly then Click Partonly option. 4. Click on Auto Design. The time required to complete partition design depends on the size of the table and the sample rate. A message box with this message is displayed. 5. To see the new table partitions, click on Get Results. The primary keys for balanced partitions are shown in the Design Partition window as shown in Figure Click on the Graph button in the Design Partition window to view the results in graphical form. dba/m Database Manager V7.1 User's Guide

224 Figure Auto Design Window. Display Dependencies Before implementing a newly-designed partition in a table, you can analyze the impact of your proposed design. To display the programs which depend on the table, click on Dependent Programs. Programs which would be invalidated by redesigning the partition are displayed. To display all objects, including programs, which depend on the partitions, click on Objects. All SQL objects that depend on the partitions are displayed. View Partitions Click on Table Partitions, then click on View in the Main window, to view partitions for an existing table Managing Index Partitions

225 Choose Base Table Use the Base Table Catalog and Base Table panes to choose base tables. 1. In the list of catalogs shown in the Base Table Catalog field, doubleclick on the catalog that contains the base table for the partition. The tables in the catalog are displayed in the Base Table field. 2. Double-click on the table you want to use as a base table. Assign Sample Rate Enter the sample rate in the Sample Rate field. Compute Row Distribution Click on Compute. The elapsed time to compute the number of rows may take a long time depending on the sample rate and size of the table. Click on View to view the results. The results are shown in the Monitor Partition window. Adding Partitions To add partitions to a table, click on Table Partitions in the Main window, then click on Add. The Add Partition window will be displayed, as shown in Figure dba/m Database Manager V7.1 User's Guide

226 Figure Add Partition Window. Assign the Number of Partitions Enter the number of partitions you want in the table in the Number of Partitions field. Note: The number you enter should be one less than the total number of partitions, because the primary partition is automatically assigned when the table is created. Assign Volumes To choose the volumes where you want the partitions to be located Click on Volumes to choose the volumes where your partitions are going to be located. The Select Volume window is displayed, as shown in Figure Managing Index Partitions

227 Figure Select Volume Window. 1. To select volumes for the partition, click on the name of the volume from the Volume Name field. Select as many volumes as there are new partitions, and click OK. 2. The Select Volumes window closes and the Add Partition window is displayed again. Partition names are assigned based on the selected volume and the name of the table. The partition names are displayed in the partition pane. This pane also shows the default catalog to which each catalog belongs, and the name of the primary-key columns in the table. Assign Catalogs Use the Partition pane and the Catalogs pane to assign a catalog to each partition. 1. Choose a partition by clicking on its name in the Partitions pane. 2. Assign a catalog to the partition by double-clicking on a catalog in the list shown in the Catalogs pane. 3. Repeat Steps 1 and 2 to assign catalogs to all partitions. dba/m Database Manager V7.1 User's Guide

228 Assign File Attributes Use the Partition File Attributes pane, to assign file attributes for the partition 1. Choose a partition by clicking on its name. 2. Select the Format Type for the partition by clicking either Format1 or Format2. 3. In the Extent in Pages pane, perform one of the following: To enter the primary and secondary extent sizes, click on Primary, then enter the primary extent size in the Primary field and the secondary extent size in the Secondary field. To enter the number of extents, click on Extents, then enter the number of extents in the Extents field. 4. Enter the maximum number of extents in the Maxextents field. 5. Press the Set button to add the parameters to the partition. This will display all the parameters in the window. Display Dependencies Before adding partitions to a table, you can analyze the impact of the additions: To display the programs which depend on the table partitions, click on Dependent Programs. Programs which would be invalidated by adding partitions are displayed. To display all objects, including programs, which depend on the partitions, click on Dependent Objects. All SQL objects which depend on the table partitions are displayed. Add the Partitions To add the new partitions to the table, click on one of the following: Execute. Executes the command immediately. Show. Displays the SQL commands created by dba/m Database Manager without executing them. Queue. Queues the command to be submitted in a batch later Managing Index Partitions

229 Altering Partitions Use the Alter partition pane to modify the file attributes of a partition. To alter a partition, click on Table Partitions in the Main window, then click on Alter. The Alter Partitions window will be displayed, as shown in Figure To alter a partition Figure Alter Partitions Window. 1. Click on the name of the partition you want to alter in the partition name and catalog pane. 2. To change extent allocations, perform one of the following: To allocate extents, click on Allocate then enter the number of extents in the Allocate field To deallocate unused extents, click on Allocate to remove the checkmark. 3. In the Extent in Pages pane, perform one of the following: To enter the primary and secondary extent sizes, click on Primary, then enter the primary extent size in the Primary field and the secondary extent size in the Secondary field. To enter the number of extents, click on Extents, then enter the number of extents in the Extents field. dba/m Database Manager V7.1 User's Guide

230 4. Enter the maximum number of extents in the Max Extents field. 5. Enable or disable the Reset-Broken flag by clicking on Reset Broken. Display Dependencies Before altering partitions to a table, you can analyze the impact of the proposed changes: To display the programs which depend on the table, click on Depedent Programs. Programs which would be invalidated by adding partitions are displayed. To display all objects, including programs, which depend on the partitions, click on Dependent Objects. All SQL objects which depend on the table partitions are displayed. Alter the Partitions To alter the partitions for the table, click on one of the following: Execute. Executes the command immediately. Show. Displays the SQL commands created by dba/m Database Manager without executing them. Queue. Queues the command to be submitted in a batch later. Drop Partitions To drop partitions from a table, click on Table Partitions in the Main window, then click on Drop. The Drop Partitions window will appear as displayed in Figure Managing Index Partitions

231 Figure Drop Partition Window. Choose Partition: To choose a partition, click on the name of the partition you want to drop in the Partition Name column.. Display Dependencies Before dropping partitions from a table, you can analyze the impact of the changes: To display the programs which depend on the partitions, click on Dependent Programs. Programs which would be invalidated by dropping the partitions are displayed. To display all objects, including programs, which depend on the table partitions, click on Dependent Objects. All SQL objects which depend on the table partitions are displayed. Drop the Partitions To drop the partitions from the table, click on one of the following: Execute. Executes the command immediately. dba/m Database Manager V7.1 User's Guide

232 Show. Displays the SQL commands created by dba/m Database Manager without executing them. Queue. Queues the command to be submitted in a batch later. Perform a Simple Move To perform a simple move of a table partition, click on Table Partitions in the Main window, then click on Simple Move. The Partition Selection window will be displayed, as shown in Figure Figure Partition Selection Window. Choose a Table 1. From the list of catalogs shown in the Base Table Catalog field, doubleclick on the catalog that contains the base table. The tables in the catalog are displayed in the Base Table field. 2. Double-click on the table you want to use as a base table. 3. Click on Simple Move. The Table Partition-Simple Move window will be displayed as shown in Figure Managing Index Partitions

233 Figure Table Partition-Simple Move Window. Select the Partition Select the partition to be moved by clicking on the partition name in the Partition Name pane. Assign Name and Location Use the First Target Specification pane to assign a name and location for the partition you are moving. 1. Enter the name of the target partition in the partition field or click on the Volume button to select the volume from the Volume window. 2. Click on the arrows in the Catalog field to display a list of catalogs. 3. Double-Click on the name of the catalog. dba/m Database Manager V7.1 User's Guide

234 Assign File Attributes Use the First Target Specification pane to specify the partition s file attributes. To assign the file attributes 1. In the Extent in Pages pane, perform one of the following: To enter the primary and secondary extent sizes, click on Primary, then enter the primary extent size in the Primary field and the secondary extent size in the Secondary field. To enter the number of extents, click on Extents, then enter the number of extents in the Extents field. 2. Enter the maximum number of extents in the Max Extents field. 3. Enter the minimum percentage of space to be left in a data block in the Dslack field. 4. Enter the minimum percentage of space to be left in an index block in the Islack field. Enter the minimum percentage of space to be left in data and index blocks in the Slack field. Display Dependencies Before performing a simple move, you can analyze the impact of the changes: To display the programs which depend on the partitions, click on Dependent Programs. Programs which would be invalidated by moving the partitions are displayed. To display all objects, including programs, which depend on the table partitions, click on Dependent Objects. All SQL objects which depend on the table partitions are displayed. Move the Partition To perform the simple move, click on one of the following: Execute. Executes the command immediately. Show. Displays the SQL commands created by dba/m Database Manager without executing them Managing Index Partitions

235 Queue. Queues the command to be submitted in a batch later. Performing a One-Way Split To perform a one-way split of a table partition, click on Table Partitions in the Main window, then click on One-Way Split/ Move. The One-Way Split window will be displayed, as shown in Figure Figure One Way Split. Choose Table 1. In the list of catalogs shown in the Base Table Catalog and Base Tables panes, double-click on the catalog that contains the base table for the partition. The tables in the catalog are displayed in the Base Table field. 2. Double-click on the table you want to use as a base table. Assign Name and Location Use the First Target Specification pane to assign a name and location for the partition you are moving. dba/m Database Manager V7.1 User's Guide

236 1. Enter the name of the target partition in the partition field or click on the Volume button to select the volume from the Volume window. 2. Click on the arrows in the Catalog field to display a list of catalogs. 3. Double-click on the name of the catalog. Assign File Attributes Use the First Target Specification pane to specify the partition s file attributes. To assign the file attributes 1. In the Extent in Pages pane, perform one of the following: To enter the primary and secondary extent sizes, click on Primary, then enter the primary extent size in the Primary field and the secondary extent size in the Secondary field. To enter the number of extents, click on Extents, then enter the number of extents in the Extents field. 2. Enter the maximum number of extents in the Max Extents field. 3. Enter the minimum percentage of space to be left in a data block in the Dslack field. 4. Enter the minimum percentage of space to be left in an index block in the Islack field. 5. Enter the minimum percentage of space to be left in data and index blocks in the Slack field. Display Dependencies Before performing a one-way move, you can analyze the impact of the changes: To display the programs which depend on the partitions, click on Dependent Programs. Programs which would be invalidated by moving the partitions are displayed. To display all objects, including programs, which depend on the table partitions, click on Dependent Objects. All SQL objects which depend on the table partitions are displayed Managing Index Partitions

237 Move the Partition To perform the one-way move, click on one of the following: Execute. Executes the command immediately. Show. Displays the SQL commands created by dba/m Database Manager without executing them. Queue. Queues the command to be submitted in a batch later. Performing a Two-Way Split To perform a two-way split, click on Table Partitions in the Main window, then click on Two-Way Split. The Two-Way Split window will be displayed, as shown in Figure Figure Two-Way Split Window. When performing a two-way split move, you assign name, location, and file attributes to the first partition, repeat the steps for the second partition, then perform the move. dba/m Database Manager V7.1 User's Guide

238 Choose Table 1. In the list of catalogs shown in the Base Table Catalog and Base Tables panes, double-click on the catalog that contains the base table for the partition. The tables in the catalog are displayed in the Base Table field. 2. Double-click on the table you want to use as a base table. 3. Click on Two Way/Split. Assign Names and Locations Use the First Target Specification pane to assign a name and location for the first partition you are moving. Then complete the Second Target Specification pane for the second partition. 1. Enter the name of the target partition in the Partition field, or use the Volume button to select the volume from the Volumes window. 2. Click on the arrow in the Catalog field to display a list of catalogs. 3. Double-click on the name of the catalog. Assign File Attributes Specify the file attributes of the first partition, then the second partition. To assign the file attributes 1. In the Extent in Pages pane, perform one of the following: To enter the primary and secondary extent sizes, click on Primary, then enter the primary extent size in the Primary field and the secondary extent size in the Secondary field. To enter the number of extents, click on Extents, then enter the number of extents in the Extents field. 2. Enter the maximum number of extents in the Max Extents field. 3. Enter the minimum percentage of space to be left in a data block in the Dslack field. 4. Enter the minimum percentage of space to be left in an index block in the Islack field Managing Index Partitions

239 5. Enter the minimum percentage of space to be left in data and index blocks in the Slack field. Assign Primary-Key Values Use the Primary-Key pane to specify primary-key values for both partitions. To assign primary-key values 1. In the Column Name field, choose a column of the primary key by clicking on the name from the list of column names. 2. Place the cursor in the First Key field for the selected column and enter the value for that column. 3. Repeat Steps 1 and 2 for all other columns of the primary-key. Display Dependencies Before performing a two-way move, you can analyze the impact of the changes: To display the programs which depend on the partitions, click on Dependent Programs. Programs which would be invalidated by moving the partitions are displayed. To display all objects, including programs, which depend on the table partitions, click on Dependent Objects. All SQL objects which depend on the table partitions are displayed. Move the Partition To perform the two-way move, click on one of the following: Execute. Executes the command immediately. Show. Displays the SQL commands created by dba/m Database Manager without executing them. Queue. Queues the command to be submitted in a batch later. dba/m Database Manager V7.1 User's Guide

240 CHAPTER 16. MANAGING ENSCRIBE Using dba/m Database ManagerEnscribe partition management windows, you can Design partitions Monitor partitions Designing Enscribe Partitions Partition design computes the primary key values for a given distribution of rows across partitions. To design a Enscribe partition, click on Enscribe in the Main window, then click on Design. The Partition Design window will be displayed, as shown in Figure Figure Partition Selection window. Choose Enscribe Table Use the Node, Volume, Subvolume and Enscribe from panes to choose Enscribe files Managing Index Partitions

241 Auto Design To create partitions with the same number of rows across all partitions 1. Enter the desired number of partitions in the Number of Partitions field in the Auto Design pane. 2. Enter the sampling rate. The lower the sample rate number is, the more precise the result will be, and the longer the time required for calculation will be. 3. Click on Auto Design. The time required to complete partition design depends on the size of the table and the sample rate. A message box with this message is displayed. Note: You may switch to Auto Design mode at any time by clicking on the Auto Design button. In this mode, you specify the number of partitions and the sampling rate and dba/m Database Manager will compute the primary key values when you press the Recompute button. Figure Graphical Window. dba/m Database Manager V7.1 User's Guide

242 Monitor Enscribe Partitions Use the Node, Volume, Subvolume and Enscribe from panes to choose Enscribe files. 1. In the list of enscribe file anmes shown in the Enscribe field, doubleclick on the filename that contains the partition. 2. Double-click on the file you want to monitor. 3. To see th status of monitored object refer section 6.2 CHAPTER 17. MANAGING INDEX PARTITIONS A partition is a portion of the index residing on a volume different from the volume on which the index was initially created. When creating partitions of an index, you specify the number of partitions and the volume, catalog, and primary-key values for each partition. Using dba/m Database Manager index partition management windows, you can Design partitions View partitions Add partitions Alter partitions Drop partitions Perform a simple move on a partition Perform a one-way split on a partition Perform a two-way split on a partition Designing Index Partitions Partition design computes the primary key values for a given distribution of rows across partitions. To design an index partition, click on Index Partitions in the Main window, then click on Design. The Partition Selection window will be displayed, as shown in Figure Managing Index Partitions

243 Figure 16-1 Partition Selection window Choose Base Index Use the Base Index Catalog and Base Index panes to choose base indexes. 1. In the list of catalogs shown in the Base Index Catalog field, double-click on the catalog that contains the base index for the partition. The indexes in the catalog are displayed in the Base Index field. 2. Double-click on the index you want to use as a base table. Choose Index Partition Use the Base Index Catalog, Base Index and Index Partition panes to choose index partitions. 1. In the list of catalogs shown in the Base Index Catalog field, double-click on the catalog that contains the base index for the partition. The indexes in the catalog are displayed in the Base Index field. Managing Index Partitions 17-2

244 2. Double-click on the index you want to use as a base index for partition. The Partitions in the index are displayed in the Index Partition list box. 3. Select the partition by double clicking the partition. Selected partition will be displayed in the Text field. Also Partonly option will be clicked. User will not be able to use Manual design option, once partition of a index is selected. User can select base partition for partonly option by clicking partonly checkbox. Choose Partonly To design individual partition of a index or Base partition of a index, use Partonly option by clicking checkbox partonly. Partonly option is only for Auto Design of a table partition. Manual Design To create partitions with an unequal number of rows, click on Manual Design, as shown in Figure Auto Design To create partitions with the same number of rows across all partitions 1. Enter the desired number of partitions in the Number of Partitions field in the Auto Design pane 2. Enter the sampling rate. The lower the sample rate number is, the more precise the result will be, and the longer the time required for calculation will be. 3. Click on Auto Design. The time required to complete partition design depends on the size of the index and the sample rate. A message box is displayed. dba/m Database Manager V7.1 User's Guide

245 Manual Design When you click on Manual Design in the Partition Selection window, the Manual Design window is displayed, as shown in Figure Figure Manual Design Window. To redesign the index partitions manually 1. Specify the new number of partitions wanted in the Number of Partitions field. 2. Specify the new sample rate in the Sample Rate field. 3. Specify the new primary-key values in the Primary-Key pane. The New Row button allows you to add more primary-key values to the partitions. 4. Click on Recompute to calculate and display the new number of rows and percentages in each partition. The time required to complete automatic partition design depends on the size of the index and the sample rate. A message box is displayed. 5. Click on Get Results to see the results in tabular form or Click on Graph to see the results in graphical form. Managing Index Partitions 17-4

246 Note: You may switch to Auto Design mode at any time by clicking on the Auto Design button. In this mode, you specify the number of partitions and the sampling rate and dba/m Database Manager will compute the primary key values when you press the Recompute button. Automatic Design To have dba/m Database Manager automatically design index partitions 1. Specify the number of partitions in the Number of Partitions pane in the Auto Design pane as shown in Figure Specify the sample rate. 3. Click on Auto Design. The time required to complete partition design depends on the size of the index and the sample rate. A message box is displayed. 4. To see the new index partitions, click on Get Results. Click on the Graph button in the Design Partition window to view the results in graphical form. Display Dependencies Before implementing a newly-designed partition in a table, you can analyze the impact of your proposed design. To display the programs which depend on the index, click on Dependent Programs. Programs which would be invalidated by redesigning the partition are displayed. To display all objects, including programs, which depend on the partitions, click on Objects. All SQL objects that depend on the partitions are displayed. View Partitions Click on Index Partitions, then click on View in the Main window, to view partitions for an existing index. The View Partition window will be displayed, as shown in Figure dba/m Database Manager V7.1 User's Guide

247 Figure View Partition Window. Choose Index Use the Index Catalog and Index panes to choose indexes. 1. In the list of catalogs shown in the Index Catalog field, double-click on the catalog that contains the base index for the partition. The indexes in the catalog are displayed in the Index field. Double-click on the index you want to use as a index. Assign Sample Rate Enter the sample rate in the Sample Rate field. Compute Row Distribution Click on Compute. The elapsed time to compute the number of rows may take a long time depending on the sample rate and size of the index. Click on View to view the results. Managing Index Partitions 17-6

248 Adding Partitions To add partitions to an index, click on Index Partitions in the Main window, then click on Add. The Add Partition window will be displayed, as shown in Figure Figure Add Partition Window. Assign the Number of Partitions Enter the number of partitions you want in the index in the Number of Partitions field. Note: The number you enter should be one less than the total number of partitions, because the primary partition is automatically assigned when the index is created. Assign Volumes To choose the volumes where you want the partitions to be located 1. Click on Volumes to choose the volumes where your partitions are going to be located. The Select Volume window is displayed, as shown in Figure dba/m Database Manager V7.1 User's Guide

249 Figure Select Volume Window. 2. To select volumes for the partition, click on the name of the volume from the Volume Name field. Select as many volumes as there are new partitions, and click OK. 3. The Select Volumes window closes and the Add Partition window is displayed again. Partition names are assigned based on the selected volume and the name of the index. The partition names are displayed in the partition pane, as shown below Assign Catalogs Use the Partition pane and the Catalogs pane to assign a catalog to each partition. Managing Index Partitions 17-8

250 1. Choose a partition by clicking on its name in the Partitions pane. 2. Assign a catalog to the partition by double-clicking on a catalog in the list shown in the Catalogs pane. 3. Repeat Steps 1 and 2 to assign catalogs to all partitions. Assign File Attributes Use the Partition File Attributes pane, to assign file attributes. To assign file attributes for the partition 1. Choose a partition by clicking on its name. 2. Select the Format Type for the partition by clicking either Format1 or Format2. 3. In the Extent in Pages pane, perform one of the following: To enter the primary and secondary extent sizes, click on Primary, then enter the primary extent size in the Primary field and the secondary extent size in the Secondary field. To enter the number of extents, click on Extents, then enter the number of extents in the Extents field. 4. Enter the maximum number of extents in the Maxextents field. 5. Press the Set button to add the parameters to the partition. This will display all the parameters in the window. Display Dependencies Before adding partitions to an index, you can analyze the impact of the additions: To display the programs which depend on the index partitions, click on Dependent Programs. Programs which would be invalidated by adding partitions are displayed. To display all objects, including programs, which depend on the partitions, click on Objects. All SQL objects which depend on the index partitions are displayed. Add the Partitions To add the new partitions to the index, click on one of the following: dba/m Database Manager V7.1 User's Guide

251 Execute. Executes the command immediately. Show. Displays the SQL commands created by dba/m Database Manager without executing them. Queue. Queues the command to be submitted in a batch later. Altering Partitions Use the Alter partition pane to modify the file attributes of a partition. To alter a partition, click on Index Partitions in the Main window, then click on Alter. The Alter Partitions window will be displayed, as shown in Figure To alter a partition Figure Alter Partitions Window. 1. Click on the name of the partition you want to alter in the partition name and catalog pane. 2. To change extent allocations, perform one of the following: Managing Index Partitions 17-10

252 To allocate extents, click on Allocate then enter the number of extents in the Allocate field To deallocate unused extents, click on Allocate to remove the checkmark. 3. In the Extent in Pages pane, perform one of the following: To enter the primary and secondary extent sizes, click on Primary, then enter the primary extent size in the Primary field and the secondary extent size in the Secondary field. To enter the number of extents, click on Extents, then enter the number of extents in the Extents field. 4. Enter the maximum number of extents in the Max Extents field. 5. Enable or disable the Reset-Broken flag by clicking on Reset Broken. Display Dependencies Before altering partitions to an index, you can analyze the impact of the proposed changes: To display the programs which depend on the index, click on Dependent Programs. Programs which would be invalidated by adding partitions are displayed. To display all objects, including programs, which depend on the partitions, click on Dependent Objects. All SQL objects which depend on the index partitions are displayed. Alter the Partitions To alter the partitions for the index, click on one of the following: Execute. Executes the command immediately. Show. Displays the SQL commands created by dba/m Database Manager without executing them. Queue. Queues the command to be submitted in a batch later. Drop Partitions To drop partitions from an index, click on Index Partitions in the Main window, then click on Drop. The Drop Partitions window will appear. dba/m Database Manager V7.1 User's Guide

253 When you click on Drop, Drop partition screen will appear as shown below in Figure Figure Drop Partition Window. When you click on Drop, Drop partition screen will appear as shown below Choose Partition: To choose a partition, click on the name of the partition you want to drop in the Partition Name column.. Display Dependencies Before dropping partitions from an index, you can analyze the impact of the changes: To display the programs which depend on the partitions, click on Dependent Programs. Programs which would be invalidated by dropping the partitions are displayed. Managing Index Partitions 17-12

254 To display all objects, including programs, which depend on the index partitions, click on Dependent Objects. All SQL objects which depend on the index partitions are displayed. Drop the Partitions To drop the partitions from the index, click on one of the following: Execute. Executes the command immediately. Show. Displays the SQL commands created by dba/m Database Manager without executing them. Queue. Queues the command to be submitted in a batch later. Perform a Simple Move To perform a simple move of an index partition, click on Index Partitions in the Main window, then click on Simple Move. The Partition Selection window will be displayed, when you click on Simplemove button following window will appear as shown in Figure dba/m Database Manager V7.1 User's Guide

255 Figure Simple Move Window. Choose a Index 1. From the list of catalogs shown in the Index Catalog field, double-click on the catalog that contains the index. The indexes in the catalog are displayed in the Index field. 2. Double-click on the index you want to use. 3. Click on Simple Move. The Index Partition-Simple Move window will be displayed as shown in Figure Select the Partition Select the partition to be moved by clicking on the partition name in the Partition Name pane. Assign Name and Location Use the First Target Specification pane to assign a name and location for the partition you are moving. 1. Enter the name of the target partition in the partition field or click on the Volume button to select the volume from the Volume window. 2. Click on the arrows in the Catalog field to display a list of catalogs. 3. Double-click on the name of the catalog. Assign File Attributes Use the First Target Specification pane to specify the partition s file attributes. To assign the file attributes 1. In the Extent in Pages pane, perform one of the following: To enter the primary and secondary extent sizes, click on Primary, then enter the primary extent size in the Primary field and the secondary extent size in the Secondary field. Managing Index Partitions 17-14

256 To enter the number of extents, click on Extents, then enter the number of extents in the Extents field. 2. Enter the maximum number of extents in the Max Extents field. 3. Enter the minimum percentage of space to be left in a data block in the Dslack field. 4. Enter the minimum percentage of space to be left in an index block in the Islack field. 5. Enter the minimum percentage of space to be left in data and index blocks in the Slack field. Display Dependencies Before performing a simple move, you can analyze the impact of the changes: To display the programs which depend on the partitions, click on Dependent Programs. Programs which would be invalidated by moving the partitions are displayed. To display all objects, including programs, which depend on the index partitions, click on Dependent Objects. All SQL objects which depend on the index partitions are displayed. Move the Partition To perform the simple move, click on one of the following: Execute. Executes the command immediately. Show. Displays the SQL commands created by dba/m Database Manager without executing them. Queue. Queues the command to be submitted in a batch later. Performing a One-Way Split To perform a one-way split of a index partition, click on Index Partitions in the Main window, then click on One-Way Split. The One-Way Split window will be displayed, as shown in Figure dba/m Database Manager V7.1 User's Guide

257 Figure One Way Split. Choose Index 1. In the list of catalogs shown in the Index Catalog and Indexes panes, double-click on the catalog that contains the base index for the partition. The indexes in the catalog are displayed in the Index field. 2. Double-click on the index you want to use as a index. Assign Name and Location Use the First Target Specification pane to assign a name and location for the partition you are moving. 1. Enter the name of the target partition in the partition field or click on the Volume button to select the volume from the Volume window. 2. Click on the arrows in the Catalog field to display a list of catalogs. 3. Double-click on the name of the catalog. Managing Index Partitions 17-16

258 Assign File Format Select the Format Specification for the partition by clicking either Format1 or Format2 option button. Assign File Attributes Use the First Target Specification pane to specify the partition s file attributes. To assign the file attributes 1. In the Extent in Pages pane, perform one of the following: To enter the primary and secondary extent sizes, click on Primary, then enter the primary extent size in the Primary field and the secondary extent size in the Secondary field. To enter the number of extents, click on Extents, then enter the number of extents in the Extents field. 2. Enter the maximum number of extents in the Max Extents field. 3. Enter the minimum percentage of space to be left in a data block in the Dslack field. 4. Enter the minimum percentage of space to be left in an index block in the Islack field. 5. Enter the minimum percentage of space to be left in data and index blocks in the Slack field. Display Dependencies Before performing a one-way move, you can analyze the impact of the changes: To display the programs which depend on the partitions, click on Dependent Programs. Programs which would be invalidated by moving the partitions are displayed. To display all objects, including programs, which depend on the index partitions, click on Dependent Objects. All SQL objects which depend on the index partitions are displayed. dba/m Database Manager V7.1 User's Guide

259 Move the Partition To perform the one-way move, click on one of the following: Execute. Executes the command immediately. Show. Displays the SQL commands created by dba/m Database Manager without executing them. Queue. Queues the command to be submitted in a batch later. Performing a Two-Way Split To perform a two-way split, click on Index Partitions in the Main window, then click on Two-Way Split. The Two-Way Split window will be displayed, as shown in Figure Figure Two-Way Split Window.. When performing a two-way split move, you assign name, location, and file attributes to the first partition, repeat the steps for the second partition, then perform the move. Managing Index Partitions 17-18

260 Choose Index 1. In the list of catalogs shown in the Index Catalog and Indexes panes, double-click on the catalog that contains the index for the partition. The indexes in the catalog are displayed in the Index field. 2. Double-click on the index you want to use. 3. Click on Two Way/Split. Assign Names and Locations Use the First Target Specification pane to assign a name and location for the first partition you are moving. Then complete the Second Target Specification pane for the second partition. 1. Enter the name of the target partition in the Partition field, or use the Volume button to select the volume from the Volumes window. 2. Click on the arrow in the Catalog field to display a list of catalogs. 3. Double-click on the name of the catalog. Assign File Attributes Specify the file attributes of the first partition, then the second partition. To assign the file attributes 1. In the Extent in Pages pane, perform one of the following: To enter the primary and secondary extent sizes, click on Primary, then enter the primary extent size in the Primary field and the secondary extent size in the Secondary field. To enter the number of extents, click on Extents, then enter the number of extents in the Extents field. 2. Enter the maximum number of extents in the Max Extents field. 3. Enter the minimum percentage of space to be left in a data block in the Dslack field. 4. Enter the minimum percentage of space to be left in an index block in the Islack field. 5. Enter the minimum percentage of space to be left in data and index blocks in the Slack field. dba/m Database Manager V7.1 User's Guide

261 Assign Primary-Key Values Use the Primary-Key pane to specify primary-key values for both partitions. To assign primary-key values 1. In the Column Name field, choose a column of the primary key by clicking on the name from the list of column names. 2. Place the cursor in the First Key field for the selected column and enter the value for that column. 3. Repeat Steps 1 and 2 for all other columns of the primary-key. Display Dependencies Before performing a two-way move, you can analyze the impact of the changes: To display the programs which depend on the partitions, click on Dependent Programs. Programs which would be invalidated by moving the partitions are displayed. To display all objects, including programs, which depend on the index partitions, click on Objects. All SQL objects which depend on the index partitions are displayed. Move the Partition To perform the two-way move, click on one of the following: Execute. Executes the command immediately. Show. Displays the SQL commands created by dba/m Database Manager without executing them. Queue. Queues the command to be submitted in a batch later. Managing Index Partitions 17-20

262

263 CHAPTER 18. MANAGING PROGRAMS Using dba/m Database Manager, you can Alter the attributes of a program Drop a program Copy or move a program to a new location Rename a program Compile programs You can manage programs by accessing windows from the Object Tree button, the Custom Tree button, or the Programs button, in the Main window. The procedures in this chapter only describe how to access program management windows from the Programs button. Refer to Chapter 3 for information about managing programs from the Object Tree, and Chapter 4 for information about the Custom Tree. Altering a Program Use the Alter Program window to change the security attributes of a program. To display the Alter Program window, click on Programs in the Main window, then click on Alter. The Alter Program window is displayed, as shown in Figure dba/m Database Manager V7.1 User's Guide

264 Figure Alter Program Window. Choose a Program Use the Catalogs and Programs Pane to choose a program. To choose a program 1. In the Catalogs field, double-click on the name of the catalog that contains the program. The programs in the selected catalog are displayed in the Programs field. 2. Choose the program to alter by double-clicking on the program name. The security attributes of the program are displayed. Change the Security Change the security attributes of the program in the Security Pane. To alter the security of a program 1. Change the security string using the drop-down lists in the R, W, E, and P fields. 2. Use the Owner ID and the ProgID check-boxes to control the process access ID of the program file when the program executes. If you check the Owner ID field, only the owner of the program can execute it. The Owner ID box displays the ID and the security mode of the user who owns the program Managing Programs

265 3. Use the Clearonpurge check-box to set the clear-on-purge attribute. If you check this field, the program file is not deleted when the program is dropped. 4. The Program Format Version is displayed in the Program Format Version field. Save the Program To save the program, click on one of the following: Execute. Executes the command immediately. Show. Displays the SQL commands created by dba/m Database Manager without executing them. Queue. Queues the command to be submitted in a batch later. Dropping a Program You can delete a program file in the Drop Program window. To display the Drop Program window, click on Programs in the Main window, then click on Drop. The Drop Program window is displayed, as shown in Figure Figure Drop Program Window. dba/m Database Manager V7.1 User's Guide

266 Choose a Program To choose a program to drop 1. In the catalogs field, double-click On the name of the catalog that contains the program. The programs in the selected catalog and some its attributes are displayed in the Program Attributes pane. 2. Choose the program to drop by clicking on the name of the program. A delete marker appears in the row header of the selected program. 3. Repeat step 2 to select additional programs. Drop the Program To drop the programs selected, click on one of the following: Execute. Executes the command immediately. Show. Displays the SQL commands created by dba/m Database Manager without executing them. Queue. Queues the command to be submitted in a batch later. Compiling a Program Two compilation environments are available: one for programs compiled using dba/m Database Manager, and another for programs compiled outside of dba/m Database Manager. dba/m Database Manager collects data on SQL statements embedded in programs only if you compile them using the Program Compile window. You must use the queue and batch facility of dba/m Database Manager to execute the compilation. If you do not compile the programs using this process, you cannot display the results of the compilation using dba/m Database Manager. To display the Compile Old Program window, click on Programs in the Main window, then click on Compile Old. The Compile Old Program window is displayed, as shown in Figure Managing Programs

267 Figure Compile Program Window. Compiling Old Programs Choose Programs To choose an old or existing program to compile 1. In the Catalogs field, double-click on the name of the catalog that contains the program. The programs in the catalog are displayed in the Program pane. 2. Use the following methods to choose the programs you want to compile. The selected programs are displayed in the Program Name pane. To choose one program at a time, double-click on the name of the program. To choose all programs, click on SelectAll. To choose programs that have been identified as invalid, click on SelectInvalidAll. To choose valid programs only, click on SelectValidAll. dba/m Database Manager V7.1 User's Guide

268 To remove one program from the selected list of programs, click on the row header of the program to be deleted. To delete all selected programs, click on DeselectAll. You can deselect all selected programs by clicking on DeSelectAll. Choose Compiler Options Compiler options are located in the Option pane, as shown in Figure Figure Compile Options Pane. To choose compiler options 1. To produce an SQL object despite any SQL errors occurring during compilation, click on Force to enable the option. 2. To generate an SQL object, click on Object. Otherwise, the SQL compiler checks for all errors and does not generate SQL objects. 3. To automatically recompile a program, click on Recompile. The program will be recompiled if The program file is marked Invalid. The run-time TACL DEFINES are different than the compile-time TACL DEFINES. An access path is invalid. 4. Choose one of the defines options by clicking on the appropriate button: To use defines that are defined in the current Guardian context, click on Currentdefines. To establish a new context of defines, specify a TACL obey file name in the Defines Obey File field Managing Programs

269 To use defines that are currently stored with the program, click on Storeddefines. The compiler will ignore any of the defines in the current Guardian context. 5. Choose one of the recompile options by clicking on the appropriate button: To have only the statements that are actually executed recompiled, click on Recompileondemand. Otherwise, all statements are recompiled if the program is invalid. To have all statements in the selected programs recompiled, click on Recompileall. 6. Click on Display Program Attributes to display the program attributes. Compile the Programs To compile programs, click on one of the following: Show. Displays the SQL commands created by dba/m Database Manager without executing them. Queue. Queues the command to be submitted in a batch later. Compiling New Programs When you compile new programs, you choose the programs and compiler options, then compile the program. Compile new programs using the Compile New Program window, as shown in Figure dba/m Database Manager V7.1 User's Guide

270 Figure Compile New Program Window Choose New Programs To choose new programs, you select a volume and subvolume in which the programs are located and then the programs using the Volumes- Subvolumes-Programs pane. 1. In the Volumes field, double-click on the volume that contains the programs. The subvolumes in that volume are displayed in the Subvolumes field. 2. In the Subvolumes field, double-click on the name of the subvolume that contains the programs. The programs in the subvolume are displayed. 3. Use the following methods to choose a program. The selected programs are highlighted. To choose one program at a time, double-click on the name of the program. To choose all programs, click on SelectAll. To deselect all programs, click on DeselectAll. To remove one program from the selected list of programs, click on the row header of the program to be deleted Managing Programs

271 The selected programs are displayed in the Selected Programs pane shown in Figure Figure Selected Programs Pane. Assign Catalog Use the Catalogs pane to assign the catalog for a program. 1. To choose a program, click on the name of the program in the Selected Programs pane. 2. In the Catalogs field, choose a catalog to register the programs in by double-clicking on the name of the catalog. Choose Compiler Options Compiler options are located in the Options pane. To choose compiler options, 1. To produce an SQL object despite any SQL errors occurring during compilation, click on Force to enable the option. 2. To generate an SQL object, click on Object. Otherwise, the SQL compiler checks for all errors and does not generate SQL objects. 3. To automatically recompile a program, click on Recompile. The program will be recompiled if The program file is marked Invalid. The run-time TACL DEFINES are different than the compile-time TACL DEFINES. An access path is invalid. 4. Choose one of the defines options by clicking on the appropriate button: dba/m Database Manager V7.1 User's Guide

272 To use defines that are defined in the current Guardian context, click on Currentdefines. To establish a new context of defines, specify a TACL obey file name in the Defines Obey File field. To use defines that are currently stored with the program, click on Storeddefines. The compiler will ignore any of the defines in the current Guardian context. 5. Choose one of the recompile options by clicking on the appropriate button: To have only the statements that are actually executed recompiled, click on Recompileondemand. To have all statements in the selected programs recompiled, click on Recompileall. Compile the Programs To compile new programs, click on one of the following: Show. Displays the SQL commands created by dba/m Database Manager without executing them. Queue. Queues the command to be submitted in a batch later. Copy or Move Programs Use the Copy/Move window to copy a program or to move a program to a new location. To display the Copy/Move window, click on Programs in the Main window, then click on Copy/Move. The Copy/Move window is displayed, as shown in Figure Managing Programs

273 Figure Copy/Move Window. Choose Programs Use the Catalogs and Programs pane to choose the programs to copy or move. To choose the programs, 1. In the Catalogs field, double-click on the name of the catalog that contains the program. The programs registered in the catalog are displayed in the Programs field. 2. Use the following methods to choose the program to copy or move. The selected programs are displayed in the Program Source and Target fields. To choose one program at a time, double-click on the name of the program. To choose all programs, click on SelectAll. To remove one program from the selected list of programs, click on the row header of the program to be deleted. To delete all selected programs, click on DeselectAll. dba/m Database Manager V7.1 User's Guide

274 Define the Target Location Use the Program Source and Target fields, to define the target of the copy or move operation. Type the target location in the Program Name Target field. Choose the Copy or Move Operation Use one of the following methods to choose the copy or move operation: To switch between copy and move options for one program at a time, double-click on the Copy/Move field for each program. To move all selected programs, click on MoveAll. To copy all programs, click on CopyAll. Choose Compiler Options To choose compiler options 1. To produce an SQL object despite any SQL errors occurring during compilation, click on Force to enable the option. 2. To generate an SQL object, click on Object. Otherwise, the SQL cornpiler checks for all errors and does not generate SQL objects. 3. To automatically recompile a program, click on Recompile. The program will be recompiled if The program file is marked Invalid. The run-time TACL DEFINES are different than the compile-time TACL DEFINES. An access path is invalid. 4. Choose one of the defines options by clicking on the appropriate button: To use defines that are defined in the current Guardian context, click on Currentdefines. To establish a new context of defines, specify a TACL obey file name in the Defines Obey File field Managing Programs

275 To use defines that are currently stored with the program, click on Storeddefines. The compiler will ignore any of the defines in the current Guardian context. 5. Choose one of the recompile options by clicking on the appropriate button: To have only the statements that are actually executed recompiled, click on Recompileondemand. To have all statements in the selected programs recompiled, click on Recompileall. Compiler options are located in the Compile Options pane. Assign Catalog Use the Catalogs and Programs panes to assign the catalog for a program. 1. To choose a program, click on the name of the program. 2. In the Catalogs field, choose a catalog to register the programs in by double-clicking on the name of the catalog. Perform the Copy or Move To copy or move the program, click on one of the following: Execute. Executes the command immediately. Show. Displays the SQL commands created by dba/m Database Manager without executing them. Queue. Queues the command to be submitted in a batch later. Renaming Programs Use the Rename Program window to change the name of a program. To display the Rename Program window, click on Programs in the Main window, then click on Rename. The Rename Program window is displayed, as shown in Figure dba/m Database Manager V7.1 User's Guide

276 Figure Rename Program Window. Choose the Program Use the Catalogs and Programs pane to choose the program to rename. To choose a program, 1. In the Catalogs field, double-click on the name of the catalog that contains the program. The programs in the catalog are displayed in the Programs field. 2. In the Programs field, double-click on the name of the program you want to rename. The attributes of the selected program are displayed. Enter the Name To rename a program, type the new program name in the Rename field. Save the Program Name To save the new program name, click on one of the following: Execute. Executes the command immediately Managing Programs