Teradata Query Scheduler. Administrator Guide

Transcription

1 Teradata Query Scheduler Administrator Guide Release B A August 2011

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. EMC, PowerPath, SRDF, and Symmetrix are registered trademarks of EMC Corporation. Hewlett-Packard and HP are registered trademarks of Hewlett-Packard Company. Intel, Pentium, and XEON are registered trademarks of Intel Corporation. IBM, CICS, RACF, Tivoli, and z/os are registered trademarks of International Business Machines Corporation. Linux is a registered trademark of Linus Torvalds. LSI is a registered trademark 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. NetVault is a trademark or registered trademark of Quest Software, Inc. in the United States and/or other countries. Novell and SUSE are registered trademarks of Novell, Inc., in the United States and other countries. Oracle, Java, and Solaris are registered trademarks of Oracle and/or its affiliates. Oracle GoldenGate is a trademark of Oracle. QLogic and SANbox are trademarks or registered trademarks of QLogic Corporation. RainStor is a registered trademark of RainStor Ltd. or its affiliates. SAS and SAS/C are trademarks or registered trademarks of SAS Institute Inc. SPARC is a registered trademark of SPARC International, Inc. 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 registered trademark of Unicode, Inc. in the United States and other countries. 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 Teradata Query Scheduler (Teradata QS), which is a Teradata Tools and Utilities product. Teradata Tools and Utilities are a group of products designed to work with Teradata Database. Teradata QS enables the database administrator to manage workloads submitted to the Teradata Database. This book will help the database administrator (DBA) learn, manage, and skillfully utilize the Teradata QS features. Audience This book is intended for use by: Teradata Database administrator Other technical personnel who manage both the Teradata QS 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 Help Menu on page 28 to learn how to verify the Teradata QS version number. To locate detailed supported-release information: 1 Go to 2 Under Online Publications, click General Search. 3 Type 3119 in the Publication Product ID box. 4 Under Sort By, select Date. 5 Click Search. 6 Open the version of the Teradata Tools and Utilities ##.##.## Supported Platforms and Product Versions spreadsheet associated with this release. 1. If and when Teradata Database 14.0 is released, features may change. Teradata Query Scheduler Administrator Guide 3

4 Preface Prerequisites The spreadsheet includes supported Teradata Database versions, platforms, and product release numbers. 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 August Description Updated TQS release number from to Updated product release number to 14.0 for DBS. Updated product release number for TTU and its applications. Documentation updated to reflect that Windows 2000 support has been removed. 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 Administrator Guide

5 Preface Additional Information Type of Information Description Access to Information Release overview Late information Additional product information CD-ROM images Ordering information for manuals 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 web 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. Use the Teradata Information Products web site to order printed versions of manuals. 1 Go to 2 Under Online Publications, click General Search 3 Type 2029 in the Publication Product ID box. 4 Click Search. 5 Select the appropriate Release Definition from the search results. 1 Go to 2 Under the Online Publications subcategory, Browse by Category, click Data Warehousing. 3 Do one of the following: For a list of Teradata Tools and Utilities documents, click Teradata Tools and Utilities, and then select an item under Releases or Products. Select a link to any of the data warehousing publications categories listed. Specific books related to Teradata QS are as follows: Teradata Query Scheduler User Guide B mmyx Teradata SQL Assistant for Microsoft Windows User Guide B mmyx Teradata Tools and Utilities Installation Guide for Microsoft Windows B mmyx 1 Go to 2 Under the Online Publications subcategory, Browse by Category, click Data Warehousing. 3 Click CD-ROM Images. 4 Follow the ordering instructions. 1 Go to 2 Under Print & CD Publications, click How to Order. 3 Follow the ordering instructions. Teradata Query Scheduler Administrator Guide 5

6 Preface Additional Information Type of Information Description Access to Information General information about Teradata 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 a link. 6 Teradata Query Scheduler Administrator Guide

7 Table of Contents Preface Purpose Audience Supported Releases Prerequisites Changes to This Book Additional Information Chapter 1: Introduction About the Teradata QS Architecture What Does Teradata QS Do? What Are Scheduled Requests? How Are Scheduled Requests Processed? Request Checking Job Dispatching Job Execution What Can I Do with Teradata QS? How Do I Start the Teradata QS Server? How Do I Get Help? Chapter 2: Prerequisites System and Software Requirements Supported Client Operating Systems Required Client Software Optional Client Software Database Requirements Modify the HOSTS File Verify the Network Connection Teradata Query Scheduler Administrator Guide 7

8 Table of Contents Chapter 3: Navigate Teradata QS Administrator Menu Bar File Menu Configuration Menu Options Menu Servers Menu View Menu Help Menu Scheduled Requests List Sorting the Scheduled Requests List Using the Shortcut Menu Status Bar Chapter 4: Prepare the Teradata QS Database Run the TQS Setup Script New Installation Upgrade Installation Migrate the Teradata QS Database Chapter 5: Use the Teradata QS Administrator Open the Teradata Query Scheduler Administrator Open Teradata QS in View-Only Mode Exit the Teradata Query Scheduler Administrator Configure the Scheduled Requests View Teradata QS Server Status Configure Execution Time Frames Create and Edit Execution Time Frames Delete Execution Time Frames Set Up Workgroups Create and Edit Workgroups Delete Workgroups Manage Results File Storage Save Scheduled Requests Results Teradata Query Scheduler Administrator Guide

9 Table of Contents Create and Edit Results File Storage Locations Delete Results File Storage Locations Manage Scheduler Profiles Automatic Cleanup Create and Edit Scheduler Profiles Delete Scheduler Profiles Clean Up Scheduler Profiles View-Only Mode Chapter 6: Work with Scheduled Requests View Scheduled Requests Refresh the Scheduled Requests List Manage Scheduled Requests View SQL Statements for a Scheduled Request Change the Execute Time for a Scheduled Job Execute a Job Immediately Delete a Scheduled Request Cancel a Job Delete a Job Abort a Job Drop Results View Job Result Information Schedule Rejected Teradata SQL Assistant Queries Set Up Notifications Appendix A: About the Dialog Boxes Refresh Interval Dialog Box Results File Storage Dialog Box Results File Storage Properties Dialog Box Scheduler Profiles Dialog Box Workgroups Dialog Box Workgroup Properties Dialog Box Teradata Query Scheduler Administrator Guide 9

10 Table of Contents Glossary Index Teradata Query Scheduler Administrator Guide

11 List of Figures Figure 1: Teradata QS Client/Server Architecture Figure 2: Teradata Query Scheduler Administrator Figure 3: Teradata Query Scheduler Administrator Menu Bar Figure 4: Scheduled Requests List Figure 5: Teradata Query Scheduler Administrator Status Bar Figure 6: Refresh Interval Dialog Box Figure 7: Results File Storage Dialog Box Figure 8: Results File Storage Properties Dialog Box Figure 9: Scheduler Profiles Dialog Box Figure 10: Workgroups Dialog Box Figure 11: Workgroup Properties Dialog Box Teradata Query Scheduler Administrator Guide 11

12 List of Figures 12 Teradata Query Scheduler Administrator Guide

13 List of Tables Table 1: File Menu Table 2: Configuration Menu Table 3: Options Menu Table 4: Servers Menu Table 5: View Menu Table 6: Help Menu Table 7: Scheduled Requests List Table 8: Status Bar Table 9: Teradata Query Scheduler Admin Logon Dialog Box Description Table 10: Scheduler Profile Properties: Scheduling Tab Table 11: Scheduler Profile Properties: Results Tables/Files Tab Table 12: Scheduler Profile Properties: User Options Tab Table 13: Teradata QS Administrator Functions in View-Only Mode Table 14: Scheduled Requests List: Teradata Query Scheduler Administrator Table 15: Refresh Interval Dialog Box Description Table 16: Results File Storage Dialog Box Description Table 17: Results File Storage Properties Dialog Box Description Table 18: Scheduler Profiles Dialog Box Options Description Table 19: Workgroups Dialog Box Description Table 20: Workgroup Properties Dialog Box Description Teradata Query Scheduler Administrator Guide 13

14 List of Tables 14 Teradata Query Scheduler Administrator Guide

15 CHAPTER 1 Introduction Before using Teradata QS, it may be 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? How Do I Start the Teradata QS Server? How Do I Get Help? About the Teradata QS Architecture Teradata QS is designed to 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. See Figure 1. 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 ( ) Teradata Database System 2496B003 Teradata Query Scheduler Administrator Guide 15

