unisys ClearPath Enterprise Servers SQL Query Processor for ClearPath MCP Installation and Operations Guide ClearPath MCP 16.0

Transcription

1 unisys ClearPath Enterprise Servers SQL Query Processor for ClearPath MCP Installation and Operations Guide ClearPath MCP 16.0 April

2 NO WARRANTIES OF ANY NATURE ARE EXTENDED BY THIS DOCUMENT. Any product or related information described herein is only furnished pursuant and subject to the terms and conditions of a duly executed agreement to purchase or lease equipment or to license software. The only warranties made by Unisys, if any, with respect to the products described in this document are set forth in such agreement. Unisys cannot accept any financial or other responsibility that may be the result of your use of the information in this document or software material, including direct, special, or consequential damages. You should be very careful to ensure that the use of this information and/or software material complies with the laws, rules, and regulations of the jurisdictions with respect to which it is used. The information contained herein is subject to change without notice. Revisions may be issued to advise of such changes and/or additions. Notice to U.S. Government End Users: This is commercial computer software or hardware documentation developed at private expense. Use, reproduction, or disclosure by the Government is subject to the terms of Unisys standard commercial license for the products, and where applicable, the restricted/limited rights provisions of the contract data rights clauses. Unisys and ClearPath are registered trademarks of Unisys Corporation in the United States and other countries. All other brands and products referenced in this document are acknowledged to be the trademarks or registered trademarks of their respective holders.

3 Contents Section 1. Overview Documentation Updates What s New? What Is SQL Query Processor? Section 2. Installing SQL Query Processor Hardware and Software Requirements Hardware Requirements MCP Environment Software Requirements Windows Environment Software Requirements Installing the SQL Query Processor Software in the MCP Environment Manually Assigning the SQL Query Processor Library Function Names to the Server Library Code File Titles Creating the SQL Query Processor Configuration File (DMSQL/CONFIG) Changing the Name and Location of the SQL Query Processor Configuration File Creating the Server Configuration File (DMSQL/SERVER/CONFIG) Configuring the TCP/IP Distributed Systems Services (DSS) Optional Installation Tasks Installing the SQL Query Processor Utilities in the Windows Environment Migrating from an Earlier Release Updating an SQL Database Definition Updating an Enterprise Database Server Database Removing the SQL Query Processor Software Reinstalling the SQL Query Processor Software Troubleshooting Updating Enterprise Database Server Databases with SQL Queries Updating Enterprise Database Server Data Sets with SQL Queries Section 3. Using the Query Design Center Starting the Query Design Center Understanding the Query Design Center Interface iii

4 Contents Setting the Look and Feel of the Interface Determining Connection Status Catalog Window Opening Tables Viewing Table Results Viewing Column Results Analyze Query Window Analyze Query Window Commands Preparing and Executing a Query Saving a Query Saving Query Results Opening a Query Enabling Manual Commit Mode Setting Transaction Isolation Levels Creating a Savepoint Rolling Back to a Savepoint Setting the Row Limit Generating a QGraph Generating a QDump Design Query Window Designing a Query Customizing the Query Design Center Section 4. Using the Relational Design Center Utility Starting the Relational Design Center Understanding the Relational Design Center Interface Using the Menu Bar Understanding Relational Mappings for SQL Default SQL Names Global Data Defaults Disjoint Data Set Defaults Embedded Data Set and Occurring Item Defaults Initial Values Set and Access Defaults as Indexes Set and Subset Defaults as Views Data Item Defaults Link Defaults Group Defaults Physical Option Defaults Restart Data Set Defaults SQL Referential Integrity Constraints Date Construct Security View Construct Grant Construct Working with Servers Adding a Server Removing a Server Importing a Relational Schema Creating an SQL Database iv

5 Contents Working with Databases Opening a Database Removing a Database Refreshing a Database Restoring a Database Getting the SQL Schema Saving the Schema Loading a Schema Applying Schema Modifications Modifying an SQL Database Working with Database Schemas Modifying Data Sets Modifying Occurring Items Modifying Variable-Format Items Modifying Indexes (Sets and Subsets) Modifying Data Items (Columns and Primary Keys) Assigning Access Rights to Database Structures Modifying Access Rights for Database Structures Creating SQL Dates Modifying SQL Dates Creating Integrity Constraints Modifying Integrity Constraints Creating SQL Views Modifying SQL Views Section 5. SQL Query Processor Server Administration Configuring SQL Query Processor Server Resources Preparing a Database to Be a Resource Controlling the SQL Query Processor Server Starting and Stopping the SQL Query Processor Server Obtaining Help Information Automating SQL Query Processor Server Initialization Creating the *DMSQL/SERVER/CONFIG File Setting the SQL Query Processor Server Timeout Intervals Obtaining SQL Query Processor Server Status Viewing Server Log Information in the MCP Environment Identifying the Server Log Understanding Server Log Contents Viewing Trace Information on the Server Diagnostic Trace Identifying the Trace File Enabling the Trace Facility Closing Trace Files Automatically Retrieving Dump Files Identifying the Dump File Displaying the Dump File v

6 Contents Section 6. SQL Query Processor Configuration Control Facility Using the SQL Query Processor Configuration Control Facility Understanding the SQL Query Processor Configuration File Creating the SQL Query Processor Configuration File Release Specification User Specification Program Specification Default Release Specification Resource Specification Using the CCS Clause Using the Limit Clause Setting a Default Release Limit Limit Clause Enforcement Sample SQL Query Processor Configuration Files Section 7. Using the Schema Administrator Ensuring Description File and Control File Accessibility Reviewing the Results File of a SQLVIEW Command Generation Viewing the Schema Using the Schema Administrator Input File Manually Enabling SQL Access to an Enterprise Database Server Database Generating the SQL Descriptions Listing the Description Section 8. Using the DMQUERY Utility What Is the DMQUERY Utility? Using DMQUERY Utility Commands BYE CANCEL CLOSE COMMIT WORK DEFINE DIAGNOSE DO OPEN PARSE QD REPEAT ROLLBACK WORK SAVEPOINT SET SHOW Running the DMQUERY Utility Interactively Through CANDE Running the DMQUERY Utility in Batch Mode DMQUERY Utility Files vi

7 Contents Appendix A. Setting Up Kerberos Authentication in the Windows Environment in the Windows Environment Appendix B. Troubleshooting Appendix C. SQL Query Processor Query Guidelines and Recommendations Index vii

8 Contents viii

9 Section 1 Overview Purpose Audience This guide explains how to install and administer the SQL Query Processor for ClearPath MCP, including the Windows-based utilities Query Design Center and Relational Design Center. This guide is intended for the experienced database administrator (DBA) who understands the Unisys Enterprise Database Server for ClearPath MCP, Windows operating systems, and the SQL specification. Terminology Conventions In this guide, the term ClearPath MCP servers refers to ClearPath LX and CS servers, and FS and Libra Series servers. For simplicity, the name of the SQL Query Processor for ClearPath MCP product is shortened to SQL Query Processor and is referred to as such throughout this guide. Documentation Updates This document contains all the information that was available at the time of publication. Changes identified after release of this document are included in problem list entry (PLE) To obtain a copy of the PLE, contact your Unisys representative or access the current PLE from the Unisys Product Support website: Note: If you are not logged into the Product Support site, you will be asked to do so

