Teradata Query Scheduler. User Guide

Transcription

1 Teradata Query Scheduler User Guide Release B A July 2007

2 The product or products described in this book are licensed products of Teradata Corporation or its affiliates. Teradata, BYNET, DBC/1012, DecisionCast, DecisionFlow, DecisionPoint, Eye logo design, InfoWise, Meta Warehouse, MyCommerce, SeeChain, SeeCommerce, SeeRisk, Teradata Decision Experts, Teradata Source Experts, WebAnalyst, and You ve Never Seen Your Business Like This Before are trademarks or registered trademarks of Teradata Corporation or its affiliates. Adaptec and SCSISelect are trademarks or registered trademarks of Adaptec, Inc. AMD Opteron and Opteron are trademarks of Advanced Micro Devices, Inc. BakBone and NetVault are trademarks or registered trademarks of BakBone Software, Inc. EMC, PowerPath, SRDF, and Symmetrix are registered trademarks of EMC Corporation. GoldenGate is a trademark of GoldenGate Software, Inc. Hewlett-Packard and HP are registered trademarks of Hewlett-Packard Company. Intel, Pentium, and XEON are registered trademarks of Intel Corporation. IBM, CICS, DB2, MVS, RACF, Tivoli, and VM are registered trademarks of International Business Machines Corporation. Linux is a registered trademark of Linus Torvalds. LSI and Engenio are registered trademarks of LSI Corporation. Microsoft, Active Directory, Windows, Windows NT, and Windows Server are registered trademarks of Microsoft Corporation in the United States and other countries. Novell and SUSE are registered trademarks of Novell, Inc., in the United States and other countries. QLogic and SANbox trademarks or registered trademarks of QLogic Corporation. SAS and SAS/C are trademarks or registered trademarks of SAS Institute Inc. SPARC is a registered trademarks of SPARC International, Inc. Sun Microsystems, Solaris, Sun, and Sun Java are trademarks or registered trademarks of Sun Microsystems, Inc., in the United States and other countries. Symantec, NetBackup, and VERITAS are trademarks or registered trademarks of Symantec Corporation or its affiliates in the United States and other countries. Unicode is a collective membership mark and a service mark of Unicode, Inc. UNIX is a registered trademark of The Open Group in the United States and other countries. Other product and company names mentioned herein may be the trademarks of their respective owners. THE INFORMATION CONTAINED IN THIS DOCUMENT IS PROVIDED ON AN AS-IS BASIS, WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT. SOME JURISDICTIONS DO NOT ALLOW THE EXCLUSION OF IMPLIED WARRANTIES, SO THE ABOVE EXCLUSION MAY NOT APPLY TO YOU. IN NO EVENT WILL TERADATA CORPORATION BE LIABLE FOR ANY INDIRECT, DIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, INCLUDING LOST PROFITS OR LOST SAVINGS, EVEN IF EXPRESSLY ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. The information contained in this document may contain references or cross-references to features, functions, products, or services that are not announced or available in your country. Such references do not imply that Teradata Corporation intends to announce such features, functions, products, or services in your country. Please consult your local Teradata Corporation representative for those features, functions, products, or services available in your country. Information contained in this document may contain technical inaccuracies or typographical errors. Information may be changed or updated without notice. Teradata Corporation may also make improvements or changes in the products or services described in this information at any time without notice. To maintain the quality of our products and services, we would like your comments on the accuracy, clarity, organization, and value of this document. Please teradata-books@lists.teradata.com Any comments or materials (collectively referred to as Feedback ) sent to Teradata Corporation will be deemed non-confidential. Teradata Corporation will have no obligation of any kind with respect to Feedback and will be free to use, reproduce, disclose, exhibit, display, transform, create derivative works of, and distribute the Feedback and derivative works thereof without limitation on a royalty-free basis. Further, Teradata Corporation will be free to use any ideas, concepts, know-how, or techniques contained in such Feedback for any purpose whatsoever, including developing, manufacturing, or marketing products or services incorporating Feedback. Copyright by Teradata Corporation. All Rights Reserved.

3 Preface Purpose This book provides information about the Teradata Query Scheduler (Teradata QS) client, which is a Teradata Tools and Utilities product. Teradata Tools and Utilities are a group of products designed to work with Teradata Database. This user guide describes the Teradata QS client components and features. Using Teradata QS, you can submit scheduled SQL requests to a Teradata QS server and also view information about your scheduled jobs. Audience This book is intended for use by: Teradata Database administrator Other technical personnel who manage both the Teradata QS client and Teradata QS server software programs Supported Releases This book supports the following releases: Teradata Database Teradata Tools and Utilities Teradata Query Scheduler Note: See Exploring the Toolbar on page 35 and the Information Icon on the toolbar to learn how to verify the Teradata QS version number. To locate detailed supported-release information: 1 Go to 2 Navigate to General Search>Publication Product ID. 3 Enter Open the version of the Teradata Tools and Utilities ##.##.## Supported Versions spreadsheet associated with this release. The spreadsheet includes supported Teradata Database versions, platforms, and product release numbers. Teradata Query Scheduler User Guide 3

4 Preface Prerequisites Prerequisites The following prerequisite knowledge is required for this product: Relational database management systems Teradata SQL Basic concepts of the Teradata Database Connectivity software, such as CLIv2 Changes to This Book The following changes were made to this book in support of the current release. Changes are marked with change bars. For a complete list of changes to the product, see the Release Definition associated with this release. Date and Release July Description Updated version numbers. See Database Requirements on page 26. Updated text inset Updated Preface Additional Information Additional information that supports this product and Teradata Tools and Utilities is available at the web sites listed in the table that follows. In the table, mmyx represents the publication date of a manual, where mm is the month, y is the last digit of the year, and x is an internal publication code. Match the mmy of a related publication to the date on the cover of this book. This ensures that the publication selected supports the same release. 4 Teradata Query Scheduler User Guide

5 Preface Additional Information Type of Information Description Access to Information Release overview Late information Additional product information CD-ROM images Use the Release Definition for the following information: Overview of all of the products in the release Information received too late to be included in the manuals Operating systems and Teradata Database versions that are certified to work with each product Version numbers of each product and the documentation for each product Information about available training and the support center Use the Teradata Information Products Publishing Library site to view or download specific manuals that supply related or additional information to this manual. Access a link to a downloadable CD-ROM image of all customer documentation for this release. Customers are authorized to create CD-ROMs for their use from this image. 1 Go to 2 Select the General Search check box. 3 In the Publication Product ID box, type Click Search. 5 Select the appropriate Release Definition from the search results. 1 Go to 2 Select the Teradata Data Warehousing check box. 3 Do one of the following: For a list of Teradata Tools and Utilities documents, click Teradata Tools and Utilities and then select a release or a specific title. Select a link to any of the data warehousing publications categories listed. Specific books related to Teradata QS are as follows: Teradata Query Scheduler Administrator Guide B mmyx Teradata Dynamic Workload Manager User Guide B mmyx ODBC Driver for Teradata User Guide B mmyx Teradata Call-Level Interface Version 2 Reference for Network-Attached Systems B mmyx Teradata Manager User Guide B mmyx Teradata SQL Assistant for Microsoft Windows User Guide B mmyx 1 Go to 2 Select the General Search check box. 3 In the Title or Keyword box, type CD-ROM. 4 Click Search. Teradata Query Scheduler User Guide 5

6 Preface Additional Information Type of Information Description Access to Information Ordering information for manuals General information about Teradata Use the Teradata Information Products Publishing Library site to order printed versions of manuals. The Teradata home page provides links to numerous sources of information about Teradata. Links include: Executive reports, case studies of customer experiences with Teradata, and thought leadership Technical information, solutions, and expert advice Press releases, mentions, and media resources 1 Go to 2 Select the How to Order check box under Print & CD Publications. 3 Follow the ordering instructions. 1 Go to Teradata.com. 2 Select a link. 6 Teradata Query Scheduler User Guide

7 Table of Contents Preface Purpose Audience Supported Releases Prerequisites Changes to This Book Additional Information Chapter 1: What is Teradata QS? About the Teradata QS Architecture Teradata QS Client Components Teradata QS Server Components Teradata QS Administrator Components What Does Teradata QS Do? What Are Scheduled Requests? How Are Scheduled Requests Processed? Execution Time Frames Request Checking Job Dispatching Job Execution What Can I Do with Teradata QS? Teradata Query Scheduler Submit Request Dialog Box Teradata Query Scheduler Viewer Chapter 2: Before You Begin System Requirements/Prerequisites Supported Client Operating Systems Required Client Software Teradata Query Scheduler User Guide 7

8 Table of Contents Optional Client Software Specifying a Default Teradata QS Server Working with Character Sets Running the Teradata QS Viewer or SQL Assistant on Windows Server Chapter 3: Getting Started Opening the Teradata Query Scheduler Viewer Connecting to a Teradata QS Server Disconnecting from a Teradata QS Server and Exiting Teradata QS Navigating the Teradata Query Scheduler Viewer Using the Menu Bar Exploring the Toolbar Using the Jobs List Reading the Status Bar Viewing Copyright and Version Information Customizing the Teradata Query Scheduler Viewer Setting the Refresh Rate Choosing a SQL Assistant Export Setting Chapter 4: Scheduling Requests Saving Result Data Scheduling a SQL Request Specifying Notifications Immediately Executing a Scheduled Request Scheduling Rejected Teradata SQL Assistant Queries Chapter 5: Working with Scheduled Requests Viewing Scheduled Requests Sorting the Job List Refreshing the Job List Managing Scheduled Requests Viewing Scheduled Request Properties Teradata Query Scheduler User Guide

9 Table of Contents Modifying a Scheduled Request Deleting a Scheduled Request Managing Jobs Canceling a Job Deleting a Job Working with Job Results Retrieving Job Results Viewing Job Result Information Dropping Results Chapter 6: Working with the Teradata Query Scheduler Operations Utility Starting the Teradata Query Scheduler Operations Utility Navigating the Teradata Query Scheduler Operations Utility Teradata QS Operations Menu Bar About the Teradata QS Configuration Parameters Changing Communications Parameters Changing Client Parameters Server Parameters Default Configuration Parameters Changing General Communication Information Changing Default Server Information Enabling Scheduling of Rejected Teradata SQL Assistant Queries Setting a Response Timeout Enabling and Disabling Tracing Managing the Teradata QS Server Configuring the Teradata QS Server Internet Services Supporting Results Files Defining the Teradata QS Database Logon Parameters Changing Server Configurations Starting the Teradata QS Server Stopping the Teradata QS Server Viewing Component Information Viewing Communications Information Viewing Server Information Scheduled Requests Information Managing Teradata QS Error Log Files Viewing Error Log Files Teradata Query Scheduler User Guide 9

10 Table of Contents Saving Error Log Files Deleting Error Log Files Appendix A: About the User Interfaces Teradata Query Scheduler Connect Dialog Box Viewer Settings Dialog Box SQL Text Dialog Box Appendix B: About the Teradata Query Scheduler Operations Interfaces 97 Communications Information Dialog Box Parameters Tab Connections Tab Client Processes Tab Statistics Tab Server Information Dialog Box General Tab Connections Tab Processes Tab Statistics Tab Scheduled Requests Information Dialog Box General Tab Scheduled Requests Tab Scheduled Jobs Tab Executing Jobs Tab Execution Time Frames Tab Workgroups Tab File Storage Locations Tab Profiles Tab More Profile Information Dialog Box Requests Scheduling Info Dialog Box Teradata Query Scheduler User Guide

11 Table of Contents Appendix C: About Error Log Files Error Log Files Component Identifiers Status Codes General Status Codes Communications Status Codes Server Vote Status Codes Server Rule Status Codes Server Exception Codes Scheduler Status Codes Glossary Index Teradata Query Scheduler User Guide 11

12 Table of Contents 12 Teradata Query Scheduler User Guide

13 List of Figures Figure 1: Teradata QS Client/Server Architecture Figure 2: Teradata Query Scheduler Connect Dialog Box Figure 3: Teradata Query Scheduler Viewer Figure 4: Teradata Query Scheduler Viewer Menu Bar Figure 5: Teradata QS Viewer Toolbar Figure 6: Teradata Query Scheduler Viewer Jobs List Figure 7: Teradata Query Scheduler Viewer Shortcut Menu Figure 8: Teradata Query Scheduler Viewer Status Bar Figure 9: About Teradata Query Scheduler Viewer Figure 10: Viewer Settings Dialog Box Figure 11: SQL Text Dialog Box Figure 12: Teradata Query Scheduler Submit Request Dialog Box Figure 13: SQL Tab: Teradata Query Scheduler Submit Request Dialog Box Figure 14: Scheduling Tab: Teradata Query Scheduler Submit Request Dialog Box Figure 15: Results Tab: Teradata Query Scheduler Submit Request Dialog Box Figure 16: Query Scheduler Request Submitted Message Box Figure 17: Teradata Query Scheduler Viewer Figure 18: Teradata Query Scheduler View/Modify Request Dialog Box Figure 19: Teradata Query Scheduler View/Modify Request Dialog Box Figure 20: Teradata Query Scheduler Operations Menu Bar Figure 21: About Teradata Query Scheduler Operations Message Box Figure 22: Communications Parameters Dialog Box Figure 23: Communications Parameters Dialog Box Figure 24: Client Parameters Dialog Box Figure 25: Client Parameters Dialog Box Figure 26: Trace Activity to Files Dialog Box Figure 27: Server Parameters Dialog Box Figure 28: Server Parameters Dialog Box Figure 29: Communications Information Dialog Box Figure 30: Server Information Dialog Box Figure 31: Scheduled Requests Information Dialog Box Figure 32: Sample Error Log File Teradata Query Scheduler User Guide 13

14 List of Figures Figure 33: Delete Error Log Files Dialog Box Figure 34: Teradata Query Scheduler Connect Dialog Box Figure 35: Viewer Settings Dialog Box Figure 36: SQL Text Dialog Box Figure 37: Communications Information Dialog Box Figure 38: Connections Tab: Communications Information Dialog Box Figure 39: Client Processes Tab: Communications Information Dialog Box Figure 40: Statistics Tab: Communication Information Dialog Box Figure 41: Server Information Dialog Box Figure 42: Connections Tab: Server Information Dialog Box Figure 43: Processes Tab: Server Information Figure 44: Statistics Tab: Server Information Dialog Box Figure 45: Scheduled Requests Information Dialog Box Figure 46: Scheduled Requests Tab: Scheduled Requests Information Dialog Box Figure 47: Scheduled Jobs Tab: Scheduled Requests Information Dialog Box Figure 48: Executing Jobs Tab: Scheduled Requests Information Dialog Box Figure 49: Execution Time Frames Tab: Scheduled Requests Information Dialog Box Figure 50: Workgroups Tab: Scheduled Requests Information Dialog Box Figure 51: File Storage Locations Tab: Scheduled Requests Information Dialog Box Figure 52: Profiles Tab: Scheduled Requests Information Dialog Box Figure 53: More Profile Information Dialog Box Figure 54: Requests Scheduling Info Dialog Box Figure 55: Sample Teradata QS Error Log File Teradata Query Scheduler User Guide