16 Chapter 1: Introduction About the Teradata QS Architecture 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 End-users use the Teradata Query Scheduler Submit dialog box to submit single or multiple SQL statement requests for execution at a later date and time. They also use the Teradata Query Scheduler Viewer to manage the request results. The Teradata QS client library has the API for the Teradata QS Viewer. The Teradata QS communications library handles socket communication with the Teradata QS server. The DBA configures and views information about the state of the Teradata QS components in the client/server architecture from the Teradata Query Scheduler Operations utility. The Teradata Query Scheduler Operations utility is used to manage both the Teradata QS client and Teradata QS server software programs. The DBA uses the Teradata Query Scheduler Operations tool to configure and start the Teradata QS server before end-users can schedule SQL requests. To learn about the Teradata QS client components, see Teradata Query Scheduler User Guide. Teradata QS Server Components The server component includes: Teradata QS Administrator 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. The 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. Note: The TDWM database is shared by Teradata Dynamic Workload Manager (Teradata DWM). However, Teradata QS maintains its own tables within the TDWM database. For more information about Teradata DWM, see Teradata Dynamic Workload Manager User Guide. In prior versions of Teradata QS (Teradata DQM), the DBA used the administrator components to create and manage Teradata Database rules. This function has been moved to 16 Teradata Query Scheduler Administrator Guide

17 Chapter 1: Introduction What Does Teradata QS Do? Teradata DWM. Using the Teradata DWM, the DBA can set up rules that manage database access, increase database efficiency, and enhance workload capacity. Two types of flexible rules can be created that examine logon and query requests, and that can reject or delay query requests. What Does Teradata QS Do? Teradata QS provides a database request scheduling service. Queries are scheduled through client applications such as the Teradata Scheduler Viewer and Teradata SQL Assistant. For more information about Teradata Scheduler Viewer, see Teradata Query Scheduler User Guide. For more information about SQL Assistant, see Teradata SQL Assistant for Microsoft Windows User Guide. The Teradata QS Server accepts new requests, executes scheduled requests at specified times, and returns request information and status to clients. What Are Scheduled Requests? Scheduled requests are SQL queries scheduled by end-users for off-line execution. Requests are scheduled using the Teradata Query Scheduler Submit dialog box. When end-users know of existing database rules that will prevent a SQL request from running or if they suspect their queries may overload the Teradata Database, they can actively schedule a request using the Teradata Query Scheduler Submit dialog box. When a request is scheduled, end-users provide information that defines preferences for when it is executed. A request can be scheduled to run periodically or only once during a specified time period without an active system user connection. 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, a scheduled request can be defined to execute daily. That request causes a separate job to be created every day to execute that request. The DBA enables or disables the scheduled request feature on your Teradata Database using the Teradata Query Scheduler Administrator. To learn how to enable or disable the scheduled request feature, see Configure the Scheduled Requests on page 37. 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 Teradata Query Scheduler Administrator Guide 17

18 Chapter 1: Introduction How Are Scheduled Requests Processed? specified. Scheduled requests are subject to the same Teradata Database rule checking as are interactive requests. In addition, an execution time frame must be available during the time specified to execute the request. To learn more about execution time frames, see Configure Execution Time Frames on page 38. Scheduled requests are subject to three phases of processing: Request Checking Job Dispatching Job Execution Request Checking When a scheduled request is submitted, the Teradata QS server does the following: Job Dispatching Job Execution Uses the scheduling information the user provides as the intended start time for the request. Because a request may not be run until some time after the requested start time, a time interval in which the request may be run must also be specified. 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. 18 Teradata Query Scheduler Administrator Guide

19 Chapter 1: Introduction What Can I Do with Teradata QS? 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. 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. The result data is written to the results table/file. What Can I Do with Teradata QS? The Teradata QS Administrator is a Windows-based GUI (graphical user interface) that allows the DBA to set up and manage these Teradata QS features: Enable or disable scheduled requests. Create, delete, or modify time periods (called execution time frames) when scheduled requests are executed by Teradata QS. Create, delete, or modify workgroups that equitably distribute resources and scheduled requests workloads during execution time frames. Create, delete, or modify the locations where scheduled request results files are stored and accessed by all Teradata QS servers. Create, delete, or modify sets of scheduled request attributes (called profiles) for users, accounts, DBS roles, and DBS profiles. View, execute, cancel, immediately submit, abort, delete, or modify scheduled SQL requests and jobs to avoid adversely affecting a Teradata Database during prime usage periods. View Teradata QS scheduled request server status. Configure the behavior of scheduled requests using profiles. See Chapter 5: Use the Teradata QS Administrator to learn how to use these features. For detailed descriptions of the controls in this interface, see Chapter 3: Navigate Teradata QS Administrator Teradata QS has a view-only mode that allows users to log on without being an administrator. In view-only mode, the user can view Teradata QS settings, but cannot make changes. For more information on logging on in view-only mode, see Open the Teradata Query Scheduler Administrator on page 35. For a detailed description of the functionality of Teradata QS in view-only mode, see View-Only Mode on page 51. How Do I Start the Teradata QS Server? The Teradata Query Scheduler Operations tools are used to manage both the Teradata QS client and Teradata QS server software programs. The DBA must use the Teradata Query Teradata Query Scheduler Administrator Guide 19

20 Chapter 1: Introduction How Do I Get Help? Scheduler Operations tools to configure and start the Teradata QS server before end-users can schedule SQL requests. For instructions on starting the Teradata QS Server, see Teradata Query Scheduler User Guide. How Do I Get Help? Teradata QS online help answers questions about how to use Teradata QS features. Online help (including context-sensitive help) opens in a browser window. Microsoft Internet Explorer, version 6.0 or later, is the recommended browser for viewing online help and context-sensitive help. A browser other than the recommended browser might result in incorrectly displayed help. If using Microsoft Internet Explorer, version 7.0, see, To allow online help content to appear using Internet Explorer, version 7.0. To open online help From the Teradata Query Scheduler Administrator menu, click Help>Help Topics. The Help window opens. Use the tools available from the Help window to navigate to other topics. To open context-sensitive help From most windows and dialog boxes, press F1 to see context-sensitive help for the active window or dialog box. To allow online help content to appear using Internet Explorer, version 7.0 Use this procedure if a warning appears such as, To help protect your security, Internet Explorer has restricted this webpage from running scripts or ActiveX controls that could access your computer. 1 Open Microsoft Internet Explorer, version Click Tools>Internet Options. 3 Click the Advanced tab. 4 Under Security, click Allow active content to run in files on My Computer*, and click OK. 5 Close and then reopen Microsoft Internet Explorer for this change to take effect. 20 Teradata Query Scheduler Administrator Guide

21 CHAPTER 2 Prerequisites Before using Teradata QS, make sure your system is set up correctly. Also set up a Teradata CLIv2 (Call-Level Interface version 2) connection. Browse through the following topics to learn more: System and Software Requirements Modify the HOSTS File Verify the Network Connection For detailed installation information, see Teradata Tools and Utilities Installation Guide for Microsoft Windows. System and Software Requirements Teradata QS has the following system and software requirements: Supported Client Operating Systems Required Client Software Optional Client Software Database Requirements Supported Client Operating Systems Teradata QS client/server architecture can run on these operating systems: Client components running on Microsoft Windows 2003, XP, or Vista Server components running on Windows 2003, XP, or Vista Teradata QS Administrator running Windows 2003, XP, or Vista Required Client Software The following software must be installed on the 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 GSS (Generic Security Services) Teradata CLIv2 (Call-Level Interface version 2) release tdicu (Shared Common Components for Internationalization for Teradata) Teradata Query Scheduler Administrator Guide 21

22 Chapter 2: Prerequisites Modify the HOSTS File Optional Client Software Database Requirements The following software can be installed on the client system: Teradata ODBC Driver for Windows Install the Teradata ODBC driver for Windows 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 Teradata Query Scheduler User Guide to find out how Teradata SQL Assistant handles job results. Prior to running Teradata Query Scheduler 14.00, run the tqssetup.bteq script. The script installs important updates to the TDWM database. Teradata Query Scheduler requires Teradata Database V2R6.1 or later. Modify the HOSTS File If your site does not use a DNS, define the IP address and the Teradata Database name to use in the system HOSTS file of the workstation. To Define the System IP Address and Teradata Database Name 1 Open Windows Explorer and navigate to the HOSTS file in the subdirectory of the directory in which Windows is installed. 2 Open the HOSTS file in a text editor. 3 Add the IP address and the Teradata Database name with the COP1 suffix. 4 Save and exit the file. To ensure the network connection is correct, continue with Verify the Network Connection on page 22. Verify the Network Connection Use the following procedure to test the network connection before opening Teradata QS and connecting to a Teradata Database: To verify a network connection 1 Click Start and select Run. A Run dialog box appears. 22 Teradata Query Scheduler Administrator Guide