10 Overview What s New? The following table identifies new and revised information for this release. New or Revised Information Updated a step to install the SQL Query Processor using MCP Installation Assistant. Added a new subsection to Section 4, describing how a primary key is chosen, and the preferred key sets. Added "User Limit Exceeded for <database name>". Updated "DMSII" sets and subsets by removing "DMSII" and replacing it with "Enterprise Database Server". Location Section 2: Installing by Using MCP Installation Assistant Section 4: How a Primary Key is Chosen Appendix B: Error Messages Appendix C: SQL Views Enterprise Database Server Subsets What Is SQL Query Processor? The SQL Query Processor is a Structured Query Language (SQL) parser, optimizer, and query execution engine. The SQL Query Processor accepts and executes SQL commands according to a chosen plan and interacts with the Enterprise Database Server storage engine to return the expected results. The optimizer chooses the fastest execution plan. In the optimization phase, the SQL Query Processor chooses Any indexes to use The order in which joins are executed The order in which constraints (such as WHERE clauses) are applied The algorithms that lead to the best performance The query execution engine executes the query plan chosen during query optimization. The execution engine also determines the algorithms available to the query optimizer. For example, SQL Query Processor implements an indexed-loop join algorithm. The SQL Query Processor enables you to Access business-critical data stored in the highly robust and scalable Enterprise Database Server using standard SQL commands from JDBC, COBOL, or ALGOL applications. Create SQL databases that can be queried using the SQL data manipulation language (DML) Build, deploy, and manage applications on your ClearPath MCP server that are secure, scalable, and reliable

11 Overview The SQL Query Processor complies with the SQL-92 entry level with extensions and data manipulation language (DML). This is defined by the American National Standards Institute (ANSI) document X , Database Language SQL. The SQL Query Processor provides an ALGOL and a COBOL call-level application program interface (API) that conforms to a subset of the SQL-99 call-level interface (CLI). Administration tools are provided to Create a relational view of an existing Enterprise Database Server database. Create an SQL database based on an SQL data definition language (DDL). Benefits of Using the SQL Query Processor The SQL Query Processor provides the following benefits: Reduced network traffic The SQL Query Processor runs entirely on the ClearPath MCP server. This feature eliminates any network traffic that would result from switching between the ClearPath MCP server and a Windows or other server. Scalability The SQL Query Processor is scalable and supports multiple user sessions at the same time. Simplified enterprise development Using the COBOL or ALGOL API or the JDBC interface, you can easily develop applications to interface to the Enterprise Database Server. Comprehensive software localization International customers are able to interact with the SQL Query Processor and its tools on all levels, in their own language, and using their own cultural conventions. Localization entails translation of all dialog boxes, online help, error messages, and other user interface text. SQL Query Processor supports various character sets and collation based on the Unisys CCSVERSION defined for the Enterprise Database Server database. Using the SQL Query Processor administration tools, you can specify the coded character set (CCS) to be used when connecting to the database and when translating database data and identifiers to and from Unicode

12 Overview Components and Capabilities The SQL Query Processor provides the following components and capabilities: Query Design Center The Query Design Center is an interactive query tool that developers and system administrators can use to issue queries against the Enterprise Database Server. This tool makes it easy to develop and design queries against Enterprise Database Server databases and test them outside of user applications. Relational Design Center The Relational Design Center is an interactive schema administration tool that enables SQL access to Enterprise Database Server databases. Database administrators can import, define, and save schema modifications. Schema administration functions include Generating an SQL schema for Enterprise Database Server databases Defining and modifying schema attributes to be used for mapping an Enterprise Database Server description file Diagnosing errors including error reporting, event logging, and tracing Call-Level Interface (CLI) The CLI is a single, open SQL API that enables a client application on a ClearPath MCP system to access Enterprise Database Server databases. CLI interfaces include JDBC, COBOL, and ALGOL. Module Language The module language supports the SQL module language interfaces. The module language enables you to partition and centralize code and develop routines that can be called by other applications

13 Section 2 Installing SQL Query Processor This section provides information on the following topics: Hardware and software requirements Installing SQL Query Processor software in the MCP environment Installing SQL Query Processor utilities in the Windows environment Migrating from an earlier release Removing the SQL Query Processor software Reinstalling the SQL Query Processor software Troubleshooting Requirements for updating Enterprise Database Server databases with SQL queries Requirements for updating Enterprise Database Server data sets with SQL queries Hardware and Software Requirements As you consider the hardware and software requirements, note the following factors: Processor size and the amount of available memory affect performance. The available memory and disk space must be sufficient for the demands of your operating environment, the SQL Query Processor software, and the client applications using the services of the SQL Query Processor

14 Installing SQL Query Processor Hardware Requirements Platform MCP environment Windows environment Hardware Requirements Currently supported ClearPath MCP Servers Any Windows version fully supported by Microsoft MCP Environment Software Requirements Software Requirements MCP Enterprise Database Server TCP/IP DALICENSESUPPORT Currently supported ClearPath MCP releases Refer to the "Software Compatibility Matrix Pages" on the Unisys Product Support website: aspx?pla=mcp&nav=mcp Current version of Enterprise Database Server for ClearPath MCP Refer to the Software Compatibility Matrix Pages on the Unisys Product Support website: aspx?pla=mcp&nav=mcp Current version of Network Services Same version as the current version of SQL Query Processor software Refer to the User Licensing Installation and Operations Guide for more information on DALICENSESUPPORT. Windows Environment Software Requirements Software Windows operating system Requirements Any Windows version fully supported by Microsoft SQL Query Processor Relational Design Center Query Design Center Other software Current version of the Java Runtime Environment (JRE)

15 Installing SQL Query Processor Installing the SQL Query Processor Software in the MCP Environment Notes: On new ClearPath MCP servers, the MCP host software, including the SQL Query Processor product, comes preloaded. Unless you are installing an Interim Correction (IC) update to the SQL Query Processor, you do not need to perform an installation in the MCP environment. For this installation process, the MCP environment is considered to be a ClearPath MCP server, unless otherwise stated. For the MCP environment, the SQL Query Processor software, including the utilities, is packaged on CD-ROM media. Run the Simple Installation (SI) program or use the Installation Center to install the SQL Query Processor software package. The following files are installed on the MCP environment: SYSTEM/SQL/ADMIN SYSTEM/SQL/ADMIN/DIAGNOSTICS SYSTEM/SQL/ETINQ SYSTEM/SQL/ETINQ/DIAGNOSTICS SYSTEM/SQL/SCODE SYSTEM/SQL/SCODE/DIAGNOSTICS SYSTEM/SQL/CONFIG SYSTEM/SQL/CONFIG/DIAGNOSTICS SYSTEM/SQL/DRIVER SYSTEM/SQL/DRIVER/DIAGNOSTICS SYSTEM/SQL/PARSER SYSTEM/SQL/PARSER/DIAGNOSTICS SYSTEM/SQL/SERVER SYSTEM/SQL/SERVER/DIAGNOSTICS SYSTEM/SQL/WORKER SYSTEM/SQL/WORKER/DIAGNOSTICS SYSTEM/SQL/DMQUERY SYSTEM/SQL/DMQUERY/DIAGNOSTICS SYSTEM/SQL/MODLANG SYSTEM/SQL/MODLANG/DIAGNOSTICS SYSTEM/SQL/SUPPORT SYSTEM/SQL/SUPPORT/DIAGNOSTICS SYSTEM/SQL/COBOLDESC SYSTEM/SQL/COBOLDESC/DIAGNOSTICS SYSTEM/SQL/INTERFACE SYSTEM/SQL/INTERFACE/DIAGNOSTICS SYSTEM/SQL/DMSIIMAPPER SYSTEM/SQL/DMSIIMAPPER/DIAGNOSTICS SYSTEM/SQL/FILESUPPORT SYSTEM/SQL/FILESUPPORT/DIAGNOSTICS SYSTEM/SQL/SCODESUPPORT SYSTEM/SQL/SCODESUPPORT/DIAGNOSTICS