15 List of Tables Table 1: Teradata Query Scheduler Viewer Field/Control Descriptions Table 2: Command Menu Commands Table 3: Options Menu Commands Table 4: View Menu Commands Table 5: Help Menu Commands: Teradata Query Scheduler Administrator Table 6: Teradata Query Scheduler Viewer Toolbar Icons Table 7: Teradata Query Scheduler Viewer Jobs List Table 8: Status Bar Fields Table 9: Request Tab: Teradata Query Scheduler Submit Request Dialog Box Table 10: SQL Tab: Teradata Query Scheduler Submit Request Dialog Box Table 11: Scheduling Tab: Teradata Query Scheduler Submit Request Dialog Box Table 12: Results Tab: Teradata Query Scheduler Submit Request Dialog Box Table 13: Teradata Query Scheduler Viewer: Jobs List Column Descriptions Table 14: Teradata Query Scheduler Operations Menus Table 15: File Menu Command: Teradata Query Scheduler Operations Table 16: Configuration Menu Commands: Teradata Query Scheduler Operations Table 17: Server Menu Commands: Teradata Query Scheduler Operations Table 18: Information Menu Commands: Teradata Query Scheduler Operations Table 19: Error Log Menu Commands: Teradata Query Scheduler Operations Table 20: Teradata QS Configuration Parameters Table 21: Communications Parameters Dialog Box: Field Descriptions Table 22: Server Parameters Dialog Box: Field/Control Descriptions Table 23: Server Parameters Dialog Box: Field/Control Descriptions Table 24: Teradata Query Scheduler Connect Dialog Box: Field/Control Descriptions Table 25: Viewer Settings Dialog Box: Option Descriptions Table 26: SQL Text Dialog Box: Option Descriptions Table 27: Communications Information Dialog Box Table 28: Parameters Tab: Communications Information Dialog Box Table 29: Connections Tab: Communications Information Dialog Box Table 30: Client Processes Tab: Communications Information Dialog Box Table 31: Statistics Tab: Communications Information Dialog Box Table 32: Server Information Dialog Box Teradata Query Scheduler User Guide 15

16 List of Tables Table 33: General Tab: Server Information Dialog Box Table 34: Connections Tab: Server Information Dialog Box Table 35: Processes Tab: Server Information Dialog Box Table 36: Statistics Tab: Server Information Dialog Box Table 37: Scheduled Requests Information Dialog Box Table 38: General Tab: Scheduled Requests Information Dialog Box Table 39: Scheduled Requests Tab: Scheduled Requests Information Dialog Box Table 40: Scheduled Jobs Tab: Scheduled Requests Information Dialog Box Table 41: Executing Jobs Tab: Scheduled Requests Information Dialog Box Table 42: Execution Time Frames Tab: Scheduled Requests Information Dialog Box Table 43: Workgroups Tab: Scheduled Requests Information Dialog Box Table 44: File Storage Locations Tab: Scheduled Requests Information Dialog Box Table 45: Profiles Tab: Scheduled Requests Information Dialog Box Table 46: More Profile Information Dialog Box Table 47: Requests Scheduling Info Dialog Box Table 48: Teradata QS Log Entries Table 49: Teradata QS Log Component Identifiers Table 50: Teradata QS Status Codes General Status Descriptions Table 51: Teradata QS Status Codes Communications Status Descriptions Table 52: Teradata QS Status Codes Server Vote Status Descriptions Table 53: Teradata QS Status Codes Server Rule Status Descriptions Table 54: Teradata QS Status Codes Server Exception Status Descriptions Table 55: Teradata QS Status Codes Scheduler Status Descriptions Teradata Query Scheduler User Guide

17 CHAPTER 1 What is Teradata QS? Before you start using Teradata Query Scheduler (Teradata QS), you might find it helpful to read through a product overview. Browse through these topics to learn more: About the Teradata QS Architecture What Does Teradata QS Do? What Are Scheduled Requests? How Are Scheduled Requests Processed? What Can I Do with Teradata QS? About the Teradata QS Architecture Teradata QS was designed to dynamically manage request input to your Teradata Database and keep the database running at optimum performance levels. Teradata QS consists of client and server system components, and a separate database within your Teradata Database called tdwm. Teradata Query Scheduler User Guide 17

18 Chapter 1: What is Teradata QS? About the Teradata QS Architecture Figure 1: Teradata QS Client/Server Architecture Teradata QS Client systems SQL Assistant Teradata QS Viewer Teradata QS Server system(s) Teradata QS Submit Dialog Library Teradata QS Client Library Teradata QS Communications Library Teradata QS Communications Library Teradata QS Scheduler/Dispatcher Teradata QS Server Processes Teradata QS Executor Program (runs on the primary server only) User Database(s) Teradata QS Database (tdwm) Teradata Database System 2496B003 Teradata QS Client Components The client component includes: Teradata Query Scheduler Viewer Teradata Query Scheduler Submit dialog box Teradata Query Scheduler Operations utility Teradata QS client library Teradata QS communications library You use the Teradata Query Scheduler Submit Request dialog box to submit single or multiple SQL statement requests for execution at a later date and time. You also use the Teradata Query Scheduler Viewer to manage the request results. This user guide explains how to schedule and monitor SQL requests using Teradata QS. Your DBA uses the Teradata Query Scheduler Operations utility to manage both the Teradata QS client and Teradata QS server software programs. Your DBA must use the Teradata Query Scheduler Operations tool to configure and start the Teradata QS server before you can schedule SQL requests. For information on managing the Teradata QS server, see Managing the Teradata QS Server on page 78. The Teradata QS client library has the API for the Teradata Query Scheduler Viewer. The Teradata QS communications library handles socket communication with the Teradata QS server. 18 Teradata Query Scheduler User Guide

19 Chapter 1: What is Teradata QS? What Does Teradata QS Do? Teradata QS Server Components The server component includes: Teradata QS scheduler/dispatcher Teradata QS executor program Teradata QS request processors Teradata QS communications library The Teradata QS server components save, process, and execute Teradata QS client requests that have been scheduled. Teradata QS Administrator Components The administrator components include: Teradata Query Scheduler Administrator Teradata Query Scheduler Setup utility Your DBA uses the Teradata Query Scheduler Administrator to enable the scheduled request feature, set up user profiles, and setup time frames in which schedule requests are executed by Teradata QS. Your DBA also runs Teradata Query Scheduler Setup to migrate earlier versions of the Teradata QS database to the new version called tdwm. Scheduled request information is stored by Teradata QS in tdwm. To learn about the Teradata Query Scheduler Administrator and Teradata Query Scheduler Setup utility, see Teradata Query Scheduler Administrator Guide. Note: The tdwm database is shared by Teradata DWM (Teradata Dynamic Workload Manager). However, Teradata QS maintains its own tables within the tdwm database. Your DBA previously used the Administrator components of prior versions of Teradata QS (Teradata DQM) to create and manage Teradata Database rules. This function has been moved to Teradata DWM. Using the Teradata DWM, your DBA can set up rules that manage database access, increase database efficiency, and enhance workload capacity. To find out about the Teradata DWM, see Teradata Dynamic Workload Manager User Guide. What Does Teradata QS Do? Teradata QS provides a database request scheduling service. Queries can be scheduled through client applications such as the Scheduled Request Viewer and Teradata SQL Assistant. The Teradata QS Server is a back end process that accepts new requests, executes scheduled requests at specified times, and returns request information and status to the clients. Teradata Query Scheduler User Guide 19

20 Chapter 1: What is Teradata QS? What Are Scheduled Requests? What Are Scheduled Requests? Scheduled requests are SQL queries submitted to a Teradata Database that become scheduled for off-line execution. You can schedule requests in two ways: Using the Teradata Query Scheduler Submit Request dialog box Using Teradata SQL Assistant When you know of existing database rules that will prevent your SQL request from running or if you suspect that your queries will overload your database, you can proactively schedule your request using the Teradata Query Scheduler Submit Request dialog box. When you schedule a request, you provide information that defines preferences for when it is executed. You can schedule a request to run periodically or only once during a specified time period without an active user connection to the Teradata Database. Because a scheduled request can actually be executed many times, the term request is used to mean the actual definition of the scheduled request parameters. The term job is used to mean an individual instance a scheduled request is scheduled to run. For example, you define a scheduled request to execute daily. That request causes a separate job to be created every day to execute that request. Your DBA can enable or disable the Teradata QS features of your Teradata Database using the Teradata QS Administrator. For details, see Teradata Query Scheduler Administrator Guide. To learn about how to schedule a request, see Chapter 4: Scheduling Requests. How Are Scheduled Requests Processed? Teradata QS accepts single- or multiple-statement query requests for execution at a later time. However, scheduling a request does not guarantee that it is executed at the date and time you specify. Your scheduled requests are subject to the same Teradata Database workload management rule checking as are interactive requests. In addition, an execution time frame must be available during the time you specified to execute the request. To learn more about execution time frames, see Execution Time Frames on page 21. Scheduled requests are subject to three phases of processing: Request Checking Job Dispatching Job Execution 20 Teradata Query Scheduler User Guide

21 Chapter 1: What is Teradata QS? How Are Scheduled Requests Processed? Execution Time Frames Request Checking Job Dispatching Job Execution Your DBA controls when scheduled requests are executed. Using the Teradata Query Scheduler Administrator, your DBA specifies one or more execution time frames, or time periods, in which scheduled requests are executed by the Teradata QS server. Your DBA must specify active execution time frames. If execution time frames are not defined or enabled, scheduled requests are not executed by Teradata QS. When you submit a scheduled request, Teradata QS server does the following: Uses the scheduling information you provide as the intended start time for the request. Because a request may not be run until some time after the requested start time, you must also specify a time interval in which the request may be run. Checks for an available execution time frame during the specified time period. If no execution time frames are available, the request is rejected. Schedules the first job for the request. Unique IDs are generated for the request and its first job. After the first job is scheduled, the Teradata QS server does the following: Monitors the job to determine when it can be run. Dispatches the Teradata QS job execution program to run the job. The Teradata QS job dispatcher is aware of established execution time frames that dictate when the job can be executed. It is also aware of how many job executors are allowed to run simultaneously. Teradata QS server follows these steps when attempting to run a scheduled request job: Retrieves information about the request from the Teradata QS database. Logs on to the database as the user, with an optional account name. If a results table/file was specified and the results table/file currently exists, the job fails unless the user specified that the results could be deleted. Runs the request. Reschedules the job for at least 15 minutes later if a Teradata Database workload management restriction is encountered. If a Teradata Database workload management restriction will cause the job to fail, the job is rescheduled to run at a time when the restriction is not in effect. When a job needs to be rescheduled, an updated execution time is computed. If the updated time exceeds the start interval for the job, the status of the job is marked as restricted because it will not be completed within its execution time frame. Teradata Query Scheduler User Guide 21

22 Chapter 1: What is Teradata QS? What Can I Do with Teradata QS? If a results table/file was specified, the last statement of the scheduled request is first run in prepare mode to obtain the column types and names of the result data. If necessary, the result table/file is recreated with those column types, and the last statement (which must be a SELECT statement) is run. Then the result data is written to the results table/file. What Can I Do with Teradata QS? The Teradata QS client component has two main Windows-based GUIs (graphical user interface): Teradata Query Scheduler Submit Request Dialog Box Teradata Query Scheduler Viewer You use the Teradata Query Scheduler Submit Request dialog box to set up and schedule your request. After you submit your request, you can disconnect from the Teradata Database. After the request has been submitted by Teradata QS and executed, you can retrieve the results at any time using the Teradata Query Scheduler Viewer. Teradata Query Scheduler Submit Request Dialog Box The Teradata Query Scheduler Submit Request dialog box has controls you use to: Specify when you want Teradata QS to execute your scheduled request. Specify single or multiple statement SQL requests. Specify where the results sets of a scheduled request is saved. You can use the Teradata Query Scheduler Submit Request dialog box to view or modify the properties of an existing scheduled request: In the view mode, the fields are read-only and you cannot modify them. In the modify mode, you can change any of the properties and submit another request. See Scheduling a SQL Request on page 44 to learn how to use this dialog box. For detailed descriptions of the controls in these interfaces, see Appendix A: About the User Interfaces. Teradata Query Scheduler Viewer Using the Teradata Query Scheduler Viewer you can: View the status of jobs. Submit new requests. Create a new request by modifying the attributes of existing requests. Cancel the scheduled execution of selected jobs. Delete a job and the scheduled request will still be available in the system if you scheduled it to run daily, weekly, or monthly. Delete requests so all jobs associated with that request are also deleted. Drop the results table or file associated with selected requests. 22 Teradata Query Scheduler User Guide

23 Chapter 1: What is Teradata QS? What Can I Do with Teradata QS? Retrieve job results data using Teradata SQL Assistant. Clean up (drop) results tables and files. To find out how to use this application, see Chapter 5: Working with Scheduled Requests. For detailed descriptions of the controls in these interfaces, see Appendix A: About the User Interfaces. Teradata Query Scheduler User Guide 23

24 Chapter 1: What is Teradata QS? What Can I Do with Teradata QS? 24 Teradata Query Scheduler User Guide

25 CHAPTER 2 Before You Begin Before you start using Teradata Query Scheduler (Teradata QS), you need to make sure your system is set up correctly. You may also need to know how to specify a default Teradata QS server and international character sets. Browse through the following topics to learn more: System Requirements/Prerequisites Specifying a Default Teradata QS Server Working with Character Sets Running the Teradata QS Viewer or SQL Assistant on Windows Server 2003 You might want to look over the Teradata QS GUIs and get familiar with the available features. See Navigating the Teradata Query Scheduler Viewer on page 32 and Appendix A: About the User Interfaces for details. System Requirements/Prerequisites Teradata QS has the following requirements and prerequisites: Supported Client Operating Systems Required Client Software Optional Client Software Supported Client Operating Systems Required Client Software Teradata QS client/server architecture can run on these operating systems: Client components running on Microsoft Windows 2000, 2003, or XP Server components running on Windows 2000, 2003, or XP Teradata QS Administrator running Windows 2000, 2003, or XP The client components for this release of Teradata QS are not compatible with those of earlier releases of Teradata Query Scheduler (TQS 6.0), Teradata Dynamic Query Manager (TDQM) or Database Query Manager (DBQM). You must have the following software installed on your client system: TCP/IP driver with WinSock support for Windows version 1.1 or later Ethernet or Token Ring packet driver compatible with the above Teradata Query Scheduler User Guide 25

26 Chapter 2: Before You Begin Specifying a Default Teradata QS Server Optional Client Software Teradata GSS (Generic Security Services) 12.0 Teradata CLIv2 (Call-Level Interface version 2) release 12.0 tdicu (Shared Common Components for Internationalization for Teradata) for TTU 12.0 You may also want to have the following software installed on your client system: Teradata ODBC Driver for Windows Install the Teradata ODBC driver for Windows if you want to use Teradata SQL Assistant. Teradata SQL Assistant Install Teradata SQL Assistant for scheduling requests rejected due to Teradata Dynamic Workload Manager rules and for retrieving job results. See Retrieving Results from a Database Table on page 62 to find out how Teradata SQL Assistant handles job results. See Choosing a SQL Assistant Export Setting on page 41, to learn how to set up that feature. For detailed installation information, see Teradata Tools and Utilities Installation Guide for Microsoft Windows. Database Requirements Prior to running Teradata Query Scheduler 12.0, be sure to run Teradata Manager Database Setup for Teradata Tools and Utilities Database Setup installs important updates to the tdwm database. Specifying a Default Teradata QS Server Usually the Query Scheduler Viewer temporarily establishes a Teradata Database session using CLIv2 (Call-Level Interface version 2) to validate the logon parameters and find the location of an active Teradata QS server. However, if CLIv2 cannot establish a session or if you have an application that accesses the Teradata QS client library functions directly, you can configure a default Teradata QS server location. Then you can use the Teradata QS client library functions. See Changing Default Server Information on page 75 for instructions. After you have configured a default Teradata QS server, you can begin using the Teradata Query Scheduler Viewer or the Teradata Query Scheduler Operations utility. If you will be working with various character sets, continue with Working with Character Sets on page 27. To learn how to start using the Teradata Query Scheduler Operations utility, go to Chapter 6: Working with the Teradata Query Scheduler Operations Utility. See Chapter 3: Getting Started, to find out more about the Teradata Query Scheduler Viewer. 26 Teradata Query Scheduler User Guide