23 Chapter 2: Prerequisites Verify the Network Connection 2 In the Open text box, type the PING command followed by the name of the Teradata Database and the COP1 suffix. For example: PING ssscop1 Where sss is the Teradata Database to connect to. 3 If the PING command does not receive a successful response from the network, see the network administrator to determine the cause. Teradata Query Scheduler Administrator Guide 23

24 Chapter 2: Prerequisites Verify the Network Connection 24 Teradata Query Scheduler Administrator Guide

25 CHAPTER 3 Navigate Teradata QS Administrator Before using Teradata QS Administrator, familiarize yourself with the GUI (graphical user interface). After verifying that the system is set up and configured correctly, the Teradata Query Scheduler Administrator (Figure 2) is ready for use. The basic features of the Teradata Query Scheduler Administrator interface are: Figure 2: Teradata Query Scheduler Administrator The Menu Bar, located immediately below the title bar, is used to access all of the Teradata Query Scheduler Administrator commands. The Scheduled Requests List, located below the menu bar, shows all users scheduled requests and jobs. The Status Bar, located at the bottom of the window, shows information about the database status. See Chapter 5: Use the Teradata QS Administrator and Chapter 6: Work with Scheduled Requests to find out about using the Teradata Query Scheduler Administrator. To get familiar with the Teradata QS Administrator dialog boxes, see Appendix A: About the Dialog Boxes. Menu Bar Use the menu bar in the Teradata Query Scheduler Administrator (Figure 3) to access all functions and features in Teradata QS. Use your mouse or keyboard to select the commands in these menus: Teradata Query Scheduler Administrator Guide 25

26 Chapter 3: Navigate Teradata QS Administrator Menu Bar File Menu Configuration Menu Options Menu Servers Menu View Menu Help Menu Figure 3: Teradata Query Scheduler Administrator Menu Bar File Menu The following table describes the commands of the File menu. Table 1: File Menu Command Exit Description Disconnects from the Teradata Database and closes the Teradata Query Scheduler Administrator. Configuration Menu The following table describes the commands of the Configuration menu: Table 2: Configuration Menu Command Scheduler Profiles Workgroups Results File Storage Execution Time Frames Enable/Disable Scheduling Description Set up groups of users, accounts, DBS roles, and DBS profiles that are associated with Teradata QS profiles. Set up attributes for workgroups that control how many simultaneously executing SQL requests can be executed. Set up Windows directory paths to locations where Teradata QS servers can create and store results files. Set up time periods when scheduled SQL requests can be executed. Make SQL request scheduling available or unavailable. 26 Teradata Query Scheduler Administrator Guide

27 Chapter 3: Navigate Teradata QS Administrator Menu Bar Options Menu The following table describes the commands of the Options menu: Table 3: Options Menu Command Cancel Job Modify Execute Time Execute Now Abort Job Delete Request Delete Job Drop Results Job Information Show SQL Description Terminates a job with a Waiting status selected from the Scheduled Requests list. Specify a new schedule execution date and time for a job with a Waiting status selected from the Scheduled Requests list. Immediately run a job with a Waiting status selected from the Scheduled Requests list. Or immediately re-execute a job selected from the Scheduled Requests list that has failed for any reason. Terminate a job with an Executing status selected from the Scheduled Requests list. Remove the request selected from the Scheduled Requests list and all the related jobs. Remove the job selected from the Scheduled Requests list. Eliminate the results table or file for the job or request selected from the Scheduled Requests list. Show all of the data concerning how a job completed, such as rows returned, processing time, and more. Show the SQL statements for the job selected from the Scheduled Requests list. Servers Menu The following table describes the commands of the Servers menu: Table 4: Servers Menu Command Server Status Description View the condition of all Teradata QS servers in the Query Scheduler Server Status dialog box. View Menu The following table describes the commands and submenus of the View menu: Table 5: View Menu Command Submenu Description Refresh Now Immediately updates the information in the Scheduled Requests list. Teradata Query Scheduler Administrator Guide 27

28 Chapter 3: Navigate Teradata QS Administrator Scheduled Requests List Table 5: View Menu (continued) Command Submenu Description Interval Choose how frequently the Scheduled Requests list is automatically updated in the Refresh Interval dialog box. See Refresh the Scheduled Requests List on page 54 to learn how. Font Select the font for displaying the list of scheduled requests, the request SQL, and Teradata QS object names (Workgroups, File Storage areas, and so on) in the Font dialog box. Help Menu The Help menu has commands that provide access to online help and information about the version of the software installed on your computer. The following table lists the commands for the Help menu: Table 6: Help Menu Command Help Topics About Teradata QS Administrator Description Locate a topic by category in the contents tab of the online Help. View copyright and version information in the About Teradata Query Scheduler Administrator dialog box. To see copyright and version information 1 Click Help>About Teradata QS Administrator. The About Teradata Query Scheduler Administrator dialog box appears showing the product version and copyright dates. Note: Encryption status appears in this dialog box. By default, data encryption is disabled after installation. To enable or disable data encryption, select or clear the Data Encryption check box on the Teradata Query Scheduler Admin Logon dialog box. 2 Click OK to close the message. Scheduled Requests List The Scheduled Requests list in the Teradata Query Scheduler Administrator (Figure 4) shows information about all the scheduled requests and jobs in the TDWM database. It shows all of the scheduled jobs currently being handled by Teradata QS. Use the scroll bar to scroll through the items in the list. Select a job or request in the list, and then use the menu commands or the shortcut menu to monitor and manage it. 28 Teradata Query Scheduler Administrator Guide

29 Chapter 3: Navigate Teradata QS Administrator Scheduled Requests List Figure 4: Scheduled Requests List The following table describes the Scheduled Requests list: Table 7: Scheduled Requests List Column Header Request Name Request ID Job ID Scheduled User Name Status Information Description The name assigned to the job when it was submitted 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. Name of the user who submitted the scheduled request. Current standing of the job. Details about how the job completed, such as rows returned, processing time, database errors, and result file errors. Sorting the Scheduled Requests List Sort the information in the Scheduled Requests list using the following procedure. To sort the Scheduled Requests list Click any one of the column headings. The requests are sorted in ascending order. Using the Shortcut Menu Right-click any request in the Scheduled Requests list to display a shortcut menu with commands. Use the commands to monitor and manage the scheduled jobs and requests. Teradata Query Scheduler Administrator Guide 29

30 Chapter 3: Navigate Teradata QS Administrator Status Bar Status Bar The status bar at the bottom of the Teradata Query Scheduler Administrator (Figure 5) shows the following information: Table 8: Status Bar Option Status Database Time Database Date Time frame Description Status of the Teradata QS Administrator or an explanation of the currently selected menu item. The current database time. The current database date. The next Scheduled Request execution time frame. Figure 5: Teradata Query Scheduler Administrator Status Bar 30 Teradata Query Scheduler Administrator Guide

31 CHAPTER 4 Prepare the Teradata QS Database After Teradata Query Scheduler has been installed per instructions from Teradata Tools and Utilities Installation Guide for Microsoft Windows, the DBA runs a script to create scheduling tables for the TDWM database. This chapter provides the following topics: Run the TQS Setup Script Migrate the Teradata QS Database Run the TQS Setup Script The following sections summarize procedures to follow to prepare your system for using Teradata QS. The procedures vary based on whether Query Scheduler was resident on your system previously. Read these topics to learn more about installation: New Installation Upgrade Installation New Installation To run Teradata QS on a new installation of the Teradata Database (that is, one on which an earlier version of Teradata QS or Teradata DQM has not been installed), run the tqssetup.bteq script. The script creates scheduling tables in the TDWM database that Teradata QS uses to store scheduling information. To run the tqssetup.bteq script 1 Locate the tqssetup.bteq file. Note: The default location is C:\Program Files\Teradata\Teradata Query Scheduler Admin Open the tqssetup.bteq file in a text editor. 3 In the.logon statement, replace dbsname with the name of the Teradata Database whose tables you are upgrading to Save the file and exit the text editor. 5 Execute the script using BTEQ. See Basic Teradata Query Reference for instructions. After the tqssetup.bteq script has completed processing: Teradata Query Scheduler Administrator Guide 31