16 Installing SQL Query Processor SYMBOL/SQL/CLI/PROPERTIES/ALGOL SYMBOL/SQL/CLI/PROPERTIES/COBOL SYSTEM/INSTALLS/DMSQLUTILITIES/"README.TXT" SYSTEM/INSTALLS/DMSQLUTILITIES/"DMSQLUTILS.MSI" EXAMPLE/SQL/CLI/ALGOL EXAMPLE/SQL/CLI/COBOL EXAMPLE/DMSQL/CONFIG DESCRIPTION/SQLDIR/DMSQL-CATALOG For information about the SI program, refer to the Simple Installation Operations Guide. For information about Installation Center, refer to the Installation Center Operations Guide. Manually Assigning the SQL Query Processor Library Function Names to the Server Library Code File Titles When you use the SI program to install the SQL Query Processor in the MCP environment, four SL assignments are automatically performed. The SQL Query Processor requires these assignments to run in the MCP environment. To perform the SL assignments manually, ensure that you have system user privileges and enter the following SL (Support Library) system commands: SL DMSQLSERVER = *SYSTEM/SQL/SERVER ON <pack name>: LINKCLASS = 1, TRUSTED SL DMSQLCONFIG = *SYSTEM/SQL/CONFIG ON <pack name> SL DMSQLSCODE = *SYSTEM/SQL/SCODE ON <pack name> SL DMSQLCLI = *SYSTEM/SQL/INTERFACE ON <pack name>: TRUSTED The <pack name> construct is the name of the pack to which you copied the code file. The : LINKCLASS = 1, TRUSTED and the TRUSTED clause are required. Creating the SQL Query Processor Configuration File (DMSQL/CONFIG) During installation of the SQL Query Processor on the ClearPath MCP host, you use CANDE to create the SQL Query Processor configuration file called DMSQL/CONFIG under the same usercode and on the same pack as the *SYSTEM/SQL/CONFIG code file. The information in the configuration file is used by the system to determine the version of the SQL Query Processor software to which a particular user has access. Perform the following steps to create the configuration file: 1. Use the EXAMPLE/DMSQL/CONFIG file as a template. This file is included with the SQL Query Processor software. 2. Copy the file EXAMPLE/DMSQL/CONFIG as DMSQL/CONFIG under your usercode. 3. Update the following sections in the DMSQL/CONFIG file to reflect your environment: RELEASE RELEASE DIAGNOSTICS

17 Installing SQL Query Processor USER DEFAULT RESOURCE See Section 6, SQL Query Processor Configuration Control Facility," for details on configuring these items to fit your environment. 4. Save the updated example file as *DMSQL/CONFIG ON DISK. Note: If you want to save the configuration file under another name and location, see Changing the Name and Location of the SQL Query Processor Configuration File later in this section. 5. From CANDE, issue the following statement to verify the accuracy of the syntax in the DMSQL/CONFIG file: RUN *SYSTEM/SQL/CONFIG ON <pack name> If the contents of the file are valid, a message similar to the following is displayed: #RUNNING 8864 > The DMSQL/CONFIG file just validated is: > *DMSQL/CONFIG ON HL511D0 10/11/ :03:05 > No errors. #ET=0.1 PT=0.0 IO=0.1 If errors are returned, see Section 6, SQL Query Processor Configuration Control Facility," to determine how to correct the errors. Changing the Name and Location of the SQL Query Processor Configuration File You can change the name and disk location of the SQL Query Processor configuration file. By default, the name and location of the configuration file is DMSQL/CONFIG ON <pack name>. The variable <pack name> identifies the pack where the SQL Query Processor is installed. The default usercode and family are the same as those in the SYSTEM/SQL/CONFIG file title. That is, if the SQL Query Processor is installed under the asterisk (*) usercode on the family named PACK, the default configuration file title is *DMSQL/CONFIG ON PACK. Perform the following steps to modify the name and location of the SQL Query Processor configuration file: 1. From CANDE, enter the following statement: WFL MODIFY *SYSTEM/SQL/CONFIG ON <pack name>;file CONFIG=<new configuration file name> ON <pack name> 2. Enter the following SL (Support Library) system command: SL DMSQLCONFIG = *SYSTEM/SQL/CONFIG ON <pack name>

18 Installing SQL Query Processor Creating the Server Configuration File (DMSQL/SERVER/CONFIG) During installation of the SQL Query Processor server on the ClearPath MCP host, you use CANDE to create the SQL Query Processor server configuration file called DMSQL/SERVER/CONFIG under the same usercode and on the same pack as the *SYSTEM/SQL/SERVER code file. The server configuration file specifies TCP/IP attributes and the distributed systems services (DSS) provider name. The file is optional, and if it is not installed or is not found, all attributes take on their default values as defined in the following text. The syntax for defining these attributes and the SQL Query Processor name follows: TCPIP <port number> : <timeout specification>, DSSPROVIDER <provider name>, MAXBUFFSIZE <integer> <timeout specification> <BLOCKEDTIMEOUT value> : <DIALOGCHECKINTERVAL value> The following table explains the elements of the syntax diagrams. Element <port number> <BLOCKEDTIMEOUT value> <DIALOGCHECKINTERVAL value> Definition Identifies the port number of the SQL Query Processor server. The default port number is The port number must also be defined in the DSS DMSQL_TCPIP endpoint and in either the connection attributes file or the connection defaults file. Specifies the length of time, in minutes, that the connection between the workstation and the server stays open after the workstation has stopped responding to inactivity handshaking procedures. This value must be an integer. The default BLOCKEDTIMEOUT value is 10 minutes. Specifies the length of time, in minutes, that the server waits without a response from an attached system before it automatically invokes inactivity handshaking procedures. This value must be an integer. The default DIALOGCHECKINTERVAL value is 5. A value of 0 (zero) prevents inactivity handshaking procedures from being invoked

19 Installing SQL Query Processor <provider name> <integer> Element Definition Specifies the name of the DSS provider that provides the SQL Query Processor DSS. The default DSS provider name is DMSQLPROV. Identifies the buffer size in bytes. The default buffer size is The allowed range is from 300 to Configuring the TCP/IP Distributed Systems Services (DSS) The SQL Query Processor Windows-based utilities use a TCP/IP connection to the ClearPath MCP server. This connection is managed as a distributed systems service (DSS). You can manually configure the DSS connection using the following ClearPath MCP commands. However, if you use the Simple Installation (SI) program, the DSS connection is automatically configured, and it is not necessary to enter the following commands. Note: You must be a system user to run the following commands. NA REG ADD PROVIDER DMSQLPROV DSS = DMSQL, SUPPORTLIBRARY = DMSQLSERVER, TASK TYPE = NONMONITOREDSUPPORTLIBRARY, INTERFACE = MESSAGE; NA REG ADD DSS DMSQL ENDPOINT = DMSQL_TCPIP, CLASS = OTHER, INITIALIZE = TRUE, RECOVER = FALSE; NA REG ADD EP DMSQL_TCPIP FILENAME = DMSQL_TCPIP, MYNAME = "1897", PUBLIC = TRUE; You can also copy the preceding commands to a ClearPath MCP sequential data file and load them using the following command: NA LOAD <file title>

