Teradata Query Scheduler User Guide

Teradata Query Scheduler
User Guide
Release 12.00.00
B035-2512-067A
July 2007
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 e-mail: 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 © 2001-2007 by Teradata Corporation. All Rights Reserved.
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 12.00.00
•
Teradata Tools and Utilities 12.00.00
•
Teradata Query Scheduler 12.00.00
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 www.info.teradata.com.
2
Navigate to General Search>Publication Product ID.
3
Enter 3119.
4
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
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
Description
July 2007
12.00.00
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
Preface
Additional Information
Type of Information
Description
Access to Information
Release overview
Use the Release Definition for the following
information:
1 Go to www.info.teradata.com.
• 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
3 In the Publication Product ID box, type 2029.
Use the Teradata Information Products
Publishing Library site to view or download
specific manuals that supply related or
additional information to this manual.
1 Go to www.info.teradata.com.
Late information
Additional product
information
2 Select the General Search check box.
4 Click Search.
5 Select the appropriate Release Definition from
the search results.
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
B035-2512-mmyx
• Teradata Dynamic Workload Manager User
Guide
B035-2513-mmyx
• ODBC Driver for Teradata User Guide
B035-2509-mmyx
• Teradata Call-Level Interface Version 2 Reference
for Network-Attached Systems
B035-2418-mmyx
• Teradata Manager User Guide
B035-2428-mmyx
• Teradata SQL Assistant for Microsoft Windows
User Guide
B035-2430-mmyx
CD-ROM images
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.
Teradata Query Scheduler User Guide
1 Go to www.info.teradata.com.
2 Select the General Search check box.
3 In the Title or Keyword box, type CD-ROM.
4 Click Search.
5
Preface
Additional Information
Type of Information
Description
Access to Information
Ordering
information for
manuals
Use the Teradata Information Products
Publishing Library site to order printed
versions of manuals.
1 Go to www.info.teradata.com.
2 Select the How to Order check box under Print &
CD Publications.
3 Follow the ordering instructions.
General information
about Teradata
The Teradata home page provides links to
numerous sources of information about
Teradata. Links include:
1 Go to Teradata.com.
2 Select a link.
• Executive reports, case studies of
customer experiences with Teradata,
and thought leadership
• Technical information, solutions, and
expert advice
• Press releases, mentions, and media
resources
6
Teradata Query Scheduler User Guide
Table of Contents
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3
Purpose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3
Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3
Supported Releases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3
Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4
Changes to This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4
Additional Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4
Chapter 1:
What is Teradata QS? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
About the Teradata QS Architecture. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Teradata QS Client Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Teradata QS Server Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Teradata QS Administrator Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
17
18
19
19
What Does Teradata QS Do? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
What Are Scheduled Requests? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
How Are Scheduled Requests Processed? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Execution Time Frames. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Request Checking. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Job Dispatching . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Job Execution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
20
21
21
21
21
What Can I Do with Teradata QS? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Teradata Query Scheduler Submit Request Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Teradata Query Scheduler Viewer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Chapter 2:
Before You Begin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
System Requirements/Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Supported Client Operating Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Required Client Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Teradata Query Scheduler User Guide
7
Table of Contents
Optional Client Software. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .26
Specifying a Default Teradata QS Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .26
Working with Character Sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .27
Running the Teradata QS Viewer or SQL Assistant on Windows Server 2003. . . . . . . . . . . . .27
Chapter 3:
Getting Started . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .29
Opening the Teradata Query Scheduler Viewer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .29
Connecting to a Teradata QS Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .29
Disconnecting from a Teradata QS Server and Exiting Teradata QS. . . . . . . . . . . . . . . . . . . . .31
Navigating the Teradata Query Scheduler Viewer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .32
Using the Menu Bar. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .34
Exploring the Toolbar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .35
Using the Jobs List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .37
Reading the Status Bar. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .39
Viewing Copyright and Version Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .39
Customizing the Teradata Query Scheduler Viewer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .40
Setting the Refresh Rate. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .40
Choosing a SQL Assistant Export Setting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .41
Chapter 4:
Scheduling Requests . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .43
Saving Result Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .43
Scheduling a SQL Request . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .44
Specifying E-Mail Notifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .52
Immediately Executing a Scheduled Request . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .53
Scheduling Rejected Teradata SQL Assistant Queries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .53
Chapter 5:
Working with Scheduled Requests . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .55
Viewing Scheduled Requests . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .55
Sorting the Job List. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .57
Refreshing the Job List. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .57
Managing Scheduled Requests. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .57
Viewing Scheduled Request Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .57
8
Teradata Query Scheduler User Guide
Table of Contents
Modifying a Scheduled Request . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Deleting a Scheduled Request . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Managing Jobs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Canceling a Job. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Deleting a Job . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Working with Job Results. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Retrieving Job Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Viewing Job Result Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Dropping Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
62
62
64
65
Chapter 6:
Working with the Teradata Query Scheduler Operations
Utility. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Starting the Teradata Query Scheduler Operations Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Navigating the Teradata Query Scheduler Operations Utility . . . . . . . . . . . . . . . . . . . . . . . . . 68
Teradata QS Operations Menu Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
About the Teradata QS Configuration Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Changing Communications Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Changing Client Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Server Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Default Configuration Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
71
71
72
72
72
Changing General Communication Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Changing Default Server Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
Enabling Scheduling of Rejected Teradata SQL Assistant Queries. . . . . . . . . . . . . . . . . . . . . . 76
Setting a Response Timeout. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Enabling and Disabling Tracing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
78
79
79
80
83
84
85
Viewing Component Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Viewing Communications Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Viewing Server Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Scheduled Requests Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
86
86
87
89
Managing Teradata QS Error Log Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Viewing Error Log Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Teradata Query Scheduler User Guide
9
Table of Contents
Saving Error Log Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .91
Deleting Error Log Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .92
Appendix A:
About the User Interfaces. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .93
Teradata Query Scheduler Connect Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .93
Viewer Settings Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .95
SQL Text Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .96
Appendix B:
About the Teradata Query Scheduler Operations Interfaces 97
Communications Information Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .97
Parameters Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .98
Connections Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .99
Client Processes Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .100
Statistics Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .101
Server Information Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .103
General Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .104
Connections Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .105
Processes Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .106
Statistics Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .107
Scheduled Requests Information Dialog Box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .109
General Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .110
Scheduled Requests Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .111
Scheduled Jobs Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .112
Executing Jobs Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .113
Execution Time Frames Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .114
Workgroups Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .115
File Storage Locations Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .116
Profiles Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .117
More Profile Information Dialog Box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .118
Requests Scheduling Info Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .119
10
Teradata Query Scheduler User Guide
Table of Contents
Appendix C:
About Error Log Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
Error Log Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
Component Identifiers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
Status Codes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
General Status Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Communications Status Codes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Server Vote Status Codes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Server Rule Status Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Server Exception Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Scheduler Status Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
123
123
123
124
125
125
126
Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
Teradata Query Scheduler User Guide
11
Table of Contents
12
Teradata Query Scheduler User Guide
List of Figures
Figure 1: Teradata QS Client/Server Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Figure 2: Teradata Query Scheduler Connect Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Figure 3: Teradata Query Scheduler Viewer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Figure 4: Teradata Query Scheduler Viewer Menu Bar. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Figure 5: Teradata QS Viewer Toolbar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Figure 6: Teradata Query Scheduler Viewer Jobs List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Figure 7: Teradata Query Scheduler Viewer Shortcut Menu . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Figure 8: Teradata Query Scheduler Viewer Status Bar. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Figure 9: About Teradata Query Scheduler Viewer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
Figure 10: Viewer Settings Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Figure 11: SQL Text Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Figure 12: Teradata Query Scheduler Submit Request Dialog Box . . . . . . . . . . . . . . . . . . . . . 45
Figure 13: SQL Tab: Teradata Query Scheduler Submit Request Dialog Box. . . . . . . . . . . . . 46
Figure 14: Scheduling Tab: Teradata Query Scheduler Submit Request Dialog Box . . . . . . . 47
Figure 15: Results Tab: Teradata Query Scheduler Submit Request Dialog Box . . . . . . . . . . 50
Figure 16: Query Scheduler Request Submitted Message Box . . . . . . . . . . . . . . . . . . . . . . . . . 52
Figure 17: Teradata Query Scheduler Viewer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Figure 18: Teradata Query Scheduler View/Modify Request Dialog Box . . . . . . . . . . . . . . . . 58
Figure 19: Teradata Query Scheduler View/Modify Request Dialog Box . . . . . . . . . . . . . . . . 59
Figure 20: Teradata Query Scheduler Operations Menu Bar . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Figure 21: About Teradata Query Scheduler Operations Message Box . . . . . . . . . . . . . . . . . . 71
Figure 22: Communications Parameters Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Figure 23: Communications Parameters Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
Figure 24: Client Parameters Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
Figure 25: Client Parameters Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Figure 26: Trace Activity to Files Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Figure 27: Server Parameters Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Figure 28: Server Parameters Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
Figure 29: Communications Information Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
Figure 30: Server Information Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
Figure 31: Scheduled Requests Information Dialog Box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
Figure 32: Sample Error Log File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Teradata Query Scheduler User Guide
13
List of Figures
Figure 33: Delete Error Log Files Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .92
Figure 34: Teradata Query Scheduler Connect Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . .93
Figure 35: Viewer Settings Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .95
Figure 36: SQL Text Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .96
Figure 37: Communications Information Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .98
Figure 38: Connections Tab: Communications Information Dialog Box . . . . . . . . . . . . . . . .100
Figure 39: Client Processes Tab: Communications Information Dialog Box . . . . . . . . . . . . .101
Figure 40: Statistics Tab: Communication Information Dialog Box . . . . . . . . . . . . . . . . . . . .102
Figure 41: Server Information Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .103
Figure 42: Connections Tab: Server Information Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . .105
Figure 43: Processes Tab: Server Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .106
Figure 44: Statistics Tab: Server Information Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . .107
Figure 45: Scheduled Requests Information Dialog Box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .109
Figure 46: Scheduled Requests Tab: Scheduled Requests Information Dialog Box . . . . . . . .111
Figure 47: Scheduled Jobs Tab: Scheduled Requests Information Dialog Box . . . . . . . . . . . .112
Figure 48: Executing Jobs Tab: Scheduled Requests Information Dialog Box . . . . . . . . . . . .113
Figure 49: Execution Time Frames Tab: Scheduled Requests Information Dialog Box. . . . .114
Figure 50: Workgroups Tab: Scheduled Requests Information Dialog Box . . . . . . . . . . . . . .115
Figure 51: File Storage Locations Tab: Scheduled Requests Information Dialog Box . . . . . .116
Figure 52: Profiles Tab: Scheduled Requests Information Dialog Box . . . . . . . . . . . . . . . . . .117
Figure 53: More Profile Information Dialog Box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .118
Figure 54: Requests Scheduling Info Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .119
Figure 55: Sample Teradata QS Error Log File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .121
14
Teradata Query Scheduler User Guide
List of Tables
Table 1: Teradata Query Scheduler Viewer Field/Control Descriptions . . . . . . . . . . . . . . . . . 33
Table 2: Command Menu Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Table 3: Options Menu Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Table 4: View Menu Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Table 5: Help Menu Commands: Teradata Query Scheduler Administrator . . . . . . . . . . . . . 35
Table 6: Teradata Query Scheduler Viewer Toolbar Icons . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Table 7: Teradata Query Scheduler Viewer Jobs List. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Table 8: Status Bar Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Table 9: Request Tab: Teradata Query Scheduler Submit Request Dialog Box . . . . . . . . . . . 45
Table 10: SQL Tab: Teradata Query Scheduler Submit Request Dialog Box . . . . . . . . . . . . . 46
Table 11: Scheduling Tab: Teradata Query Scheduler Submit Request Dialog Box. . . . . . . . 49
Table 12: Results Tab: Teradata Query Scheduler Submit Request Dialog Box . . . . . . . . . . . 51
Table 13: Teradata Query Scheduler Viewer: Jobs List Column Descriptions . . . . . . . . . . . . 56
Table 14: Teradata Query Scheduler Operations Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Table 15: File Menu Command: Teradata Query Scheduler Operations . . . . . . . . . . . . . . . . 69
Table 16: Configuration Menu Commands: Teradata Query Scheduler Operations. . . . . . . 69
Table 17: Server Menu Commands: Teradata Query Scheduler Operations . . . . . . . . . . . . . 69
Table 18: Information Menu Commands: Teradata Query Scheduler Operations . . . . . . . . 70
Table 19: Error Log Menu Commands: Teradata Query Scheduler Operations . . . . . . . . . . 70
Table 20: Teradata QS Configuration Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Table 21: Communications Parameters Dialog Box: Field Descriptions. . . . . . . . . . . . . . . . . 75
Table 22: Server Parameters Dialog Box: Field/Control Descriptions . . . . . . . . . . . . . . . . . . . 81
Table 23: Server Parameters Dialog Box: Field/Control Descriptions . . . . . . . . . . . . . . . . . . . 83
Table 24: Teradata Query Scheduler Connect Dialog Box: Field/Control Descriptions . . . . 94
Table 25: Viewer Settings Dialog Box: Option Descriptions. . . . . . . . . . . . . . . . . . . . . . . . . . . 95
Table 26: SQL Text Dialog Box: Option Descriptions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Table 27: Communications Information Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
Table 28: Parameters Tab: Communications Information Dialog Box . . . . . . . . . . . . . . . . . . 99
Table 29: Connections Tab: Communications Information Dialog Box. . . . . . . . . . . . . . . . 100
Table 30: Client Processes Tab: Communications Information Dialog Box. . . . . . . . . . . . . 101
Table 31: Statistics Tab: Communications Information Dialog Box . . . . . . . . . . . . . . . . . . . 102
Table 32: Server Information Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
Teradata Query Scheduler User Guide
15
List of Tables
Table 33: General Tab: Server Information Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .104
Table 34: Connections Tab: Server Information Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . .105
Table 35: Processes Tab: Server Information Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . .106
Table 36: Statistics Tab: Server Information Dialog Box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .107
Table 37: Scheduled Requests Information Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .109
Table 38: General Tab: Scheduled Requests Information Dialog Box . . . . . . . . . . . . . . . . . . .110
Table 39: Scheduled Requests Tab: Scheduled Requests Information Dialog Box . . . . . . . . .111
Table 40: Scheduled Jobs Tab: Scheduled Requests Information Dialog Box. . . . . . . . . . . . .112
Table 41: Executing Jobs Tab: Scheduled Requests Information Dialog Box . . . . . . . . . . . . .113
Table 42: Execution Time Frames Tab: Scheduled Requests Information Dialog Box . . . . .114
Table 43: Workgroups Tab: Scheduled Requests Information Dialog Box . . . . . . . . . . . . . . .115
Table 44: File Storage Locations Tab: Scheduled Requests Information Dialog Box . . . . . . .116
Table 45: Profiles Tab: Scheduled Requests Information Dialog Box . . . . . . . . . . . . . . . . . . .117
Table 46: More Profile Information Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .118
Table 47: Requests Scheduling Info Dialog Box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .120
Table 48: Teradata QS Log Entries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .122
Table 49: Teradata QS Log Component Identifiers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .122
Table 50: Teradata QS Status Codes—General Status Descriptions . . . . . . . . . . . . . . . . . . . .123
Table 51: Teradata QS Status Codes—Communications Status Descriptions . . . . . . . . . . . .123
Table 52: Teradata QS Status Codes—Server Vote Status Descriptions . . . . . . . . . . . . . . . . .124
Table 53: Teradata QS Status Codes—Server Rule Status Descriptions . . . . . . . . . . . . . . . . .125
Table 54: Teradata QS Status Codes—Server Exception Status Descriptions. . . . . . . . . . . . .125
Table 55: Teradata QS Status Codes—Scheduler Status Descriptions. . . . . . . . . . . . . . . . . . .126
16
Teradata Query Scheduler User Guide
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
Chapter 1: What is Teradata QS?
About the Teradata QS Architecture
Figure 1: Teradata QS Client/Server Architecture
Teradata QS
Server
system(s)
Teradata QS Client systems
SQL
Assistant
Teradata QS
Viewer
Teradata QS
Scheduler/Dispatcher
Teradata QS
Submit Dialog Library
Teradata QS
Server
Processes
Teradata QS
Client Library
Teradata QS
Communications
Library
Teradata QS
Executor
Program
(runs on the
primary server
only)
Teradata QS
Communications
Library
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
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
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:
20
•
“Request Checking”
•
“Job Dispatching”
•
“Job Execution”
Teradata Query Scheduler User Guide
Chapter 1: What is Teradata QS?
How Are Scheduled Requests Processed?
Execution Time Frames
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.
Request Checking
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.
Job Dispatching
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.
Job Execution
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
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:
22
•
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.
Teradata Query Scheduler User Guide
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
Chapter 1: What is Teradata QS?
What Can I Do with Teradata QS?
24
Teradata Query Scheduler User Guide
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
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).
Required Client Software
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
Chapter 2: Before You Begin
Specifying a Default Teradata QS Server
•
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
Optional Client Software
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 12.0. 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
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
Chapter 2: Before You Begin
Running the Teradata QS Viewer or SQL Assistant on Windows Server 2003
28
Teradata Query Scheduler User Guide
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
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
Control/Field
Description
Database Name
Enter the name of the Teradata Database you want to use to schedule your SQL requests.
User Name
Enter your user name associated with the Teradata Database you entered in the Database
Name box.
Password
Enter the password associated with the user name you entered in the User Name box.
Default Database
(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.
Account String
(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.
Mechanism
Select the appropriate authentication mechanism (for example, TD2) in this list box. The
default is blank, representing the standard Teradata (TD2) mechanism.
Parameter
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.
Server
Displays the name of the Teradata QS server
3
30
Complete the options of the Teradata Query Scheduler Connect dialog box as follows:
Click OK.
Teradata Query Scheduler User Guide
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
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
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
Description
Menu bar
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.
Toolbar
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.
Jobs list
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
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
Description
Connect
Opens a session with the Teradata QS server.
Disconnect
Closes a session with the Teradata QS server.
Schedule SQL
Opens the SQL Text dialog box to input SQL statements for scheduling.
Exit
Closes the Teradata QS application.
Options Menu
The following table describes the commands and submenus of the Options menu:
Table 3: Options Menu Commands
34
Command
Description
Cancel Job
Terminates a job with a Waiting status that selected from the Jobs list.
Drop Results
Eliminates the results table or file for the job or request selected from the Jobs
list.
Delete Job
Removes the job selected from the Jobs list.
Delete Request
Removes the request selected from the Jobs list and all the related jobs.
Request
Properties
Shows the properties of the job selected from the Jobs list.
Retrieve Result
Data
Get the results of a job with a Completed status selected from the Jobs list.
Teradata Query Scheduler User Guide
Chapter 3: Getting Started
Navigating the Teradata Query Scheduler Viewer
Table 3: Options Menu Commands (continued)
Command
Description
Job Information
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
Description
Toolbar
Shows or hides the Teradata Query Scheduler Viewer tool bar.
Status Bar
Shows or hides the Teradata Query Scheduler Viewer status bar.
Font
Displays the Font dialog box to select a font for displaying the list of scheduled
requests and the request SQL
Refresh
Immediately updates the information in the Jobs list.
Settings
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
Description
Help Topics
Opens the contents tab of the online Help to locate a topic by category.
About Teradata Query
Scheduler Viewer
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
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
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
Description
Request Name
The name you assigned to the job when you submitted it using the Teradata Query
Scheduler Submit dialog box.
Req ID
Generated by Teradata QS to uniquely identify the request.
Job ID
Generated by Teradata QS to uniquely identify the job.
Schedule
Current time the job is scheduled to run.
Max. Start Time
Latest time the job is allowed to execute.
Status
Current standing of the job.
Information
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
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
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
Description
Status
Status of the Teradata Query Scheduler Viewer or an explanation of the currently selected menu item.
Requests
The number of scheduled requests you have in the system.
Jobs
The number of scheduled jobs.
Time frame
The current or next Scheduled Request execution time frame. Your DBA sets Scheduled Requests execution
time frames using the Teradata QS Administrator.
Database
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
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
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
Setting the Refresh Rate
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
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
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 95.
42
Teradata Query Scheduler User Guide
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
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:
•
44
Type the SQL statement text.
Teradata Query Scheduler User Guide
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
Description
User Name
(Read-only) Your Teradata Database logon name. This information is obtained from
the Query Scheduler Viewer or Teradata SQL Assistant.
Account String
(Read-only) Your Teradata Database account string This information is obtained from
the Teradata QS Viewer or Teradata SQL Assistant.
Request Name
(Optional) Enter a user-defined name for the request.
Session Character Set
Select the Teradata session character set under which the scheduled request will execute.
Teradata Query Scheduler User Guide
45
Chapter 4: Scheduling Requests
Scheduling a SQL Request
Table 9: Request Tab: Teradata Query Scheduler Submit Request Dialog Box (continued)
Option
Description
E-mail address for notification
on completion box
(Optional) E-mail 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 E-Mail
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
Modify parameters to make a
new request check box
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
46
Use this field/control…
To…
SQL box
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.
Estimates Rows and Time lists
(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.
Teradata Query Scheduler User Guide
Chapter 4: Scheduling Requests
Scheduling a SQL Request
Table 10: SQL Tab: Teradata Query Scheduler Submit Request Dialog Box (continued)
Use this field/control…
To…
Update button
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 58.
7
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
Chapter 4: Scheduling Requests
Scheduling a SQL Request
48
Teradata Query Scheduler User Guide
Chapter 4: Scheduling Requests
Scheduling a SQL Request
Table 11: Scheduling Tab: Teradata Query Scheduler Submit Request Dialog Box
Use this field/control…
To…
Frequency frame
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.
Start Days frame
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
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.
Maximum Start Interval Days/
Hours boxes
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
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
Chapter 4: Scheduling Requests
Scheduling a SQL Request
Table 12: Results Tab: Teradata Query Scheduler Submit Request Dialog Box
Use this field/control…
To…
Save To options
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.
Database Name box
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.
Table/File Name box
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.
Options list
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.
Table Options check boxes
(Optional) If you choose to create a Teradata Database table, choose the type of table
created:
• Fallback
• Multi-set
Field Separator list
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 |
Encoding list box
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.
Automatically cleaned up after
list
(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
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 E-Mail Notifications
After your DBA sets up the e-mail notifications, you can use this feature. An example of the email text is included with the following procedure.
To use e-mail notifications
1
Create a scheduled request.
Note: For information on creating a scheduled request, see “Scheduling a SQL Request”
on page 44.
2
In the Teradata Query Scheduler Submit Request dialog box, enter an e-mail address in the
E-mail address for notification on completion text box and click Submit.
The following is an example of an e-mail 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 63460 for RequestId 43294 () - Status is Successful
52
Teradata Query Scheduler User Guide
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 3149-3159), 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
Chapter 4: Scheduling Requests
Scheduling Rejected Teradata SQL Assistant Queries
54
Teradata Query Scheduler User Guide
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
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
Description
Request Name
View the name entered when the request was scheduled.
Req ID
View a unique numeric ID generated by Teradata QS identifying a request.
Job ID
View a unique numeric ID generated by Teradata QS identifying a job.
Schedule
View the current scheduled run time.
Max. Start Time
View the latest time the job can begin execution.
Status
View the current status of the job.
Information
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 32.
56
Teradata Query Scheduler User Guide
Chapter 5: Working with Scheduled Requests
Managing Scheduled Requests
Sorting 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.
Refreshing the Job List
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
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
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
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
Chapter 5: Working with Scheduled Requests
Managing Jobs
Managing Jobs
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
Canceling a Job
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
Chapter 5: Working with Scheduled Requests
Working with Job Results
OR
Click
.
Working with 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
Retrieving Job Results
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
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
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
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
Chapter 5: Working with Scheduled Requests
Working with Job Results
66
Teradata Query Scheduler User Guide
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
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
68
Menu
Description
File
Exiting Teradata Query Scheduler Operations.
Configuration
Configuring parameters and activating tracing.
Server
Controlling the Teradata QS server if the server software is installed.
Information
Viewing information about the Teradata QS components.
Error Log
Viewing, resetting, or saving an error log file
Help
Accessing the online help and view information about the Teradata Query
Scheduler Operations utility.
Teradata Query Scheduler User Guide
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.
Description
Exit
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.
Description
Communications
Configure communications parameters in the Communications Parameters
dialog box.
Client
Configure client parameters in the Client Parameters dialog box.
Server
Configure the server parameters in the Server Parameters dialog box.
Tracing
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.
Description
Start
Starts the Teradata QS server service.
Stop
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
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
Description
Communications
View information about the communications components in the
Communications Information dialog box.
Server
View information about the server in the Server Information dialog box. This
command is only available if the Teradata QS server software is installed.
Scheduled
Requests
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
Description
View
View a tqslog file.
Delete
Delete one or more tqslog files.
Save
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
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
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
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.
Server 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.
Yes
Schedule rejected Teradata SQL Assistant queries. Set to No to disable
display of Teradata Query Scheduler Submit Request dialog box.
Client Parameters
CliSRDialog
72
Teradata Query Scheduler User Guide
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 04.03.00).
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.
Server Parameters
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
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
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
Description
Default Server Port
Number box
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 3000.
Default Server Name
box
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
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
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
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
3
Choose from the following options:
Use this check box…
To trace …
Enable Communications Tracing
Communications component activities such as session
create, data send/receive, and more.
Enable Client Tracing
Client Teradata QS component activities.
Enable Server Tracing
Server component activities.
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
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
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.
3000 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.
Supporting Results Files
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
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
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…
To…
Database Name box
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.
User Name box
This is the user/database name of the Teradata QS database, created as tdwm. This
field is unavailable and cannot be changed.
Password box
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.
Mechanism list box
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
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…
To…
Parameter box
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
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…
To…
Character Set list box
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
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…
To…
Shared Memory Size (KB) text box
Specify the size of the memory area on this system used to store server information.
This memory is shared among all the server processes.
Request Processor Processes spin
box
Specify the number of server processes created for handling client messages.
Encrypt Client Data check box
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
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
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
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
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 103.
88
Teradata Query Scheduler User Guide
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
Chapter 6: Working with the Teradata Query Scheduler Operations Utility
Managing Teradata QS Error Log Files
Managing Teradata QS Error Log Files
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, tqslog040712 is created to contain error log entries that occurred on July 12, 2004. 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.
Figure 32: Sample Error Log File
For details about the contents of the error log files, see Appendix C: “About Error Log Files.”
90
Teradata Query Scheduler User Guide
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
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.
Saving Error Log Files
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
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
92
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.
Teradata Query Scheduler User Guide
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
Appendix A: About the User Interfaces
Teradata Query Scheduler Connect Dialog Box
Table 24: Teradata Query Scheduler Connect Dialog Box: Field/Control Descriptions
Option
Description
Database Name
Use this text box to enter the name of the Teradata Database you want to use to schedule your SQL
requests.
User Name
Enter your user name associated with the Teradata Database you entered in the Database Name box.
Password
Enter the password associated with the user name you entered in the User Name box.
Default Database
(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.
Account String
(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.
Server
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.
Mechanism
Select the appropriate authentication mechanism (for example, TD2) in this list box. The default is
blank, representing the standard Teradata (TD2) mechanism.
Parameter
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.
OK
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.
Cancel
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 29.
94
Teradata Query Scheduler User Guide
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
Description
Refresh every __
minutes
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.
Export Results
Tables
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.
OK
Click to save settings, close the Viewer Settings dialog box, and return to the Teradata Query Scheduler
Viewer.
Cancel
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
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
Description
SQL
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.
OK
Click to save your SQL statement and schedule it for execution in the Teradata Query Scheduler Submit
dialog box.
Cancel
Click to close the SQL Text dialog box without saving SQL statement.
Paste
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 44.
96
Teradata Query Scheduler User Guide
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
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
Shows
Parameters
System and network configuration, and general runtime information about the Teradata QS
Communications components.
Connections
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.
Client Processes
Information about the client application processes that have attached to the communications
library. These are usually Scheduled Requests Viewer client applications.
Statistics
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
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
The communications shared memory size in kilobytes.
Retries list
Indicates the number of times the Teradata QS Communications components retries system
and network functions when a failure is encountered.
Free Memory (KB) list
The amount of free communications shared memory in kilobytes.
Free Msg Buffers list
Indicates how many communications message buffers are currently available for use.
Client
Default Server Name 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.
Default Server Port list
The default IP port number for a remote Teradata QS server system.
Server
Network Node Name list The name of the local network node if it has been used as a Teradata QS server.
Network Node Address
list
The address of the local network node.
Listener Port list
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.
Listener Process ID list
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
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
Description
Type
Indicates whether the connection is a client or server router process or a logical session.
Local Id
The hexadecimal identifier of the router or session on the local system.
PID/CSID
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.
Sock State
The state of the socket connection for the router types.
Send Msgs
Indicates whether there are messages ready to send over the session or socket.
Shut/Disc
Shut indicates whether there is a shutdown pending for router types.
Disc indicates whether there is a disconnect pending for sessions.
Pend Msgs
The number of messages waiting for a response on the session.
Total Msgs
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
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
Description
Process Id
The process ID of the process that opened a client communications session.
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
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
Description
Request Type
This column displays the basic Teradata QS communications request or message types.
Client Statistics
Reqs Sent
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).
Resps Recvd
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
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.
Resps Sent
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.
Server Resps
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
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
Number of communications connections on the local system.
Normal Discs
Number of communications connections disconnected normally.
Errors
Number of communications connections disconnected because of socket errors.
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.
Figure 41: Server Information Dialog Box
Table 32: Server Information Dialog Box
Tab
Shows
General
Configuration and general runtime information about the Teradata QS server components.
Connections
Information about the connections of Teradata QS clients to the local Teradata QS server.
Teradata Query Scheduler User Guide
103
Appendix B: About the Teradata Query Scheduler Operations Interfaces
Server Information Dialog Box
Table 32: Server Information Dialog Box (continued)
Tab
Shows
Processes
Information about the processes that make up the Teradata QS server.
Statistics
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
Description
Database Name
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.
Database Version
The Teradata Database release level.
Current DB Date
The current database date. This date is updated every minute.
Current DB Time
The current database time. This time is updated every minute.
Scheduler DB
Name
The name of the Teradata Query Scheduler database (tdwm).
Local System
Name
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.
Server ID
The unique internal numeric identifier assigned to each Teradata Query Scheduler server system.
Primary Server
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.
Time Active
(hh:mm)
Indicates how long, in hours and minutes format, that the Teradata Query Scheduler server has been
continuously active.
Character Set
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.
Encrypt Data
Provides data security through the encryption of communications between the Teradata Query
Scheduled Request client and server components over network socket connections.
Memory Size (KB)
The server shared memory size in kilobytes.
Free Memory (KB)
The amount of free server shared memory in kilobytes.
104
Teradata Query Scheduler User Guide
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
Description
Conn Id
The unique Teradata QS connection identifier for this system
Version
The Teradata QS client version identifier which determines if the client is from a previous
release
User Name
The name of the user for which the connection was made to the Teradata QS server
Database Name
The name of the database the client connection is currently using as its default database
Account
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
Appendix B: About the Teradata Query Scheduler Operations Interfaces
Server Information Dialog Box
Processes Tab
The Processes tab shows information about the processes that make up the Teradata QS
server.
Figure 43: Processes Tab: Server Information
Table 35: Processes Tab: Server Information Dialog Box
Column Header
Description
Type
Indicates the type of the server process:
• Initialization/Update
• Request Processor
Process Id
The process identification number of the server process.
State
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
Appendix B: About the Teradata Query Scheduler Operations Interfaces
Server Information Dialog Box
Table 35: Processes Tab: Server Information Dialog Box (continued)
Column Header
Description
Db Env
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)
DbRecov
Indicates if the server is currently recovering from a database session crash.
PidRecov
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
Description
Total Requests
The total number of requests processed by the Teradata QS server request processors.
Final Responses
The total number of final responses sent by the Teradata QS server.
Teradata Query Scheduler User Guide
107
Appendix B: About the Teradata Query Scheduler Operations Interfaces
Server Information Dialog Box
Table 36: Statistics Tab: Server Information Dialog Box (continued)
Option
Description
Intermediate Responses
The number of intermediate responses sent by the Teradata QS server.
Explain Errors
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.
Parser Errors
The number of times a statement request could not be parsed by the parser utility used by
Teradata QS.
Update Collisions
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
The number of connect requests processed.
Disconnects
The number of disconnect requests processed.
Scheduled Requests
The number of scheduled requests messages (of all types) processed.
Query Requests
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.
Information
The number of information messages processed.
Cancels
The number of (query) cancel messages processed.
Other
The number of miscellaneous messages processed.
Query Results
The number of query results messages (indicating that a query has completed) processed.
Stmts Checked
The number of statement requests checked for rules. Some types of requests, such as DDL, are
not checked by Teradata QS.
Multiple Stmts
The number of statement requests containing more than one SQL statement in the request.
108
Teradata Query Scheduler User Guide
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
Shows
General
Configuration and general runtime information about the Teradata QS environment.
Scheduled Requests Information about all of the scheduled requests defined to Teradata QS.
Scheduled Jobs
Information about all of the scheduled requests jobs that have already run or scheduled to run.
Executing Jobs
Information about all of the scheduled requests jobs currently being executed.
Execution Time
Frames
Information about all of the time periods in which scheduled requests can execute.
Workgroups
Information about workgroups.
Teradata Query Scheduler User Guide
109
Appendix B: About the Teradata Query Scheduler Operations Interfaces
Scheduled Requests Information Dialog Box
Table 37: Scheduled Requests Information Dialog Box (continued)
Tab
Shows
File Storage
Locations
Information about the locations where scheduled request results files are stored.
Profiles
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
Description
Scheduled Requests
Indicates whether the Scheduled Requests feature of Teradata QS is enabled.
Next Job Gen Check
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.
Last Update Timestamp
An internal timestamp that represents the last time an update to a scheduled request was
detected.
E-mail Notifications
Available
Indicates whether e-mail 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 e-mail address.
110
Teradata Query Scheduler User Guide
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
Description
Request Id
This column displays the unique numerical identifier assigned to the scheduled request.
Request Name
This column displays an optional descriptive name that helps you to identify the request and
its jobs.
User Name
This column displays the name of the user who issued the request.
Last Job D/T
This column displays the date and time, in yyyymmdd and hhmm format, the last job
associated with the request that was scheduled to run.
Show Scheduling Info
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
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
Description
Request Id
A unique numerical identifier assigned to the scheduled request.
Job Id
A unique numerical identifier assigned to the job.
State
Indicates whether the job is waiting to run, or whether it completed successfully or
unsuccessfully.
Orig Run D/T
The date and time, in yyyymmdd and hhmm format, when the job was initially scheduled to
run.
Curr Run D/T
The date and time, in yyyymmdd and hhmm format, when the job is currently scheduled to
run.
Max Run D/T
The date and time, in yyyymmdd and hhmm format, after which the job can no longer run.
112
Teradata Query Scheduler User Guide
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
Description
Request Id
A unique numerical identifier assigned to the scheduled request.
Job Id
The unique numerical identifier assigned to the job.
Process Id
The identification of the process executing the job.
Submit D/T
The date and time, in yyyymmdd and hhmm format, the job was initially scheduled to run.
Teradata Query Scheduler User Guide
113
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
Description
Time Frame Name
The descriptive title of the time frame.
From
The 24-hour based time, in hhmm format, when the execution time frame becomes active.
To
The 24-hour based time, in hhmm format, when the execution time frame becomes inactive.
Days Of Week
The days of the week when the execution time frame is active.
Enabled
Indicates whether this time frame is enabled or disabled.
114
Teradata Query Scheduler User Guide
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
Description
WorkGroup Name
The descriptive title of the workgroup name.
Max Executors
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
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
Description
File Storage Name
The name given to the file storage specification.
Directory Path
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
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
Description
Profile Name
This column displays the name of the user, user group, or account for which the profile is
defined.
Type
This column displays the type of profile (user, user group, or account).
Scheduling
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.
Max Start
This column displays the default maximum start interval in days and hours, in ddhh format,
after a request is scheduled that it can start.
Job Days
This column displays the number of days a record of a completed job is kept by Teradata QS
before it is automatically deleted.
Result Days
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.
Show Additional Info
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
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
Description
Workgroup Name
Shows the name of the workgroup associated with this profile.
Allowed Results Type
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
Appendix B: About the Teradata Query Scheduler Operations Interfaces
Requests Scheduling Info Dialog Box
Table 46: More Profile Information Dialog Box (continued)
Option
Description
Results Database Name
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
The name of the file storage location associated with the profile. It defines the high-level path
name where results files are stored.
Additional Path
An optional low-level path name where results files are stored. The complete path combines
the file storage path and this path.
Maximum File Length (x1000)
Maximum length, in thousands of bytes, of the file storing the results.
Field Separation Character
(hex)
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
Appendix B: About the Teradata Query Scheduler Operations Interfaces
Requests Scheduling Info Dialog Box
Table 47: Requests Scheduling Info Dialog Box
Option
Description
Frequency
Indicates how often the request will be executed.
Start Date
The date, in yyyymmd format, the first job will be executed.
Start Time
The time, in hhmm format, the first job is to be executed. Subsequent jobs will execute at the
same start time.
Start Interval
The maximum start interval in days and hours relative to the start time that the job can
begin.
Scheduled Days
The days of the week or month that the request will execute.
OK
Closes the Request Scheduling Info dialog box.
120
Teradata Query Scheduler User Guide
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
Appendix C: About Error Log Files
Component Identifiers
Table 48: Teradata QS Log Entries
Column
Description
Time
Time the log entry was made in hhmmss format where hh=hour, mm=minutes, and ss=seconds.
Component
Abbreviated name of the Teradata Query Scheduler component or subcomponent when Teradata Query
Scheduler logged the entry. See Table 49 on page 122 for a list of identifiers.
Process ID
Process ID that logged the entry. A Process ID is the numeric ID assigned by the system to a particular
instance of a program running on that system.
Function
Name of the function in the Teradata QS code where the condition being logged occurred.
Activity
Description of the activity or interface called by the Teradata Query Scheduler function that caused the
entry to be logged.
Errno
Current system error number for the process.
Status
Teradata QS status value, or in some cases, the numeric value of a variable or a condition. See “Status
Codes” on page 123 for details.
Message
Log entries can be followed by one or more lines of text. A text message is included when the logging of a
status or errno value is insufficient, such as database errors.
Component Identifiers
The Component column identifies what component or subcomponent of Teradata QS is
logging the entry. The following component identifiers are used in the Teradata QS log:
Table 49: Teradata QS Log Component Identifiers
122
Identifier
Component
COMM
Communications
INIT
Main (initialization) server process
SRVR
Request processor server processes
DBMS
Database interface module
SRCLI
Scheduled Request client library
SREXE
Scheduled Request job executor
SCHED
Scheduled Request scheduler
DISP
Scheduled Request dispatcher
Teradata Query Scheduler User Guide
Appendix C: About Error Log Files
Status Codes
Status Codes
The statuses logged by Teradata QS are listed in the remainder of this section, and are grouped
by the component that logs them. There are some general statuses that can be logged by any
component. Status codes communicate general or specific information of an error or a
situation that occurred, and if it was logged.
General Status Codes
Table 50: Teradata QS Status Codes—General Status Descriptions
Value
General Status Description
0
General good status
99999
General failure status
50001
Invalid argument
50002
No memory available
50003
No semaphores available
50004
Bad semaphore operation
50005
Cannot put msg on queue
50006
Path or filename invalid
50007
Cannot start (exec) program
50008
Process terminated
50009
Server is inactive
50010
Server startup completed OK
50011
Server startup pending (initiated)
50012
Server startup required
Communications Status Codes
Table 51: Teradata QS Status Codes—Communications Status Descriptions
Value
Communications Status Description
51001
Comm inactive (i.e., not started)
51002
No socket library
51003
No sockets available
51004
No host name specified
51005
Host name not found
Teradata Query Scheduler User Guide
123
Appendix C: About Error Log Files
Status Codes
Table 51: Teradata QS Status Codes—Communications Status Descriptions (continued)
Value
Communications Status Description
51006
TCP service not found
51007
Socket connect failed
51008
Bad socket read
51009
Bad socket write
51010
Socket error
51011
Set sock option error
51012
Socket closed
51013
Interrupted socket read
51014
Invalid msg (bad key)
51015
Invalid msg (unknown msg type)
51016
Msg not found
51017
Cannot generate timestamp
51018
invalid session ID
51019
comm listener terminated
51020
no response required—OK
51021
packet size mismatch
51022
product ID error
Server Vote Status Codes
Table 52: Teradata QS Status Codes—Server Vote Status Descriptions
124
Value
Server Vote Status Description
53000
success vote
53001
error vote
53002
warning vote
53003
bypass vote
53004
cancel vote
53005
server down vote
Teradata Query Scheduler User Guide
Appendix C: About Error Log Files
Status Codes
Server Rule Status Codes
Table 53: Teradata QS Status Codes—Server Rule Status Descriptions
Value
Server Rule Status Description
53100
no access rule
53101
no join rule
53102
query answer set size (rows) rule
53103
query processing time rule
53104
query spool size rule (not used)
53105
YNET usage threshold rule (no longer used)
53106
CPU usage threshold rule
53107
disk usage threshold rule
53108
network transit time threshold rule
53109
user logons threshold rule
53110
internal (software) error
53111
delayed queue max size exceeded
53112
delayed max time exceeded
53113
no scan rule
53114
retryable software error, such as database, UNIX resource
53115
no scheduled request execution time frames available
53116
running query count threshold rule
53117
request already pending on session (software error)
53118
disk space threshold rule
53119
invalid request syntax
Server Exception Codes
Table 54: Teradata QS Status Codes—Server Exception Status Descriptions
Value
Server Exception Status Description
53201
unexpected keyword (in parsed object list)
53202
unexpected object kind (in update table)
53203
unexpected operation (in update table)
53204
no objects specified (in update table)
Teradata Query Scheduler User Guide
125
Appendix C: About Error Log Files
Status Codes
Table 54: Teradata QS Status Codes—Server Exception Status Descriptions (continued)
Value
Server Exception Status Description
53205
no SQL statement specified
53206
database error encountered
53207
object not found
53222
results table exists
Scheduler Status Codes
Table 55: Teradata QS Status Codes—Scheduler Status Descriptions
126
Value
Scheduler Status Description
56000
successful operation
56001
general error occurred
56002
invalid ID specified
56003
bad date value specified
56004
database error encountered
56005
password mismatch
56006
scheduling not enabled
56007
for cancel or delete job
Teradata Query Scheduler User Guide
Glossary
A
account The distinct account name portion of the system account strings, excluding the
performance group designation. Accounts can be employed wherever a user object can be
specified.
ANSI American National Standards Institute. The private, non-profit organization
responsible for approving US standards in many areas, including computers and
communications.
API Application Program Interface. An interface (calling conventions) by which an
application program accesses an operating system and other services. An API is defined at
source code level and provides a level of abstraction between the application and the kernel
(or other privileged utilities) to ensure the portability of the code. A language and message
format used by an application program to communicate with the operating system or some
other control program such as a database management system (DBMS) or communications
protocol.
An API can also provide an interface between a high level language and lower level utilities
and services written without consideration for the calling conventions supported by compiled
languages. In this case, the API may translate the parameter lists from one format to another
and the interpret call-by-value and call-by-reference arguments in one or both directions.
ASCII American Standard Code for Information Interchange. The basis of character sets
used in almost all present-day computers.
B
BTET Begin Transaction End Transaction. The Transaction mode (option TRANSACT or
-tr) that implicitly creates transactions for each SQL request if there is not an active
transaction. Commands that mark a unit of work that is all updated or all rolled back (not
updated).
BTEQ Basic Teradata Query. A general-purpose, command-based program that allows
users on a workstation to communicate with one or more Teradata Database systems, and to
format reports for both print and screen output.
C
CLIv2 Call-Level Interface version 2. The application used by Teradata DWM to connect to
the Teradata Database.
CLI2SPB CLIv2 system parameter block (SPB) for network-attached systems. The internal
SPB, is a data structure that is examined during initialization. During initialization, any
Teradata Query Scheduler User Guide
127
Glossary
DBCAREA values not set in the clispb.dat file by the user will default to the values contained
in CLI2SPB.
CPU
Central Processing Unit. The part of a computer which controls all the other parts.
D
DBA Database Administrator. Generally, a person responsible for the design and
management of one or more databases and for the evaluation, selection and implementation
of database management systems.
DBCAREA A communication structure shared by an application program and CLI. The
application uses it to forward control and data information. CLI uses it to return control and
data information. An application may use a single DBCAREA or multiple DBCAREAs. CLI
retains no knowledge of a particular DBCAREA across multiple CLI calls. CLI is concerned
only with the values for DBCAREA that are meaningful to the routine called.
DBQL Database Query Log. DBQL are a series of system tables created in the Teradata
Database during the Teradata Database installation process. They are used to track query
processing. See Database Administration to learn more about the DBQL.
DBQM
Database Query Manager (an earlier version of Teradata QS).
DCB Data Control Block. The control structure that defines the attributes of the file for z/
OS systems.
DDL Data Definition Language. SQL statements used to define, revise, and remove database
objects. They are used to manage and control access to schema objects in a database. See SQL
Reference: Data Definition Statements to learn more.
DML Data Manipulation Language. SQL statements used to change data in the database
tables. Can require an application to supply data to the database using input (bind) variables.
To find out about DML statements, see SQL Reference: Data Manipulation Statements.
DNS Domain Name System. A general-purpose distributed, replicated, data query service
chiefly used on Internet for translating hostnames into Internet addresses. Also, the style of
hostname used on the Internet, though such a name is properly called a fully qualified domain
name. DNS can be configured to use a sequence of name servers, based on the domains in the
name being looked for, until a match is found.
DQM Dynamic Query Manager (an earlier version of Teradata QS) used for scheduling
SQL requests.
DWM Dynamic Workload Manager. A Teradata tool used to create and manage rules that
manage access to a Teradata Database.
E
EUC Extended UNIX Code. Extended UNIX Code (EUC) for Japanese and TraditionalChinese defines a set of encoding rules that can support from 1 to 4 character sets.
128
Teradata Query Scheduler User Guide
Glossary
exclusion join In Teradata SQL, a product join or merge join where only the rows that do
not satisfy (are NOT in) the conditional specified in the SELECT are joined.
execution time frame
waiting to run.
A period of time when DWM can execute scheduled requests that are
G
GSS Generic Security Services. An application level interface (API) to system security
services. It provides a generic interface to services which may be provided by a variety of
different security mechanisms. Vanilla GSS-API supports security contexts between two
entities (known as "principals").
I
ID
Identifier or Identification.
inner join In Teradata SQL, a join operation on two or more tables, according to a join
condition, that returns the qualifying rows from each table.
I/O Input/Output. Communication between a computer and its users, its storage devices,
other computers (via a network) or the outside world. The devices the computer uses to do
this are called "peripherals." What actually counts as I/O depends on what level of detail you
are considering, e.g. communication between processors would not be considered I/O when
considering a multiprocessor as a single system.
J
JDBC Java Database Connectivity. An API for the Java programming language that defines
how a client may access a database. It provide methods for querying and updating data in a
database. JDBC is oriented towards relational databases.
JIS Japanese Industrial Standards specify the standards used for industrial activities in
Japan. The standardization process is coordinated by Japanese Industrial Standards
Committee and published through Japanese Standards Association.
join In Teradata SQL, a join is a SELECT operation that allows you to combine columns
and rows from two or more tables to produce a result. Join types restricted by DWM are inner
join, outer join, merge join, product join, and all joins. For more information, see all joins,
exclusion join, inner join, merge join, nested join, and RowId join.
M
merge join In Teradata SQL, the type of join that occurs when the WHERE conditional of a
SELECT statement causes the system first to sort the rows of two tables based on a join field
(specified in the statement), then traverse the result while performing a merge/match process.
MPP Massively Parallel Processing. An MPP implementation of Teradata consists of
multiple SMP nodes that work together. The nodes are connected through the BYNET, a
combination of hardware and software that allows the vprocs (PEs and AMPs) to
Teradata Query Scheduler User Guide
129
Glossary
communicate with each other. Teradata is a linearly expandable database system because as
additional nodes and vprocs are added, the system capacity scales in a linear fashion.
N
nested join In Teradata SQL, this join occurs when the user specifies a field that is a unique
primary index on one table and which is in itself an index (unique/non-unique primary or
secondary) to the second table.
O
ODBC Open Database Connectivity. An application that may be used by Teradata tools and
utilities to establish a connection with a Teradata Database.
outer join In Teradata SQL, an extension of an inner join operation. In addition to
returning qualifying rows from tables joined according to a join condition (the inner join), an
outer join returns non-matching rows from one or both of its tables. Multiple tables are
joined two at a time.
P
PDE Parallel Database Extensions. A software layer that runs on the operating system on
each node. This additional software layer was created by Teradata to support the parallel
environment.
PE Parsing Engine. Vprocs that receive SQL requests from the client and break the requests
into steps. The PEs send the steps to the AMPs and subsequently return the answer to the
client.
performance groups A performance group is a collection of parameters used to control and
prioritize resource allocation for a particular set of Teradata Database sessions within the
Priority Scheduler. Every Teradata Database session is assigned to a performance group
during the logon process. Performance groups are the primary consideration in partitioning
the working capacity of the Teradata Database. To learn more about performance groups, see
the Priority Scheduler section of Utilities.
performance periods A threshold or limit value that determines when a session is under the
control of that performance period. A performance period links PGs/Teradata Database
sessions under its control to an AG that defines a scheduling strategy. A performance period
allows you to change AG assignments based on time-of-day or resource usage.
product join In Teradata SQL, the type of join that occurs when the WHERE conditional of
a SELECT statement causes the Teradata Database system to compare all qualifying rows
from one table to all qualifying rows from the other table. Because each row of one table is
compared to each row of another table, this join can be costly in terms of system performance.
Note that product joins without an overall WHERE constraint are considered unconstrained
(Cartesian). If the tables to be joined are small, the effect of an unconstrained join on
performance may be negligible, but if they are large, there may be a severe negative effect on
system performance.
130
Teradata Query Scheduler User Guide
Glossary
profiles A profile is a set of parameters you assign to a user, group of users, or an account
that determines what scheduling capabilities are available and how your Teradata Query
Scheduler scheduled requests server handles their scheduled requests.
Q
query analysis A feature that estimates the answer set size (number of rows) and processing
time of a SELECT type query.
query management The primary function of DWM is to manage logons and queries. This
feature examines logon and query requests before they are dispatched for execution within the
Teradata Database, and may reject logons, and may reject or delay queries. It does this by
comparing the objects referenced in the requests to the types of DBA-defined rules.
QS
Query Scheduler. A Teradata tool used to schedule SQL requests.
R
RDBMS Relational Database Management System. A database based on the relational
model developed by E.F. Codd. A relational database allows the definition of data structures,
storage and retrieval operations and integrity constraints.
request A message sent from an application program, such as DWM, to the Teradata
Database. In the Teradata Query Scheduler schedule request environment, a request is the
definition of the parameters and text associated with a schedule request.
resource partition A collection of prioritized PGs related by their users’ associations. Has
an assigned weight that determines the proportion of resources available to that partition
relative to the other partitions defined for that Teradata Database.
results table/file In the Schedule Request environment, a results table or file is a database
table or a Windows file into which result data for a schedule request that is not self-contained
are stored.
results file storage A symbolic name to a root directory where scheduled requests results
are stored. You map a file storage location to a Windows root directory where results are
stored.
RowID join In Teradata SQL, this join occurs when one of the join tables has a non-unique
primary index constant, and another column of that table matches weakly with a non-unique
secondary index column of the second table.
rule Rules are the name given to the method used by DWM to define what requests are
prohibited from being immediately executed on the Teradata Database. That is, the rules
enforced by DWM provide the Query Management capabilities.
S
scheduled requests The capability to store scripts of SQL requests and execute them at a
scheduled later time.
Teradata Query Scheduler User Guide
131
Glossary
self-contained statement A query request that stores the result data that it generates, if any.
For example, an INSERT/SELECT statement would be self-contained, whereas a SELECT
statement would not.
SMP Symmetric Multi Processing. An SMP platform consists of a single Teradata node. An
SMP system has multiple CPUs that work together. All applications run under a single
operating system on the node. The AMPs and PEs on an SMP system communicate through
the BYNET software that handles the message queuing and flow control.
SQL Structured Query Language. An industry-standard language for creating, updating
and, querying relational database management systems. SQL was developed by IBM in the
1970s. It is the de facto standard as well as being an ISO and ANSI standard. It is often
embedded in general purpose programming languages. Programming language used to
communicate with the Teradata Database.
T
TDP Teradata Director Program. An interface for messages communicated between the
client and the Teradata system. TDP transforms headers and parcels into one or more channel
blocks and sends the channel blocks over the block multiplexer channel to the Teradata
system. It provides the data communications component of the Teradata Database. Every
channel-attached client system connected to a Teradata system has at least one TDP
associated with it.
TDPID Teradata Director Program Identifier. In an MVS and VOS3 environment, a tdpid
is a Subsystem ID of four characters; the first three of which are “TDP” and a fourth that
uniquely differentiates TDPs on that system. On VM, the tdpid is the userid of the virtual
machine in which that TDP is executing, and is usually named in the same manner as the
MVS tdpid.
tdwm The database shared by Teradata Dynamic Workload Manager and Teradata Query
Scheduler. Previously called the dbqrymgr database.
U
UTF Universal Transformation Format. A method for converting 16-bit Unicode characters
into 7- or 8-bit characters. UTF-7 converts to 7-bit ASCII for transmission over 7-bit mail
systems, while UTF-8 converts Unicode to 8-bit bytes.
W
workgroups Workgroups represent collections of related scheduled request work for users,
user groups, or accounts. Each workgroup is assigned a maximum number of requests that
can be executing from that workgroup simultaneously thereby ensuring that requests for all
workgroups get a fair share of their scheduled work done within the execution time frames.
132
Teradata Query Scheduler User Guide
Index
A
About icon
Teradata Query Scheduler Viewer 36
About Query Scheduler Operations command
using 71
About Query Scheduler Viewer command
Teradata Query Scheduler Viewer 35
using 39
About Query Scheduler Viewer dialog box 35
Account String box
Teradata Query Scheduler Connect dialog box 30
Account String text box
Teradata Query Scheduler Connect dialog box 94
Teradata Query Scheduler Submit Request dialog box 45
account strings
entering 30
accounts
defined 127
profiles 110, 117
ANSI
defined 127
API
defined 127
Automatically cleaned up after field
Results tab
Teradata Query Scheduler Submit Request dialog box
51
B
BTEQ
defined 127
BTET
defined 127
C
Cancel Job
command 61
Options menu
overview 34
cancel job icon
overview 36
canceling
jobs 61
changing
client parameters 76
Teradata Query Scheduler User Guide
communications parameters 74
server parameters 80
character sets, specifying 27
checking
scheduled requests 21
CLI2SPB
defined 127
client
changing configuration parameters 76
Client command
Configuration menu
overview 69
client parameters
changing 76
default 72
Client Parameters dialog box
opening 69
Client Processes tab
Communications Information dialog box 98, 100
Process Id field 101
Session field 101
client software components 22
CLIv2
defined 127
codes
status 123
Command menu
Connect command
using 29
Disconnect command
using 31
Teradata Query Scheduler Viewer
overview 34
commands See specific command names
Communications command
Configuration menu
overview 69
Information menu
overview 70
using 86
Communications Information dialog box 97
opening 70
using 86
communications parameters
changing 74
default 72
Communications Parameters dialog box
133
Index
opening 69
component identifiers 122
components, client software 22
Configuration menu
Client command
using 76
Communications command
using 74
Teradata Query Scheduler Operations
overview 69
Tracing command
using 78
configuration parameters
changing 71
defaults 72
Connect command
Command menu
overview 34
using 29
connect icon
overview 36
using 29
connecting
Teradata QS server 29
Connections tab
Communications Information dialog box 98, 99
Server Information dialog box 103, 105
copyright information
viewing
Teradata Query Scheduler Operations 71
Teradata Query Scheduler Viewer 39
CPU
defined 128
CPU usage 125
D
Daily option
Scheduling tab
Teradata Query Scheduler Submit Request dialog box
49
Database list
status bar
Teradata Query Scheduler Viewer 39
Database Name box
Teradata QS Connect dialog box 30
Teradata Query Scheduler Connect dialog box 94
Database Name text box
Results tab
Teradata Query Scheduler Submit Request dialog box
51
database table
retrieving job results 63
Day text box
134
Scheduling tab
Teradata Query Scheduler Submit Request dialog box
49
DB Table option 51
DBA
defined 128
DBC Name 73
DBC Name text box
Sever Parameters dialog box 81
DBCAREA
defined 128
DBQL
defined 128
DBQM
defined 128
DCB
defined 128
DDL
defined 128
debugging 77
Default Database box
Teradata Query Scheduler Connect dialog box 30, 94
Default Server Name field
Parameters tab
Communications Information dialog box 99
Default Server Port field
Parameters tab
Communications Information dialog box 99
defaults
database
specifying 30
Teradata Query Scheduler
configuration parameters 72
Delete command
Error Log menu
overview 70
using 92
Delete Error Log Files dialog box
using 92
Delete Job command
Options menu
overview 34
using 61
delete job icon
overview 36
Delete Request command
Options menu
overview 34
using 60
deleting
error log files 92
jobs 61
dialog boxes
About Query Scheduler Viewer 35
Teradata Query Scheduler User Guide
Index
disabling
scheduled requests 20
Disconnect command
Command menu
overview 34
using 31
disconnect icon
overview 36
using 31
disconnecting
Teradata QS server 31
dispatching
jobs 21
displaying
status bar, Teradata Query Scheduler Viewer 39
toolbar, Teradata Query Scheduler Viewer 36
DML
defined 128
DNS
defined 128
DQM
defined 128
drivers
ODBC 25
TCP/IP 25
Token Ring packet 25
Drop Results command
Options menu
overview 34
using 65
dropping
results 65
E
E-mail address for notification on completion text box
Teradata Query Scheduler Submit Request dialog box 46
e-mail notification 46
Enable Client Tracing check box 78
Enable Communications Tracing check box 78
Enable Server Tracing check box 78
enabling
scheduled requests 20
error log files See log
Error Log menu
Delete command
using 92
Save command
using 91
Teradata Query Scheduler Operations
overview 70
View command
using 91
Estimates lists
Teradata Query Scheduler User Guide
Results tab
Teradata Query Scheduler Submit Request dialog box
46
EUC
defined 128
exclusion joins
defined 129
executing jobs 21
Executing Jobs tab
Scheduled Requests Information dialog box 109, 113
execution
time frames 21
execution time frames
defined 129
Execution Time Frames tab
Scheduled Requests Information dialog box 109, 114
Export Results Table option, setting 41
Export Results Tables check box
Query Scheduler Viewer Settings dialog box 95
exporting
results table data, setting 41
F
Fallback check box 51
field descriptions
Query Scheduler Viewer Settings dialog box 95
SQL Text dialog box 96
Teradata Query Scheduler Viewer 33
Field Separator list
Results tab
Teradata Query Scheduler Submit Request dialog box
51
File menu
Teradata Query Scheduler Operations 69
File menu See menus
File Name text box
Results tab
Teradata Query Scheduler Submit Request dialog box
51
File Storage Locations tab
Scheduled Requests Information dialog box 110, 116
files
installation 73
schedlog 78
tqslog See log
trace 73
writing log 73
Free Memory (KB) field
Parameters tab
Communications Information dialog box 99
Free Msg Buffers field
Parameters tab
Communications Information dialog box 99
135
Index
Frequency frame
Scheduling tab
Teradata Query Scheduler Submit Request dialog box
49
inner joins
defined 129
installation directory 73
internet services, server 79
G
J
General tab
Scheduled Requests Information dialog box 109, 110
Server Information dialog box 103, 104
gethostname values 72
glossary 127
GSS
defined 129
JDBC
defined 129
JIS
defined 129
Job ID column
Teradata Query Scheduler Viewer 37, 56
Job Information command
Options menu
overview 35
using 65
job information icon
overview 36
jobs
canceling 61
definition 20
deleting 61
dispatching 21
executing 21
results data
database table 63
retrieving 62
server file 64
viewing 65
Jobs list
columns 37, 56
refreshing 57
setting refresh rate 41
Teradata Query Scheduler Viewer 33, 37
Jobs menu
Delete Job command 61
Delete Request command 60
Drop Results command 65
Request Properties command 57
joins
defined 129
H
Help menu
About Query Scheduler Viewer command
Teradata Query Scheduler Viewer 35
Help Topics command
Teradata Query Scheduler Viewer 35
Teradata Query Scheduler Operations
overview 70
Teradata Query Scheduler Viewer 35
Help Topics command
Teradata Query Scheduler Viewer 35
hiding
toolbar, Teradata Query Scheduler Viewer 36
HOSTS file 81
Hour text box
Scheduling tab
Teradata Query Scheduler Submit Request dialog box
49
I
I/O
defined 129
icons See specific icon names
ID
defined 129
identifiers
component 122
information
communications 86, 87, 89
scheduled requests 89
server 87
Information column
Teradata Query Scheduler Viewer 37, 56
Information menu
Scheduled Requests Information command 89
Server command 87
Teradata Query Scheduler Operations 86
overview 70
136
L
Large Objects support, see LOBs 45
Listener Port field
Parameters tab
Communications Information dialog box 99
Listener Process ID field
Parameters tab
Communications Information dialog box 99
LOBs
using 45
log
Teradata Query Scheduler User Guide
Index
directory 73
dqmlog file 70
error log file 90, 121
tqslog file 90, 121
logs
schedlog 78
M
Max. Start Time column
Teradata Query Scheduler Viewer 37, 56
Maximum Start Interval Days text box
Scheduling tab
Teradata Query Scheduler Submit Request dialog box
49
Maximum Start Interval Hours text box
Scheduling tab
Teradata Query Scheduler Submit Request dialog box
49
Memory Size (KB) field
Parameters tab
Communications Information dialog box 99
menu bar
Teradata Query Scheduler Operations 68
Teradata Query Scheduler Viewer 33, 34
menus See specific menu names
merge joins
defined 129
Minute text box
Scheduling tab
Teradata Query Scheduler Submit Request dialog box
49
Modify parameters to make a new request check box
Teradata Query Scheduler Submit Request dialog box 46
modifying
request properties 58
Month text box
Scheduling tab
Teradata Query Scheduler Submit Request dialog box
49
Monthly option
Scheduling tab
Teradata Query Scheduler Submit Request dialog box
49
More Profile Information dialog box 117, 118
MPP
defined 129
Multiset check box 51
N
nested joins
defined 130
Network Node Address field
Parameters tab
Teradata Query Scheduler User Guide
Communications Information dialog box 99
Network Node Name field
Parameters tab
Communications Information dialog box 99
Number of Jobs list
status bar
Teradata Query Scheduler Viewer 39
O
ODBC
defined 130
Once option
Scheduling tab
Teradata Query Scheduler Submit Request dialog box
49
online help
opening 35
opening 35
online help 35
operating systems
supported 25
Options list
Results tab
Teradata Query Scheduler Submit Request dialog box
51
Options menu
Job Information command 65
Retrieve Results command 64
Teradata Query Scheduler Viewer
overview 34
outer join
defined 130
outer joins
defined 130
P
parameters
client
changing 76
communications
changing 74
default configurations 72
Parameters tab
Communications Information dialog box 98
Password box
Server Parameters dialog box 81
Teradata Query Scheduler Connect dialog box 30, 94
passwords
default database logon 73
resetting, tdwm database 80
resetting, Teradata QS database 80
specifying 30
PDE
137
Index
defined 130
performance groups
defined 130
performance periods
defined 130
port number 79
Processes tab
Server Information dialog box 104, 106
product join
defined 130
product version numbers 3
profiles
defined 131
Profiles tab
Scheduled Requests Information dialog box 110, 117
properties
request
modifying 58
viewing 57
Q
QS
defined 131
QS server file
retrieving results 64
query analysis
defined 131
query management
defined 131
Query Scheduler Viewer Settings dialog box
overview 95
R
RDBMS
defined 131
Refresh command
View menu
overview 35
using 57
Refresh every __ minutes spin box
Query Scheduler Viewer Settings dialog box 95
refresh icon
overview 36
refresh rate
setting
Jobs list 41
refreshing
Jobs list 57
registries
Windows 72
rejected requests
SQL Assistant, scheduling 53
Request ID column
138
Teradata Query Scheduler Viewer 37, 56
Request Name column
Teradata Query Scheduler Viewer 37, 56
Request Name text box
Teradata Query Scheduler Submit Request dialog box 45
Request Processor Processes spin box
Server Parameters dialog box 84
request properties
modifying 58
viewing 57
Request Properties command
Options menu
overview 34
using 57
request properties icon
overview 36
Request Scheduling Info dialog box 119
requests
defined 131
deleting 60
rejected
SQL Assistant, scheduling 53
submitting 44
Requests list
status bar
Teradata Query Scheduler Viewer 39
resetting
tdwm database password 80
Teradata QS database password 80
resource partitions
defined 131
results
dropping 65
retrieving
job results, database table 63
job results, server file 64
retrieving job result data 62
saving 43
results file storage
defined 131
results files
defined 131
results tables
defined 131
Retries field
Parameters tab
Communications Information dialog box 99
Retrieve Results command
Options menu
overview 34
overview 62
using 63, 64
retrieve results icon
overview 36
Teradata Query Scheduler User Guide
Index
retrieving
job result data 62
results, Teradata SQL Assistant 62
RowID joins
defined 131
rules
defined 131
S
Save command
Error Log menu
overview 70
using 91
Save Error Log Files dialog box 91
Save Results To options
Results tab
Teradata Query Scheduler Submit Request dialog box
51
saving
result data 43
Schedule column
Teradata Query Scheduler Viewer 37, 56
Schedule SQL command 44
Command menu
overview 34
schedule SQL icon
overview 36
Scheduled Jobs tab
Scheduled Requests Information dialog box 109, 112
scheduled requests
checking 21
defined 20, 131
disabling 20
e-mail notification 46
enabling 20
information 89
job queue, viewing 53
submitting 44
Scheduled Requests command
Information menu
overview 70
using 89
Scheduled Requests Information dialog box 109
opening 70
Scheduled Requests tab
Scheduled Requests Information dialog box 109, 111
scheduling
requests, submitting 44
SQL 44
scheduling information
job 20
security settings 27
self-contained statements
Teradata Query Scheduler User Guide
defined 132
server
changing configuration parameters 80
information 87
internet services 79
Server box
Teradata Query Scheduler Connect dialog box 31, 94
Server command
Configuration menu
overview 69
Information menu
overview 70
using 87
Server File option 51
Server Information dialog box 87, 89, 103
opening 70
Server menu
Teradata Query Scheduler Operations
overview 69
server parameters 78
default 72
Server Parameters dialog box 80
opening 69
servers
changing, configuration parameters 80
Teradata QS, changing configuration parameters 78
sets
character 27
setting
Export Results Table option, Teradata SQL Assistant 41
refresh rate
Jobs list 41
Settings command
using 41
View menu
overview 35
Shared Memory Size (KB) text box
Server Parameters dialog box 84
shortcut menu 38
Teradata Query Scheduler Viewer 38
showing
toolbar, Teradata Query Scheduler Viewer 36
SMP
defined 132
software releases
supported 3
sorting columns 38
specifying
character sets 27
Database name 30
default database 30
Teradata QS server
Teradata Query Scheduler Connect dialog box 31
user name 30
139
Index
SQL
defined 132
SQL box
SQL Text dialog box 96
SQL scheduling 44
SQL text box
Results tab
Teradata Query Scheduler Submit Request dialog box
46
SQL Text dialog box 44
field descriptions 96
overview 96
SQL box, description 96
Start command
Server menu
overview
server service (starting) 69
Start Days/Dates frame
Scheduling tab
Teradata Query Scheduler Submit Request dialog box
49
Start Time frame
Scheduling tab
Teradata Query Scheduler Submit Request dialog box
49
starting
Teradata QS server 84
Teradata Query Scheduler Operations 67
starting Teradata Query Scheduler Viewer 29
Statistics tab
Communications Information dialog box 98, 101
Server Information dialog box 104, 107
status bar
Teradata Query Scheduler Viewer 33
Status Bar command
using 39
View menu
overview 35
status bar, Teradata Query Scheduler Viewer 39
status bars
Teradata Query Scheduler Viewer, displaying 39
status codes 123
Status column
Teradata Query Scheduler Viewer 37, 56
Status list
status bar
Teradata Query Scheduler Viewer 39
Stop command
Server menu
overview
server service (stopping) 69
submitting
scheduled requests 44
support results files, results files 79
140
supported
operating systems 25
T
Table Name text box
Results tab
Teradata Query Scheduler Submit Request dialog box
51
Table Options check box
Results tab
Teradata Query Scheduler Submit Request dialog box
51
TCP/IP driver 25
TDP
defined 132
TDPID
defined 132
tdwm
defined 132
tdwm database
password, resetting 80
Teradata QS database
password, resetting 80
Teradata QS server
connecting 29
disconnecting 31
information
specifying 31
starting 84
Teradata Query Scheduler
installation directory 73
Teradata Query Scheduler Connect dialog box 30
Account String box 30
Account String text box, description 94
Database Name box 30
Database Name box, description 94
Default Database box 30
Default Database box, description 94
field descriptions 93
overview 93
Password box 30
Password box, description 94
Server box, completing 31
Server box, description 94
User Name box 30
User Name box, description 94
Teradata Query Scheduler Operations
configuration parameters 71
enabling tracing 77
error log files 91
menu bar 68
overview 67
starting 67
Teradata Query Scheduler User Guide
Index
viewing, component information 86
Teradata Query Scheduler Operations utility 18
menus See menus
Teradata Query Scheduler Submit Request dialog box 45
modifying requests 58
overview 22
Teradata Query Scheduler Viewer 55
cancel job icon, overview 36
columns, Information 37
columns, Job ID 37
columns, Max Start Time 37
columns, Request ID 37
columns, Request Name 37
columns, Schedule 37
columns, Status 37
Command menu
Connect command 34
Disconnect command 34
Schedule SQL command 34
connect icon, overview 36
delete job icon, overview 36
disconnect icon, overview 36
field descriptions 33
Help menu 35
job information icon, overview 36
Jobs list columns, descriptions 37
Jobs list, column headers 38
Jobs list, description 33, 37
menu bar, description 33, 34
menus See menus
navigating 32
Options menu
Cancel Job command, overview 34
Delete Job command, overview 34
Delete Request command, overview 34
Drop Results command, overview 34
Job Information command, overview 35
Request Properties command, overview 34
Retrieve Results command, overview 34
overview 22, 55
refresh icon, overview 36
request properties icon, overview 36
retrieve results icon, overview 36
schedule SQL icon, overview 36
shortcut menu 38
shortcut menu, descriptions 38
starting 29
status bar 39
Database list 39
Jobs list 39
Requests list 39
Status list 39
Time frame list 39
status bar, description 33
Teradata Query Scheduler User Guide
status bar, displaying 39
toolbar
About icon 36
toolbar, description 33, 35
toolbar, displaying 36
View menu
Refresh command, overview 35
Settings command, overview 35
Status Bar command, overview 35
Toolbar command, overview 35
Teradata SQL Assistant
configuration parameters 72
export results table option, setting 41
results, retrieving 62
retrieving results 62
scheduling rejected requests 53
Time frame list
status bar
Teradata Query Scheduler Viewer 39
time frames
execution 21
toolbar
Teradata Query Scheduler Viewer 33, 35
Toolbar command
using 36
View menu
overview 35
toolbars
Teradata Query Scheduler Viewer, displaying 36
Trace Activity to Files dialog box 78
opening 69
tracing
configuration parameters 72
disabling 77
enabling 77
tracing files 77
Tracing command
Configuration menu
overview 69
U
Update button
Results tab
Teradata Query Scheduler Submit Request dialog box
47
user name
specifying 30
User Name box
Teradata Query Scheduler Connect dialog box 30, 94
User Name text box
Server Parameters dialog box 81
Teradata Query Scheduler Submit Request dialog box 45
using
141
Index
LOBs 45
UTF
defined 132
V
Y
Year text box
Scheduling tab
Teradata Query Scheduler Submit Request dialog box
49
version information
About Query Scheduler Operations 71
Teradata Query Scheduler Viewer
viewing 39
viewing
Teradata Query Scheduler Operations 71
version numbers 3
View command
Error Log menu
using 91
overview 70
View Error Log File dialog box 90, 91, 121
View menu
Refresh command 57
Settings command 41
Status Bar command 39
Teradata Query Scheduler Viewer
overview 35
Toolbar command 36
View menu See menus
Viewer See Teradata Query Scheduler Viewer
viewing
component information 86
copyright information
Teradata Query Scheduler Operations 71
job result information 65
request properties 57
scheduled requests 55
scheduled requests job queue 53
version information
Teradata Query Scheduler Operations 71
W
Weekly option
Scheduling tab
Teradata Query Scheduler Submit Request dialog box
49
Windows
registry 72
Windows Server 2003
security settings 27
workgroups
defined 132
Workgroups tab
Scheduled Requests Information dialog box 109, 115
142
Teradata Query Scheduler User Guide
Download PDF
Similar pages