32 Chapter 4: Prepare the Teradata QS Database Migrate the Teradata QS Database Upgrade Installation From the Query Scheduler Administrator main window, enable scheduling, configure time frames, file storage, workgroups, and profiles. See: Configure the Scheduled Requests on page 37 Configure Execution Time Frames on page 38 Manage Results File Storage on page 42 Set Up Workgroups on page 40 Manage Scheduler Profiles on page 44 Using Query Scheduler Operations, configure Client and Server parameters. In particular, on the Server Parameters screen, fill in the Database Logon information so that Teradata QS communicates with the correct Teradata Database. Restart the Operations utility if prompted to do so, and then restart the server. After the server has started, in the Scheduler Viewer (client) application, use the Connect command to connect to a Teradata QS Server, and the Schedule SQL command to submit scheduled requests. Teradata QS supports upgrades from Teradata QS versions 6.1, 6.2, 12.0, 13.0, and Follow the instructions from Run the TQS Setup Script on page 31 to upgrade the scheduling tables by running the tqssetup.bteq script. To upgrade Teradata QS on a Teradata Database containing scheduled requests from version 6.1, 6.2, 12.0, 13.0 or Stop all running client (Viewer) applications. 2 Stop all running Teradata QS servers. 3 Install the Teradata QS Administrator package. (The client and server packages can also be installed at this time.) For instructions, see the Teradata Tools and Utilities Installation Guide for the appropriate operating system. 4 Run the tqssetup.bteq script to update the scheduler tables. 5 Proceed to Chapter 5 Use the Teradata QS Administrator on page 35. Migrate the Teradata QS Database If upgrading from Teradata QS 6.1, 6.2, 12.0, 13.0 or 13.10, migration is not necessary. However, the tqssetup.bteq script must be run to update the scheduler table definitions to release version See Run the TQS Setup Script on page Teradata Query Scheduler Administrator Guide

33 Chapter 4: Prepare the Teradata QS Database Migrate the Teradata QS Database To upgrade Teradata QS on a Teradata Database containing scheduled requests from version First upgrade from Teradata 6.0 to 12.0, as described in the section Migrating the Teradata QS Database of Teradata Query Scheduler Administrator Guide, version Note: You must perform the upgrade and migration to 12.0 before continuing. 2 Upgrade from Teradata QS 12.0 to Teradata using the tqssetup.bteq script. See Run the TQS Setup Script on page 31. Teradata Query Scheduler Administrator Guide 33

34 Chapter 4: Prepare the Teradata QS Database Migrate the Teradata QS Database 34 Teradata Query Scheduler Administrator Guide

35 CHAPTER 5 Use the Teradata QS Administrator After setting up or migrating your Teradata QS database, begin using the Teradata QS Administrator. Configure the scheduled requests feature using the Teradata Query Scheduler Administrator, as well as manage scheduled request, user profiles, and execution time frames. Browse through these topics to learn more: Open the Teradata Query Scheduler Administrator Exit the Teradata Query Scheduler Administrator Configure the Scheduled Requests View Teradata QS Server Status Configure Execution Time Frames Set Up Workgroups Manage Results File Storage Manage Scheduler Profiles Open the Teradata Query Scheduler Administrator Before using Teradata Query Scheduler Administrator, connect to the Teradata QS database, TDWM. This section explains how to connect to the TDWM database and start Teradata Query Scheduler Administrator. The following procedure assumes Teradata QS is installed and your Teradata Database connection is configured. To start Teradata Query Scheduler Administrator 1 From your desktop, click Start>Programs Teradata Query Scheduler Admin 14.0>Administrator. The Teradata Query Scheduler Admin Logon dialog box appears. Teradata Query Scheduler Administrator Guide 35

36 Chapter 5: Use the Teradata QS Administrator Open the Teradata Query Scheduler Administrator 2 Complete the following options in the Teradata Query Scheduler Admin Logon dialog box: Table 9: Teradata Query Scheduler Admin Logon Dialog Box Description Option Database Name box User Name box Password box Mechanism list box Parameter box Session Character Set list box Use Data Encryption check box Description Enter the name of the Teradata Database to use for scheduled SQL requests. Shows the default user name tdwm. If logging on as an Teradata QS admin, use this default. If logging on in view-only mode, enter the user name associated with the database name. See Open Teradata QS in View-Only Mode on page 36 for more details. Enter the password associated with the user specified in the User Name box. Select the authentication mechanism (for example, TD2) to be used for logon. The default is blank, representing the standard Teradata (TD2) mechanism. Enter the authentication string to be used with the mechanism specified. If the specified mechanism does not require this string, leave the box empty. Select the Teradata session character set under which Administrator tasks will execute. On a Kanji system (having KANJI1 database object names), select the KANJISJIS_0S character set. Click or clear, based on whether to encrypt data through CLIv2. The default setting is checked, meaning data is encrypted when passed over the network between the Teradata QS Administrator and the Teradata Database. Note: Encryption between the Teradata QS Administrator and the Teradata Database can also be enabled via the clispb.dat file, as described in the Teradata Call-Level Interface Version 2 Reference for Network-Attached Systems. 3 Click OK. Teradata QS Administrator connects the Teradata Database and displays the list of scheduled requests. To disconnect from the Teradata QS database and exit the Teradata Query Scheduler Administrator, see Exit the Teradata Query Scheduler Administrator on page 37. Open Teradata QS in View-Only Mode View-only mode allows users other than an administrator to log on to Teradata QS and view settings. The following procedure explains how to open Teradata QS in view-only mode. For more information about the functionality of Teradata QS in view-only mode, see View-Only Mode on page Teradata Query Scheduler Administrator Guide

37 Chapter 5: Use the Teradata QS Administrator Exit the Teradata Query Scheduler Administrator To Open Teradata QS in View-Only Mode 1 From the desktop, click Start>Programs>Teradata Query Scheduler Admin 14.0>Administrator. The Teradata Query Scheduler Admin Logon dialog box appears. 2 Enter the database name and the associated user name and password. For more information on the remaining options, see Table 9 on page 36. When logged onto Teradata QS as a non-administrator (user name other than tdwm), Teradata QS opens in view-only mode. For more information on the functionality in viewonly mode, see View-Only Mode on page 51. Exit the Teradata Query Scheduler Administrator The following section explains how to exit Teradata QS Administrator. To exit the Teradata Query Scheduler Administrator Click Command>Exit. The Teradata QS server disconnects and the Teradata Query Scheduler Administrator closes. Configure the Scheduled Requests The scheduled requests feature allows any user to submit SQL requests for scheduled execution. The DBA must enable the feature on your Teradata Database system before SQL requests can be scheduled or processed. To enable scheduled requests Click Configuration>Enable Scheduling. To disable scheduled requests using the Teradata QS Administrator Click Configuration>Disable Scheduling. View Teradata QS Server Status Teradata Query Scheduler Administrator Guide 37

38 Chapter 5: Use the Teradata QS Administrator Configure Execution Time Frames View the status of all Teradata QS Servers on your Teradata Database. To see the status of the Teradata QS Servers on your system 1 Click Servers>Servers Status The Query Scheduler Server Status dialog box appears. Note: Delete is available only after selecting an item from the Servers list. 2 Click Close to exit the Teradata QS Server Status dialog box and return to the Teradata QS Administrator. To delete an inactive Teradata QS Server 1 Click Servers>Server Status. The Query Scheduler Server Status window opens. 2 Select a server from the Servers list. Note: Delete is available only after selecting an item from the Servers list. 3 Click Delete. Information about that server is removed from the tables in the TDWM database. 4 Click Close to exit the Query Scheduler Server Status window and return to the Teradata Query Scheduler Administrator. Configure Execution Time Frames The DBA controls when scheduled SQL requests are executed on the system by defining and enabling execution time frames. An execution time frame is a period of time in which scheduled SQL requests are permitted to run and when the Teradata QS server will attempt to execute any scheduled requests. 38 Teradata Query Scheduler Administrator Guide

39 Chapter 5: Use the Teradata QS Administrator Configure Execution Time Frames After creating an execution time frame, the DBA must make it available on your Teradata Database system. Scheduled requests are not accepted or run unless an execution time frame is available. When a user submits a request for scheduling, Teradata QS determines whether there are any execution time frames available during the scheduled time period. If no execution time frames are available and the maximum start interval is exceeded, then the request is not scheduled. Although multiple execution time frames can be created and enabled, only the primary Teradata QS server actually dispatches and executes the scheduled requests. Create and Edit Execution Time Frames To create or edit an execution time frame 1 Click Configuration>Execution Time Frames. The Execution Time Frame Names dialog box appears. 2 Do one of the following: To modify an existing time frame, select the desired time frame from the Time Frame Names list, and then click Edit. Go to Step 4. Note: The Edit and Delete buttons are available only when a time frame is selected from the list. To create a new time frame, click New. The Time Frame Properties dialog box appears. 3 Type the name of the new time frame in the Time Frame Name box. Time frame names cannot contain single quotes. Note: If editing an execution time frame, the Time Frame Name box is read-only. 4 Do one of the following: Teradata Query Scheduler Administrator Guide 39