27 Chapter 2: Before You Begin Working with Character Sets Working with Character Sets Internally, Teradata QS stores scheduled request text in Unicode. The Teradata QS Server executes scheduled requests in the session character set specified in the Teradata Query Scheduler Submit Request dialog box. Running the Teradata QS Viewer or SQL Assistant on Windows Server 2003 The security settings on Window Server 2003 (and XP SP2) may prevent non-administrative users from running the Scheduled Requests Vieweror SQL Assistant (which optionally invokes Scheduled Requests functions). To allow a normal user to run the Viewer or SQL Assistant, enable the Create Global Objects privilege for that user. The following steps explain how. Enabling the Create Global Objects privilege 1 Run Windows Local Security Policy tool. Go to Start> Administrative Tools > Local Security Policy). 2 In the directory view, expand Security Settings> Local Policies> User Rights Assignment. 3 In the list of policy items, right-click Create global objects and select Properties, and add the user by clicking the Add User or Group button. 4 Click Ok to save settings. Teradata Query Scheduler User Guide 27

28 Chapter 2: Before You Begin Running the Teradata QS Viewer or SQL Assistant on Windows Server Teradata Query Scheduler User Guide

29 CHAPTER 3 Getting Started After you verify that your system is set up correctly and you have configured your system, you are ready to use Teradata Query Scheduler (Teradata QS). Continue with these topics to learn how: Opening the Teradata Query Scheduler Viewer Disconnecting from a Teradata QS Server and Exiting Teradata QS Navigating the Teradata Query Scheduler Viewer Customizing the Teradata Query Scheduler Viewer Before you can use Teradata QS to schedule and manage SQL requests, your DBA must configure and start the Teradata QS server. See Chapter 6: Working with the Teradata Query Scheduler Operations Utility for instructions. Opening the Teradata Query Scheduler Viewer This section explains how to start the Teradata Query Scheduler Viewer before connecting to a Teradata QS server. The following procedure assumes you have installed Teradata QS. To start the Teradata Query Scheduler Viewer Click Start>Programs>Teradata Query Scheduler Utilities>Scheduler Viewer. Continue with the next step, Connecting to a Teradata QS Server on page 29. Connecting to a Teradata QS Server Before you can schedule SQL requests using the Teradata Query Scheduler Viewer, you must connect to a Teradata QS server. To connect to a Teradata QS server 1 Click Command>Connect. OR Click. Teradata Query Scheduler User Guide 29

30 Chapter 3: Getting Started Opening the Teradata Query Scheduler Viewer The Teradata Query Scheduler Connect dialog box appears prompting you to connect to a Teradata QS server. Figure 2: Teradata Query Scheduler Connect Dialog Box 2 Complete the options of the Teradata Query Scheduler Connect dialog box as follows: Control/Field Database Name User Name Password Default Database Account String Mechanism Parameter Server Description Enter the name of the Teradata Database you want to use to schedule your SQL requests. Enter your user name associated with the Teradata Database you entered in the Database Name box. Enter the password associated with the user name you entered in the User Name box. (Optional) Usually, your DBA sets up a default database associated with your user name and password. However, you can enter the name of another database that you want to use as the default database in this box. (Optional) Usually, your DBA sets up a logon account string associated with your user name and password. However, you can enter a different account string if you do not want to use the default. Select the appropriate authentication mechanism (for example, TD2) in this list box. The default is blank, representing the standard Teradata (TD2) mechanism. Type the authentication string you must as a parameter for the authentication mechanism specified. If the specified mechanism does not require this string, leave the field empty. Displays the name of the Teradata QS server 3 Click OK. 30 Teradata Query Scheduler User Guide

31 Chapter 3: Getting Started Disconnecting from a Teradata QS Server and Exiting Teradata QS Teradata QS validates the Teradata Database logon parameters and attempts to obtain information about active Teradata QS servers using a CLIv2 connection. If an active server is found, a connection is established. If a CLIv2 error occurs, a Teradata QS attempts to establish a connection using the Teradata QS server name configured with the Teradata QS Operations tool. See Managing the Teradata QS Server on page 78 for details on configuring the Teradata QS server. If this is unsuccessful, the Server box becomes available. Continue with step 4. 4 (Optional) Enter the name or IP address of the system the Teradata QS server is running on in the Server box. The parameters are validated and the Teradata Query Scheduler Viewer opens. If the Teradata QS server has not been started, the following message appears: When you have successfully opened the Teradata Query Scheduler Viewer and connected to a Teradata QS server, you are ready to use it. See Chapter 4: Scheduling Requests to learn about scheduling SQL requests. See Navigating the Teradata Query Scheduler Viewer on page 32 to find out about the GUI. To find out how to set up the Teradata Query Scheduler Viewer, go to Customizing the Teradata Query Scheduler Viewer on page 40. At any time you can disconnect and then reconnect as the same user or a different user. Continue with Disconnecting from a Teradata QS Server and Exiting Teradata QS on page 31 to learn how to disconnect. Disconnecting from a Teradata QS Server and Exiting Teradata QS You can disconnect from a Teradata QS server at any time and close the Teradata Query Scheduler Viewer. To disconnect from a Teradata QS Server 1 Click Command>Disconnect. OR Click. Teradata Query Scheduler User Guide 31

32 Chapter 3: Getting Started Navigating the Teradata Query Scheduler Viewer This clears the Teradata Query Scheduler Viewer and prevents any further actions until you connect again. A Teradata QS Viewer dialog box appears. 2 Click Yes to confirm you want to disconnect. 3 Click Command>Exit to close the Teradata Query Scheduler Viewer. You have successfully disconnected from the Teradata QS server and closed the Teradata QS Viewer. Navigating the Teradata Query Scheduler Viewer Before you start using the Teradata Query Scheduler Viewer, you might want to familiarize yourself with its available features. Continue with these topics to find out more: Using the Menu Bar on page 34 Exploring the Toolbar on page 35 Using the Jobs List on page 37 Reading the Status Bar on page 39 Viewing Copyright and Version Information on page 39 To start using the Teradata QS Viewer, see Chapter 5: Working with Scheduled Requests. To learn about the other Teradata QS windows and dialog boxes and their available features, see Appendix A: About the User Interfaces for details. 32 Teradata Query Scheduler User Guide

33 Chapter 3: Getting Started Navigating the Teradata Query Scheduler Viewer Figure 3: Teradata Query Scheduler Viewer The following table introduces you to the Teradata Query Scheduler Viewer fields and controls: Table 1: Teradata Query Scheduler Viewer Field/Control Descriptions Field/Control Menu bar Toolbar Jobs list Description You find the menu bar immediately below the title bar of the Teradata Query Scheduler Viewer. Using the menu bar, you can access all of the Teradata Query Scheduler Viewer functions. The menu bar has these items: Command Options View Help To learn about the available commands, see Using the Menu Bar on page 34. Below the menu bar is an icon tool bar. Click these icons to access the more commonly used Teradata QS features. To learn more, see Exploring the Toolbar on page 35. The Jobs list is a table showing your scheduled requests and jobs. It is located below the tool bar and has a scroll bar you can use to scroll through items in the list. See Using the Jobs List on page 37 to find out more. Status bar To find out more, see Reading the Status Bar on page 39. Teradata Query Scheduler User Guide 33

34 Chapter 3: Getting Started Navigating the Teradata Query Scheduler Viewer Using the Menu Bar The menu bar in the Teradata Query Scheduler Viewer gives you access to all of the functions and features in Teradata QS. You can use your mouse or keyboard to select the commands in these menus: Command Menu Options Menu View Menu Help Menu Figure 4: Teradata Query Scheduler Viewer Menu Bar Command Menu The following table describes the commands and submenus of the Command menu: Table 2: Command Menu Commands Command Connect Disconnect Schedule SQL Exit Description Opens a session with the Teradata QS server. Closes a session with the Teradata QS server. Opens the SQL Text dialog box to input SQL statements for scheduling. Closes the Teradata QS application. Options Menu The following table describes the commands and submenus of the Options menu: Table 3: Options Menu Commands Command Cancel Job Drop Results Delete Job Delete Request Request Properties Retrieve Result Data Description Terminates a job with a Waiting status that selected from the Jobs list. Eliminates the results table or file for the job or request selected from the Jobs list. Removes the job selected from the Jobs list. Removes the request selected from the Jobs list and all the related jobs. Shows the properties of the job selected from the Jobs list. Get the results of a job with a Completed status selected from the Jobs list. 34 Teradata Query Scheduler User Guide

35 Chapter 3: Getting Started Navigating the Teradata Query Scheduler Viewer Table 3: Options Menu Commands (continued) Command Job Information Description Shows the all of the data concerning how a job completed, such as rows returned, processing time, and more. View Menu The following table describes the commands and submenus of the View menu: Table 4: View Menu Commands Command Toolbar Status Bar Font Refresh Settings Description Shows or hides the Teradata Query Scheduler Viewer tool bar. Shows or hides the Teradata Query Scheduler Viewer status bar. Displays the Font dialog box to select a font for displaying the list of scheduled requests and the request SQL Immediately updates the information in the Jobs list. Click to set up the frequency at which the Jobs list is automatically updated in the Query Scheduler Viewer Settings dialog box. Help Menu The Help menu has commands that provide access to Teradata Query Scheduler Viewer online help and information about the version of the software installed on your computer. The following table lists the commands and submenus of the Help menu: Table 5: Help Menu Commands: Teradata Query Scheduler Administrator Command Help Topics About Teradata Query Scheduler Viewer Description Opens the contents tab of the online Help to locate a topic by category. Opens the About Teradata Query Scheduler Viewer message box showing copyright and version information. See Viewing Copyright and Version Information on page 39 to learn how. Exploring the Toolbar The Teradata Query Scheduler Viewer tool bar has icons to access the more commonly used Teradata QS features. When you first open the Teradata Query Scheduler Viewer, only a few of the icons in the tool bar are available. Toolbar icons appear gray when you cannot use the related function. Figure 5: Teradata QS Viewer Toolbar Teradata Query Scheduler User Guide 35

36 Chapter 3: Getting Started Navigating the Teradata Query Scheduler Viewer The following table describes the features available from the Teradata Query Scheduler Viewer tool bar: Table 6: Teradata Query Scheduler Viewer Toolbar Icons Use this icon To Connect to the Teradata QS server. Disconnect from the Teradata QS server Open the SQL Text dialog box so you can input SQL statements for scheduling. Cancel a job with a Waiting status that you select from the Jobs list. Delete the job you select from the Jobs list. See the properties of the job you select from the Jobs list Retrieve the results of a job with a Completed status that you select from the Jobs list. Shows job information for a job completed, such as rows returned, processing time, and more. Immediately update the information in the Jobs list. Open the About Teradata Query Scheduler Viewer dialog box to view product version and copyright information. Displaying the Toolbar You can show or hide the Teradata Query Scheduler Viewer tool bar by toggling it on or off. By default, the tool bar appears in the Teradata Query Scheduler Viewer. To view or hide the Teradata Query Scheduler Viewer tool bar Go to the View menu, and choose Toolbar. 36 Teradata Query Scheduler User Guide

37 Chapter 3: Getting Started Navigating the Teradata Query Scheduler Viewer Using the Jobs List The Teradata Query Scheduler Viewer Jobs list appears below the column headers. It shows each of your scheduled job currently being handled by Teradata QS. The list has a scroll bar you can use to scroll through items in the list. Select a job or request in the list, and then use the menu commands, shortcut menu commands, or the tool bar icon to monitor and manage it. Figure 6: Teradata Query Scheduler Viewer Jobs List The following table describes the Teradata Query Scheduler Viewer Jobs list: Table 7: Teradata Query Scheduler Viewer Jobs List Column Name Request Name Req ID Job ID Schedule Max. Start Time Status Information Description The name you assigned to the job when you submitted it using the Teradata Query Scheduler Submit dialog box. Generated by Teradata QS to uniquely identify the request. Generated by Teradata QS to uniquely identify the job. Current time the job is scheduled to run. Latest time the job is allowed to execute. Current standing of the job. For successful jobs, details about how the job completed, such as rows returned and the processing time. For unsuccessful jobs, details of database or other errors. Teradata Query Scheduler User Guide 37

38 Chapter 3: Getting Started Navigating the Teradata Query Scheduler Viewer Sorting the Jobs List You can sort the information in the Jobs list using any of the column headers. To sort the Jobs list Click any one of the column headers. The requests are sorted in ascending order. Using the Shortcut Menu When you right-click any request in the Jobs list of the Teradata Query Scheduler Viewer, a shortcut menu with applicable commands appears. Figure 7: Teradata Query Scheduler Viewer Shortcut Menu 38 Teradata Query Scheduler User Guide

39 Chapter 3: Getting Started Navigating the Teradata Query Scheduler Viewer Reading the Status Bar The status bar at the bottom of the Teradata Query Scheduler Viewer has five fields showing the following information: Table 8: Status Bar Fields Field Status Requests Jobs Time frame Database Description Status of the Teradata Query Scheduler Viewer or an explanation of the currently selected menu item. The number of scheduled requests you have in the system. The number of scheduled jobs. The current or next Scheduled Request execution time frame. Your DBA sets Scheduled Requests execution time frames using the Teradata QS Administrator. The current database date and time Figure 8: Teradata Query Scheduler Viewer Status Bar Displaying the Status Bar You can show or hide the Teradata Query Scheduler Viewer status bar by toggling it on or off. By default, the status bar appears in the Teradata Query Scheduler Viewer. To show or hide the Teradata Query Scheduler Viewer status bar Go to the View menu, and choose Status Bar. Viewing Copyright and Version Information When you want to know what version of Teradata QS you are using, you can open the About Teradata Query Scheduler Viewer message box to find out. To see copyright and version information from the Teradata Query Scheduler Viewer 1 Click Help>About Teradata Query Scheduler Viewer. OR Click. Teradata Query Scheduler User Guide 39

40 Chapter 3: Getting Started Customizing the Teradata Query Scheduler Viewer The About Teradata Query Scheduler Viewer message appears showing the product version and copyright dates. Figure 9: About Teradata Query Scheduler Viewer 2 Read the information, and then click OK to close the message box. Now that you have customized the Teradata Query Scheduler Viewer, you are ready to submit and work with schedule requests. To find out about submitting a scheduled request, see Chapter 4: Scheduling Requests. Go to Chapter 5: Working with Scheduled Requests to learn about managing your scheduled requests and results. Customizing the Teradata Query Scheduler Viewer Setting the Refresh Rate Before you begin working with scheduled requests, jobs, and results, you can customize the following items in the Teradata Query Scheduler Viewer: Setting the Refresh Rate on page 40 Choosing a SQL Assistant Export Setting on page 41 You use the Settings command to open the Viewer Settings dialog box. You use the controls in that dialog box to set the refresh rate at which the Jobs list is updated from the Teradata QS server. Although refresh is a background process, it still adds to network traffic. You should set the rate as low as possible. 40 Teradata Query Scheduler User Guide

41 Chapter 3: Getting Started Customizing the Teradata Query Scheduler Viewer To set the Refresh rate 1 From the Teradata Query Scheduler Viewer, click View>Settings. The Viewer Settings dialog box appears. Figure 10: Viewer Settings Dialog Box 2 In the Refresh every minutes box, click an arrow to choose an interval between 5 and 99 minutes for the refresh rate. 3 Continue with Choosing a SQL Assistant Export Setting to set how Teradata SQL Assistant handles results retrieved from a Teradata Database table. Choosing a SQL Assistant Export Setting Using the Settings command opens the Viewer Settings dialog box containing the Export Results Tables check box. This check box lets you select how Teradata SQL Assistant handles results retrieved from a Teradata Database table. Selecting the Export Results Tables check box, causes Teradata SQL Assistant to export a results set and then terminate without showing the results in an Answer Set window. Note: To see how using the Export Results Tables check box affects how results are retrieved from a Teradata Database table, see Retrieving Results from a Database Table on page 62. To choose a SQL Assistant export setting 1 From the Teradata Query Scheduler Viewer, click View>Settings. The Viewer Settings dialog box appears. 2 Select the Export Results Tables check box. Teradata Query Scheduler User Guide 41