20 Installing SQL Query Processor Optional Installation Tasks As part of the SQL Query Processor product installation, you can optionally direct the MCP host to use a pack other than the pack on which the SQL Query Processor is installed for The logging and tracing capabilities of the SQL Query Processor server By default, the system writes requested log and trace files to the pack on which the *SYSTEM/SQL/SERVER code file resides. The location of the *DMSQL/SERVER/CONFIG file By default, the system looks for the server configuration file (*DMSQL/SERVER/CONFIG) on the pack on which the *SYSTEM/SQL/SERVER code file resides. Perform the following steps to change the location of the log or trace files, or the *DMSQL/SERVER/CONFIG file: 1. Stop the SQL Query Processor server by entering the following system command: NA DMSQL QUIT NOW 2. Remove the function name specification for DMSQLSERVER by entering the following system command: SL - DMSQLSERVER 3. Execute the following commands: WFL MODIFY *SYSTEM/SQL/SERVER ON <pack name>; FILE LOG_FILE (FAMILYNAME = <pack name>); FILE TRACE_FILE (FAMILYNAME = <pack name>); FILE DMSQL_SERVER_CONFIG (FAMILYNAME = <pack name>); 4. Map the function name DMSQLSERVER to the SQL Query Processor server code file by entering the following SL (Support Library) system command: SL DMSQLSERVER = *SYSTEM/SQL/SERVER ON <pack name>:linkclass = 1, TRUSTED The pack name represents the name of the pack to which you copied the code file *SYSTEM/SQL/SERVER. The :LINKCLASS = 1, TRUSTED clause of the preceding command is required

21 Installing SQL Query Processor 5. Type the following command to start the SQL Query Processor server software: NA DMSQL + 6. Type the following command to display the status of the SQL Query Processor connection: NA DMSQL STATUS The status report includes the following information: DSS name is DMSQL. DSS provider name is DMSQLPROV. TCP/IP options are as follows: Using port is BlockedTimeout value is 10 min. DialogCheckInterval value is 5 min. Installing the SQL Query Processor Utilities in the Windows Environment After the release media is installed on the ClearPath MCP server, the SQL Query Processor installation package is accessible from the Windows environment on the MCP share called INSTALLS. Note: If you do not have the INSTALLS share on your ClearPath MCP server, you must set up the share using the Administration Center. For instructions on how to do this, refer to the Client Access Services Administration Center Help. The preferred installation method is through MCP Installation Assistant. However, you can install the SQL Query Processor directly from the \DMSQLUtilities folder on the INSTALLS share. Installing by Using MCP Installation Assistant Perform the following steps to install the SQL Query Processor using MCP Installation Assistant: 1. From the Windows environment, map a network drive to the INSTALLS share on your MCP server. 2. Perform one of the following actions to run MCPIA.ps1 from the root directory of the INSTALLS share: If you are logged on as an administrator, you can right-click MCPIA.ps1 and select Run with PowerShell. If you are not logged on as an administrator Right-click Windows PowerShell and select Run as Administrator. Change the directory to the INSTALLS share. Type.\MCPIA.ps1 to start MCP Installation Assistant

22 Installing SQL Query Processor 3. Expand the Database Query and Reporting group. 4. Select the SQL Query Processor Utilities for ClearPath MCP check box. Note: By default, MCP Installation Assistant installs only the Query Design Center. To install both utilities, click the Install Options button, select the Relational Design Center check box, and click Apply. You can also click the ReadMe link to view the readme file. 5. Click Next. 6. Click Install. The SQL Query Processor software is installed in the following path on the Windows environment: Program Files\Unisys\MCP\DMSQLUtilities Note: The MCP Installation Assistant automatically selects for installation, the Java Runtime Environment (JRE) if you do not have the JRE version 1.4 or later installed. Installing by Using the SQL Query Processor.msi File Perform the following steps to install the SQL Query Processor directly from the.msi file in the \DMSQLUtilities folder on the INSTALLS share: 1. Ensure that the Java Runtime Environment (JRE) version 1.4 or later is installed. If not, install it from the INSTALLS share under the Redist\SUN folder. 2. From the Windows environment, map a network drive to the INSTALLS share on your ClearPath MCP server. 3. Double-click the INSTALLS folder. 4. Double-click the DMSQLUtilities folder. 5. Double-click the DMSQLUtils.msi file. An installation wizard is initiated. 6. Follow the instructions on the screen. Be sure to select the appropriate options for your type of installation. Note: When installing using the.msi file, you can choose to perform a complete or a custom installation. The complete setup installs both utilities. To install only one utility, select Custom. On the Custom Setup page, select Query Design Center (the default in a custom setup) or Relational Design Center, and then click Next. Migrating from an Earlier Release The format of the catalog file has changed to accommodate new functionality. Therefore, if you have an earlier release of the SQL Query Processor software installed, you must update your SQL database definition or Enterprise Database Server database on which the SQLVIEW command was processed

23 Installing SQL Query Processor Updating an SQL Database Definition To update your SQL database definition to the current release of SQL Query Processor, run the Schema Administrator with the UPDATE command. You can also use the UPDATE command to update an SQL database to the current level of Enterprise Database Server software. Updating an Enterprise Database Server Database Perform the following steps to update an Enterprise Database Server database that was previously generated with the SQLVIEW command: 1. On the ClearPath MCP server, remove the file named DESCRIPTION/<database name>/dmsql-catalog. 2. Run the following command if you made changes to the SQL schema (such as renaming a column or table) and want to preserve those changes: RUN *SYSTEM/SQL/ADMIN ("SQLVIEW DATABASE <database name> :ACCESSCONTROL=UPDATEOK"); FILE CARD=DDLRESULTS/<database name>/semantic Note: If the database must be mapped for read-only access, use the ACCESSCONTROL = INQUIRYONLY clause or omit the ACCESSCONTROL declaration. For further details, see Section 7, Using the Schema Administrator. 3. Start the Relational Design Center, remove the database name from the tree view, and reimport the database. Removing the SQL Query Processor Software MCP Environment Removing the SQL Query Processor software from the MCP environment involves deleting the server library, worker code files, DMSQL/CONFIG file, and the DSS entities. Perform the following steps to remove the SQL Query Processor software from the MCP environment: 1. Stop the SQL Query Processor server by entering the following system command: NA DMSQL QUIT NOW 2. Remove the function name specification for DMSQLSERVER by entering the following system commands: SL - DMSQLSERVER SL - DMSQLCONFIG SL - DMSQLSCODE SL - DMSQLCLI

24 Installing SQL Query Processor 3. Delete the DSS entities by entering the following system commands: NA REG DEL PROV DMSQLPROV NA REG DEL DSS DMSQL NA REG DEL EP DMSQL_TCPIP 4. Remove the SQL Query Processor server files by entering the following system commands: REM *SYSTEM/SQL/ADMIN ON <pack name> *SYSTEM/SQL/ADMIN/DIAGNOSTICS ON <pack name> *SYSTEM/SQL/ETINQ ON <pack name> *SYSTEM/SQL/ETINQ/DIAGNOSTICS ON <pack name> *SYSTEM/SQL/SCODE ON <pack name> *SYSTEM/SQL/SCODE/DIAGNOSTICS ON <pack name> *SYSTEM/SQL/CONFIG ON <pack name> *SYSTEM/SQL/CONFIG/DIAGNOSTICS ON <pack name> *SYSTEM/SQL/DRIVER ON <pack name> *SYSTEM/SQL/DRIVER/DIAGNOSTICS ON <pack name> *SYSTEM/SQL/PARSER ON <pack name> *SYSTEM/SQL/PARSER/DIAGNOSTICS ON <pack name> *SYSTEM/SQL/SERVER ON <pack name> *SYSTEM/SQL/SERVER/DIAGNOSTICS ON <pack name> *SYSTEM/SQL/WORKER ON <pack name> *SYSTEM/SQL/WORKER/DIAGNOSTICS ON <pack name> *SYSTEM/SQL/DMQUERY ON <pack name> *SYSTEM/SQL/DMQUERY/DIAGNOSTICS ON <pack name> *SYSTEM/SQL/MODLANG ON <pack name> *SYSTEM/SQL/MODLANG/DIAGNOSTICS ON <pack name> *SYSTEM/SQL/SUPPORT ON <pack name> *SYSTEM/SQL/SUPPORT/DIAGNOSTICS ON <pack name> *SYSTEM/SQL/COBOLDESC ON <pack name> *SYSTEM/SQL/COBOLDESC/DIAGNOSTICS ON <pack name> *SYSTEM/SQL/INTERFACE ON <pack name> *SYSTEM/SQL/INTERFACE/DIAGNOSTICS ON <pack name> *SYSTEM/SQL/DMSIIMAPPER ON <pack name> *SYSTEM/SQL/DMSIIMAPPER/DIAGNOSTICS ON <pack name> *SYSTEM/SQL/FILESUPPORT ON <pack name> *SYSTEM/SQL/FILESUPPORT/DIAGNOSTICS ON <pack name> *SYSTEM/SQL/SCODESUPPORT ON <pack name> *SYSTEM/SQL/SCODESUPPORT/DIAGNOSTICS ON <pack name> *SYMBOL/SQL/CLI/PROPERTIES/ALBOL ON <pack name> *SYMBOL/SQL/CLI/PROPERTIES/COBOL ON <pack name> *EXAMPLE/SQL/CLI/ALGOL ON <pack name> *EXAMPLE/SQL/CLI/COBOL ON <pack name> *EXAMPLE/DMSQL/CONFIG ON <pack name> *DESCRIPTION/SQLDIR/DMSQL-CATALOG ON <pack name> *DMSQL/SERVER/CONFIG ON <pack name> *DMSQL/LOG/= ON <pack name> *DMSQL/TRACE/= ON <pack name> *DMSQL/CONFIG ON <pack name>