40 Chapter 5: Use the Teradata QS Administrator Set Up Workgroups Select the Enable Time Frame check box to make the time frame available. (By default, this control is not selected.) Clear the Enable Time Frame check box to make the time frame unavailable. 5 Do one of the following: To make the time frame effective each day of the week, leave the Everyday check box selected. (By default, this control is selected.) To select specific days when the time frame is in effect, clear the Everyday check box and select the desired days using the boxes in the Days frame. 6 Using a 24 hour format, enter the hour the time frame is to begin in the From box. 7 Enter the hour the time frame is to end in the To box. 8 Click OK to save your entries and close the Time Frame Properties dialog box. The new time frame appears in the Time Frame Names list in the Execution Time Frames dialog box. 9 Click Close to close the Execution Time Frames dialog box and return to the Teradata Query Scheduler Administrator. Delete Execution Time Frames To delete an execution time frame 1 Click Configuration>Execution Time Frames. The Execution Time Frames dialog box appears. 2 Select the time frame to delete from the Time Frame Names list. 3 Click Delete. 4 Click Yes to confirm the deletion and close the message box. The time frame no longer appears in the Time Frame Names list. 5 Click Close to close the Execution Time Frames dialog box and return to the Teradata Query Scheduler Administrator. Set Up Workgroups A workgroup represents a collection of related scheduled requests for a number of users, accounts, roles, and profiles. The DBA can create, edit, or delete any number of workgroups that equitably distribute resources and scheduled requests workloads during execution time frames. Assign a maximum number of requests that can be simultaneously executing from each workgroup. This ensures that a fair share of the scheduled work gets done within the execution time frames for all workgroups. 40 Teradata Query Scheduler Administrator Guide

41 Chapter 5: Use the Teradata QS Administrator Set Up Workgroups Create and Edit Workgroups To create or edit a workgroup 1 Click Configuration>Workgroups. The Workgroups dialog box appears with DEFAULT_WORKGROUP in the Workgroup Names list. Note: When creating or modifying a scheduled requests profile for a user, user group, or account, select a workgroup to associate with the profile. See Manage Scheduler Profiles on page 44 for more information. 2 Do one of the following: To modify an existing workgroup, select the desired workgroup from the Workgroup Names list, and then click Edit. Go to Step 4. Note: The Edit and Delete buttons are available only after a workgroup is selected from the list. To create a new workgroup, click New. The Workgroup Properties dialog box appears. 3 Type up to 30 characters for the name of your workgroup in the Workgroup Name box. Note: If editing a workgroup, the Workgroup Name box is read-only. 4 In the Maximum queries running simultaneously box, enter a number between 0 and 28 to limit the number of concurrent queries that can be run by this workgroup. 5 Click OK to save your entries and close the Workgroup Properties dialog box. The workgroup appears in the Workgroup Names list in the Workgroups dialog box. 6 Click Close to close the Workgroups dialog box and return to the Teradata Query Scheduler Administrator. Teradata Query Scheduler Administrator Guide 41

42 Chapter 5: Use the Teradata QS Administrator Manage Results File Storage Delete Workgroups When deleting a workgroup, make sure it is not being referenced by a scheduler profile. If it is, change the scheduler profile to reference a different work group or delete the scheduler profile. To change the scheduler profile, Manage Scheduler Profiles on page 44. To delete the scheduler profile, see Delete Scheduler Profiles on page 50. To delete a workgroup 1 Click Configuration>Workgroups. The Workgroups dialog box appears. 2 Select the workgroup to delete from the Workgroup Names list. Note: The Edit and Delete buttons are available only after selecting a workgroup from the list. 3 Click Delete. 4 Click Yes to confirm the deletion and close the message box. The workgroup no longer appears in the Workgroup Names list in the Workgroups dialog box. 5 Click Close to close the Workgroups dialog box and return to the Teradata Query Scheduler Administrator. Manage Results File Storage Results file storage is a symbolic name for a file system directory where scheduled requests results files are stored. To save the results of scheduled requests in flat text files, the storage location must be designated. Create, edit, or delete any number of locations where scheduled request results files are stored and accessed by all Teradata QS servers. Each results file storage location has a specified Windows path. The same Windows path is used by all active Teradata QS servers so that they can all access the results files at the same location. This requires that all Teradata QS scheduled requests servers must have access to the Windows path(s) that describe the results file storage location(s). Profiles additionally contain an optional relative path that is used to reference a subdirectory name for the desired profile. Teradata QS joins the appropriate results file storage location path with the relative profile path to create a valid directory name for a Windows system for the desired profile. For the Teradata QS server to read and write to the results files in the location the DBA specifies, the DBA needs to set up the appropriate Windows privileges for the server. See Create and Edit Results File Storage Locations on page 43 for instructions on specifying a results file storage location. For instructions on setting up Windows privileges, see the Teradata Query Scheduler User Guide. In the topic, Managing the Teradata QS Server, specifically read Supporting Results Files. 42 Teradata Query Scheduler Administrator Guide

43 Chapter 5: Use the Teradata QS Administrator Manage Results File Storage If the last, or only, statement in a scheduled request is a SELECT statement, it generates a result set that can be captured and saved by Teradata QS. Results from a scheduled request can be saved to a new or existing database table, or to a file specified when the request was created. The user controls whether any existing data is destroyed. For database tables, Teradata QS can create a table with the appropriate column types for the result data. Save Scheduled Requests Results To save scheduled requests results into files 1 Ensure all disk drives on which results files are stored by Teradata QS servers are identically available to all Teradata QS server systems on Windows. This enables any Scheduled Request client to connect to any Teradata QS Server to retrieve their results. 2 Ensure all results file storage locations are configured so they have the same path on all server systems. This is easier to manage than configuring a different results location for every server. To save scheduled requests results to a file in a shared network directory 1 Configure the Teradata QS Server to run as a user with network access privileges and write and read access to the specified directory. 2 From your desktop, click Start>Administrative Tools>Computer Management. 3 Select Services under Services and Applications in the directory tree. 4 From the list of services, select TQS Server and click Properties or right-click and select Properties from the shortcut menu. 5 In the TQS Server Properties dialog box, click the Log On tab. 6 Click This Account and fill in the domain/username and password boxes. Note: Be sure the user specified is a member of the Windows Administrators group. 7 Click OK to save your changes. Create and Edit Results File Storage Locations To create and edit results file storage locations 1 Click Configuration>Results File Storage. The Results File Storage dialog box appears with a DEFAULT_FILE_STORAGE appearing in the File Storage Names list. 2 Do one of the following: To modify an existing file storage location, select the name from the File Storage Names list, and then click Edit. Go to Step 4. Teradata Query Scheduler Administrator Guide 43

44 Chapter 5: Use the Teradata QS Administrator Manage Scheduler Profiles Note: The Edit and Delete buttons are available only after a name is selected from the list. To create a new file storage location, click New. The Results File Storage Properties dialog box appears. 3 Type a name for the results file storage in the Results File Storage box. Note: If editing a file storage location, the Results File Storage box is read-only. 4 Type the directory where this file storage is to be located in the Windows Results Directory box. 5 Click OK to save your entries and close the Results File Storage Properties dialog box. The storage location appears in the File Storage Names list in the Results File Storage dialog box. 6 Click Close to exit the Results File Storage dialog box and return to the Teradata Query Scheduler Administrator. Delete Results File Storage Locations To delete a results file storage location 1 Click Configuration> Results File Storage. The Results File Storage dialog box appears. 2 Select the file storage location that will be deleted from the File Storage Names list. Note: The Edit and Delete buttons are available only after selecting a file storage location from the list. 3 Click Delete. 4 Click Yes to confirm the deletion and close the message box. The storage location no longer appears in the File Storage Names list in the Results File Storage dialog box. Click Close to close the Results File Storage dialog box and return to the Teradata Query Scheduler Administrator. Manage Scheduler Profiles Profiles are used to control scheduled requests submitted to your Teradata QS Server. A profile is a set of parameters assigned to individual users, accounts, Teradata Roles, or Teradata Profiles that determines what scheduling capabilities are available and how your Teradata QS Server handles their scheduled requests. A default user profile is created and reserved by Teradata QS during installation and is used when a user is not assigned to a user profile, a group profile, or an account profile. The default user profile cannot be deleted, but it can be changed. 44 Teradata Query Scheduler Administrator Guide