42 Chapter 3: Getting Started Customizing the Teradata Query Scheduler Viewer 3 Click OK to close the Viewer Settings dialog box, and return to the Teradata Query Scheduler Viewer. You have successfully set the refresh rate for the Jobs list and chosen a Teradata SQL Assistant export option. Now that you have customized the Teradata Query Scheduler Viewer, you are ready to submit and work with schedule requests. To find out about submitting a scheduled request, see Chapter 4: Scheduling Requests. Go to Chapter 5: Working with Scheduled Requests to learn about managing your scheduled requests and results. To get details about the controls in the Viewer Settings dialog box, see Viewer Settings Dialog Box on page Teradata Query Scheduler User Guide

43 CHAPTER 4 Scheduling Requests You submit SQL requests to a Query Scheduler (Teradata QS) server using the Teradata Query Scheduler Submit Request dialog box. You can open the dialog box from the Teradata Query Scheduler Viewer. The Teradata Query Scheduler Submit Request dialog box can also be set up to automatically open from Teradata SQL Assistant (previously known as Queryman). See Choosing a SQL Assistant Export Setting on page 41 to learn how. Read through these topics to find out how to schedule a request: Saving Result Data Scheduling a SQL Request Immediately Executing a Scheduled Request Scheduling Rejected Teradata SQL Assistant Queries Saving Result Data Most scheduled requests, especially automatically scheduled requests, are not self-contained; that is, they do not specify where to save the results data. You can have Teradata QS save the results for those types of requests. However, results from only the last statement in the scheduled request are saved. To do this, the last statement in your scheduled SQL request must be a SELECT statement, and you must specify a valid Teradata Database and table or a valid Teradata QS server file name in which to store the results. If the results table or file already exist when the scheduled request is run, one of the following events occurs: The job execution is aborted and the job is marked as failed. The results table is destroyed, if so specified. Then, the results table is recreated with the proper column types and the data from the last statement is stored. Which event occurs depends on your selections in the Results tab of the Teradata Query Scheduler Submit Request dialog box. To find out how to make these selections, see Scheduling a SQL Request on page 44, then go to step 8. Teradata Query Scheduler User Guide 43

44 Chapter 4: Scheduling Requests Scheduling a SQL Request Scheduling a SQL Request The scheduling information you provide is used by Teradata QS as the intended start time for the request. The Teradata QS server attempts to execute requests during the time period specified, but Teradata Database workload management rules determine if or when the scheduled request is executed. Because a request may not be run until some time after the requested start time, you must also specify a time interval in which the request may be run. Submitted requests are immediately rejected if an execution time frame is not available during the specified interval. To schedule a SQL request using the Teradata Query Scheduler Submit Request dialog box 1 Start Teradata QS and connect to a Teradata QS server. See Opening the Teradata Query Scheduler Viewer on page 29 to learn how. 2 Click Command>Schedule SQL OR Press. The SQL Text dialog box appears. Figure 11: SQL Text Dialog Box 3 Add the SQL statements to schedule in the edit area of the SQL Text dialog box using one of these methods: Type the SQL statement text. 44 Teradata Query Scheduler User Guide

45 Chapter 4: Scheduling Requests Scheduling a SQL Request Copy (Ctrl+C) the SQL statement from another tool and paste it using Ctrl+V or click Paste. Note: You cannot use scheduled requests to insert large object (LOB) data into a Teradata Database. However, you can schedule a SQL request that retrieves LOB data from a table, and save those results to a table or a file. 4 Click OK to save the statement and close the SQL Text dialog box. The Teradata Query Scheduler Submit Request dialog box appears with the Request tab selected by default. Figure 12: Teradata Query Scheduler Submit Request Dialog Box 5 Complete the following information in the Request tab: Table 9: Request Tab: Teradata Query Scheduler Submit Request Dialog Box Option User Name Account String Request Name Session Character Set Description (Read-only) Your Teradata Database logon name. This information is obtained from the Query Scheduler Viewer or Teradata SQL Assistant. (Read-only) Your Teradata Database account string This information is obtained from the Teradata QS Viewer or Teradata SQL Assistant. (Optional) Enter a user-defined name for the request. Select the Teradata session character set under which the scheduled request will execute. Teradata Query Scheduler User Guide 45

46 Chapter 4: Scheduling Requests Scheduling a SQL Request Table 9: Request Tab: Teradata Query Scheduler Submit Request Dialog Box (continued) Option address for notification on completion box Modify parameters to make a new request check box Description (Optional) address where you want to receive a notification message when a request job finishes execution. Field availability is based on the existence of a dbcmngr.alertrequest table on the Teradata Database. See Specifying Notifications on page 52 for more information. For information on installing and configuring the software to enable this feature, see the Teradata Query Scheduler Administrator Guide Enable the controls is this dialog box so that you can change the request parameters and submit a new request. This check box is not available for new requests. 6 Select the SQL tab, and then complete the following fields: Figure 13: SQL Tab: Teradata Query Scheduler Submit Request Dialog Box Table 10: SQL Tab: Teradata Query Scheduler Submit Request Dialog Box Use this field/control SQL box Estimates Rows and Time lists To Enter text for one or more SQL statements to be submitted to the Teradata QS server. Statements are delimited by semicolons. You create these statements directly in this box, using the SQL Text dialog box, or using Teradata SQL Assistant. (Read-only) The estimated time the request is expected to execute and the estimated number of rows generated by the last statement. These values are calculated by the Teradata QS server using the EXPLAIN statement run on the request. 46 Teradata Query Scheduler User Guide

47 Chapter 4: Scheduling Requests Scheduling a SQL Request Table 10: SQL Tab: Teradata Query Scheduler Submit Request Dialog Box (continued) Use this field/control Update button To Refresh the estimates associated with the scheduled request. This command is available only when you are editing the SQL text of a scheduled request. See Modifying a Scheduled Request on page Select the Scheduling tab, and then complete the following fields: Figure 14: Scheduling Tab: Teradata Query Scheduler Submit Request Dialog Box Teradata Query Scheduler User Guide 47

48 Chapter 4: Scheduling Requests Scheduling a SQL Request 48 Teradata Query Scheduler User Guide

49 Chapter 4: Scheduling Requests Scheduling a SQL Request Table 11: Scheduling Tab: Teradata Query Scheduler Submit Request Dialog Box Use this field/control Frequency frame Start Days frame To Choose the frequency at which you want the request to run using one of these options: Once Daily Weekly Monthly Option availability is based on your profile type. The default is Once; the scheduled SQL statement executes only one time. Enter the month, day, and year when you want the request to run using these text boxes in this frame. Selecting a different Frequency option changes these values. By default, this field is set to the first date when a scheduled request execution time frame is available as computed by the Teradata QS server. If you select the Once option, enter the month, day, and year when you the request to execute in the corresponding boxes. If you select the Daily option, the fields in the Start Days frame are not available. If you select the Weekly option, use the Days of the Week check boxes to select when you want the request to execute. If you select the Monthly option, enter the dates delimited by a comma in the Days of the Month box to select when you want the request to execute. Start Time frame Maximum Start Interval Days/ Hours boxes Enter the time when you want the request to run in the Hour (0-23) box and the Minute (0-59) boxes. The default values indicate the next time the Teradata QS server predicts the request can be executed. Enter the maximum interval beyond the start time that you want the job to be able begin to execute in the Day and Hours boxes. For new requests, the initial value is determined by the profile type. The default value is defined by the Teradata QS Administrator. 8 Select the Results tab, and then complete the following fields to specify where and how the results of the scheduled request are saved. Teradata Query Scheduler User Guide 49

50 Chapter 4: Scheduling Requests Scheduling a SQL Request Figure 15: Results Tab: Teradata Query Scheduler Submit Request Dialog Box Note: If no results are generated, the controls in the Results tab are not available. Field availability is based on your profile type. 50 Teradata Query Scheduler User Guide

51 Chapter 4: Scheduling Requests Scheduling a SQL Request Table 12: Results Tab: Teradata Query Scheduler Submit Request Dialog Box Use this field/control Save To options Database Name box Table/File Name box Options list Table Options check boxes Field Separator list Encoding list box Automatically cleaned up after list To Select where you want to store the results from the last statement of the query using one of these options: DB Table Server File The default value is defined from the Teradata Query Scheduler Administrator. Enter the Teradata Database name where you want to store the results from the last statement of the query. When results are saved to a database table, this field is initialized to a default database name defined from the Teradata Query Scheduler Administrator. The name of this text box depends on the Save To option you select. In the Table Name box, enter the name of the Teradata Database table where you want to store the results from the last statement of the query. In the File Name box, enter the name of the Teradata QS server file where you want to store the results from the last statement of the query. Choose how the results are handled when the database table already exists using one of these options: Append if exists: Appended to an existing table Drop if exists: Stored after dropping the existing table. This option is the default. Fail if exists: Not stored if scheduled request failed because the result table already exists. (Optional) If you choose to create a Teradata Database table, choose the type of table created: Fallback Multi-set Choose a character field separator for results saved to a file. The default value is defined using the Teradata Query Scheduler Administrator. The values are: Tab Space Semicolon Comma Bar Select the file encoding format (ANSI, UTF-8, or Unicode) for saving results. This is available only if you select Server File for the Save As option. (Read-only) See the number of days the results are saved before being automatically deleted by Teradata QS. This value is set using the Teradata Query Scheduler Administrator. It indicates the number of days a history of completed jobs and unupdated results are retained before being automatically deleted by Teradata QS. 9 Click OK to submit a request to the Teradata QS server. All of the parameters you enter are checked for validity. Teradata Query Scheduler User Guide 51

52 Chapter 4: Scheduling Requests Scheduling a SQL Request If the request is approved, a message box appears showing a Request ID and Job ID for the scheduled request. Figure 16: Query Scheduler Request Submitted Message Box 10 Read the information in the message box and click OK to close the it. You have successfully scheduled a SQL request. If the request is not approved, you can change the parameters and resubmit the request. See SQL Text Dialog Box on page 96 to find out more about using the SQL Text dialog box to create your SQL statements. Specifying Notifications After your DBA sets up the notifications, you can use this feature. An example of the e- mail text is included with the following procedure. To use notifications 1 Create a scheduled request. Note: For information on creating a scheduled request, see Scheduling a SQL Request on page In the Teradata Query Scheduler Submit Request dialog box, enter an address in the address for notification on completion text box and click Submit. The following is an example of an notification: Subject: Alert for Teradata QS Scheduled Request Executor Date: 2002/11/05 Time: 10:08:36 DBS: agassi Utility: Teradata QS Scheduled Request Executor Datapoint: Scheduled Job Completed Actual Value: 0 JobId for RequestId () - Status is Successful 52 Teradata Query Scheduler User Guide

53 Chapter 4: Scheduling Requests Immediately Executing a Scheduled Request Immediately Executing a Scheduled Request Using the Teradata Query Scheduler Administrator, your DBA can monitor and manipulate the scheduled requests job queue. By changing the state of a scheduled request job, your DBA can execute the job immediately or cancel the job. Scheduling Rejected Teradata SQL Assistant Queries You can use Teradata SQL Assistant (a Windows ODBC application) to submit SQL requests to a Teradata Database. When a Teradata SQL Assistant query is rejected by the Teradata Database because of Teradata Dynamic Workload Manager (DWM) rules (Teradata DWM statuses ), your BDA can make the Teradata Query Scheduler Submit Request dialog box available so that you can re-schedule the request. To learn how to set up this option, see Enabling Scheduling of Rejected Teradata SQL Assistant Queries on page 76. For more information about DWM rules, see Teradata Dynamic Workload Manager User Guide. To Set Up Automatic Scheduling You must complete the following steps for your query to automatically be scheduled using Teradata SQL Assistant: 1 Make sure the Teradata QS client software is installed on your system. 2 Use the Teradata QS Administrator to make sure the Scheduled Requests feature is enabled. 3 Make sure at least one Teradata QS server is running. 4 Make sure the request is not always restricted (24 hours a day, 7 days a week). 5 Use the Teradata QS Administrator to make sure you have a scheduled requests profile that allows scheduling. If the above steps have been taken, the Teradata Query Scheduler Submit Request dialog box will automatically open when a Teradata SQL Assistant request is rejected because of DWM rules. Teradata Query Scheduler User Guide 53

54 Chapter 4: Scheduling Requests Scheduling Rejected Teradata SQL Assistant Queries 54 Teradata Query Scheduler User Guide

55 CHAPTER 5 Working with Scheduled Requests Using the Teradata Query Scheduler Viewer, you can manage your scheduled requests and jobs. Read through these topics to learn how to work with your scheduled requests: Viewing Scheduled Requests Managing Scheduled Requests Managing Jobs Working with Job Results For details on the Teradata QS GUIs and the available features, see Appendix A: About the User Interfaces. Viewing Scheduled Requests To view your scheduled requests using the Teradata Query Scheduler Viewer Start the Teradata Query Scheduler Viewer and connect to a Teradata QS server. See Opening the Teradata Query Scheduler Viewer on page 29 to learn how. After you successfully connect to a Teradata QS server, your scheduled jobs are retrieved and they appear in the Teradata Query Scheduler Viewer. The Teradata Query Scheduler Viewer shows information only for the user currently logged on using the application. Note: The security settings on Window Server 2003 (and XP SP2) may prevent nonadministrative users from running the Scheduled Requests Viewer. See Running the Teradata QS Viewer or SQL Assistant on Windows Server 2003 on page 27 for more information on solving this problem. Teradata Query Scheduler User Guide 55

56 Chapter 5: Working with Scheduled Requests Viewing Scheduled Requests Figure 17: Teradata Query Scheduler Viewer You can view the following information for each of your scheduled jobs currently in the system: Table 13: Teradata Query Scheduler Viewer: Jobs List Column Descriptions Column Header Request Name Req ID Job ID Schedule Max. Start Time Status Information Description View the name entered when the request was scheduled. View a unique numeric ID generated by Teradata QS identifying a request. View a unique numeric ID generated by Teradata QS identifying a job. View the current scheduled run time. View the latest time the job can begin execution. View the current status of the job. View information on how the job was completed, such as database error, rows returned, and more. To get details about the controls in the Teradata Query Scheduler Viewer dialog box, see Navigating the Teradata Query Scheduler Viewer on page Teradata Query Scheduler User Guide

57 Chapter 5: Working with Scheduled Requests Managing Scheduled Requests Sorting the Job List Refreshing the Job List To sort the jobs in the Jobs list From the Teradata Query Scheduler Viewer, click any one of the column headers to sort the information in the Jobs list in ascending order by that heading. Using the Refresh command, you can immediately update the Jobs list with information from the Teradata QS server. To refresh the Jobs list From the Teradata Query Scheduler Viewer, click View>Refresh or click. Managing Scheduled Requests In addition to submitting new scheduled requests, use the Teradata Query Scheduler Viewer to do the following: Viewing Scheduled Request Properties on page 57 Modifying a Scheduled Request on page 58 Deleting a Scheduled Request on page 60 Viewing Scheduled Request Properties Using the Request Properties command you can open the Teradata Query Scheduler View/ Modify Request dialog box to see the properties for a request or job. Although the dialog box appears as read-only, you can select the Modify parameters to make a new request check box so you can edit the properties. To view scheduled request properties 1 From the Teradata Query Scheduler Viewer, select a job from the Jobs list. 2 Click Options>Request Properties. OR Right-click the job to display a shortcut menu and click Request Properties. OR Click. The Teradata Query Scheduler View/Modify Request dialog box appears as read-only with the Request tab selected by default. Teradata Query Scheduler User Guide 57