25 Installing SQL Query Processor Windows Environment The Windows uninstall program removes only the SQL Query Processor software. The program does not remove the log, trace, and schema files, which you can remove manually. Perform the following steps to uninstall the SQL Query Processor software from your Windows environment: 1. Double-click the Add or Remove Programs icon on Control Panel. The Add or Remove Programs Properties dialog box is displayed. 2. Select Unisys SQL Query Processor Utilities for ClearPath MCP. 3. Click OK. The uninstall program begins and removes the SQL Query Processor software. Reinstalling the SQL Query Processor Software MCP Environment To reinstall the SQL Query Processor software in the MCP environment, follow the directions explained earlier in this section under Installing the SQL Query Processor Software in the MCP Environment. Windows Environment You can reinstall the SQL Query Processor software by repeating the installation procedure. However, it is recommended that you uninstall the product first using the following procedure to ensure a trouble-free operation after you have reinstalled the product: 1. Uninstall the SQL Query Processor software. See Removing the SQL Query Processor Software earlier in this section. 2. Install the SQL Query Processor software as outlined under Installing the SQL Query Processor Utilities in the Windows Environment earlier in this section. Note: The server maintains your previous configuration when you reinstall the SQL Query Processor software. Troubleshooting The following procedures can help you determine if the SQL Query Processor server installation completed correctly. These procedures are not required. If you had any problems during the installation process, or if you want to confirm that all components of the SQL Query Processor server were installed, you can run some or all of the troubleshooting procedures

26 Installing SQL Query Processor Verifying Release Identifiers Action To verify the installation of the most recent support libraries, enter the following CANDE commands: FAM LFILES *SYSTEM/SQL ON SYSNEW :RELEASEID LFILES *DESCRIPTION/SQLDIR/DMSQL-CATALOG :RELEASEID Result The following number of files are returned. File Type Number Returned *SYSTEM/SQL 32 *DESCRIPTION/SQLDIR/DMSQL-CATALOG 1 Solution If an incorrect number of files are returned or if the RELEASEID attribute of the files is not correct, perform the following procedures. If... Then... You are installing files from an Interim Correction (IC) tape You are installing the base release Recopy the appropriate files from the IC tape. Complete the following steps: 1. Run the Simple Installation (SI) program. 2. Ensure the product identifier is SQL. 3. Specify the appropriate release identifier. Verifying the SQL Query Processor Configuration System Library Action Enter the following ODT command: SL *DMSQLCONFIG Result The following statement is displayed: SL DMSQLCONFIG = *SYSTEM/SQL/CONFIG ON SYSNEW

27 Installing SQL Query Processor Solution If the DMSQLCONFIG statement points to another file or if the SQL Query Processor configuration system library function does not exist, enter the following ODT command: SL DMSQLCONFIG = *SYSTEM/SQL/CONFIG ON SYSNEW Verifying the SCode Compiler System Library Action Enter the following ODT command: SL * DMSQLSCODE Result The following statement is displayed: SL DMSQLSCODE = *SYSTEM/SQL/SCODE ON SYSNEW Solution If the DMSQLCODE statement points to an incorrect file or if the Scode compiler system library function does not exist, enter the following ODT command: SL DMSQLSCODE = *SYSTEM/SQL/SCODE ON SYSNEW Verifying the SQL Driver System Library Action Enter the following ODT command: SL *DMSQLCLI Result The following statement is displayed: SL DMSQLCLI = *SYSTEM/SQL/INTERFACE/ ON SYSNEW TRUSTED Solution If the DMSQLCLI statement points to another file, if the TRUSTED parameter is missing, or if the SQL driver system library function does not exist, enter the following ODT command: SL DMSQLCLI = *SYSTEM/SQL/INTERFACE ON SYSNEW :TRUSTED

28 Installing SQL Query Processor Verifying the Existence and Location of the SQL Query Processor Configuration File Action Enter the following CANDE command: RUN $SYSTEM/SQL/CONFIG ON SYSNEW Result The following text is displayed: #RUNNING 8864 > The DMSQL/CONFIG file just validated is: > *DMSQL/CONFIG ON HL511D0 10/11/ :03:05 > No errors. #ET=0.1 PT=0.0 IO=0.1 Solution If the SQL Query Processor configuration file does not exist, see Creating the SQL Query Processor Configuration File (DMSQL/CONFIG) earlier in this section for instructions on creating an SQL Query Processor configuration file. If the SQL Query Processor configuration file does exist, but syntax errors occur, see Section 6, SQL Query Processor Configuration Control Facility," for instructions on creating an SQL Query Processor configuration file. Verifying the Contents of the SQL Query Processor Configuration File Action After verifying the existence and location of the SQL Query Processor configuration file, enter the following command to display the contents of the SQL Query Processor configuration file: LIST *DMSQL/CONFIG ON SYSNEW Result The exact text of your SQL Query Processor configuration file might differ, but ensure the following information is contained in your file: RELEASE MYSQL (PACK = SYSNEW) Solution If the RELEASE or VIEWCONNECTION option is missing from your SQL Query Processor configuration file, modify your SQL Query Processor configuration file to include these options. For detailed information about the SQL Query Processor configuration file, see Section 6, SQL Query Processor Configuration Control Facility

29 Installing SQL Query Processor Verifying the SQL Query Processor Server Code File Action Enter the following ODT command: SL *DMSQLSERVER Result The following text is displayed: SL DMSQLSERVER = *SYSTEM/SQL/SERVER ON SYSNEW :TRUSTED, LINKCLASS=1 Solution If the DMSQLSERVER statement points to an incorrect file, if either the TRUSTED parameter or the LINKCLASS parameter is missing, or if the code file does not exist, enter the following ODT command: SL DMSQLSERVER = *SYSTEM/SQL/SERVER ON SYSNEW :TRUSTED, LINKCLASS=1 Verifying the SQL Query Processor Server Provider Action Enter the following ODT command: NA REG SHOW PROV DMSQLPROV Result The following text is displayed: Provider name: DMSQLPROV, Task type: NonMonitoredSupportLibrary Interface: Message SL: DMSQLSERVER DSSes provided: DMSQL Solution If the displayed information differs from the preceding result, enter the following ODT command: NA REG ADD PROV DMSQLPROV SL=DMSQLSERVER, TASK TYPE=NMSL, INTERFACE=MESSAGE, DSS=DMSQL