45 Chapter 5: Use the Teradata QS Administrator Manage Scheduler Profiles Automatic Cleanup Using the Job History box in the profile, specify the length of time that records of scheduled request jobs will be saved before being automatically deleted from the system. Users can also delete their own completed jobs at any time. Using the Results Duration box in the profile, specify the length of time that the users results data tables and files can be kept, if not updated, before being automatically deleted by Teradata QS. Create and Edit Scheduler Profiles To create or edit a scheduler profile 1 Click Configuration>Scheduler Profiles. The Scheduler Profiles dialog box appears. 2 From the Select Type list, choose one of the following types of scheduler profiles to create: Account Profile Role User 3 Do one of the following: If creating a new profile, click New. If editing an existing profile, click Edit. The Scheduler Profile Properties dialog box appears with the Scheduling tab selected by default. Teradata Query Scheduler Administrator Guide 45

46 Chapter 5: Use the Teradata QS Administrator Manage Scheduler Profiles 4 Complete the following options in the Scheduling tab: Table 10: Scheduler Profile Properties: Scheduling Tab Option Profile Type Name Allowed Scheduling Workgroup Description (Read-only) See the profile type chosen from the Select Type list on the Scheduler Profiles dialog box. (Read-only) See the name of the Teradata Database object selected from the Objects list on the Scheduler Profiles dialog box. Select the types of query requests that can be scheduled by this profile: No scheduling: Disables scheduling. No requests can be scheduled, effectively disabling the feature for this user, group, or account. Onetime only: Runs the request once. Onetime & Recurring: Runs the request more than once such as daily, weekly, or monthly. Select the workgroup specification indicating which scheduled request workgroup the profile should use. The default is DEFAULT_WORKGROUP. The administrator configures the workgroup specification in the Settings dialog box. 46 Teradata Query Scheduler Administrator Guide

47 Chapter 5: Use the Teradata QS Administrator Manage Scheduler Profiles Table 10: Scheduler Profile Properties: Scheduling Tab (continued) Option Start Interval Job History Description Specify the greatest length of time from the submitted start time that a job can begin to run in days and hours. Default value is one day. New requests are not accepted if there is no time between the start time and the maximum start interval that a request can execute due to rules and/or unavailability of an execution time frame. Specify the number of days between 1 and 365 that job records are retained before Teradata QS automatically deletes them. 5 Select the Results Tables/Files tab. 6 Complete the following options in the Results Tables/Files tab to set up results parameters: Teradata Query Scheduler Administrator Guide 47

48 Chapter 5: Use the Teradata QS Administrator Manage Scheduler Profiles Table 11: Scheduler Profile Properties: Results Tables/Files Tab Option Allowed Results Type Description Select the location where results of a scheduled request are stored: Save in database: Stores the results in a database table. Save in file: Stores the results in a file. Save in database or file: Stores the results in a database table, a file, or either. If selecting this option, the user can choose the destination when scheduling a request. Results Tables Parameters Results Database Create as Fallback Create as Multiset Append user name Specify the name of the results database to use as the default. This is the name of the database in which the Teradata QS Server stores the results. This option cannot be used if Save in file was selected as the Allowed Results Type. Specify that the results table is created with the fallback attribute. This option cannot be used if Save in file was selected as the Allowed Results Type. Specify that the results table is created with the multiset attribute. This option cannot be used if Save in file was selected as the Allowed Results Type. Have Teradata QS to automatically append the user name to the results table. This option cannot be used if Save in file was selected as the Allowed Results Type. Note: When the same results database is used by multiple users, the results table name is modified to include the user name to avoid duplicates if this check box is selected. Results Files Parameters Storage Location Optional Sub-Directory Field Separator Character Max File Size Results Duration Select the results file storage specification where to store results files. This option cannot be used if Save in database was selected as the Allowed Results Type. Configure the file storage location from the Results File Storage Properties dialog box. See Manage Results File Storage on page 42 to learn how. Specify a relative path beneath the results file storage location where results from this profile are stored. The Teradata QS Server joins the directory corresponding to the selected results file storage path and this relative path to form the full directory path where results are stored. This option cannot be used if Save in database was selected as the Allowed Results Type. Select the character to use to separate record fields when results are saved in a file. This option cannot be used if Save in database was selected as the Allowed Results Type. Specify the greatest number of bytes (in thousand bytes) allowed for a results file. This option cannot be used if Save in database was selected as the Allowed Results Type. Specify the number of days between 1 and 365 that results tables or files are retained before they are automatically deleted by Teradata QS. The timestamp for results is reset when the results are replaced or appended to. 48 Teradata Query Scheduler Administrator Guide

49 Chapter 5: Use the Teradata QS Administrator Manage Scheduler Profiles 7 Select the User Options tab. 8 Complete the following options in the User Options tab: Table 12: Scheduler Profile Properties: User Options Tab Option Modify start interval Modify results database name Modify create Table as Fallback option Modify create Table as Multiset option Modify results File field separator character Description Allow users to modify the maximum start interval in the Query Scheduler Submit dialog box. Allow users to modify the results database in the Query Scheduler Submit dialog box. Allow users to modify the Create as Fallback option in the Query Scheduler Submit dialog box when saving results to a table. Allow users to modify the Create as Multiset option in the Query Scheduler Submit dialog box when saving results to a table. Allow users to modify the Field Separator character for results files in the Query Scheduler Submit dialog box when saving results to a file. 9 Click OK. 10 Click Close to close the Scheduler Profiles dialog box and return to the Teradata Query Scheduler Administrator. Teradata Query Scheduler Administrator Guide 49

50 Chapter 5: Use the Teradata QS Administrator Manage Scheduler Profiles Delete Scheduler Profiles To delete a scheduler profile 1 Click Configuration>Scheduler Profiles. The Scheduler Profiles dialog box appears. 2 Select the profile to delete from the Objects list. Note: Delete is available only when the item selected has a scheduler profile associated with it. 3 Click Delete. Clean Up Scheduler Profiles A message box appears prompting confirmation of the deletion. 4 Click Close to exit the Scheduler Profiles dialog box and return to the Teradata Query Scheduler Administrator. To clean up scheduler profiles 1 Click Configuration>Scheduler Profiles. The Scheduler Profiles dialog box appears. 2 Click Cleanup. 3 Click Close to exit the Scheduler Profiles dialog box and return to the Teradata Query Scheduler Administrator. Teradata QS finds and deletes all scheduler profiles associated with Teradata Database objects that no longer exist. 50 Teradata Query Scheduler Administrator Guide

51 Chapter 5: Use the Teradata QS Administrator Manage Scheduler Profiles View-Only Mode View-only mode allows users, other than TDWM admin, to log on to Teradata QS Administrator and view settings. In view-only mode, the user can open Teradata QS Administrator, view the settings, but cannot make changes. The following section explains the functions for view-only mode. Table 13: Teradata QS Administrator Functions in View-Only Mode Function Sub Menu Description of Use in View-Only Mode Logon dialog None Database: Enter the name of a Teradata Database. User Name: Enter the name of a Teradata user associated with the Teradata Database. Use the default TDWM for full administrative access to the Teradata QS Administrator settings, or enter a different user name for viewonly access. Password: Enter the password associated with the name entered into the User Name box. For more information on logging into Teradata QS in view mode, see Open the Teradata Query Scheduler Administrator on page 35. Configuration Scheduler Profiles Workgroups Results File Storage Execution Time Frames TDWM can create, edit and delete scheduler profiles. View-only users can only view the existing settings. View replaces Edit in view-only mode. View opens the Scheduler Profile Properties dialog so existing profiles can be viewed. View is available if an item from the drop down menu has an existing scheduler profile. TDWM can create, edit and delete workgroups. View-only users can only view the settings in workgroups. View replaces Edit for users other than TDWM. Description: Opens the Workgroup Properties dialog box where an existing workgroup can be viewed. Workgroup Properties Dialog Box: all options are read-only for users other than TDWM. TDWM can create, edit and delete results file storage. View-only users can only view the existing settings. View is available in view-only mode. View opens the Results File Storage Properties dialog to view an existing file storage mapping. View replaces the Edit in view-only mode. TDWM can create, edit and delete time frames. View-only users can only view these settings. Options None There are no options available in view-only mode. Server Server Status View-only users can see the Teradata QS Server status, but Delete is available only to the TDWM user. Teradata Query Scheduler Administrator Guide 51