58 Chapter 5: Working with Scheduled Requests Managing Scheduled Requests Figure 18: Teradata Query Scheduler View/Modify Request Dialog Box 3 If you want to modify the request properties, continue with Modifying a Scheduled Request on page 58. Otherwise click OK to close the Teradata Query Scheduler View/Modify Request dialog box and return to the Teradata Query Scheduler Viewer. Modifying a Scheduled Request You can switch the Teradata Query Scheduler View/Modify Request dialog box from read-only to edit mode so you can modify the request or job properties. To modify a scheduled request or job 1 From the Teradata Query Scheduler Viewer, select a job from the Jobs list. 2 Click Options>Request Properties. OR Right-click the job to display a shortcut menu and click Request Properties. OR Click. The Teradata Query Scheduler View/Modify Request dialog box appears as read-only with the Request tab selected by default. 58 Teradata Query Scheduler User Guide

59 Chapter 5: Working with Scheduled Requests Managing Scheduled Requests Figure 19: Teradata Query Scheduler View/Modify Request Dialog Box 3 Select the Modify parameters to make a new request check box to switch to edit mode. Note: The tabs in the Teradata Query Scheduler View/Modify Request dialog box are the same as those in the Teradata QS Submit dialog box. 4 Use the Request, SQL, Scheduling, or Results tabs to change the properties you want. See Scheduling a SQL Request on page 44 to learn how to enter information in these tabs. 5 Click OK. If the new request is submitted successfully, a message box appears with your Request ID number and Job ID number. 6 Click OK to close the message box. 7 You are prompted to delete the original request. Click Yes if you want to delete the original request. Otherwise, click No. If you click No, your new request appears in the Jobs list of the Teradata Query Scheduler Viewer. Your original request remains in the Jobs list. If you click Yes, another message asks if you are sure you want to delete the selected request. Teradata Query Scheduler User Guide 59

60 Chapter 5: Working with Scheduled Requests Managing Scheduled Requests 8 Click Yes if you want to delete the selected request. Otherwise, click No. If you click No, your new request appears in the Jobs list of the Teradata Query Scheduler Viewer. Your original request remains in the Jobs list. If you click Yes, another message asks if you are sure you want to drop the results for the selected request. 9 Click Yes if you want to drop the results for the request. Otherwise, click No. If you click Yes, the results for the request are dropped and your new request appears in the Jobs list. If you click No, the results for the request are not dropped and your new request appears in the Jobs list. You have successfully modified a scheduled request or job. Deleting a Scheduled Request Using the Delete Request command, you can delete a scheduled request. When you delete a request, all jobs associated with that request are deleted. To delete a request 1 From the Teradata Query Scheduler Viewer, select a job from the Jobs list. 2 Click Options>Delete Request. OR Right-click the request to display a shortcut menu and click Delete Request. 60 Teradata Query Scheduler User Guide

61 Chapter 5: Working with Scheduled Requests Managing Jobs Managing Jobs Canceling a Job In addition to submitting new scheduled requests, you can use the Teradata Query Scheduler Viewer to do the following: Canceling a Job on page 61 Deleting a Job on page 61 You can cancel the scheduled execution of any selected job in a Waiting status, using the Cancel Job command. Once you cancel a job, you cannot restart it. If the job is for a recurring request, a new job is automatically generated by Teradata QS server before the next day. Otherwise, you must submit a new scheduled request. To cancel a job 1 From the Teradata Query Scheduler Viewer, select a job in a Waiting status from the Jobs list. 2 Click Options> Cancel Job. OR Right-click the job to display a shortcut menu and click Cancel Job. OR Click. Deleting a Job Using the Delete Job command you can delete any selected job in a Complete status. If you delete a completed job for a recurring request, the scheduled request is still available in the system. Deleting completed jobs allows for faster updates of the Job list. Jobs are also periodically deleted as specified using the Teradata Query Scheduler Administrator. To delete a job 1 From the Teradata Query Scheduler Viewer, select a job in a Complete status from the Jobs list. 2 Click Options>Delete Job. OR Right-click the job to display a shortcut menu and click Delete Job. Teradata Query Scheduler User Guide 61

62 Chapter 5: Working with Scheduled Requests Working with Job Results OR Click. Working with Job Results Retrieving Job Results In addition to submitting new scheduled requests, you can use the Teradata Query Scheduler Viewer to do the following: Retrieving Job Results on page 62 Viewing Job Result Information on page 64 Dropping Results on page 65 Using the Retrieve Result Data command you get the results data for any selected job in a Complete status. This command is available only if Teradata SQL Assistant 6.0 or later is installed on your system. The presence of Teradata SQL Assistant is automatically checked each time the Teradata Query Scheduler Viewer is started. Each time you use this command, a new instance of Teradata SQL Assistant is executed so that multiple queries can run simultaneously Using the Retrieve Result Data command launches Teradata SQL Assistant with one of these options: The SQL to retrieve the result data from the job s results table, see Retrieving Results from a Database Table on page 62 to learn more. The name of a local copy of the results file, see Retrieving Results from a Teradata QS Server File on page 63 to learn more. Note: How you submitted the request determines which option is used. Retrieving Results from a Database Table When you are retrieving a results table, you are prompted by Teradata SQL Assistant for these items: An ODBC data source Any information required to connect to the Teradata Database Then depending on the settings you chose in the Query Scheduler Viewer Settings dialog box, Teradata SQL Assistant does one of the following Retrieves and loads the results set in a Teradata SQL Assistant answer set window. Retrieves and exports the results set, and then terminates without showing the results. See Choosing a SQL Assistant Export Setting on page 41 to learn about setting this Teradata SQL Assistant option. 62 Teradata Query Scheduler User Guide

63 Chapter 5: Working with Scheduled Requests Working with Job Results To retrieve results from a database table 1 From the Teradata Query Scheduler Viewer, select a job in a Complete status from the Jobs list. 2 Click Options>Retrieve Result Data. OR Right-click the request to display a shortcut menu and click Retrieve Result Data. OR Click. The Select Data Source dialog box appears prompting for an ODBC data source. 3 Select the Machine Data Source tab. 4 Choose the appropriate Data Source Name and click OK. Then Teradata SQL Assistant opens, connects to the Teradata Database, gets the results from the database table. Next, one of the following events occurs: The results are exported and Teradata SQL Assistant closes without showing the results. The results are loaded in a Teradata SQL Assistant answer set window. To save an answer set to a file, see Teradata SQL Assistant for Microsoft Windows User Guide to learn how. Retrieving Results from a Teradata QS Server File When you are retrieving results from a file on the Teradata QS Server, you are prompted by the Teradata QS Viewer for the name of a local file into which to copy the results. Next, the Teradata QS Viewer gets the results from the Teradata QS server file and copies them to the local file using tabs as field delimiters. Then Teradata SQL Assistant is invoked with the local file name. Teradata SQL Assistant opens, retrieves the results from the local file, and loads them in a Teradata SQL Assistant answer set window. Teradata Query Scheduler User Guide 63

64 Chapter 5: Working with Scheduled Requests Working with Job Results To retrieve results from a Teradata QS Server text file 1 From the Teradata Query Scheduler Viewer, select a job in a Complete status from the Jobs list. 2 Click Options>Retrieve Result Data. OR Right-click the request to display a shortcut menu and click Retrieve Result Data. OR Click. 3 You are prompted for the name of a local file where you want to copy the results. The Teradata Query Scheduler Viewer gets the results from the Teradata QS server file and copies them to the local file. Then Teradata SQL Assistant is invoked with the local file name. Teradata SQL Assistant opens, retrieves the results from the local file, and loads them in a Teradata SQL Assistant answer set window. Viewing Job Result Information Frequently the text in the Information column of the Jobs list is too long to be completely visible in the list. You can view the entire text using the Job Information command. 64 Teradata Query Scheduler User Guide

65 Chapter 5: Working with Scheduled Requests Working with Job Results To view job result information 1 From the Teradata Query Scheduler Viewer, select a job from the Jobs list. 2 Click Options>Job Information. OR Right-click the job to display a shortcut menu and click Job Information. OR Click. The entire job information text appears in a Job Result Information message box. 3 Click OK to close the message and return to the Teradata Query Scheduler Viewer Dropping Results You can drop the results table or file associated with the selected request or job using the Drop Results command. Dropping results cleans up tables or files generated for that request or job. If you want to use the same results table or file for each request, you must drop the results. You can also use either the Drop if exists or Append if exists options when scheduling requests. For information on that option, see Scheduling a SQL Request on page 44. To drop results 1 From the Teradata Query Scheduler Viewer, select a job from the Jobs list. 2 Click Options>Drop Results. OR Right-click the request to display a shortcut menu and click Drop Results. Teradata Query Scheduler User Guide 65

66 Chapter 5: Working with Scheduled Requests Working with Job Results 66 Teradata Query Scheduler User Guide

67 CHAPTER 6 Working with the Teradata Query Scheduler Operations Utility Information about the state of the Teradata Query Scheduler (Teradata QS) components in the client/server architecture is configured and viewed from the Teradata Query Scheduler Operations utility. Your DBA uses the Teradata Query Scheduler Operations tool to manage both the Teradata QS client and Teradata QS server software programs. The following topics address tasks performed by your DBA. To learn more about the Teradata Query Scheduler Operations utility, browse through these topics: Starting the Teradata Query Scheduler Operations Utility Navigating the Teradata Query Scheduler Operations Utility About the Teradata QS Configuration Parameters Changing General Communication Information Changing Default Server Information Enabling Scheduling of Rejected Teradata SQL Assistant Queries Setting a Response Timeout Enabling and Disabling Tracing Managing the Teradata QS Server Viewing Component Information Managing Teradata QS Error Log Files Starting the Teradata Query Scheduler Operations Utility To start the Teradata Query Scheduler Operations utility 1 From the Windows task bar, click Start>Programs. 2 Click Teradata Query Scheduler Utilities>Scheduler Operations. You have successfully started the Teradata Query Scheduler Operations tool. Continue with Navigating the Teradata Query Scheduler Operations Utility on page 68 to familiarize yourself with the utility. Or, go to About the Teradata QS Configuration Parameters on page 71 to find out about Teradata QS configuration settings. Teradata Query Scheduler User Guide 67

68 Chapter 6: Working with the Teradata Query Scheduler Operations Utility Navigating the Teradata Query Scheduler Operations Utility Navigating the Teradata Query Scheduler Operations Utility The Teradata QS client software has some general functions used by all Teradata QS components, such as writing to the error log file. So you must install the Teradata QS client software before you can install the Teradata QS server software on a system. Typically, the Teradata QS client software is installed on many systems while the Teradata QS server software is installed on one or a limited number of servers. When only the Teradata QS client software is installed, the operations for the Teradata QS server are not available from the Teradata QS Operations tool. Teradata QS Operations Menu Bar The menu bar provides access to all the Teradata Query Scheduler Operations functions. Using the Teradata Query Scheduler Operations utility, you can do the following: Configure the scheduled requests client environment on your PC Configure the communications, client, and server parameters Start and stop the Teradata QS server as a Windows service (server only) Enable and disable tracing View configuration and runtime information View information about client parameters, connections, processes, and statistics View, save, or delete the Teradata QS error log files Figure 20: Teradata Query Scheduler Operations Menu Bar Table 14: Teradata Query Scheduler Operations Menus Menu File Configuration Server Information Error Log Help Description Exiting Teradata Query Scheduler Operations. Configuring parameters and activating tracing. Controlling the Teradata QS server if the server software is installed. Viewing information about the Teradata QS components. Viewing, resetting, or saving an error log file Accessing the online help and view information about the Teradata Query Scheduler Operations utility. 68 Teradata Query Scheduler User Guide

69 Chapter 6: Working with the Teradata Query Scheduler Operations Utility Navigating the Teradata Query Scheduler Operations Utility File Menu Table 15 describes the commands and submenus of the File menu. Table 15: File Menu Command: Teradata Query Scheduler Operations Command. Exit Description Closes the Teradata Query Scheduler Operations utility. Configuration Menu Table 16 describes the commands and submenus of the Configuration menu. Table 16: Configuration Menu Commands: Teradata Query Scheduler Operations Command. Communications Client Server Tracing Description Configure communications parameters in the Communications Parameters dialog box. Configure client parameters in the Client Parameters dialog box. Configure the server parameters in the Server Parameters dialog box. Enable or disable tracing for the client, the server, and/or communications components of Teradata QS in the Trace Activity to Files dialog box. See About the Teradata QS Configuration Parameters on page 71 to find out about the Teradata QS configuration parameters. Server Menu Table 17 describes the commands and submenus of the Server menu. Table 17: Server Menu Commands: Teradata Query Scheduler Operations Command. Start Stop Description Starts the Teradata QS server service. Stops the Teradata QS server service and shut down all the Teradata QS server components. See Managing the Teradata QS Server on page 78 to find out about the Teradata QS server. To learn how to start or stop the Teradata QS server, go to Changing Server Configurations on page 83. Teradata Query Scheduler User Guide 69

70 Chapter 6: Working with the Teradata Query Scheduler Operations Utility Navigating the Teradata Query Scheduler Operations Utility Information Menu Table 18 describes the commands and submenus of the Information menu. Table 18: Information Menu Commands: Teradata Query Scheduler Operations Command Communications Server Scheduled Requests Description View information about the communications components in the Communications Information dialog box. View information about the server in the Server Information dialog box. This command is only available if the Teradata QS server software is installed. View information about scheduled requests in the Scheduled Requests Information dialog box. This command is only available if the Teradata QS server software is installed. To learn how to view Teradata QS system or scheduled request information, see Viewing Component Information on page 86. Error Log Menu Table 19 describes the commands and submenus of the Error Log menu. Table 19: Error Log Menu Commands: Teradata Query Scheduler Operations Command View Delete Save Description View a tqslog file. Delete one or more tqslog files. Save a copy of a tqslog file into a text file so it can be sent to technical support. See Managing Teradata QS Error Log Files on page 90 to learn about Teradata QS error log files. Help Menu The Help menu has commands that provide access to Teradata Query Scheduler Operations online help and information about the version of the software installed on the computer. 70 Teradata Query Scheduler User Guide

71 Chapter 6: Working with the Teradata Query Scheduler Operations Utility About the Teradata QS Configuration Parameters To see copyright and version information from Teradata Query Scheduler Operations 1 Click Help>About Query Scheduler Operations. The About Teradata Query Scheduler Operations box appears showing the product version and copyright dates. Figure 21: About Teradata Query Scheduler Operations Message Box 2 Read the information, and then click OK to close the message. About the Teradata QS Configuration Parameters You use Teradata QS configuration parameters to customize how Teradata QS operates on your system. There are three types of Teradata QS configuration parameters representing the different Teradata QS components: Communications or Com Client or Cli Server or Srv Note: Srv parameters apply only when the system is being used as a Teradata QS server. Changing Communications Parameters Com parameters let you define communication services. The Teradata QS communications components also use these parameters to provide communication services to the Teradata QS servers. Some of the Com parameters are read-only during the start up phase of the corresponding component. You should not have to change any of the Com parameters. Depending on which configuration parameters you change, you may need to shut down and restart the Teradata Query Scheduler Operations tool and all the Teradata QS software for your changes to take affect. Teradata Query Scheduler User Guide 71

72 Chapter 6: Working with the Teradata Query Scheduler Operations Utility About the Teradata QS Configuration Parameters See Changing General Communication Information on page 74 and Changing Default Server Information on page 75 to learn how to change Com parameters. Changing Client Parameters Server Parameters Using Cli parameters you can specify whether end-users can schedule rejected Teradata SQL Assistant queries with Teradata QS. You also use those parameters to define how long the Teradata QS Viewer waits for a response from the Teradata QS server. See Enabling Scheduling of Rejected Teradata SQL Assistant Queries on page 76 and Setting a Response Timeout on page 77 to learn how to modify Cli parameters. Srv parameters let you set up the Teradata QS server. To find out more about Srv parameters and how to change them, see Changing Server Configurations on page 83. Default Configuration Parameters The following table lists the names of and the default values for the Teradata QS configuration parameters as they appear in the Windows registry. Table 20: Teradata QS Configuration Parameters Parameter Default Description Communications Parameters ComShmSz 1000 Communications shared memory size in kilobytes. ComNMsgs 300 Number of Communications message structures to preallocate. ComRetries 1 Number of times to retry network and system requests. ComTracing No Trace Communications activity for debugging (normally No). ComSrvPort 3000 Port number of remote Teradata QS servers. Used as the default when the client does not provide one. ComSrvName (2,3) None Up to three network names or IP addresses of remote Teradata QS servers. The first one is used as the default when the client does not provide one. ComSysName None Network node name of the local Teradata QS server on the network used by the client systems to access the server. Used to override the gethostname values. ComSysAddr None IP address of the local Teradata QS server on the network used by the client systems to access the server. Must be specified with the ComSysName parameter. Client Parameters CliSRDialog Yes Schedule rejected Teradata SQL Assistant queries. Set to No to disable display of Teradata Query Scheduler Submit Request dialog box. 72 Teradata Query Scheduler User Guide