30 Installing SQL Query Processor Verifying SQL Query Processor Distributed Systems Services (DSS) Information Action Enter the following ODT command: NA REG SHOW DSS DMSQL Result The following text is displayed: DSSName: DMSQL, Class: OTHER Recovery after Halt/Load: FALSE, Initialize DSS: TRUE Endpoints: DMSQL_TCPIP Note: Your settings for Recovery after Halt/Load and Initialize DSS might differ. Solution If the displayed information differs from the preceding result, enter the following ODT command: NA REG ADD DSS DMSQL EP=(DMSQL_TCPIP), CLASS=OTHER, INIT=TRUE Verifying the TCP/IP Endpoint Action Enter the following ODT command: NA REG SHOW EP DMSQL_TCPIP Result The following text is displayed: Endpoint Name: DMSQL_TCPIP, Public Endpoint: TRUE Filename: DMSQL_TCPIP, Applicationgroup: Myname: "1897" Solution If the displayed information differs from the preceding result, enter the following ODT command: NA REG ADD EP DMSQL_TCPIP FILENAME=DMSQL_TCPIP, MYNAME="1897", PUBLIC=TRUE

31 Installing SQL Query Processor Note: MYNAME must be a TCP/IP port number unique to the system. The number 1897 is the default service number used for the SQL Query Processor. You can specify a different port number by registering this endpoint with a different port number for MYNAME, and by entering this number in the SQL Query Processor configuration file. Failure to choose a unique number could cause conflicts between different TCP/IP-based services. Listing the Status of the SQL Query Processor Server Action Enter the following ODT commands: NA DMSQL - NA DMSQL + NA DMSQL STATUS Note: The NA DMSQL command closes all SQL Query Processor connections and stops the SQL Query Processor server. Result The following text is displayed: DMSQL Server Status Report for job 4318/4318. Monday, October 11, :50: DSS Name is DMSQL. DSS Provider Name is DMSQLPROV. DMSQL Server [ ]. Server : *SYSTEM/SQL/SERVER ON DMSQL. Trace Information not available. 0 DMSQL connections TCPIP Options: BlockedTimeout: 10 mins DialogCheckInterval: 5 mins Subfiles offered: 3 Using port: 1897 Solution If the required information is missing from your SQL Query Processor server configuration file (DMSQL/SERVER/CONFIG), modify your server configuration file

32 Installing SQL Query Processor Updating Enterprise Database Server Databases with SQL Queries If you want an Enterprise Database Server database to be updated by SQL queries, the database must meet the following requirements: The database must be audited and include the REAPPLYCOMPLETED and INDEPENDENTTRANS options. Refer to the Enterprise Database Server Data and Structure Definition Language (DASDL) Programming Reference Manual for details on these options. The database must be imported through the Relational Design Center utility with the Read-only access control option reset. See Importing a Relational Schema in Section 4 for more information. Or, the clause ACCESSCONTROL = UPDATEOK must be included as part of the Schema Administrator RUN statement. See Manually Enabling SQL Access to an Enterprise Database Server Database in Section 7 for more information. The database resource must specify MODE UPDATE. Refer to the DMQUERY utility OPEN command in Section 8 for more information. Although updates to an Enterprise Application Environment (EAE) database can be performed using the SQL Query Processor, such direct updates are not recommended as they might violate EAE application business rules and corrupt the application integrity of an EAE system. Updating Enterprise Database Server Data Sets with SQL Queries If you want an Enterprise Database Server data set to be updated by SQL queries, the data set must meet the following requirements: The data set must not contain any LINK items. For some applications, the data set must have at least one set with no duplicates. Note: Ordered data sets with duplicates allowed cannot be updated

33 Section 3 Using the Query Design Center The Query Design Center is an interactive tool that administrators and developers can use to design and execute ad-hoc SQL requests against the SQL Query Processor for ClearPath MCP. This tool makes it easy to design and execute queries against Enterprise Database Server and test these queries outside of user applications. Using the Query Design Center, you specify your solution in terms of joins, ordering, columns to display, and so on. You do not use SQL syntax. The Query Design Center automatically builds the syntax of your queries based on your input. However, if you are fluent in SQL, you can manually enter and execute SQL syntax. Starting the Query Design Center Perform the following steps to start the Query Design Center: 1. On the Start menu, point to Programs, Unisys MCP, and then SQL Query Processor for ClearPath MCP Utilities, and click Query Design Center. The Open Connection dialog box appears

34 Using the Query Design Center 2. Perform one of the following actions: Type your log-in credentials without a resource name, and click OK. See Usercode and Password Conventions later in this section for details on specifying your usercode and password. The Catalog window is displayed. Type your log-in credentials with a resource name, and click OK. See Usercode and Password Conventions later in this section for details on specifying your usercode and password. Notes: The Analyze Query window is displayed. To authenticate log-in credentials using your ClearPath MCP usercode and password, select the MCP option in the Authentication list and type your log-in credentials. To authenticate log-in credentials using Kerberos credentials, select the Kerberos option in the Authentication list. To encrypt your Kerberos credentials, select the Encryption option in the Encryption list. If only read access is allowed on the database, select the Read Only check box. The ReadOnly property in the qdc.properties file controls the default setting of this option. The value 1 indicates read-only access. 3. Proceed with your work as desired. Usercode and Password Conventions The usercode can consist of usercode, accesscode, and chargecode combinations as shown in the following syntax. Accesscode and chargecode requirements are defined by your system administrator. <usercode> /<accesscode> /<chargecode> /<accesscode>/<chargecode> The password can consist of a password and an optional accesscode password as shown in the following syntax: <password> /<accesscode password>

35 Using the Query Design Center Understanding the Query Design Center Interface The Query Design Center consists of a main window with a menu bar and the following internal windows: Catalog The Catalog window enables you to view the available resources, the tables and columns of a given resource, and their respective properties. You can also access the Analyze Query window and the Design Query window. Analyze Query The Analyze Query window enables you to enter and execute SQL statements, and view the results. To use this window, it is recommended that you have experience in SQL syntax and semantics. Design Query The Design Query window enables you to interactively build queries and automatically generate an SQL statement. The internal window that appears in the main window of the Query Design Center depends on the task you are performing

36 Using the Query Design Center Using the Menu Bar The following table describes the menu bar located at the top of the Query Design Center window. Menu Item File Query Options Enables you to Description Connect to a resource for a server Disconnect from a server Open an existing query Save a query or query result Exit the Query Design Center The following commands are available: Prepare Validates the syntax of an SQL statement and prepares the SQL statement for execution. Execute Executes the SQL statement. Commit Commits the current transaction when the Manual Commit Mode command is set. Abort Aborts the current transaction when the Manual Commit Mode command is set. Savepoint Creates a named savepoint when the Manual Commit Mode command is set. Rollback to Savepoint Rolls back the current transaction to a selected savepoint when the Manual Commit Mode command is set. The following commands are available: QGraphs Generates a QGraph which contains information that is useful when you are manually optimizing queries. QDumps Generates a QDump which contains diagnostic information used by Unisys support personnel to analyze and troubleshoot problems you report to the Unisys Support Center. Manual Commit Mode Commits the results of each SQL statement to the database. Manual Commit Mode is disabled by default. You can enable Manual Commit Mode and then use the Commit and Abort commands to manually manage transactions. Isolation level Sets the transaction isolation level