52 Chapter 5: Use the Teradata QS Administrator Manage Scheduler Profiles Table 13: Teradata QS Administrator Functions in View-Only Mode (continued) Function Sub Menu Description of Use in View-Only Mode View Refresh Refresh options are available in view-only mode. See View Menu on page 27 for more information on using this option. Font Font controls are available in view-only mode. See View Menu on page 27 for more information on using this option. Help None The items under the Help menu are available in view-only mode. 52 Teradata Query Scheduler Administrator Guide

53 CHAPTER 6 Work with Scheduled Requests The Teradata Query Scheduler Administrator offers a number of features that help to manage scheduled requests, user profiles, and execution time frames. Browse through these topics to learn more: View Scheduled Requests Manage Scheduled Requests Schedule Rejected Teradata SQL Assistant Queries Set Up Notifications View Scheduled Requests To view all scheduled SQL requests in your system Start the Teradata Query Scheduler Administrator and connect to the Teradata Database. For instructions, see Open the Teradata Query Scheduler Administrator on page 35. After connecting to the Teradata Database, all scheduled requests are retrieved and appear in the Scheduled Requests list of the Teradata Query Scheduler Administrator. (See Figure 4 on page 29). View the following information for each of the scheduled jobs currently in the system: Table 14: Scheduled Requests List: Teradata Query Scheduler Administrator Column Name Request Name Request ID Job ID Scheduled User Name Status Information Description The name assigned to the request when it was submitted 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. Name of the user who submitted the scheduled request. Current standing of the job. Details about how the job completed, such as rows returned, processing time, database errors, and result file errors. Teradata Query Scheduler Administrator Guide 53

54 Chapter 6: Work with Scheduled Requests View Scheduled Requests Refresh the Scheduled Requests List Before working with scheduled requests, jobs, and results, the DBA can set the rate at which the Scheduled Requests list is updated from the Teradata QS server. Although refresh is a background process, it still adds to network traffic. Set the rate as low as possible. Immediate Refresh To immediately refresh the Scheduled Requests List Click View>Refresh>Now. The Scheduled Requests list is updated with information from the Teradata QS server. Refresh Rate To set the Refresh rate 1 Click View> Refresh>Interval. The Refresh Interval dialog box appears. For information about the Refresh Interval dialog box, see Appendix A: About the Dialog Boxes. 2 Select the Set Refresh Interval check box. 3 Type an interval between 5 and 99 in the Refresh every box. 4 Click the Minute or the Hour option to set the refresh rate. 5 Click OK to close the Refresh Interval dialog box, and return to the Teradata Query Scheduler Administrator. Begin working with the scheduled jobs and requests. To learn more, see Manage Scheduled Requests on page Teradata Query Scheduler Administrator Guide

55 Chapter 6: Work with Scheduled Requests Manage Scheduled Requests Manage Scheduled Requests To some extent, the DBA can control which scheduled request jobs are executed by canceling any job waiting to execute or forcing a job to execute immediately. The DBA can also view, abort, delete, or modify scheduled SQL requests and jobs to avoid adversely affecting a Teradata Database during prime usage periods. View SQL Statements for a Scheduled Request Use the Show SQL command to see the SQL statements for any request in the Scheduled Requests list. To see the SQL statements for a scheduled request 1 From from the Scheduled Jobs list of the Teradata Query Scheduler Administrator, select a job. 2 Do one of the following: Click Options>Show SQL. Right-click the job to display a shortcut menu and click Show SQL. The Show SQL dialog box appears showing the SQL statements used in the request. 3 View the information and click OK to close the Show SQL dialog box and return to the Teradata Query Scheduler Administrator. Change the Execute Time for a Scheduled Job Use the Modify Execute Time command to change the execute time for a job with a Waiting status in the Scheduled Requests list. To change the execute time for a scheduled job 1 From the Scheduled Requests list of the Teradata Query Scheduler Administrator, select a job with a Waiting status. 2 Do one of the following: Click Options>Modify Execute Time. Right-click the job to display a shortcut menu and click Modify Execute Time. The Change Start Time dialog box appears. 3 Enter a new start time using the Hour and Minute boxes. 4 Click OK to close the dialog box and return to the Teradata Query Scheduler Administrator. Teradata Query Scheduler Administrator Guide 55

56 Chapter 6: Work with Scheduled Requests Manage Scheduled Requests Execute a Job Immediately Use the Execute Now command to immediately run for a job with a Waiting status in the Scheduled Requests list. Also use the same command to re-execute jobs that have failed for any reason. Jobs submitted for immediate execution are still subject to database management rules. To immediately execute a scheduled job 1 From the Scheduled Requests list of the Teradata Query Scheduler Administrator, select a job with a Waiting status or any job that failed to execute. 2 Do one of the following: Click Options>Execute Now. Right-click the job to display a shortcut menu, and click Execute Now. A Teradata Query Scheduler Administrator dialog box appears asking for confirmation. 3 Click Yes to confirm the execution, close the dialog box, return to the Teradata Query Scheduler Administrator, and execute the query. Delete a Scheduled Request Use the Delete Request command to delete a scheduled request. Deleting unwanted jobs saves database space. When a request is deleted, all jobs associated with that request are deleted. To delete a request 1 From from the Scheduled Requests list of the Teradata Query Scheduler Administrator, select a request. 2 Do one of the following: Click Options>Delete Request. Right-click the request to display a shortcut menu and click Delete Request. A Teradata Query Scheduler Administrator dialog box appears asking for confirmation. 3 Click Yes to confirm the deletion and close the dialog box. A Teradata Query Scheduler Administrator message appears indicating the request was deleted. 4 Click OK to close the dialog box and return to Teradata Query Scheduler Administrator. Cancel a Job Use the Cancel Job command, to cancel the scheduled execution of any selected job in a Waiting status. 56 Teradata Query Scheduler Administrator Guide

57 Chapter 6: Work with Scheduled Requests Manage Scheduled Requests After a job is cancelled, it cannot be restarted. If the job is for a recurring request, a new job is automatically generated by Teradata QS server before the next day. Otherwise, a new scheduled request must be submitted. To cancel a job 1 From from the Scheduled Requests list of the Teradata Query Scheduler Administrator, select a job in a Waiting status. 2 Do one of the following: Click Options>Cancel Job. Right-click the job to display a shortcut menu and click Cancel Job. A Teradata Query Scheduler Administrator dialog box appears asking for confirmation. 3 Click Yes to confirm the cancellation and close the dialog box. Admin Cancelled appears under the Status column of the Jobs list in the Teradata Query Scheduler Administrator for the cancelled job. Delete a Job Use the Delete Job command to delete any job that has completed successfully or unsuccessfully. If a completed job is deleted for a recurring request, the scheduled request is still available in the system. Deleting completed jobs allows for faster updates of the Scheduled Requests list. Jobs are also periodically deleted as specified using the Teradata Query Scheduler Administrator. To delete a job 1 From from the Scheduled Requests list of the Teradata Query Scheduler Administrator, select any completed job. 2 Do one of the following: Click Options>Delete Job. Right-click the job to display a shortcut menu and click Delete Job. A Teradata Query Scheduler Administrator dialog box appears asking for confirmation. 3 Click Yes to confirm the deletion and close the dialog box. A Teradata Query Scheduler Administrator message appears indicating the job was deleted. 4 Click OK to close the dialog box and return to Teradata Query Scheduler Administrator. Abort a Job Use the Abort Job command to terminate any job with an Executing status. For example, abort a job because the job is tying up Teradata Database resources. Teradata Query Scheduler Administrator Guide 57

58 Chapter 6: Work with Scheduled Requests Manage Scheduled Requests To abort a job 1 From from the Scheduled Requests list of the Teradata Query Scheduler Administrator, select a job with an Executing status. 2 Do one of the following: Click Options>Abort Job. Right-click the job to display a shortcut menu and click Abort Job. A Teradata Query Scheduler dialog box appears asking for confirmation. 3 Click Yes to confirm the deletion and close the dialog box. Drop Results Use the Drop Results command to drop the results table or file associated with the selected request or job. Dropping results cleans up tables or files generated for that request or job. To use the same results table or file for each request, the results must be dropped. The Drop if exists or Append if exists options can also be used to drop results when scheduling requests. For information on that option, see Teradata Query Scheduler User Guide. To drop results 1 From from the Scheduled Requests list of the Teradata Query Scheduler Administrator, select a job. 2 Do one of the following: Click Options>Drop Results. Right-click the request to display a shortcut menu and click Drop Results. A Teradata Query Scheduler Administrator dialog box appears confirming the deletion. 3 Click Yes to confirm the deletion, close the dialog box, and return to Teradata Query Scheduler Administrator. The results of the scheduled request are dropped and have been removed from the TDWM database. View Job Result Information Frequently the text in the Information column of the Jobs list is too long to be completely visible in the list. Use the Job Information command to view the entire text. To view job result information 1 From from the Scheduled Requests list of the Teradata Query Scheduler Administrator, select a job. 2 Do one of the following: Click Options>Job Information. 58 Teradata Query Scheduler Administrator Guide