73 Chapter 6: Working with the Teradata Query Scheduler Operations Utility About the Teradata QS Configuration Parameters Table 20: Teradata QS Configuration Parameters (continued) Parameter Default Description CliTimeout 60 Seconds to wait for server response. CliTracing No Trace client activity for debugging (not available in Teradata DQM version ). Server Parameters SrvShmSz 1000 Server shared memory size in kilobytes. SrvReqPool 3 Number of processes for request processing to run SrvTracing No Trace server activity for debugging (normally No). SrvDbTdpid DBC Name of the Teradata Database SrvDbName Tdwm Database logon user name of the Teradata QS database. Should always be tdwm. SrvDbPwd Tdwm Database logon password for the tdwm user. May be changed by the user (encrypted). SrvEncrypt No If Yes, data sent over the network betweenteradata QS clients and server, and between Teradata QS server and the Teradata Database are encrypted. Note: This parameter is not used. InstallPath C:\Program Files\NCR\ Teradata Query Scheduler Location of the Teradata QS installation directory LogPath C:\SchedLog Location of the Teradata QS log directory for writing log and trace files (must be globally writable). Teradata Query Scheduler User Guide 73

74 Chapter 6: Working with the Teradata Query Scheduler Operations Utility Changing General Communication Information Changing General Communication Information To change the general communication information 1 Click Configuration>Communications. The Communications Parameters dialog box appears. Figure 22: Communications Parameters Dialog Box 2 In the Shared Memory Size box, specify the size, in kilobytes, of the shared memory used by all the Teradata QS Communications components to store connection and message information. The default is 1000 KB. 3 Use the Data Transfer Retries spin box to specify the number of times the Teradata QS Communications components retry system and network functions when a failure is encountered. The default is 1. 4 Continue with Changing Default Server Information on page 75. OR Click OK to close the Communications Parameters dialog box and return to the Teradata Query Scheduler Operations tool. You have successfully changed the default Teradata QS server for your Teradata Database system. 74 Teradata Query Scheduler User Guide

75 Chapter 6: Working with the Teradata Query Scheduler Operations Utility Changing Default Server Information Changing Default Server Information The Default Server Port Number and Default Server Name need to be specified only if you are calling the Teradata QS client library functions from your own application. Otherwise, the Teradata Query Scheduler Viewer uses CLIv2 to find the IP address and port number of an active Teradata QS server. To change the default server information 1 Click Configuration>Communications. The Communications Parameters dialog box appears. Figure 23: Communications Parameters Dialog Box 2 Change the following fields as desired: Table 21: Communications Parameters Dialog Box: Field Descriptions Field/Control Default Server Port Number box Default Server Name box Description Specifies the default IP port number for a remote Teradata QS server. This value is used if a client does not specify a port number when opening a new communications session. The default port number is Specifies the default network node name or address of a remote Teradata QS server. This value is used if a client does not specify a server name when opening a new communications session. 3 Click OK to close the Communications Parameters dialog box and return to the Teradata Query Scheduler Operations tool. Teradata Query Scheduler User Guide 75

76 Chapter 6: Working with the Teradata Query Scheduler Operations Utility Enabling Scheduling of Rejected Teradata SQL Assistant Queries You have successfully changed the default Teradata QS server for your Teradata Database system. Enabling Scheduling of Rejected Teradata SQL Assistant Queries End-users can submit queries to the Teradata Database using Teradata SQL Assistant (SQLA). When an SQLA-submitted query is rejected because of Teradata Database management rules, a status of 3149 or 3150 is returned to SQLA. You can specify that the Teradata Query Scheduler Submit dialog box appears so that the end-user can schedule the rejected query to run at a later time. If you do not set up this option, the end-user does not have the opportunity to schedule the query using the Teradata Query Scheduler Submit dialog box. To specify whether Teradata QS opens when a SQLA query is rejected 1 Click Configurations>Client. The Client Parameters dialog box appears. Figure 24: Client Parameters Dialog Box 2 Select the Display the Query Scheduler - Submit dialog for SQL Assistant queries rejected by Teradata Workload Management check box. 3 Continue with Setting a Response Timeout on page 77 OR Click OK to close the Client Parameters dialog box and return to the Teradata Query Scheduler Operations tool. Now when a Teradata SQL Assistant query is rejected because of Teradata Database management rules, the Teradata Query Scheduler Submit dialog box appears so the user can schedule the query to run at a later time. 76 Teradata Query Scheduler User Guide

77 Chapter 6: Working with the Teradata Query Scheduler Operations Utility Setting a Response Timeout Note: Query scheduling for rejected Teradata SQL Assistant queries is subject to the same requirements for scheduling any query. Setting a Response Timeout You can also specify how long Teradata Query Scheduler Viewer waits for a response from the Teradata QS server. To specify a response timeout 1 Click Configurations>Client. The Client Parameters dialog box appears. Figure 25: Client Parameters Dialog Box 2 Use the Request Timeout spin box to specify the number of seconds (between 5 and 99) Teradata QS waits before timing out a request to the Teradata QS server. The default is 60 seconds. 3 Click OK to close the Client Parameters dialog box and return to the Teradata Query Scheduler Operations tool. You have successfully set a response timeout. Enabling and Disabling Tracing Warning: Tracing can use a lot of disk space and can severely impact performance. You should use it only when resolving a problem. The default is no tracing. Tracing writes special debugging information to text files. This information is useful when troubleshooting the system. When tracing is on, information regarding the Teradata QS operation is saved to files. Depending on where the client software is installed, these files are Teradata Query Scheduler User Guide 77

78 Chapter 6: Working with the Teradata Query Scheduler Operations Utility Managing the Teradata QS Server typically located at c:\schedlog. The administrator or technical support personnel can troubleshoot problems by viewing these files. Depending on the problem you are resolving, tracing can be turned on selectively for each of the three Teradata QS components. Tracing can be turned on or off before or after the components are started. This eliminates the need to stop and restart Teradata QS components in order to change the tracing setting. To enable or disable tracing 1 Click Configuration>Tracing. The Trace Activity to Files dialog box appears. Figure 26: Trace Activity to Files Dialog Box 2 Choose from the following options: Use this check box Enable Communications Tracing Enable Client Tracing Enable Server Tracing To trace Communications component activities such as session create, data send/receive, and more. Client Teradata QS component activities. Server component activities. 3 Click OK to close the Trace Activity to Files dialog box and return to the Teradata Query Scheduler Operations tool. You have successfully chosen tracing settings for your system. Managing the Teradata QS Server The Teradata QS Administrator and Teradata QS servers use a database in the Teradata Database to save scheduled requests information called tdwm. To read and load scheduled requests information, the servers on this system need to connect to the Teradata QS database. 78 Teradata Query Scheduler User Guide

79 Chapter 6: Working with the Teradata Query Scheduler Operations Utility Managing the Teradata QS Server You use the Srv parameters to specify logon information and Teradata QS server configuration settings. The Teradata QS server handles requests submitted using the Teradata Query Scheduler Viewer or Teradata Query Scheduler Submit dialog box, and executes queries. Note: The option to configure server parameters is available only on Teradata QS servers. Configuring the Teradata QS Server Internet Services Supporting Results Files The IP services file must have an entry for Teradata QS if the system is to be used as a Teradata QS server. The following entry is made in this file during Teradata QS Server installation: tqs 3000/tcp # TQS Listener port Note: You can find the services file in the WINNT\system32\drivers\etc directory is the default port number. However, it can be changed during installation. But if different service port numbers are used on various Teradata QS server nodes, only those PC clients knowing a particular Teradata QS server node s service port can access it. When the Teradata QS is set up to support results files, the location where the results are stored can be on the local Teradata QS server system if only one Teradata QS server is running, or on a network file server. For systems with one Teradata QS server running, using the default Local System account as the Windows Logon for the Teradata QS server may be sufficient. In all other cases, you must set up the Teradata QS server service to use another account, in order to have access to protected files. To support results files 1 From the Windows Start menu, choose Contol Panel. 2 Choose Administrative Tools, and then select Services. The Services dialog box appears. 3 From the Services dialog box, select TQS Server. 4 From the Action menu, select Properties. The TQS Server Properties dialog box appears. 5 Select the Log On tab. 6 Select the This account option. Type in the appropriate information in the text boxes to specify which user account you want the service to log on. 7 Click OK. The Teradata Query Scheduler Server Properties dialog box closes. 8 Close the Services dialog box. The service logs on to the Windows system the next time you start up the service. Teradata Query Scheduler User Guide 79

80 Chapter 6: Working with the Teradata Query Scheduler Operations Utility Managing the Teradata QS Server Note: To configure service startup, you must be logged on to a user account with membership in the Administrator s local group. Defining the Teradata QS Database Logon Parameters You can modify or view the Teradata QS database password or the DBS Name. However, the Teradata QS database user name (tdwm) should not be changed. The DBS Name identifies the Teradata Database to which the server connects. Changing the Teradata QS database password periodically provides additional security. If you change the password, Teradata QS database password must also be changed on the Teradata Database and the Teradata QS Server must be restarted so it can detect the new password. If any of these parameters are incorrect for your database, the Teradata QS Server will not start. To define the Teradata QS database logon parameters 1 Click Configuration>Server. The Server Parameters dialog box appears. 80 Teradata Query Scheduler User Guide

81 Chapter 6: Working with the Teradata Query Scheduler Operations Utility Managing the Teradata QS Server Figure 27: Server Parameters Dialog Box 2 Change the following fields as desired: Table 22: Server Parameters Dialog Box: Field/Control Descriptions Use this field/control Database Name box User Name box Password box Mechanism list box To Specify the Teradata Database you want to connect to. Note: There must be an entry in the HOSTS file on the server system that corresponds to the DBS name. This entry should have the form xxx.xx.xxx.xxx ssscop1; where xxx.xx.xxx.xxx is the IP address and sss is the Teradata Database name. See Teradata Query Scheduler Administrator Guide for instructions. This is the user/database name of the Teradata QS database, created as tdwm. This field is unavailable and cannot be changed. Specify the password of the Teradata QS database that is initialized to tdwm. You can change it here, but it must also be changed in the database itself or the Teradata QS server will not log on correctly. If you change the password, you are prompted to verify the change before it is saved. Select the authentication mechanism (for example, TD2) used for logon. The default is blank, representing the standard Teradata (TD2) mechanism. Teradata Query Scheduler User Guide 81

82 Chapter 6: Working with the Teradata Query Scheduler Operations Utility Managing the Teradata QS Server Table 22: Server Parameters Dialog Box: Field/Control Descriptions (continued) Use this field/control Parameter box To Specify the logon string for authentication under the specified mechanism. If the specified mechanism does not require this string, leave the field empty. 3 Continue with Changing Server Configurations on page 83. OR Click OK to close the Server Parameters dialog box and return to the Teradata Query Scheduler Operations tool. You have successfully changed the Teradata QS database logon parameters. 82 Teradata Query Scheduler User Guide