37 Using the Query Design Center Menu Item Options (cont.) View Window Change Row Limit Description Sets the number of rows returned for queries. Look and feel Sets the look and feel of the Query Design Center interface to the Windows, Metal (Java), or Motif (UNIX) environment. Enables you to view the Catalog window. Enables you to switch between currently opened windows. Setting the Look and Feel of the Interface You can set the Query Design Center interface to have the look and feel of a Java, UNIX, or Windows environment. The default look and feel is the Windows environment. Perform the following steps to set the look and feel of the Query Design Center interface: 1. On the Options menu, point to Look and Feel. 2. Click one of the following options: Metal Motif Windows The Query Design Center adopts the selected look and feel for the current session. Determining Connection Status Perform the following steps to determine the connection status of a database: 1. Right-click in any window and click Connection Status. The Connection Status dialog box appears. 2. Review the details of the resource connection. 3. Click OK to dismiss the dialog box

38 Using the Query Design Center Catalog Window The Catalog window provides a view of resources against which you can design and execute queries. Tree View The Catalog window has two views: a tree view and a properties view. The left pane of the Catalog window displays a tree view of databases that you can access, assuming you have the proper privileges to access a particular resource. The resources are defined in the SQL Query Processor configuration file named DMSQL/CONFIG file that is used by the DMSQLCONFIG library. Note: If the number of resources exceeds the number specified for the rowlimit property, the list of available resources in the tree view is truncated. See Default Properties later in this section for more information about the rowlimit property. Icons The Catalog window uses the following icons to represent different objects in the tree view. Icon Description Identifies a database. Identifies a table. Identifies a column. Identifies a primary key. Identifies a view

39 Using the Query Design Center Properties View The right pane of the Catalog window displays the properties of the object selected in the tree view. The properties and their values vary depending on the selected object. Resource Properties The following properties appear in the properties view when a resource is selected in the tree view. The tree view presents the database schema in a hierarchical fashion. For a given server, the root node is the database. The properties view displays the following information for a database. Resource Name Database Title Property Description Identifies the logical name of the data source. Identifies the file title of the physical database. Table Properties The following properties appear in the properties view when a table is selected in the tree view. Property Resource Name Table Name Owner Name Type Primary Key Description Identifies the logical name of the data source. A resource maps a data source identifier to one or more physical databases. Identifies the name of the table or view of the resource. Identifies the name of the owner of the table or view. Identifies the item as a table or view. Identifies the column names of the primary key for the table or view

40 Using the Query Design Center Column Properties The following properties appear in the properties view when a column is selected in the tree view. Property Resource Name Table Name Column Name Type Length Precision Scale Required Description Identifies the logical name of the data source. A resource maps a data source identifier to one or more physical databases. Identifies the name of the table or view of the resource. Identifies the column name. Identifies the data type of the column. For a character type, identifies the number of bytes for a fixed length type and the maximum number of bytes for a variable length type. For a fixed point number (numeric or decimal type), identifies the maximum number of digits representing the value. For a fixed point number (numeric or decimal type), identifies the maximum number of digits representing the value to the right of the decimal point. Indicates whether the column can contain NULL values. Primary Key Properties The following properties appear in the properties view when a primary key is selected in the tree view. Property Resource Name Table Name Column Name Type Length Description Identifies the logical name of the data source. A resource maps a data source identifier to one or more physical databases. Identifies the name of the table or view of the resource. Identifies the column name. Identifies the data type of the column. For a character type, identifies the number of bytes for a fixed length type and the maximum number of bytes for a variable length type

41 Using the Query Design Center Property Description Precision Scale Required Primary Key Sequence Index For a fixed point number (numeric or decimal type), identifies the maximum number of digits representing the value. For a fixed point number (numeric or decimal type), identifies the maximum number of digits representing the value to the right of the decimal point. Indicates whether the column can contain NULL values. Identifies the ordinal number for each column that is part of the primary key. There can be more than one column that is part of the primary key. Identifies the name of the index if an index exists over this column. This property could apply to any column. Opening Tables You can open tables contained in a resource. The Query Design Center automatically executes the appropriate SQL query on the table to enable you to see the rows of the table. Perform the following steps to open a table: 1. From the Catalog window, expand a resource to expose the underlying tables. 2. Right-click the desired table and click Open. The Analyze Query window appears with the SELECT statement in the text pane and the rows of the table in the results pane. Viewing Table Results To display the tables of a resource and its related information, do the following: 1. From the Catalog window, right-click a resource, point to View, and click SQLTables. A separate window appears listing tables (contained in the resource) in the results pane. 2. To save the results as a text file, right-click the results pane and click Save Result Set As. The Save dialog box appears. 3. Navigate to the desired folder, type a name in the File name box, and click Save. The file is saved

42 Using the Query Design Center Viewing Column Results Perform the following steps to display the information related to columns: 1. From the Catalog window, expand a resource, right-click the desired table, and point to View. 2. Click one of the following commands on the shortcut menu: SQLColumns Displays the columns of the selected table SQLPrimaryKeys Displays the columns that make up the primary key for the selected table SQLForeignKeys, related Displays the list of foreign keys in the selected table and their related primary keys SQLForeignKeys, in this Displays the list of foreign keys in the selected table and their related primary keys SQLStatistics Displays a list of statistics about a single table and the indexes associated with the table A separate window appears with the results in the results pane. 3. To save the results as a text file, right-click the results pane and click Save Result Set As. The Save dialog box appears. 4. Navigate to the desired folder, type a name in the File name box, and click Save. The file is saved. Analyze Query Window The Analyze Query window enables you to Interrogate and update data in a database using SQL syntax and semantics. Experiment with the SQL Query Processor call-level interface (CLI) without having to write a COBOL or ALGOL program. Obtain diagnostic information about queries for purposes of optimization and to send to Unisys support for analysis. View result sets translated using the coded character set of the database

43 Using the Query Design Center Text Pane Through the Analyze Query window, you can enter and execute the following SQL statements, and view their results: SELECT INSERT UPDATE DELETE The Analyze Query window has two panes: a text pane and a results pane. The top pane of the Analyze Query window enables you to type the text of an SQL query statement and perform a number of operations such as statement execution and syntax checking. You can also load a query from a text file into the text pane. In the following example, a SELECT statement was typed in the text pane. A shortcut menu appears when you right-click the text pane, enabling you to perform actions against the statement. Results Pane The bottom pane of the Analyze Query window displays the results of syntax checking (along with item descriptions) and the results of the executed query statement. You can also save results of a query to a text file

44 Using the Query Design Center In the following example, the syntax of the statement SELECT * FROM sqlexample.car in the text pane is validated and the item descriptions are displayed in the results pane. The following example shows the results of the executed query statement. Note: From the shortcut menu for a table or view, you can access the Analyze Query window to display the contents of the selected table (Open) or access the Design Query window to design a query involving the selected table

45 Using the Query Design Center Analyze Query Window Commands The following commands are available on the shortcut menu when you right-click in the Analyze Query window. Command Copy Result Set Clear Execute Prepare Commit Abort Savepoint Rollback to Savepoint Open Query Save Query As Save Result Set As View Catalog Design Query Description Copies the table of results to the clipboard. You can only execute this command from the results pane. Removes the contents of the text pane or results pane, depending on the pane from which you execute the command. Executes the SQL statement in the text area, or executes the SQL statement that the user has selected in the text area. Parses the SQL statement in the text pane. The Query Design Center validates the syntax without attempting to execute the query. The results of a successful validation appear in the results pane along with item descriptions. If the syntax is not valid, an error message provides a description of the error. Commits the current transaction when in Manual Commit Mode. Aborts the current transaction when in Manual Commit Mode. Saves a named savepoint when in Manual Commit Mode. Rolls back the current transaction to a selected savepoint when in Manual Commit Mode. Enables you to place the contents of a saved query into the text pane. Saves the contents of the text pane to a file. Saves the results of an executed query to a text file. Displays the Catalog window. Displays the Design Query window