59 Chapter 6: Work with Scheduled Requests Schedule Rejected Teradata SQL Assistant Queries Right-click the job to display a shortcut menu and click Job Information. A Job Result Information message appears displaying the entire job information text. 3 Click OK to close the message box and return to the Teradata Query Scheduler Administrator. Schedule Rejected Teradata SQL Assistant Queries End-users 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 workload management restrictions (Teradata DWM statuses ), the DBA can make the Teradata Query Scheduler Submit dialog box available so the end-user can re-schedule the request. To learn how to set up this option, see the Teradata Query Scheduler User Guide. For more information about Teradata DWM rules, see Teradata Dynamic Workload Manager User Guide. Set Up Notifications When creating a scheduled request, end-users can specify an address where Teradata QS will send a notification message when a request has completed its execution, successfully or unsuccessfully. Users specify their addresses in the Teradata Query Scheduler Submit Requests dialog box. For more information, refer to the Teradata Query Scheduler User Guide. Because Teradata QS uses Teradata Viewpoint to generate notifications, Teradata Viewpoint must first be installed and configured. See Teradata Viewpoint documentation for more information. For instructions on setting up, viewing, and managing alerts, see Teradata Viewpoint Alert Setup and Teradata Viewpoint Alert Viewer documentation, in addition to the Teradata Query Scheduler User Guide. Teradata Query Scheduler Administrator Guide 59

60 Chapter 6: Work with Scheduled Requests Set Up Notifications 60 Teradata Query Scheduler Administrator Guide

61 APPENDIX A About the Dialog Boxes While working with Teradata QS Administrator, information about the options and controls is available. The following topics provide information about the various dialog boxes: Refresh Interval Dialog Box Results File Storage Dialog Box Results File Storage Properties Dialog Box Scheduler Profiles Dialog Box Workgroups Dialog Box Workgroup Properties Dialog Box Refresh Interval Dialog Box Use the Refresh Interval dialog box (Figure 6) to set the rate at which the Scheduled Requests list is updated by the Teradata QS server. To open this dialog box, go to the Teradata Query Scheduler Administrator, and click View>Refresh>Interval. Figure 6: Refresh Interval Dialog Box Table 15: Refresh Interval Dialog Box Description Option/Control Set Refresh Interval check box Description Select to enable the controls in the Refresh Interval dialog box Clear to disable the controls in the Refresh Interval dialog box Teradata Query Scheduler Administrator Guide 61

62 Appendix A: About the Dialog Boxes Results File Storage Dialog Box Table 15: Refresh Interval Dialog Box Description (continued) Option/Control Refresh every box Minute option Hour option OK Cancel Description Enter a value for the rate at which the Teradata QS Administrator will update the Scheduled Requests list: 0 to 60 minutes, or 0 to 24 hours. Enter an interval between 5 and 99 for the rate at which the Teradata QS server will update the Scheduled Jobs list. Select this option to have the rate be measured in minutes. Select this option to have the rate be measured in hours. Saves entries and exits the Refresh Interval dialog box. Exits the Refresh Interval dialog box without saving entries. Results File Storage Dialog Box Use the Results File Storage dialog box (Figure 7) to create or manage existing results file storage. To open this dialog box, go to the Teradata Query Scheduler Administrator, and click Configuration>Results File Storage. Figure 7: Results File Storage Dialog Box Table 16: Results File Storage Dialog Box Description Option File Storage Names list Description Contains a list of the names related to a location where the scheduled requests results are stored. 62 Teradata Query Scheduler Administrator Guide

63 Appendix A: About the Dialog Boxes Results File Storage Properties Dialog Box Table 16: Results File Storage Dialog Box Description (continued) Option New Delete Edit Close Description Creates a new file storage mapping in the New Results File Storage dialog box. Deletes the selected file storage mapping. Opens an existing file storage mapping for editing in the Edit Results File Storage. Closes the Results File Storage dialog box Results File Storage Properties Dialog Box Use the Results File Storage Properties dialog box (Figure 8) to enter the details about a new file storage location. To open this dialog box, go to the Teradata Query Scheduler Administrator, and click Configuration>Results File Storage. Then click New. Figure 8: Results File Storage Properties Dialog Box Table 17: Results File Storage Properties Dialog Box Description Option/Control Description Results File Storage Defines the name of the results file storage. The names is limited to 30 characters. Windows Results Directory OK Cancel Defines the Windows directory where the results are saved. The directory name is limited to 128 characters. Saves entries and closes the Results File Storage Properties dialog box. Closes the Results File Storage Properties dialog box without saving entries. Teradata Query Scheduler Administrator Guide 63

64 Appendix A: About the Dialog Boxes Scheduler Profiles Dialog Box Scheduler Profiles Dialog Box Use the Scheduler Profiles dialog box (Figure 9) to choose the type of scheduler profile to create or edit. To open this dialog box, go to the Teradata Query Scheduler Administrator, and click Configuration>Scheduler Profiles. If logged on to Teradata QS in View Mode, the Scheduler Profiles dialog box opens, but no changes can be made. In View-Only mode, use the View button to view profiles. Figure 9: Scheduler Profiles Dialog Box Table 18: Scheduler Profiles Dialog Box Options Description Option/Control Select Type list Profile Description Defines the type of scheduler profile to create. Select one of the following items: Account Profile Role User When an item is selected, an alphabetical list of all available accounts, profiles, roles, or users appears. Scroll down the list and click the correct name. This list shows all objects for the type selected. 64 Teradata Query Scheduler Administrator Guide

65 Appendix A: About the Dialog Boxes Workgroups Dialog Box Table 18: Scheduler Profiles Dialog Box Options Description (continued) Option/Control New Delete Edit Cleanup View Close Description Create a profile for the selected account, profile, role, or user. New is available if the selected account, profile, role, or user does not have an existing profile. Deletes the selected profile. Delete is available if the selected account, profile, role, or user has an existing profile. Modify the profile with the changes made. Edit is available if the selected account, profile, role, or user has an existing profile. Finds and deletes the Teradata QS profiles for all Teradata Database objects that no longer exist. View information about selected profiles. Available only in View Mode. Closes the Scheduler Profile dialog box. Workgroups Dialog Box Use the Workgroups dialog box (Figure 10) to create a new workgroup or manage existing workgroups. To open this dialog box, go to the Teradata Query Scheduler Administrator, and click Configuration>Workgroups. If logged on to Teradata QS in View Mode, the Workgroups dialog box opens, but no changes can be made. In View-Only mode, use the View button to view workgroups. Figure 10: Workgroups Dialog Box Teradata Query Scheduler Administrator Guide 65

66 Appendix A: About the Dialog Boxes Workgroup Properties Dialog Box Table 19: Workgroups Dialog Box Description Option Workgroup Names New Delete Edit View Close Description Shows the names of the existing scheduled requests execution workgroups. Note: These are case sensitive. Creates a new workgroup in the Workgroup Properties dialog box. Deletes the selected workgroup. Opens the selected workgroup for editing in the Edit Workgroup dialog box. View information about selected workgroups. Available only in View Mode. Closes the Workgroup dialog box Workgroup Properties Dialog Box Use the Workgroup Properties dialog box (Figure 11) to define parameters for a workgroup. To open this dialog box, go to the Teradata Query Scheduler Administrator, and click Configuration>Workgroups. Then click New. Figure 11: Workgroup Properties Dialog Box Table 20: Workgroup Properties Dialog Box Description Option/Control Description Workgroup Name Defines the name of the workgroup. Names are limited to 30 characters. Maximum queries running simultaneously OK Cancel Defines the maximum number (0 and 128) of concurrent queries that can be run by the workgroup. Saves entries and closes the Workgroup Properties dialog box. Closes the Workgroup Properties dialog box without saving entries. 66 Teradata Query Scheduler Administrator Guide