83 Chapter 6: Working with the Teradata Query Scheduler Operations Utility Managing the Teradata QS Server Changing Server Configurations General Teradata QS server configurations are specified using the Server Parameters dialog box. To change Server parameters 1 Click Configuration>Server. The Server Parameters dialog box appears. Figure 28: Server Parameters Dialog Box 2 Change the following fields as desired: Table 23: Server Parameters Dialog Box: Field/Control Descriptions Use this field/control Character Set list box To Select the Teradata session character set to use. On a Kanji system (having KANJI1 database object names, select the KANJISJIS_0S character set. Teradata Query Scheduler User Guide 83

84 Chapter 6: Working with the Teradata Query Scheduler Operations Utility Managing the Teradata QS Server Table 23: Server Parameters Dialog Box: Field/Control Descriptions (continued) Use this field/control Shared Memory Size (KB) text box Request Processor Processes spin box Encrypt Client Data check box To Specify the size of the memory area on this system used to store server information. This memory is shared among all the server processes. Specify the number of server processes created for handling client messages. Define whether or not you want client data encrypted through CLIv2. If selected, encryption provides data security in communications between the Teradata QS client and server components over network socket connections. The default setting is blank, meaning data is unencrypted. Click the check box to select encryption. Selecting the Encrypt Client Data option also causes encryption to be used for data passed between the Teradata QS server and the Teradata Database. Note: Changing the encryption option requires that you stop and restart both the Teradata QS clients and server. 3 Click OK to close the Server Parameters dialog box and return to the Teradata Query Scheduler Operations tool. You have successfully changed the Server configurations for the Teradata QS client and server components on your system. To find out about viewing Teradata QS component or scheduled request information, see Viewing Component Information on page 86. See Managing Teradata QS Error Log Files on page 90 to learn about log files. Starting the Teradata QS Server You can start the Teradata QS server in three different ways: Automatically at system start up using the Windows Control Panel Manually using the Windows Control Panel Manually from the Teradata QS Operations utility Setting Up the Teradata QS Server to Start Automatically To start a service automatically at system startup 1 From the Windows Start button, choose Settings. 2 Choose Administrative Tools, and then select Services. The Services applet opens. 3 In the Services dialog box, select the TQS server. 4 From the Action menu, select Properties. The TQS Server Properties dialog box appears. 84 Teradata Query Scheduler User Guide

85 Chapter 6: Working with the Teradata Query Scheduler Operations Utility Managing the Teradata QS Server 5 Select Automatic from the Startup Type list. This causes the service to start automatically when the system starts. 6 Click OK to close the Teradata Query Scheduler Server Properties dialog box. 7 Close the Services dialog box. Now this service starts automatically the next time and every time you start up the system. Note: To configure service startup, you must be logged on to a user account with membership in the Administrators local group. Use the Allow Service to Interact with Desktop option only if the service is running as a local system account (as specified in the This Account box). Manually Starting the Teradata QS Server To start the Teradata QS server from the Windows Control Panel 1 From the Start button, choose Settings. 2 Choose Administrative Tools, and then select Services. The Services applet opens. 3 In the Services dialog box, select the TQS server. 4 From the Action menu, select Properties. The Teradata Query Scheduler Server Properties dialog box appears. 5 (Optional) From the Log On tab, select the This account option. Then use the boxes to specify the user account you want the service to use to log on. 6 Click OK to close the Teradata Query Scheduler Server Properties dialog box. 7 Click Action>Start. 8 Close the Services dialog box. This allows a user or a dependent service to start the Teradata QS server. To start the Teradata QS Server from the Teradata Query Scheduler Operations utility From the Server menu, choose Start. Note: The option to start and stop the server service is available only if the Teradata QS server software is installed. If the Start command on the Server menu is unavailable, install the Teradata QS server software. Stopping the Teradata QS Server You can stop the Teradata QS server in two different ways: Manually using the Windows Control Panel Manually from the Teradata Query Scheduler Operations utility Teradata Query Scheduler User Guide 85

86 Chapter 6: Working with the Teradata Query Scheduler Operations Utility Viewing Component Information To stop the Teradata QS server from the Windows Control Panel 1 From the Start button, choose Settings. 2 Choose Administrative Tools, and then select Services. The Services applet opens. 3 In the Services dialog box, select the Teradata Query Scheduler server. 4 From the Action menu, select Stop. 5 Click Yes to confirm that you want to stop the Teradata QS server and close the message box. 6 Close the Services dialog box. To stop the Teradata QS server from the Teradata Query Scheduler Operations utility From the Server menu, select Stop. Viewing Component Information You can view information that the main Teradata QS communications components are actually using at runtime. To view the server and scheduled requests components, the Teradata QS server software must be installed. Parameters Connections Client Processes Statistics Viewing Communications Information To view communications information Click Information>Communications. The Communications Information dialog box appears and you can see runtime information. 86 Teradata Query Scheduler User Guide

87 Chapter 6: Working with the Teradata Query Scheduler Operations Utility Viewing Component Information Figure 29: Communications Information Dialog Box For detailed information about the Communications Information dialog box, see Communications Information Dialog Box on page 97. Viewing Server Information To view server information Click Information>Server. The Server Information dialog box appears showing information about the Teradata QS Servers on this system. Teradata Query Scheduler User Guide 87

88 Chapter 6: Working with the Teradata Query Scheduler Operations Utility Viewing Component Information Figure 30: Server Information Dialog Box For detailed information about the Server Information dialog box, see Server Information Dialog Box on page Teradata Query Scheduler User Guide

89 Chapter 6: Working with the Teradata Query Scheduler Operations Utility Viewing Component Information Scheduled Requests Information To view scheduled request information Click Information>Scheduled Requests. The Scheduled Requests Information dialog box appears showing information about the scheduled requests feature and all scheduled requests on the Teradata Database system. Figure 31: Scheduled Requests Information Dialog Box For detailed information about the Scheduled Requests Information dialog box, see Scheduled Requests Information Dialog Box on page 109. Teradata Query Scheduler User Guide 89

90 Chapter 6: Working with the Teradata Query Scheduler Operations Utility Managing Teradata QS Error Log Files Managing Teradata QS Error Log Files Figure 32: Sample Error Log File Teradata QS error log files provide Teradata support personnel and users with a general description of problems that have occurred. The Teradata QS error log file is called tqslog. It always exists if errors have been logged. A different error log file is created for each date that a error log entry needs to be made. The error log file name is appended with the year, month, and date it was created. For example, tqslog is created to contain error log entries that occurred on July 12, If it is deleted, another is created when needed. The Teradata QS components log all severe errors related to Teradata QS to this file. Only Teradata QS errors, and not user request errors, are logged. Database errors encountered when executing scheduled requests are not logged in the error file, but are saved in conjunction with the scheduled request being executed. The default Teradata QS error log is in the C:\SchedLog directory. This location is specified during installation and saved in the Windows registry during Teradata QS Client installation. For details about the contents of the error log files, see Appendix C: About Error Log Files. 90 Teradata Query Scheduler User Guide

91 Chapter 6: Working with the Teradata Query Scheduler Operations Utility Managing Teradata QS Error Log Files Viewing Error Log Files To view error log files Saving Error Log Files 1 Click Error Log>View. The View Error Log Files dialog box appears showing the current error log files in the Error Log Files list. 2 From the list, click once to highlight the file to view. 3 Click OK to open the View Error Log File dialog box. 4 After viewing the error log file, click OK to close the View Error Log File dialog box. To save error log files 1 Click Error Log>Save. The Save Error Log Files dialog box appears. 2 Select the name of the error log file to save from the Error Log Files list, and click OK. 3 In the Save In list box, select a directory location to save the file. 4 Enter a file name in the File Name list box. 5 In the Save as Type list box, accept the default.txt file format. 6 Click Save. Teradata Query Scheduler User Guide 91

92 Chapter 6: Working with the Teradata Query Scheduler Operations Utility Managing Teradata QS Error Log Files Deleting Error Log Files To delete error log files 1 Click Error Log>Delete. The Delete Error Log Files dialog box appears. Figure 33: Delete Error Log Files Dialog Box 2 Select the files to delete from the Error Log Files list using one of these options: Click once to highlight a file Press and hold the Ctrl key and then click multiple files to highlight 3 Click OK to delete the file. 4 Click OK to confirm you want to delete the file, or click Cancel to close the dialog box without deleting the file. 92 Teradata Query Scheduler User Guide

93 APPENDIX A About the User Interfaces While you are working with Teradata Query Scheduler (Teradata QS), you might want detailed information about the fields and controls in the graphical user interfaces (GUIs). The following topics provide you with the specifics: Teradata Query Scheduler Connect Dialog Box Viewer Settings Dialog Box SQL Text Dialog Box Teradata Query Scheduler Connect Dialog Box You use the Connect command in the Teradata Query Scheduler Viewer to open the Teradata Query Scheduler Connect dialog box. You use the controls in that dialog box to connect to a Teradata QS server. Figure 34: Teradata Query Scheduler Connect Dialog Box The following table gives you detailed options descriptions. Teradata Query Scheduler User Guide 93

94 Appendix A: About the User Interfaces Teradata Query Scheduler Connect Dialog Box Table 24: Teradata Query Scheduler Connect Dialog Box: Field/Control Descriptions Option Database Name User Name Password Default Database Account String Server Mechanism Parameter OK Cancel Description Use this text box to enter the name of the Teradata Database you want to use to schedule your SQL requests. Enter your user name associated with the Teradata Database you entered in the Database Name box. Enter the password associated with the user name you entered in the User Name box. (Optional) Usually, your DBA sets up a default database associated with your user name and password. However, you can enter the name of another database that you want to use as the default database in this text box. (Optional) Usually, your DBA sets up a logon account string associated with your user name and password. However, you can enter a different account string if you do not want to use the default. Enter the name or IP address of the system the Teradata QS server is running on. Initially, this box is disabled. Teradata QS validates the Teradata Database logon parameters and attempts to obtain information about active Teradata QS servers from the tdwm database. If an active server is found, a connection is established, and the Teradata QS Viewer opens. If a CLIv2 error occurs, an attempt is made to establish a connection using the Teradata QS server name configured with the Teradata QS Operations tool. If that is unsuccessful, the Server box becomes available. Note: Your DBA defines the default Teradata QS server using the Teradata Query Scheduler Operations tool. See Changing Default Server Information on page 75 for details. Select the appropriate authentication mechanism (for example, TD2) in this list box. The default is blank, representing the standard Teradata (TD2) mechanism. Type the authentication string you must as a parameter for the authentication mechanism specified. If the specified mechanism does not require this string, leave the field empty. Click to save the entries, close the Teradata Query Scheduler Connect dialog box, connect to the Teradata QS server, and open the Teradata Query Scheduler Viewer. Click to close the Teradata Query Scheduler Connect dialog box without saving the entries or connecting to the Teradata QS server. To learn how to use the Teradata Query Scheduler Connect dialog box, see Connecting to a Teradata QS Server on page Teradata Query Scheduler User Guide

95 Appendix A: About the User Interfaces Viewer Settings Dialog Box Viewer Settings Dialog Box You use the Viewer Settings command to open the Viewer Settings dialog box. You use the controls in that dialog box to set the refresh rate at which the Jobs list is updated from the Teradata QS server and to select how Teradata SQL Assistant handles results retrieved from a Teradata Database table. Figure 35: Viewer Settings Dialog Box The following table gives you detailed field and control descriptions. Table 25: Viewer Settings Dialog Box: Option Descriptions Option Refresh every minutes Export Results Tables OK Cancel Description Use the arrows to choose an interval between 5 and 99 minutes for the refresh rate. This sets the rate at which the Teradata Query Scheduler Viewer gets information from the Teradata QS server and updates the Jobs list. Select this check box to have Teradata SQL Assistant export results retrieved from a Teradata Database table and then terminate without showing the results in an Answer Set window. Clear the box to have Teradata SQL Assistant show the results in an Answer Set window. Click to save settings, close the Viewer Settings dialog box, and return to the Teradata Query Scheduler Viewer. Click to close the Viewer Settings dialog box and return to the Teradata Query Scheduler Viewer without saving settings. To learn how to use the Viewer Settings dialog box, see Customizing the Teradata Query Scheduler Viewer on page 40. Teradata Query Scheduler User Guide 95

96 Appendix A: About the User Interfaces SQL Text Dialog Box SQL Text Dialog Box You use the SQL Text dialog box to create single or multiple SQL statements that you want to schedule for execution at a later time and/or date. Figure 36: SQL Text Dialog Box The following table gives you detailed option descriptions. Table 26: SQL Text Dialog Box: Option Descriptions Option SQL OK Cancel Paste Description Enter the text for the single or multiple SQL statements to schedule. Note: Large object (LOB) data cannot be inserted into a Teradata Database with scheduled requests to insert. However, you can schedule a SQL request that retrieves LOB data from a table, and save those results to a table or a file. Click to save your SQL statement and schedule it for execution in the Teradata Query Scheduler Submit dialog box. Click to close the SQL Text dialog box without saving SQL statement. Click to add the text of single or multiple SQL statements copied from another application to the SQL Text dialog box. To learn how to create SQL statements for scheduling using the SQL Text dialog box, see Scheduling a SQL Request on page Teradata Query Scheduler User Guide

97 APPENDIX B About the Teradata Query Scheduler Operations Interfaces While you are working with Teradata Query Scheduler (Teradata QS) Operations utility, you might want detailed information about the fields and controls in the graphical user interfaces (GUIs). The following topics provide you with the specifics: Communications Information Dialog Box Server Information Dialog Box Scheduled Requests Information Dialog Box More Profile Information Dialog Box Requests Scheduling Info Dialog Box Communications Information Dialog Box The Communications Information dialog box shows you information about the communications components of the Teradata QS. From the Teradata Query Scheduler Operations tool, use the Information menu and choose Communications to open this dialog box. Teradata Query Scheduler User Guide 97

98 Appendix B: About the Teradata Query Scheduler Operations Interfaces Communications Information Dialog Box Figure 37: Communications Information Dialog Box Table 27: Communications Information Dialog Box Tab Parameters Connections Client Processes Statistics Shows System and network configuration, and general runtime information about the Teradata QS Communications components. Information about the physical and logical communications connections. The physical connections between client and server systems are managed by processes called routers. The router process that services the client end of a physical connection is a client router. The router process that services the server end is a server router. The logical connections between client applications and the Teradata QS server are called sessions. On client and server systems, all sessions to the same remote system are handled by a single router process. Information about the client application processes that have attached to the communications library. These are usually Scheduled Requests Viewer client applications. Information about the communications connections and the requests sent over the connections. Parameters Tab The Parameters tab shows configuration and general runtime information about the Teradata QS Communications components. You cannot modify the fields in the Parameters tab. However, you can change Communication parameters from the Configuration menu of the Teradata QS Operations tool. See Changing Default Server Information on page 75 to learn how. 98 Teradata Query Scheduler User Guide

99 Appendix B: About the Teradata Query Scheduler Operations Interfaces Communications Information Dialog Box Table 28: Parameters Tab: Communications Information Dialog Box Field/Control Description General Memory Size (KB) list Retries list Free Memory (KB) list Free Msg Buffers list The communications shared memory size in kilobytes. Indicates the number of times the Teradata QS Communications components retries system and network functions when a failure is encountered. The amount of free communications shared memory in kilobytes. Indicates how many communications message buffers are currently available for use. Client Default Server Name list Default Server Port list The default network node name of a remote Teradata QS server system. This value is used if a client does not specify a server name when opening a new communications session. The default IP port number for a remote Teradata QS server system. Server Network Node Name list Network Node Address list Listener Port list Listener Process ID list The name of the local network node if it has been used as a Teradata QS server. The address of the local network node. The IP port number on which the Teradata QS Listener component accepts socket connections from remote client systems. This value is specified during Server installation and is saved in the <system>\system32\drivers\etc\ services file. The process ID of the Teradata QS Listener process. Connections Tab The Connections tab shows information about the physical and logical communications connections. The physical connections between client and server systems are managed by processes called routers. The router process that services the client end of a physical connection is a client router. The router process that services the server end is a server router. The logical connections between client applications and the Teradata QS server are called sessions. On client and server systems, all sessions to the same remote system are handled by a single router process. Teradata Query Scheduler User Guide 99

100 Appendix B: About the Teradata Query Scheduler Operations Interfaces Communications Information Dialog Box Figure 38: Connections Tab: Communications Information Dialog Box Table 29: Connections Tab: Communications Information Dialog Box Column Name Type Local Id PID/CSID Sock State Send Msgs Shut/Disc Pend Msgs Total Msgs Description Indicates whether the connection is a client or server router process or a logical session. The hexadecimal identifier of the router or session on the local system. PID is the process ID of the main router process for the router types. CSID is the hexadecimal identifier of the client or server sessions. The state of the socket connection for the router types. Indicates whether there are messages ready to send over the session or socket. Shut indicates whether there is a shutdown pending for router types. Disc indicates whether there is a disconnect pending for sessions. The number of messages waiting for a response on the session. The total number of messages sent on the session. Client Processes Tab The Client Processes tab shows information about the client application processes attached to the communications library. These are usually Scheduled Requests Viewer client applications. 100 Teradata Query Scheduler User Guide

101 Appendix B: About the Teradata Query Scheduler Operations Interfaces Communications Information Dialog Box Figure 39: Client Processes Tab: Communications Information Dialog Box Table 30: Client Processes Tab: Communications Information Dialog Box Column Name Process Id Session Description The process ID of the process that opened a client communications session. The session identifier of the session created for the process. Several sessions could be created by one client application process or thread. Statistics Tab The Statistics tab shows information about the communications connections and the requests sent over the connections. Teradata Query Scheduler User Guide 101

102 Appendix B: About the Teradata Query Scheduler Operations Interfaces Communications Information Dialog Box Figure 40: Statistics Tab: Communication Information Dialog Box Table 31: Statistics Tab: Communications Information Dialog Box Option Request Type Description This column displays the basic Teradata QS communications request or message types. Client Statistics Reqs Sent Resps Recvd This column displays the number of requests of each type sent by client applications on the local system using the Teradata QS client communications component. Because client applications do not send intermediate responses, that statistic is not applicable (N/A). This column displays the number of responses of each type received by client applications on the local system using the Teradata QS client communications component. Because client applications do not receive responses for cancel and close-session requests, those statistics are not applicable. Server Statistics Reqs Recvd Resps Sent Server Resps This column displays the number of requests of each type received by the Teradata QS server communications component on the local system from local and/or remote Teradata QS client communications components. This column displays the number of responses of each type sent by the Teradata QS server communications component on the local system. The server communications component sends responses to the client communications component even if the client application does not receive them. This column displays the number of responses of each type returned by the Teradata QS server component to the Teradata QS server communications component on the local system. The Teradata QS server responds to each request it processes. 102 Teradata Query Scheduler User Guide

103 Appendix B: About the Teradata Query Scheduler Operations Interfaces Server Information Dialog Box Table 31: Statistics Tab: Communications Information Dialog Box (continued) Option Description Routers Connections Normal Discs Errors Number of communications connections on the local system. Number of communications connections disconnected normally. Number of communications connections disconnected because of socket errors. Server Information Dialog Box Figure 41: Server Information Dialog Box The Server Information dialog box describes the information used by the Teradata QS server. From the Teradata Query Scheduler Operations tool, use the Information menu and choose Server to open this dialog box. Table 32: Server Information Dialog Box Tab General Connections Shows Configuration and general runtime information about the Teradata QS server components. Information about the connections of Teradata QS clients to the local Teradata QS server. Teradata Query Scheduler User Guide 103

104 Appendix B: About the Teradata Query Scheduler Operations Interfaces Server Information Dialog Box Table 32: Server Information Dialog Box (continued) Tab Processes Statistics Shows Information about the processes that make up the Teradata QS server. Information about the number and type of requests and responses processed by the Teradata QS server. General Tab The General tab shows configuration and general runtime information about the Teradata QS server components. Table 33: General Tab: Server Information Dialog Box Field/Control Database Name Database Version Current DB Date Current DB Time Scheduler DB Name Local System Name Server ID Primary Server Time Active (hh:mm) Character Set Encrypt Data Memory Size (KB) Free Memory (KB) Description The Database Name determines the Teradata Database to which the Teradata QS server connects. To configure the name of the Teradata system, open the Server Parameters dialog box by clicking Configuration>Server. The Teradata Database release level. The current database date. This date is updated every minute. The current database time. This time is updated every minute. The name of the Teradata Query Scheduler database (tdwm). The network node name of the local system. This is the name of the server in the host_status table and is the name by which the system is known on the network. The unique internal numeric identifier assigned to each Teradata Query Scheduler server system. Indicates whether the Teradata QS server is acting as the primary or master Teradata QS server. The master server executes scheduled requests and cleans up tables. Indicates how long, in hours and minutes format, that the Teradata Query Scheduler server has been continuously active. Indicates the session character set under which the Teradata QS Server executes internal tasks. This value is set on the Server Parameters dialog box of the Query Scheduler Operations utility. Provides data security through the encryption of communications between the Teradata Query Scheduled Request client and server components over network socket connections. The server shared memory size in kilobytes. The amount of free server shared memory in kilobytes. 104 Teradata Query Scheduler User Guide

105 Appendix B: About the Teradata Query Scheduler Operations Interfaces Server Information Dialog Box Connections Tab The Connections tab shows information about the connections of Teradata QS clients to the local Teradata QS server. Figure 42: Connections Tab: Server Information Dialog Box Table 34: Connections Tab: Server Information Dialog Box Column Header Conn Id Version User Name Database Name Account Description The unique Teradata QS connection identifier for this system The Teradata QS client version identifier which determines if the client is from a previous release The name of the user for which the connection was made to the Teradata QS server The name of the database the client connection is currently using as its default database The name of the account for which the connection was made. This will be the default account for the user if no account was specified when the Teradata QS client connected to the Teradata QS server. Teradata Query Scheduler User Guide 105

106 Appendix B: About the Teradata Query Scheduler Operations Interfaces Server Information Dialog Box Processes Tab Figure 43: Processes Tab: Server Information The Processes tab shows information about the processes that make up the Teradata QS server. Table 35: Processes Tab: Server Information Dialog Box Column Header Type Process Id State Description Indicates the type of the server process: Initialization/Update Request Processor The process identification number of the server process. The state of the server process: Initializing Waiting Busy Shutdown # Msgs For the Init/Update process, this is the number of database updates that have been processed. For a Request Processor process, this is the number of client requests that have processed. Msg Id For a Request Processor process, this is the internal message identifier of the request currently being processed. 106 Teradata Query Scheduler User Guide

107 Appendix B: About the Teradata Query Scheduler Operations Interfaces Server Information Dialog Box Table 35: Processes Tab: Server Information Dialog Box (continued) Column Header Db Env DbRecov PidRecov Description The current environment of the server's Teradata Database session: Teradata QS (logged on to the tdwm database) User (logged on to a user database) None (not logged on) Indicates if the server is currently recovering from a database session crash. The number of times the server process has recovered. Statistics Tab The Statistics tab shows information about the number and type of requests and responses processed by the Teradata QS server. Figure 44: Statistics Tab: Server Information Dialog Box Table 36: Statistics Tab: Server Information Dialog Box Option Total Requests Final Responses Description The total number of requests processed by the Teradata QS server request processors. The total number of final responses sent by the Teradata QS server. Teradata Query Scheduler User Guide 107

108 Appendix B: About the Teradata Query Scheduler Operations Interfaces Server Information Dialog Box Table 36: Statistics Tab: Server Information Dialog Box (continued) Option Intermediate Responses Explain Errors Parser Errors Update Collisions Description The number of intermediate responses sent by the Teradata QS server. The number of times the Teradata Database returned an error for an Explain of a user request. The cause is most likely that Teradata QS does not have the proper database permissions to execute that type of request. The number of times a statement request could not be parsed by the parser utility used by Teradata QS. The number of times a deadlock status was received from the database when Teradata QS updated its host_status table. Types of Requests Processed Connects Disconnects Scheduled Requests Query Requests Information Cancels Other Query Results Stmts Checked Multiple Stmts The number of connect requests processed. The number of disconnect requests processed. The number of scheduled requests messages (of all types) processed. The number of query requests processed. If this number is non-zero, there are DBQMenhanced ODBC drivers that are using this server for query authorization. The number of information messages processed. The number of (query) cancel messages processed. The number of miscellaneous messages processed. The number of query results messages (indicating that a query has completed) processed. The number of statement requests checked for rules. Some types of requests, such as DDL, are not checked by Teradata QS. The number of statement requests containing more than one SQL statement in the request. 108 Teradata Query Scheduler User Guide

109 Appendix B: About the Teradata Query Scheduler Operations Interfaces Scheduled Requests Information Dialog Box Scheduled Requests Information Dialog Box The Scheduled Requests Information dialog box provides information about scheduled requests. From the menu bar of the Teradata Query Scheduler Operations utility, click Information>Scheduled Requests. Figure 45: Scheduled Requests Information Dialog Box Table 37: Scheduled Requests Information Dialog Box Tab General Scheduled Requests Scheduled Jobs Executing Jobs Execution Time Frames Workgroups Shows Configuration and general runtime information about the Teradata QS environment. Information about all of the scheduled requests defined to Teradata QS. Information about all of the scheduled requests jobs that have already run or scheduled to run. Information about all of the scheduled requests jobs currently being executed. Information about all of the time periods in which scheduled requests can execute. Information about workgroups. Teradata Query Scheduler User Guide 109

110 Appendix B: About the Teradata Query Scheduler Operations Interfaces Scheduled Requests Information Dialog Box Table 37: Scheduled Requests Information Dialog Box (continued) Tab File Storage Locations Profiles Shows Information about the locations where scheduled request results files are stored. Information about the sets of scheduled requests attributes or profiles defined for specific users, accounts, Teradata Roles, and Teradata Profiles. Note: A default user profile applies to all users not associated with any other profile. General Tab The General tab shows configuration and general runtime information about the Teradata QS environment. Table 38: General Tab: Scheduled Requests Information Dialog Box Field/Control Scheduled Requests Next Job Gen Check Last Update Timestamp Notifications Available Description Indicates whether the Scheduled Requests feature of Teradata QS is enabled. The next date and time, yyyymmdd and hhmm format, that Teradata QS checks whether new jobs need to be created and scheduled. Typically this occurs once at the end of each day. An internal timestamp that represents the last time an update to a scheduled request was detected. Indicates whether notification is available for use. If available, Teradata QS sends a notification message when a request job completes. Teradata QS checks for the existence of the dbcmngr.alertrequest table which is created as part of the Teradata Manager server installation. Use the Teradata Query Scheduler Submit Request dialog box to insert an address. 110 Teradata Query Scheduler User Guide

111 Appendix B: About the Teradata Query Scheduler Operations Interfaces Scheduled Requests Information Dialog Box Scheduled Requests Tab The Scheduled Requests tab shows information about all of the scheduled requests defined to Teradata QS. Figure 46: Scheduled Requests Tab: Scheduled Requests Information Dialog Box Table 39: Scheduled Requests Tab: Scheduled Requests Information Dialog Box Option Request Id Request Name User Name Last Job D/T Show Scheduling Info Description This column displays the unique numerical identifier assigned to the scheduled request. This column displays an optional descriptive name that helps you to identify the request and its jobs. This column displays the name of the user who issued the request. This column displays the date and time, in yyyymmdd and hhmm format, the last job associated with the request that was scheduled to run. Click to view information about the selected request such as how and when the request is scheduled to execute, such as the frequency, start date and time, and maximum start interval in the Scheduling Info dialog box. See Scheduled Jobs Tab on page 112 for more information. Teradata Query Scheduler User Guide 111

112 Appendix B: About the Teradata Query Scheduler Operations Interfaces Scheduled Requests Information Dialog Box Scheduled Jobs Tab The Scheduled Jobs tab shows information about all of the scheduled requests jobs that have already run or scheduled to run. Figure 47: Scheduled Jobs Tab: Scheduled Requests Information Dialog Box Table 40: Scheduled Jobs Tab: Scheduled Requests Information Dialog Box Column Name Request Id Job Id State Orig Run D/T Curr Run D/T Max Run D/T Description A unique numerical identifier assigned to the scheduled request. A unique numerical identifier assigned to the job. Indicates whether the job is waiting to run, or whether it completed successfully or unsuccessfully. The date and time, in yyyymmdd and hhmm format, when the job was initially scheduled to run. The date and time, in yyyymmdd and hhmm format, when the job is currently scheduled to run. The date and time, in yyyymmdd and hhmm format, after which the job can no longer run. 112 Teradata Query Scheduler User Guide

113 Appendix B: About the Teradata Query Scheduler Operations Interfaces Scheduled Requests Information Dialog Box Executing Jobs Tab The Executing Jobs tab shows information about all of the scheduled requests jobs currently being executed. Figure 48: Executing Jobs Tab: Scheduled Requests Information Dialog Box Table 41: Executing Jobs Tab: Scheduled Requests Information Dialog Box Column Name Request Id Job Id Process Id Submit D/T Description A unique numerical identifier assigned to the scheduled request. The unique numerical identifier assigned to the job. The identification of the process executing the job. The date and time, in yyyymmdd and hhmm format, the job was initially scheduled to run. Teradata Query Scheduler User Guide 113

114 Appendix B: About the Teradata Query Scheduler Operations Interfaces Scheduled Requests Information Dialog Box Execution Time Frames Tab The Execution Time Frames tab shows information about all of the time periods in which scheduled requests can execute. Figure 49: Execution Time Frames Tab: Scheduled Requests Information Dialog Box Table 42: Execution Time Frames Tab: Scheduled Requests Information Dialog Box Column Name Time Frame Name From To Days Of Week Enabled Description The descriptive title of the time frame. The 24-hour based time, in hhmm format, when the execution time frame becomes active. The 24-hour based time, in hhmm format, when the execution time frame becomes inactive. The days of the week when the execution time frame is active. Indicates whether this time frame is enabled or disabled. 114 Teradata Query Scheduler User Guide

115 Appendix B: About the Teradata Query Scheduler Operations Interfaces Scheduled Requests Information Dialog Box Workgroups Tab The Workgroups tab shows information about workgroups. Figure 50: Workgroups Tab: Scheduled Requests Information Dialog Box Table 43: Workgroups Tab: Scheduled Requests Information Dialog Box Column Name WorkGroup Name Max Executors Description The descriptive title of the workgroup name. The maximum number of scheduled request jobs that the server will execute simultaneously for users, accounts, Teradata Roles, and Teradata Profiles in this workgroup when several jobs are scheduled to run at about the same time. # Executing The number of scheduled requests that are currently executing for this workgroup. Teradata Query Scheduler User Guide 115

116 Appendix B: About the Teradata Query Scheduler Operations Interfaces Scheduled Requests Information Dialog Box File Storage Locations Tab The File Storage Locations tab shows information about the locations where scheduled request results files are stored. Figure 51: File Storage Locations Tab: Scheduled Requests Information Dialog Box Table 44: File Storage Locations Tab: Scheduled Requests Information Dialog Box Column Name File Storage Name Directory Path Description The name given to the file storage specification. The directory path where scheduled request result files are stored. To provide more organization to the results files, user or user group, and account profiles referencing this file storage specification may choose to store results directories under this location. This directory path must: Be sharable and available to all Teradata QS server systems on all types of platforms used, such as NT, 2000, and XP. Use the same directory path for all Teradata QS servers. 116 Teradata Query Scheduler User Guide

117 Appendix B: About the Teradata Query Scheduler Operations Interfaces Scheduled Requests Information Dialog Box Profiles Tab The Profiles tab shows information about the sets of scheduled requests attributes or profiles defined for specific users, accounts, Teradata Roles, and Teradata Profiles. A default user profile applies to all users not associated with any other profile. Figure 52: Profiles Tab: Scheduled Requests Information Dialog Box Table 45: Profiles Tab: Scheduled Requests Information Dialog Box Option Profile Name Type Scheduling Max Start Job Days Result Days Show Additional Info Description This column displays the name of the user, user group, or account for which the profile is defined. This column displays the type of profile (user, user group, or account). This column displays the frequency such as None, Onetime, or All that the user or user group is allowed to specify when scheduling a request. This column displays the default maximum start interval in days and hours, in ddhh format, after a request is scheduled that it can start. This column displays the number of days a record of a completed job is kept by Teradata QS before it is automatically deleted. This column displays the number of days results tables and files are kept by Teradata QS before they are automatically deleted. This does not apply if the results were recreated or updated in the interim. Click to view more information about where results are stored, etc. in the More Profile Information dialog box. See More Profile Information Dialog Box on page 118. Teradata Query Scheduler User Guide 117

118 Appendix B: About the Teradata Query Scheduler Operations Interfaces More Profile Information Dialog Box More Profile Information Dialog Box This dialog box shows information about the user, user group, or account you selected in the Profiles tab in the Scheduled Requests Information dialog box. The information is read-only. To open this dialog box, select an item in the Profiles tab, and then click Show Additional Info. Figure 53: More Profile Information Dialog Box Table 46: More Profile Information Dialog Box Option Workgroup Name Allowed Results Type Description Shows the name of the workgroup associated with this profile. The location where results will be stored that the users specified when scheduling the request: File Results from the request will be stored in a file. The user is required to store the results in a file when scheduling a request. Database Results from the request will be stored in a database table. The user is required to store the results in a database table when scheduling a request. Either Table or File Results from the request may be stored in either a database table or a file. The user may choose a database table or a file when scheduling a request. 118 Teradata Query Scheduler User Guide

119 Appendix B: About the Teradata Query Scheduler Operations Interfaces Requests Scheduling Info Dialog Box Table 46: More Profile Information Dialog Box (continued) Option Results Database Name Description The default database name where results of scheduled requests are stored. This may be empty if the user profile does not allow results to be saved to a database. Results File Info The following options specify the location and characteristics of how results files are stored for the user. File Storage Name Additional Path Maximum File Length (x1000) Field Separation Character (hex) The name of the file storage location associated with the profile. It defines the high-level path name where results files are stored. An optional low-level path name where results files are stored. The complete path combines the file storage path and this path. Maximum length, in thousands of bytes, of the file storing the results. The default character code, in hex format, inserted in flat text results files to separate fields in an entry. Requests Scheduling Info Dialog Box The Requests Scheduling Info dialog box shows scheduling information about the request you selected in the Scheduled Requests tab in the Scheduled Requests Information dialog box. To open this dialog box, select a request in the list, and click Show Scheduling Info. Figure 54: Requests Scheduling Info Dialog Box Teradata Query Scheduler User Guide 119

120 Appendix B: About the Teradata Query Scheduler Operations Interfaces Requests Scheduling Info Dialog Box Table 47: Requests Scheduling Info Dialog Box Option Frequency Start Date Start Time Start Interval Scheduled Days OK Description Indicates how often the request will be executed. The date, in yyyymmd format, the first job will be executed. The time, in hhmm format, the first job is to be executed. Subsequent jobs will execute at the same start time. The maximum start interval in days and hours relative to the start time that the job can begin. The days of the week or month that the request will execute. Closes the Request Scheduling Info dialog box. 120 Teradata Query Scheduler User Guide

121 APPENDIX C About Error Log Files Teradata Query Scheduler (Teradata QS) error log files are intended to provide Teradata support personnel and users with a general description of problems that have occurred. The Teradata QS error log file is called tqslog. It always exists if errors have been logged. A different error log file is created for each date that a error log entry needs to be made. Read through the following topics to learn about the contents of an Teradata QS error log file: Error Log Files Component Identifiers Status Codes Error Log Files Figure 55: Sample Teradata QS Error Log File The following table describes the contents of an error log file. Teradata Query Scheduler User Guide 121