46 Using the Query Design Center Preparing and Executing a Query Perform the following steps to prepare and execute a query. Note: Queries are limited to a maximum number of 5000 rows by default. See "Customizing the Query Design Center" later in this section. 1. From the Catalog window, right-click the desired resource and click Analyze Query. The Analyze Query window appears. 2. In the text pane (top pane), type your query statement. 3. Right-click and choose Prepare. The Query Design Center checks the syntax of your statement. If the SQL syntax is valid, the outcome along with item descriptions is displayed in the results pane (bottom pane). The following message also appears: Statement was prepared successfully. See item descriptions above. If the SQL syntax is not valid, an error message appears containing a description of the error. You must correct the syntax before proceeding. 4. Right-click and choose Execute. If your SQL statement contains parameters, the Enter Parameters dialog box appears. Continue with step 5. Otherwise, the Query Design Center executes the query and the outcome appears in the results pane. 5. Type the desired parameters in the Parameter 1 box, and click OK. The outcome of the query appears in the results pane. Note: The Enter Parameters dialog box continues to appear depending on the number of parameters declared in your SQL statement. 6. To save the results as a text file, right-click the results pane and click Save Result Set As. The Save dialog box appears. 7. Navigate to the desired folder, type a name in the File name box, and click Save. The file is saved. Saving a Query You can save a query statement that you enter in the text pane and use it later. Perform the following steps to save a query: 1. Right-click the text pane and click Save Query As. The Save dialog box appears. 2. Navigate to the desired folder, type a name in the File name box, and click Save. The file is saved with the.sql extension (for example, mystatement.sql)

47 Using the Query Design Center Saving Query Results Perform the following steps to save query results: 1. Right-click the results pane and click Save Result Set As. The Save dialog box appears. 2. Navigate to the desired folder, and select a file format from the Files of type list. Note: Selecting All Files saves the file as a.txt file. 3. Type a name in the File name box and click Save. Opening a Query The file is saved with the extension that corresponds to the format you chose (that is,.txt,.csv, or.tsv). You can reuse a query that you previously saved in the Query Design Center. This action eliminates the need for you to retype the query or recall syntax of an intricate SQL statement. Perform the following steps to open a query: 1. From the Analyze Query window, right-click and click Open Query. The Open dialog box appears. 2. Navigate to the folder containing the.sql file (for example, myquery.sql) of the query you want to open, and select the file. The file name appears in the File name box. 3. Click Open. The Open dialog box is closed and the query appears in the text pane of the Analyze Query window. Enabling Manual Commit Mode By default, the results of each SQL statement executed in the Query Design Center are automatically committed in the database. However, you can override this action by enabling Manual Commit Mode. Once this mode is enabled, you can then use the Commit and Abort commands to manually manage transactions. See "Analyze Query Window Commands" earlier in this section for a description of the Commit and Abort commands

48 Using the Query Design Center Perform the following steps to enable Manual Commit Mode: 1. On the Options menu, click Manual Commit Mode. A check mark appears to the left of the command to indicate that Manual Commit Mode is enabled. You can now initiate the Commit and Abort commands for SQL statements you execute in the Query Design Center. 2. To disable the option, click Manual Commit Mode on the Options menu to remove the check mark next to the command. Setting Transaction Isolation Levels The Query Design Center supports the following isolation levels for transactions. Isolation Level Read Committed Read Uncommitted Repeatable Read Serializable Description The Read Committed isolation level allows a transaction to acquire a read lock (if it only reads the data) or a write lock (if it updates or deletes data) on the current record of data with which it is working. The record being used by the transaction cannot be changed or removed by other transactions until the lock is released. Read locks are released when the transaction moves off the current record. Write locks are held until the transaction is committed or rolled back. Transactions using the Read Committed isolation level wait until records of data that are write-locked by other transactions are unlocked before they acquire their own locks. Dirty reads are not allowed. Nonrepeatable reads and phantom reads are allowed. The Read Uncommitted isolation level does not lock records. Dirty reads, nonrepeatable reads, and phantom reads are allowed. The Repeatable Read isolation level places a shared lock on records. Dirty reads and nonrepeatable reads are not allowed. Phantom reads are allowed. The Serializable isolation level locks an entire structure. Dirty reads, nonrepeatable reads, and phantom reads are not allowed. Note: If you do not specify an isolation level, the level Read Committed is applied to automatic and manual transactions. To set the isolation level for transactions, click the Options menu, point to Isolation Level, and click the level you want to apply to transactions. A check mark appears to the left of the isolation level to indicate that it is enabled

49 Using the Query Design Center Creating a Savepoint A savepoint is a special mark inside a transaction that allows all commands that are executed after it is established to be rolled back, restoring the transaction state to what it was at the time of the savepoint. The Query Design Center enables you to create savepoints for transactions you perform. Note: You can only create a savepoint when Manual Commit Mode is enabled. Perform the following steps to create a savepoint: 1. On the Options menu, click Manual Commit Mode. A check mark appears to the left of the command to indicate that Manual Commit Mode is enabled. 2. Perform the desired actions. 3. Right-click the Analyze Query window and click Savepoint. The New Savepoint dialog box appears. 4. Type the desired name in the Savepoint Name box, and click OK. A message is displayed indicating that the savepoint was successfully created. Rolling Back to a Savepoint Note: You can only roll back the current transaction to a selected savepoint when Manual Commit Mode is enabled. Perform the following steps to roll back the current transaction to a selected savepoint: 1. Right-click the Analyze Query window and click Rollback to savepoint. The Rollback to Savepoint dialog box appears. 2. Type the desired name in the Savepoint Name box and click OK. A message is displayed indicating that the transaction was rolled back to the savepoint. Setting the Row Limit The Query Design Center enables you to set the maximum number of rows returned for queries made in the current session. Perform the following steps to set the row limit: 1. On the Options menu, click Change Row Limit. The Set Row Limit dialog box appears. 2. Type the desired value in the Number of Rows box and click OK. The new limit takes effect

50 Using the Query Design Center Generating a QGraph A QGraph is a useful aid when manually optimizing queries. You enable and disable QGraphs from the Options menu when the Analyze Query window is displayed. When you enable QGraphs, a graph is generated for each SQL statement executed in the Analyze Query window. Note: You cannot enable or disable QGraphs from the other windows of the Query Design Center. Perform the following steps to generate a QGraph: 1. Display the Analyze Query window, and click QGraphs on the Options menu. A check mark appears to the left of the command indicating that QGraphs is enabled. 2. Type a valid SQL statement in the text pane. 3. Right-click and click Execute or Prepare. The text editor Notepad appears containing a QGraph for the executed query. The following example shows sample QGraph output. 4. If desired, save the QGraph output to a text file. Generating a QDump A QDump serves as a diagnostic aid to Unisys support personnel to analyze and troubleshoot problems you report. You enable and disable QDumps from the Options menu when the Analyze Query window is displayed. When you enable QDumps, a graph is generated for each SQL statement executed in the Analyze Query window. Note: You cannot enable or disable QDumps from the other windows of the Query Design Center

51 Using the Query Design Center Perform the following steps to generate a QDump: 1. Display the Analyze Query window, and click QDumps on the Options menu. A check mark appears to the left of the command indicating that QDumps is enabled. 2. Type a valid SQL statement in the text pane. 3. Right-click and click Execute or Prepare. The text editor Notepad appears containing a QDump for the executed query. The following example shows sample QDump output. 4. If desired, save the QDump output to a text file. Design Query Window The Design Query window enables you to interactively build queries and automatically generate the SQL statements