You are on page 1of 76

Teradata Query Scheduler

Administrator Guide

Release 14.00
B035-2511-071A
August 2011

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 Youve Never Seen Your Business Like
This Before are trademarks or registered trademarks of Teradata Corporation or its affiliates in the United States and other countries.
Adaptec and SCSISelect are trademarks or registered trademarks of Adaptec, Inc.
AMD Opteron and Opteron are trademarks of Advanced Micro Devices, Inc.
EMC, PowerPath, SRDF, and Symmetrix are registered trademarks of EMC Corporation.
GoldenGate is a trademark of Oracle.
Hewlett-Packard and HP are registered trademarks of Hewlett-Packard Company.
Intel, Pentium, and XEON are registered trademarks of Intel Corporation.
IBM, CICS, RACF, Tivoli, and z/OS are registered trademarks of International Business Machines Corporation.
Linux is a registered trademark of Linus Torvalds.
LSI is a registered trademark of LSI Corporation.
Microsoft, Active Directory, Windows, Windows NT, and Windows Server are registered trademarks of Microsoft Corporation in the United
States and other countries.
NetVault is a trademark or registered trademark of Quest Software, Inc. in the United States and/or other countries.
Novell and SUSE are registered trademarks of Novell, Inc., in the United States and other countries.
Oracle, Java, and Solaris are registered trademarks of Oracle and/or its affiliates.
QLogic and SANbox are trademarks or registered trademarks of QLogic Corporation.
SAS and SAS/C are trademarks or registered trademarks of SAS Institute Inc.
SPARC is a registered trademark of SPARC International, Inc.
Symantec, NetBackup, and VERITAS are trademarks or registered trademarks of Symantec Corporation or its affiliates in the United States
and other countries.
Unicode is a registered trademark of Unicode, Inc. in the United States and other countries.
UNIX is a registered trademark of The Open Group in the United States and other countries.
Other product and company names mentioned herein may be the trademarks of their respective owners.

THE INFORMATION CONTAINED IN THIS DOCUMENT IS PROVIDED ON AN AS-IS BASIS, WITHOUT WARRANTY OF ANY KIND, EITHER
EXPRESS OR IMPLIED, INCLUDING THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR
NON-INFRINGEMENT. SOME JURISDICTIONS DO NOT ALLOW THE EXCLUSION OF IMPLIED WARRANTIES, SO THE ABOVE EXCLUSION
MAY NOT APPLY TO YOU. IN NO EVENT WILL TERADATA CORPORATION BE LIABLE FOR ANY INDIRECT, DIRECT, SPECIAL, INCIDENTAL,
OR CONSEQUENTIAL DAMAGES, INCLUDING LOST PROFITS OR LOST SAVINGS, EVEN IF EXPRESSLY ADVISED OF THE POSSIBILITY OF
SUCH DAMAGES.
The information contained in this document may contain references or cross-references to features, functions, products, or services that are
not announced or available in your country. Such references do not imply that Teradata Corporation intends to announce such features,
functions, products, or services in your country. Please consult your local Teradata Corporation representative for those features, functions,
products, or services available in your country.
Information contained in this document may contain technical inaccuracies or typographical errors. Information may be changed or updated
without notice. Teradata Corporation may also make improvements or changes in the products or services described in this information at any
time without notice.
To maintain the quality of our products and services, we would like your comments on the accuracy, clarity, organization, and value of this
document. Please email: 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-2011 by Teradata Corporation. All Rights Reserved.

Preface
Purpose
This book provides information about Teradata Query Scheduler (Teradata QS), which is a
Teradata Tools and Utilities product. Teradata Tools and Utilities are a group of products
designed to work with Teradata Database.
Teradata QS enables the database administrator to manage workloads submitted to the
Teradata Database. This book will help the database administrator (DBA) learn, manage, and
skillfully utilize the Teradata QS features.

Audience
This book is intended for use by:

Teradata Database administrator

Other technical personnel who manage both the Teradata QS and Teradata QS server
software programs

Supported Releases
This book supports the following releases:

Teradata Database 14.01

Teradata Tools and Utilities 14.00

Teradata Query Scheduler 14.00


Note: See Help Menu on page 28 to learn how to verify the Teradata QS version number.

To locate detailed supported-release information:


1

Go to http://www.info.teradata.com/.

Under Online Publications, click General Search.

Type 3119 in the Publication Product ID box.

Under Sort By, select Date.

Click Search.

Open the version of the Teradata Tools and Utilities ##.##.## Supported Platforms and
Product Versions spreadsheet associated with this release.

1. If and when Teradata Database 14.0 is released, features may change.

Teradata Query Scheduler Administrator Guide

Preface
Prerequisites

The spreadsheet includes supported Teradata Database versions, platforms, and product
release numbers.

Prerequisites
The following prerequisite knowledge is required for this product:

Relational database management systems

Teradata SQL

Basic concepts of the Teradata Database

Connectivity software, such as CLIv2

Changes to This Book


The following changes were made to this book in support of the current release. Changes are
marked with change bars. For a complete list of changes to the product, see the Release
Definition associated with this release.
Date and Release

Description

August 2011
14.00

Updated TQS release number from 13.10 to 14.00.


Updated product release number to 14.0 for DBS.
Updated product release number for TTU and its applications.
Documentation updated to reflect that Windows 2000 support has been
removed.

Additional Information
Additional information that supports this product and Teradata Tools and Utilities is available
at the web sites listed in the table that follows. In the table, mmyx represents the publication
date of a manual, where mm is the month, y is the last digit of the year, and x is an internal
publication code. Match the mmy of a related publication to the date on the cover of this book.
This ensures that the publication selected supports the same release.

Teradata Query Scheduler Administrator Guide

Preface
Additional Information

Type of Information

Description

Access to Information

Release overview

Use the Release Definition for the following


information:

1 Go to http://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 Type 2029 in the Publication Product ID box.

Use the Teradata Information Products web


site to view or download specific manuals
that supply related or additional
information to this manual.

1 Go to http://www.info.teradata.com/.

Late information

Additional product
information

2 Under Online Publications, click General Search


4 Click Search.
5 Select the appropriate Release Definition from

the search results.

2 Under the Online Publications subcategory,

Browse by Category, click Data Warehousing.


3 Do one of the following:

For a list of Teradata Tools and Utilities


documents, click Teradata Tools and Utilities,
and then select an item under Releases or
Products.
Select a link to any of the data warehousing
publications categories listed.
Specific books related to Teradata QS are as follows:
Teradata Query Scheduler User Guide
B035-2497-mmyx
Teradata SQL Assistant for Microsoft Windows
User Guide
B035-2430-mmyx
Teradata Tools and Utilities Installation Guide for
Microsoft Windows
B035-2407-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.

1 Go to http://www.info.teradata.com/.
2 Under the Online Publications subcategory,

Browse by Category, click Data Warehousing.


3 Click CD-ROM Images.
4 Follow the ordering instructions.

Ordering
information for
manuals

Use the Teradata Information Products web


site to order printed versions of manuals.

1 Go to http://www.info.teradata.com/.
2 Under Print & CD Publications, click How to

Order.
3 Follow the ordering instructions.

Teradata Query Scheduler Administrator Guide

Preface
Additional Information

Type of Information

Description

Access to Information

General information
about Teradata

The Teradata home page provides links to


numerous sources of information about
Teradata. Links include:

1 Go to http://www.teradata.com/t/resources.
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

Teradata Query Scheduler Administrator 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:
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
About the Teradata QS Architecture. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
What Does Teradata QS Do? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
What Are Scheduled Requests? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
How Are Scheduled Requests Processed? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Request Checking. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Job Dispatching . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Job Execution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

17
18
18
18

What Can I Do with Teradata QS? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19


How Do I Start the Teradata QS Server?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
How Do I Get Help? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Chapter 2:
Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
System and Software Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Supported Client Operating Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Required Client Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Optional Client Software. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Database Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

21
21
21
22
22

Modify the HOSTS File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22


Verify the Network Connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Teradata Query Scheduler Administrator Guide

Table of Contents

Chapter 3:
Navigate Teradata QS Administrator . . . . . . . . . . . . . . . . . . . . . . . . . . . . .25
Menu Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .25
File Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .26
Configuration Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .26
Options Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .27
Servers Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .27
View Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .27
Help Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .28
Scheduled Requests List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .28
Sorting the Scheduled Requests List. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .29
Using the Shortcut Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .29
Status Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .30

Chapter 4:
Prepare the Teradata QS Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31
Run the TQS Setup Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31
New Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31
Upgrade Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .32
Migrate the Teradata QS Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .32

Chapter 5:
Use the Teradata QS Administrator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .35
Open the Teradata Query Scheduler Administrator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .35
Open Teradata QS in View-Only Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .36
Exit the Teradata Query Scheduler Administrator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .37
Configure the Scheduled Requests . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .37
View Teradata QS Server Status. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .37
Configure Execution Time Frames . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .38
Create and Edit Execution Time Frames . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .39
Delete Execution Time Frames . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .40
Set Up Workgroups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .40
Create and Edit Workgroups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .41
Delete Workgroups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .42
Manage Results File Storage. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .42
Save Scheduled Requests Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .43
8

Teradata Query Scheduler Administrator Guide

Table of Contents

Create and Edit Results File Storage Locations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43


Delete Results File Storage Locations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Manage Scheduler Profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Automatic Cleanup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Create and Edit Scheduler Profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Delete Scheduler Profiles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Clean Up Scheduler Profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
View-Only Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

44
45
45
50
50
51

Chapter 6:
Work with Scheduled Requests . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
View Scheduled Requests . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Refresh the Scheduled Requests List. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Manage Scheduled Requests . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
View SQL Statements for a Scheduled Request. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Change the Execute Time for a Scheduled Job . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Execute a Job Immediately . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Delete a Scheduled Request. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Cancel a Job . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Delete a Job . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Abort a Job . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Drop Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
View Job Result Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

55
55
55
56
56
56
57
57
58
58

Schedule Rejected Teradata SQL Assistant Queries. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59


Set Up E-mail Notifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

Appendix A:
About the Dialog Boxes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Refresh Interval Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Results File Storage Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Results File Storage Properties Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Scheduler Profiles Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Workgroups Dialog Box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Workgroup Properties Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

Teradata Query Scheduler Administrator Guide

Table of Contents

Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .67

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .73

10

Teradata Query Scheduler Administrator Guide

List of Figures

Figure 1: Teradata QS Client/Server Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15


Figure 2: Teradata Query Scheduler Administrator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Figure 3: Teradata Query Scheduler Administrator Menu Bar . . . . . . . . . . . . . . . . . . . . . . . . 26
Figure 4: Scheduled Requests List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Figure 5: Teradata Query Scheduler Administrator Status Bar . . . . . . . . . . . . . . . . . . . . . . . . 30
Figure 6: Refresh Interval Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Figure 7: Results File Storage Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Figure 8: Results File Storage Properties Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Figure 9: Scheduler Profiles Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Figure 10: Workgroups Dialog Box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Figure 11: Workgroup Properties Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

Teradata Query Scheduler Administrator Guide

11

List of Figures

12

Teradata Query Scheduler Administrator Guide

List of Tables

Table 1: File Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26


Table 2: Configuration Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Table 3: Options Menu. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Table 4: Servers Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Table 5: View Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Table 6: Help Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Table 7: Scheduled Requests List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Table 8: Status Bar. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Table 9: Teradata Query Scheduler Admin Logon Dialog Box Description . . . . . . . . . . . . . . 36
Table 10: Scheduler Profile Properties: Scheduling Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Table 11: Scheduler Profile Properties: Results Tables/Files Tab . . . . . . . . . . . . . . . . . . . . . . . 48
Table 12: Scheduler Profile Properties: User Options Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Table 13: Teradata QS Administrator Functions in View-Only Mode . . . . . . . . . . . . . . . . . . 51
Table 14: Scheduled Requests List: Teradata Query Scheduler Administrator . . . . . . . . . . . . 53
Table 15: Refresh Interval Dialog Box Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Table 16: Results File Storage Dialog Box Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Table 17: Results File Storage Properties Dialog Box Description . . . . . . . . . . . . . . . . . . . . . . 63
Table 18: Scheduler Profiles Dialog Box Options Description . . . . . . . . . . . . . . . . . . . . . . . . . 64
Table 19: Workgroups Dialog Box Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
Table 20: Workgroup Properties Dialog Box Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

Teradata Query Scheduler Administrator Guide

13

List of Tables

14

Teradata Query Scheduler Administrator Guide

CHAPTER 1

Introduction

Before using Teradata QS, it may be helpful to read through a product overview. Browse
through these topics to learn more:

About the Teradata QS Architecture

What Does Teradata QS Do?

What Are Scheduled Requests?

How Are Scheduled Requests Processed?

What Can I Do with Teradata QS?

How Do I Start the Teradata QS Server?

How Do I Get Help?

About the Teradata QS Architecture


Teradata QS is designed to manage request input to your Teradata Database and keep the
database running at optimum performance levels. Teradata QS consists of client and server
system components, and a separate database within your Teradata Database called TDWM.
See Figure 1.
Figure 1: Teradata QS Client/Server Architecture
Teradata QS
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

User
Database(s)

(runs on the
primary server
only)

Teradata QS
Communications
Library

Teradata QS
Database
(4$7-)

Teradata Database System

Teradata Query Scheduler Administrator Guide

Teradata QS
Executor
Program

2496B003

15

Chapter 1: Introduction
About the Teradata QS Architecture

Teradata QS Client Components


The client component includes:

Teradata Query Scheduler Viewer

Teradata Query Scheduler Submit dialog box

Teradata Query Scheduler Operations utility

Teradata QS client library

Teradata QS communications library

End-users use the Teradata Query Scheduler Submit dialog box to submit single or multiple
SQL statement requests for execution at a later date and time. They also use the Teradata
Query Scheduler Viewer to manage the request results.
The Teradata QS client library has the API for the Teradata QS Viewer. The Teradata QS
communications library handles socket communication with the Teradata QS server.
The DBA configures and views information about the state of the Teradata QS components in
the client/server architecture from the Teradata Query Scheduler Operations utility.
The Teradata Query Scheduler Operations utility is used to manage both the Teradata QS client
and Teradata QS server software programs. The DBA uses the Teradata Query Scheduler
Operations tool to configure and start the Teradata QS server before end-users can schedule
SQL requests.
To learn about the Teradata QS client components, see Teradata Query Scheduler User Guide.

Teradata QS Server Components


The server component includes:

Teradata QS 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
The DBA uses the Teradata Query Scheduler Administrator to enable the scheduled request
feature, set up user profiles, and setup time frames in which schedule requests are executed by
Teradata QS.
Note: The TDWM database is shared by Teradata Dynamic Workload Manager (Teradata
DWM). However, Teradata QS maintains its own tables within the TDWM database. For
more information about Teradata DWM, see Teradata Dynamic Workload Manager User
Guide.
In prior versions of Teradata QS (Teradata DQM), the DBA used the administrator
components to create and manage Teradata Database rules. This function has been moved to
16

Teradata Query Scheduler Administrator Guide

Chapter 1: Introduction
What Does Teradata QS Do?

Teradata DWM. Using the Teradata DWM, the DBA can set up rules that manage database
access, increase database efficiency, and enhance workload capacity. Two types of flexible rules
can be created that examine logon and query requests, and that can reject or delay query
requests.

What Does Teradata QS Do?


Teradata QS provides a database request scheduling service. Queries are scheduled through
client applications such as the Teradata Scheduler Viewer and Teradata SQL Assistant. For
more information about Teradata Scheduler Viewer, see Teradata Query Scheduler User Guide.
For more information about SQL Assistant, see Teradata SQL Assistant for Microsoft Windows
User Guide.
The Teradata QS Server accepts new requests, executes scheduled requests at specified times,
and returns request information and status to clients.

What Are Scheduled Requests?


Scheduled requests are SQL queries scheduled by end-users for off-line execution. Requests
are scheduled using the Teradata Query Scheduler Submit dialog box.
When end-users know of existing database rules that will prevent a SQL request from running
or if they suspect their queries may overload the Teradata Database, they can actively schedule
a request using the Teradata Query Scheduler Submit dialog box.
When a request is scheduled, end-users provide information that defines preferences for when
it is executed. A request can be scheduled to run periodically or only once during a specified
time period without an active system user connection.
Because a scheduled request can actually be executed many times, the term request is used to
mean the actual definition of the scheduled request parameters. The term job is used to mean
an individual instance a scheduled request is scheduled to run.
For example, a scheduled request can be defined to execute daily. That request causes a
separate job to be created every day to execute that request.
The DBA enables or disables the scheduled request feature on your Teradata Database using
the Teradata Query Scheduler Administrator.
To learn how to enable or disable the scheduled request feature, see Configure the Scheduled
Requests on page 37.

How Are Scheduled Requests Processed?


Teradata QS accepts single- or multiple-statement query requests for execution at a later time.
However, scheduling a request does not guarantee that it is executed at the date and time

Teradata Query Scheduler Administrator Guide

17

Chapter 1: Introduction
How Are Scheduled Requests Processed?

specified. Scheduled requests are subject to the same Teradata Database rule checking as are
interactive requests.
In addition, an execution time frame must be available during the time specified to execute
the request. To learn more about execution time frames, see Configure Execution Time
Frames on page 38.
Scheduled requests are subject to three phases of processing:

Request Checking

Job Dispatching

Job Execution

Request Checking
When a scheduled request is submitted, the Teradata QS server does the following:

Uses the scheduling information the user provides as the intended start time for the
request.
Because a request may not be run until some time after the requested start time, a time
interval in which the request may be run must also be specified.

Checks for an available execution time frame during the specified time period. If no
execution time frames are available, the request is rejected.

Schedules the first job for the request. Unique IDs are generated for the request and its first
job.

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:

18

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.

Teradata Query Scheduler Administrator Guide

Chapter 1: Introduction
What Can I Do with Teradata QS?

When a job needs to be rescheduled, an updated execution time is computed. If the


updated time exceeds the start interval for the job, the status of the job is marked as
restricted because it will not be completed within its execution time frame.

If a results table/file was specified, the last statement of the scheduled request is first run in
prepare mode to obtain the column types and names of the result data. If necessary, the
result table/file is recreated with those column types, and the last statement (which must
be a SELECT statement) is run. The result data is written to the results table/file.

What Can I Do with Teradata QS?


The Teradata QS Administrator is a Windows-based GUI (graphical user interface) that allows
the DBA to set up and manage these Teradata QS features:

Enable or disable scheduled requests.

Create, delete, or modify time periods (called execution time frames) when scheduled
requests are executed by Teradata QS.

Create, delete, or modify workgroups that equitably distribute resources and scheduled
requests workloads during execution time frames.

Create, delete, or modify the locations where scheduled request results files are stored and
accessed by all Teradata QS servers.

Create, delete, or modify sets of scheduled request attributes (called profiles) for users,
accounts, DBS roles, and DBS profiles.

View, execute, cancel, immediately submit, abort, delete, or modify scheduled SQL
requests and jobs to avoid adversely affecting a Teradata Database during prime usage
periods.

View Teradata QS scheduled request server status.

Configure the behavior of scheduled requests using profiles.

See Chapter 5: Use the Teradata QS Administrator to learn how to use these features. For
detailed descriptions of the controls in this interface, see Chapter 3: Navigate Teradata QS
Administrator
Teradata QS has a view-only mode that allows users to log on without being an administrator.
In view-only mode, the user can view Teradata QS settings, but cannot make changes. For
more information on logging on in view-only mode, see Open the Teradata Query Scheduler
Administrator on page 35. For a detailed description of the functionality of Teradata QS in
view-only mode, see View-Only Mode on page 51.

How Do I Start the Teradata QS Server?


The Teradata Query Scheduler Operations tools are used to manage both the Teradata QS
client and Teradata QS server software programs. The DBA must use the Teradata Query

Teradata Query Scheduler Administrator Guide

19

Chapter 1: Introduction
How Do I Get Help?

Scheduler Operations tools to configure and start the Teradata QS server before end-users can
schedule SQL requests.
For instructions on starting the Teradata QS Server, see Teradata Query Scheduler User Guide.

How Do I Get Help?


Teradata QS online help answers questions about how to use Teradata QS features. Online
help (including context-sensitive help) opens in a browser window. Microsoft Internet
Explorer, version 6.0 or later, is the recommended browser for viewing online help and
context-sensitive help. A browser other than the recommended browser might result in
incorrectly displayed help.
If using Microsoft Internet Explorer, version 7.0, see, To allow online help content to appear
using Internet Explorer, version 7.0.

To open online help


From the Teradata Query Scheduler Administrator menu, click Help>Help Topics.

The Help window opens. Use the tools available from the Help window to navigate to other
topics.

To open context-sensitive help


From most windows and dialog boxes, press F1 to see context-sensitive help for the active

window or dialog box.

To allow online help content to appear using Internet Explorer, version 7.0
Use this procedure if a warning appears such as, To help protect your security, Internet Explorer
has restricted this webpage from running scripts or ActiveX controls that could access your
computer.

20

Open Microsoft Internet Explorer, version 7.0.

Click Tools>Internet Options.

Click the Advanced tab.

Under Security, click Allow active content to run in files on My Computer*, and click OK.

Close and then reopen Microsoft Internet Explorer for this change to take effect.

Teradata Query Scheduler Administrator Guide

CHAPTER 2

Prerequisites

Before using Teradata QS, make sure your system is set up correctly. Also set up a Teradata
CLIv2 (Call-Level Interface version 2) connection. Browse through the following topics to
learn more:

System and Software Requirements

Modify the HOSTS File

Verify the Network Connection

For detailed installation information, see Teradata Tools and Utilities Installation Guide for
Microsoft Windows.

System and Software Requirements


Teradata QS has the following system and software requirements:

Supported Client Operating Systems

Required Client Software

Optional Client Software

Database Requirements

Supported Client Operating Systems


Teradata QS client/server architecture can run on these operating systems:

Client components running on Microsoft Windows 2003, XP, or Vista

Server components running on Windows 2003, XP, or Vista

Teradata QS Administrator running Windows 2003, XP, or Vista

Required Client Software


The following software must be installed on the client system:

TCP/IP driver with WinSock support for Windows version 1.1 or later

Ethernet or Token Ring packet driver compatible with the above

Teradata GSS (Generic Security Services) 14.00

Teradata CLIv2 (Call-Level Interface version 2) release 14.00

tdicu (Shared Common Components for Internationalization for Teradata) 14.00

Teradata Query Scheduler Administrator Guide

21

Chapter 2: Prerequisites
Modify the HOSTS File

Optional Client Software


The following software can be installed on the client system:

Teradata ODBC Driver for Windows


Install the Teradata ODBC driver for Windows to use Teradata SQL Assistant.

Teradata SQL Assistant


Install Teradata SQL Assistant for scheduling requests rejected due to Teradata Dynamic
Workload Manager rules and for retrieving job results. See Teradata Query Scheduler User
Guide to find out how Teradata SQL Assistant handles job results.

Database Requirements
Prior to running Teradata Query Scheduler 14.00, run the tqssetup.bteq script. The script
installs important updates to the TDWM database. Teradata Query Scheduler 14.00 requires
Teradata Database V2R6.1 or later.

Modify the HOSTS File


If your site does not use a DNS, define the IP address and the Teradata Database name to use
in the system HOSTS file of the workstation.

To Define the System IP Address and Teradata Database Name


1

Open Windows Explorer and navigate to the HOSTS file in the subdirectory of the
directory in which Windows is installed.

Open the HOSTS file in a text editor.

Add the IP address and the Teradata Database name with the COP1 suffix.

Save and exit the file.


To ensure the network connection is correct, continue with Verify the Network
Connection on page 22.

Verify the Network Connection


Use the following procedure to test the network connection before opening Teradata QS and
connecting to a Teradata Database:

To verify a network connection


1

Click Start and select Run.


A Run dialog box appears.

22

Teradata Query Scheduler Administrator Guide

Chapter 2: Prerequisites
Verify the Network Connection
2

In the Open text box, type the PING command followed by the name of the Teradata
Database and the COP1 suffix. For example: PING ssscop1
Where sss is the Teradata Database to connect to.

If the PING command does not receive a successful response from the network, see the
network administrator to determine the cause.

Teradata Query Scheduler Administrator Guide

23

Chapter 2: Prerequisites
Verify the Network Connection

24

Teradata Query Scheduler Administrator Guide

CHAPTER 3

Navigate Teradata QS Administrator

Before using Teradata QS Administrator, familiarize yourself with the GUI (graphical user
interface).
After verifying that the system is set up and configured correctly, the Teradata Query
Scheduler Administrator (Figure 2) is ready for use. The basic features of the Teradata Query
Scheduler Administrator interface are:

The Menu Bar, located immediately below the title bar, is used to access all of the Teradata
Query Scheduler Administrator commands.

The Scheduled Requests List, located below the menu bar, shows all users scheduled
requests and jobs.

The Status Bar, located at the bottom of the window, shows information about the
database status.

Figure 2: Teradata Query Scheduler Administrator

See Chapter 5: Use the Teradata QS Administrator and Chapter 6: Work with Scheduled
Requests to find out about using the Teradata Query Scheduler Administrator.
To get familiar with the Teradata QS Administrator dialog boxes, see Appendix A: About the
Dialog Boxes.

Menu Bar
Use the menu bar in the Teradata Query Scheduler Administrator (Figure 3) to access all
functions and features in Teradata QS. Use your mouse or keyboard to select the commands in
these menus:

Teradata Query Scheduler Administrator Guide

25

Chapter 3: Navigate Teradata QS Administrator


Menu Bar

File Menu

Configuration Menu

Options Menu

Servers Menu

View Menu

Help Menu

Figure 3: Teradata Query Scheduler Administrator Menu Bar

File Menu
The following table describes the commands of the File menu.
Table 1: File Menu

Command

Description

Exit

Disconnects from the Teradata Database and closes the Teradata Query
Scheduler Administrator.

Configuration Menu
The following table describes the commands of the Configuration menu:
Table 2: Configuration Menu

26

Command

Description

Scheduler Profiles

Set up groups of users, accounts, DBS roles, and DBS profiles that are associated
with Teradata QS profiles.

Workgroups

Set up attributes for workgroups that control how many simultaneously


executing SQL requests can be executed.

Results File
Storage

Set up Windows directory paths to locations where Teradata QS servers can


create and store results files.

Execution Time
Frames

Set up time periods when scheduled SQL requests can be executed.

Enable/Disable
Scheduling

Make SQL request scheduling available or unavailable.

Teradata Query Scheduler Administrator Guide

Chapter 3: Navigate Teradata QS Administrator


Menu Bar

Options Menu
The following table describes the commands of the Options menu:
Table 3: Options Menu

Command

Description

Cancel Job

Terminates a job with a Waiting status selected from the Scheduled Requests list.

Modify Execute
Time

Specify a new schedule execution date and time for a job with a Waiting status
selected from the Scheduled Requests list.

Execute Now

Immediately run a job with a Waiting status selected from the Scheduled
Requests list. Or immediately re-execute a job selected from the Scheduled
Requests list that has failed for any reason.

Abort Job

Terminate a job with an Executing status selected from the Scheduled Requests
list.

Delete Request

Remove the request selected from the Scheduled Requests list and all the related
jobs.

Delete Job

Remove the job selected from the Scheduled Requests list.

Drop Results

Eliminate the results table or file for the job or request selected from the
Scheduled Requests list.

Job Information

Show all of the data concerning how a job completed, such as rows returned,
processing time, and more.

Show SQL

Show the SQL statements for the job selected from the Scheduled Requests list.

Servers Menu
The following table describes the commands of the Servers menu:
Table 4: Servers Menu

Command

Description

Server Status

View the condition of all Teradata QS servers in the Query Scheduler Server
Status dialog box.

View Menu
The following table describes the commands and submenus of the View menu:
Table 5: View Menu

Command

Submenu

Description

Refresh

Now

Immediately updates the information in the Scheduled Requests list.

Teradata Query Scheduler Administrator Guide

27

Chapter 3: Navigate Teradata QS Administrator


Scheduled Requests List
Table 5: View Menu (continued)

Command

Submenu

Description

Interval

Choose how frequently the Scheduled Requests list is automatically


updated in the Refresh Interval dialog box. See Refresh the Scheduled
Requests List on page 54 to learn how.

Font

Select the font for displaying the list of scheduled requests, the request
SQL, and Teradata QS object names (Workgroups, File Storage areas,
and so on) in the Font dialog box.

Help Menu
The Help menu has commands that provide access to online help and information about the
version of the software installed on your computer.
The following table lists the commands for the Help menu:
Table 6: Help Menu

Command

Description

Help Topics

Locate a topic by category in the contents tab of the online Help.

About Teradata QS
Administrator

View copyright and version information in the About Teradata Query


Scheduler Administrator dialog box.

To see copyright and version information


1

Click Help>About Teradata QS Administrator.


The About Teradata Query Scheduler Administrator dialog box appears showing the
product version and copyright dates.
Note: Encryption status appears in this dialog box. By default, data encryption is disabled
after installation. To enable or disable data encryption, select or clear the Data Encryption
check box on the Teradata Query Scheduler Admin Logon dialog box.

Click OK to close the message.

Scheduled Requests List


The Scheduled Requests list in the Teradata Query Scheduler Administrator (Figure 4) shows
information about all the scheduled requests and jobs in the TDWM database. It shows all of
the scheduled jobs currently being handled by Teradata QS. Use the scroll bar to scroll
through the items in the list. Select a job or request in the list, and then use the menu
commands or the shortcut menu to monitor and manage it.

28

Teradata Query Scheduler Administrator Guide

Chapter 3: Navigate Teradata QS Administrator


Scheduled Requests List
Figure 4: Scheduled Requests List

The following table describes the Scheduled Requests list:


Table 7: Scheduled Requests List

Column Header

Description

Request Name

The name assigned to the job when it was submitted using the Teradata Query
Scheduler Submit dialog box.

Request ID

Generated by Teradata QS to uniquely identify the request.

Job ID

Generated by Teradata QS to uniquely identify the job.

Scheduled

Current time the job is scheduled to run.

User Name

Name of the user who submitted the scheduled request.

Status

Current standing of the job.

Information

Details about how the job completed, such as rows returned, processing time,
database errors, and result file errors.

Sorting the Scheduled Requests List


Sort the information in the Scheduled Requests list using the following procedure.

To sort the Scheduled Requests list


Click any one of the column headings.

The requests are sorted in ascending order.

Using the Shortcut Menu


Right-click any request in the Scheduled Requests list to display a shortcut menu with
commands. Use the commands to monitor and manage the scheduled jobs and requests.

Teradata Query Scheduler Administrator Guide

29

Chapter 3: Navigate Teradata QS Administrator


Status Bar

Status Bar
The status bar at the bottom of the Teradata Query Scheduler Administrator (Figure 5) shows
the following information:
Table 8: Status Bar

Option

Description

Status

Status of the Teradata QS Administrator or an explanation of the currently selected


menu item.

Database Time

The current database time.

Database Date

The current database date.

Time frame

The next Scheduled Request execution time frame.

Figure 5: Teradata Query Scheduler Administrator Status Bar

30

Teradata Query Scheduler Administrator Guide

CHAPTER 4

Prepare the Teradata QS Database

After Teradata Query Scheduler 14.00 has been installed per instructions from Teradata Tools
and Utilities Installation Guide for Microsoft Windows, the DBA runs a script to create
scheduling tables for the TDWM database. This chapter provides the following topics:

Run the TQS Setup Script

Migrate the Teradata QS Database

Run the TQS Setup Script


The following sections summarize procedures to follow to prepare your system for using
Teradata QS. The procedures vary based on whether Query Scheduler was resident on your
system previously.
Read these topics to learn more about installation:

New Installation

Upgrade Installation

New Installation
To run Teradata QS on a new installation of the Teradata Database (that is, one on which an
earlier version of Teradata QS or Teradata DQM has not been installed), run the tqssetup.bteq
script. The script creates scheduling tables in the TDWM database that Teradata QS uses to
store scheduling information.

To run the tqssetup.bteq script


1

Locate the tqssetup.bteq file.


Note: The default location is C:\Program Files\Teradata\Teradata Query Scheduler Admin
14.0.

Open the tqssetup.bteq file in a text editor.

In the .logon statement, replace dbsName with the name of the Teradata Database whose
tables you are upgrading to 14.0.

Save the file and exit the text editor.

Execute the script using BTEQ. See Basic Teradata Query Reference for instructions.
After the tqssetup.bteq script has completed processing:

Teradata Query Scheduler Administrator Guide

31

Chapter 4: Prepare the Teradata QS Database


Migrate the Teradata QS Database

From the Query Scheduler Administrator main window, enable scheduling, configure
time frames, file storage, workgroups, and profiles. See:

Configure the Scheduled Requests on page 37

Configure Execution Time Frames on page 38

Manage Results File Storage on page 42

Set Up Workgroups on page 40

Manage Scheduler Profiles on page 44

Using Query Scheduler Operations, configure Client and Server parameters. In


particular, on the Server Parameters screen, fill in the Database Logon information so
that Teradata QS communicates with the correct Teradata Database.

Restart the Operations utility if prompted to do so, and then restart the server. After
the server has started, in the Scheduler Viewer (client) application, use the Connect
command to connect to a Teradata QS Server, and the Schedule SQL command to
submit scheduled requests.

Upgrade Installation
Teradata QS 14.00 supports upgrades from Teradata QS versions 6.1, 6.2, 12.0, 13.0, and
13.10. Follow the instructions from Run the TQS Setup Script on page 31 to upgrade the
scheduling tables by running the tqssetup.bteq script.

To upgrade Teradata QS on a Teradata Database containing scheduled requests from


version 6.1, 6.2, 12.0, 13.0 or 13.10
1

Stop all running client (Viewer) applications.

Stop all running Teradata QS servers.

Install the Teradata QS 14.00 Administrator package. (The client and server packages can
also be installed at this time.) For instructions, see the Teradata Tools and Utilities
Installation Guide for the appropriate operating system.

Run the tqssetup.bteq script to update the scheduler tables.

Proceed to Chapter 5 Use the Teradata QS Administrator on page 35.

Migrate the Teradata QS Database


If upgrading from Teradata QS 6.1, 6.2, 12.0, 13.0 or 13.10, migration is not necessary.
However, the tqssetup.bteq script must be run to update the scheduler table definitions to
release version 14.00. See Run the TQS Setup Script on page 31.

32

Teradata Query Scheduler Administrator Guide

Chapter 4: Prepare the Teradata QS Database


Migrate the Teradata QS Database

To upgrade Teradata QS on a Teradata Database containing scheduled requests from


version 6.0
1

First upgrade from Teradata 6.0 to 12.0, as described in the section Migrating the
Teradata QS Database of Teradata Query Scheduler Administrator Guide, version 12.00.
Note: You must perform the upgrade and migration to 12.0 before continuing.

Upgrade from Teradata QS 12.0 to Teradata 14.00 using the tqssetup.bteq script. See Run
the TQS Setup Script on page 31.

Teradata Query Scheduler Administrator Guide

33

Chapter 4: Prepare the Teradata QS Database


Migrate the Teradata QS Database

34

Teradata Query Scheduler Administrator Guide

CHAPTER 5

Use the Teradata QS Administrator

After setting up or migrating your Teradata QS database, begin using the Teradata QS
Administrator.
Configure the scheduled requests feature using the Teradata Query Scheduler Administrator,
as well as manage scheduled request, user profiles, and execution time frames. Browse through
these topics to learn more:

Open the Teradata Query Scheduler Administrator

Exit the Teradata Query Scheduler Administrator

Configure the Scheduled Requests

View Teradata QS Server Status

Configure Execution Time Frames

Set Up Workgroups

Manage Results File Storage

Manage Scheduler Profiles

Open the Teradata Query Scheduler


Administrator
Before using Teradata Query Scheduler Administrator, connect to the Teradata QS database,
TDWM. This section explains how to connect to the TDWM database and start Teradata
Query Scheduler Administrator.
The following procedure assumes Teradata QS is installed and your Teradata Database
connection is configured.

To start Teradata Query Scheduler Administrator


1

From your desktop, click Start>Programs Teradata Query Scheduler Admin


14.0>Administrator.
The Teradata Query Scheduler Admin Logon dialog box appears.

Teradata Query Scheduler Administrator Guide

35

Chapter 5: Use the Teradata QS Administrator


Open the Teradata Query Scheduler Administrator
2

Complete the following options in the Teradata Query Scheduler Admin Logon dialog box:
Table 9: Teradata Query Scheduler Admin Logon Dialog Box Description

Option

Description

Database Name box

Enter the name of the Teradata Database to use for scheduled SQL
requests.

User Name box

Shows the default user name tdwm. If logging on as an Teradata QS


admin, use this default. If logging on in view-only mode, enter the user
name associated with the database name. See Open Teradata QS in
View-Only Mode on page 36 for more details.

Password box

Enter the password associated with the user specified in the User Name
box.

Mechanism list box

Select the authentication mechanism (for example, TD2) to be used for


logon. The default is blank, representing the standard Teradata (TD2)
mechanism.

Parameter box

Enter the authentication string to be used with the mechanism


specified. If the specified mechanism does not require this string, leave
the box empty.

Session Character Set


list box

Select the Teradata session character set under which Administrator


tasks will execute. On a Kanji system (having KANJI1 database object
names), select the KANJISJIS_0S character set.

Use Data Encryption


check box

Click or clear, based on whether to encrypt data through CLIv2. The


default setting is checked, meaning data is encrypted when passed over
the network between the Teradata QS Administrator and the Teradata
Database.
Note: Encryption between the Teradata QS Administrator and the
Teradata Database can also be enabled via the clispb.dat file, as
described in the Teradata Call-Level Interface Version 2 Reference for
Network-Attached Systems.

Click OK.
Teradata QS Administrator connects the Teradata Database and displays the list of
scheduled requests.

To disconnect from the Teradata QS database and exit the Teradata Query Scheduler
Administrator, see Exit the Teradata Query Scheduler Administrator on page 37.

Open Teradata QS in View-Only Mode


View-only mode allows users other than an administrator to log on to Teradata QS and view
settings. The following procedure explains how to open Teradata QS in view-only mode. For
more information about the functionality of Teradata QS in view-only mode, see View-Only
Mode on page 51

36

Teradata Query Scheduler Administrator Guide

Chapter 5: Use the Teradata QS Administrator


Exit the Teradata Query Scheduler Administrator

To Open Teradata QS in View-Only Mode


1

From the desktop, click Start>Programs>Teradata Query Scheduler Admin


14.0>Administrator.
The Teradata Query Scheduler Admin Logon dialog box appears.

Enter the database name and the associated user name and password. For more
information on the remaining options, see Table 9 on page 36.

When logged onto Teradata QS as a non-administrator (user name other than tdwm),
Teradata QS opens in view-only mode. For more information on the functionality in viewonly mode, see View-Only Mode on page 51.

Exit the Teradata Query Scheduler


Administrator
The following section explains how to exit Teradata QS Administrator.

To exit the Teradata Query Scheduler Administrator


Click Command>Exit.

The Teradata QS server disconnects and the Teradata Query Scheduler Administrator
closes.

Configure the Scheduled Requests


The scheduled requests feature allows any user to submit SQL requests for scheduled
execution. The DBA must enable the feature on your Teradata Database system before SQL
requests can be scheduled or processed.

To enable scheduled requests


Click Configuration>Enable Scheduling.

To disable scheduled requests using the Teradata QS Administrator


Click Configuration>Disable Scheduling.

View Teradata QS Server Status

Teradata Query Scheduler Administrator Guide

37

Chapter 5: Use the Teradata QS Administrator


Configure Execution Time Frames

View the status of all Teradata QS Servers on your Teradata Database.

To see the status of the Teradata QS Servers on your system


1

Click Servers>Servers Status


The Query Scheduler Server Status dialog box appears.

Note: Delete is available only after selecting an item from the Servers list.
2

Click Close to exit the Teradata QS Server Status dialog box and return to the Teradata QS
Administrator.

To delete an inactive Teradata QS Server


1

Click Servers>Server Status.


The Query Scheduler Server Status window opens.

Select a server from the Servers list.


Note: Delete is available only after selecting an item from the Servers list.

Click Delete.
Information about that server is removed from the tables in the TDWM database.

Click Close to exit the Query Scheduler Server Status window and return to the Teradata
Query Scheduler Administrator.

Configure Execution Time Frames


The DBA controls when scheduled SQL requests are executed on the system by defining and
enabling execution time frames. An execution time frame is a period of time in which
scheduled SQL requests are permitted to run and when the Teradata QS server will attempt to
execute any scheduled requests.

38

Teradata Query Scheduler Administrator Guide

Chapter 5: Use the Teradata QS Administrator


Configure Execution Time Frames

After creating an execution time frame, the DBA must make it available on your Teradata
Database system. Scheduled requests are not accepted or run unless an execution time frame is
available.
When a user submits a request for scheduling, Teradata QS determines whether there are any
execution time frames available during the scheduled time period. If no execution time frames
are available and the maximum start interval is exceeded, then the request is not scheduled.
Although multiple execution time frames can be created and enabled, only the primary
Teradata QS server actually dispatches and executes the scheduled requests.

Create and Edit Execution Time Frames


To create or edit an execution time frame
1

Click Configuration>Execution Time Frames.


The Execution Time Frame Names dialog box appears.

Do one of the following:

To modify an existing time frame, select the desired time frame from the Time Frame
Names list, and then click Edit. Go to Step 4.
Note: The Edit and Delete buttons are available only when a time frame is selected
from the list.

To create a new time frame, click New.

The Time Frame Properties dialog box appears.

Type the name of the new time frame in the Time Frame Name box. Time frame names
cannot contain single quotes.
Note: If editing an execution time frame, the Time Frame Name box is read-only.

Do one of the following:

Teradata Query Scheduler Administrator Guide

39

Chapter 5: Use the Teradata QS Administrator


Set Up Workgroups

Select the Enable Time Frame check box to make the time frame available. (By default,
this control is not selected.)

Clear the Enable Time Frame check box to make the time frame unavailable.

Do one of the following:

To make the time frame effective each day of the week, leave the Everyday check box
selected. (By default, this control is selected.)

To select specific days when the time frame is in effect, clear the Everyday check box
and select the desired days using the boxes in the Days frame.

Using a 24 hour format, enter the hour the time frame is to begin in the From box.

Enter the hour the time frame is to end in the To box.

Click OK to save your entries and close the Time Frame Properties dialog box.
The new time frame appears in the Time Frame Names list in the Execution Time Frames
dialog box.

Click Close to close the Execution Time Frames dialog box and return to the Teradata
Query Scheduler Administrator.

Delete Execution Time Frames


To delete an execution time frame
1

Click Configuration>Execution Time Frames.


The Execution Time Frames dialog box appears.

Select the time frame to delete from the Time Frame Names list.

Click Delete.

Click Yes to confirm the deletion and close the message box.
The time frame no longer appears in the Time Frame Names list.

Click Close to close the Execution Time Frames dialog box and return to the Teradata
Query Scheduler Administrator.

Set Up Workgroups
A workgroup represents a collection of related scheduled requests for a number of users,
accounts, roles, and profiles. The DBA can create, edit, or delete any number of workgroups
that equitably distribute resources and scheduled requests workloads during execution time
frames.
Assign a maximum number of requests that can be simultaneously executing from each
workgroup. This ensures that a fair share of the scheduled work gets done within the
execution time frames for all workgroups.

40

Teradata Query Scheduler Administrator Guide

Chapter 5: Use the Teradata QS Administrator


Set Up Workgroups

Create and Edit Workgroups


To create or edit a workgroup
1

Click Configuration>Workgroups.
The Workgroups dialog box appears with DEFAULT_WORKGROUP in the Workgroup
Names list.

Note: When creating or modifying a scheduled requests profile for a user, user group, or
account, select a workgroup to associate with the profile. See Manage Scheduler Profiles
on page 44 for more information.
2

Do one of the following:

To modify an existing workgroup, select the desired workgroup from the Workgroup
Names list, and then click Edit. Go to Step 4.
Note: The Edit and Delete buttons are available only after a workgroup is selected from
the list.

To create a new workgroup, click New.

The Workgroup Properties dialog box appears.


3

Type up to 30 characters for the name of your workgroup in the Workgroup Name box.
Note: If editing a workgroup, the Workgroup Name box is read-only.

In the Maximum queries running simultaneously box, enter a number between 0 and 28 to
limit the number of concurrent queries that can be run by this workgroup.

Click OK to save your entries and close the Workgroup Properties dialog box.
The workgroup appears in the Workgroup Names list in the Workgroups dialog box.

Click Close to close the Workgroups dialog box and return to the Teradata Query
Scheduler Administrator.

Teradata Query Scheduler Administrator Guide

41

Chapter 5: Use the Teradata QS Administrator


Manage Results File Storage

Delete Workgroups
When deleting a workgroup, make sure it is not being referenced by a scheduler profile. If it is,
change the scheduler profile to reference a different work group or delete the scheduler profile.
To change the scheduler profile, Manage Scheduler Profiles on page 44. To delete the
scheduler profile, see Delete Scheduler Profiles on page 50.

To delete a workgroup
1

Click Configuration>Workgroups.
The Workgroups dialog box appears.

Select the workgroup to delete from the Workgroup Names list.


Note: The Edit and Delete buttons are available only after selecting a workgroup from the
list.

Click Delete.

Click Yes to confirm the deletion and close the message box.
The workgroup no longer appears in the Workgroup Names list in the Workgroups dialog
box.

Click Close to close the Workgroups dialog box and return to the Teradata Query
Scheduler Administrator.

Manage Results File Storage


Results file storage is a symbolic name for a file system directory where scheduled requests
results files are stored. To save the results of scheduled requests in flat text files, the storage
location must be designated. Create, edit, or delete any number of locations where scheduled
request results files are stored and accessed by all Teradata QS servers.
Each results file storage location has a specified Windows path. The same Windows path is
used by all active Teradata QS servers so that they can all access the results files at the same
location. This requires that all Teradata QS scheduled requests servers must have access to the
Windows path(s) that describe the results file storage location(s).
Profiles additionally contain an optional relative path that is used to reference a subdirectory
name for the desired profile. Teradata QS joins the appropriate results file storage location
path with the relative profile path to create a valid directory name for a Windows system for
the desired profile.
For the Teradata QS server to read and write to the results files in the location the DBA
specifies, the DBA needs to set up the appropriate Windows privileges for the server. See
Create and Edit Results File Storage Locations on page 43 for instructions on specifying a
results file storage location. For instructions on setting up Windows privileges, see the
Teradata Query Scheduler User Guide. In the topic, Managing the Teradata QS Server,
specifically read Supporting Results Files.

42

Teradata Query Scheduler Administrator Guide

Chapter 5: Use the Teradata QS Administrator


Manage Results File Storage

If the last, or only, statement in a scheduled request is a SELECT statement, it generates a


result set that can be captured and saved by Teradata QS. Results from a scheduled request can
be saved to a new or existing database table, or to a file specified when the request was created.
The user controls whether any existing data is destroyed. For database tables, Teradata QS can
create a table with the appropriate column types for the result data.

Save Scheduled Requests Results


To save scheduled requests results into files
1

Ensure all disk drives on which results files are stored by Teradata QS servers are identically
available to all Teradata QS server systems on Windows. This enables any Scheduled
Request client to connect to any Teradata QS Server to retrieve their results.

Ensure all results file storage locations are configured so they have the same path on all
server systems. This is easier to manage than configuring a different results location for
every server.

To save scheduled requests results to a file in a shared network directory


1

Configure the Teradata QS Server to run as a user with network access privileges and write
and read access to the specified directory.

From your desktop, click Start>Administrative Tools>Computer Management.

Select Services under Services and Applications in the directory tree.

From the list of services, select TQS Server and click Properties or right-click and select
Properties from the shortcut menu.

In the TQS Server Properties dialog box, click the Log On tab.

Click This Account and fill in the domain/username and password boxes.
Note: Be sure the user specified is a member of the Windows Administrators group.

Click OK to save your changes.

Create and Edit Results File Storage Locations


To create and edit results file storage locations
1

Click Configuration>Results File Storage.


The Results File Storage dialog box appears with a DEFAULT_FILE_STORAGE appearing
in the File Storage Names list.

Do one of the following:

To modify an existing file storage location, select the name from the File Storage
Names list, and then click Edit. Go to Step 4.

Teradata Query Scheduler Administrator Guide

43

Chapter 5: Use the Teradata QS Administrator


Manage Scheduler Profiles

Note: The Edit and Delete buttons are available only after a name is selected from the
list.

To create a new file storage location, click New.

The Results File Storage Properties dialog box appears.


3

Type a name for the results file storage in the Results File Storage box.
Note: If editing a file storage location, the Results File Storage box is read-only.

Type the directory where this file storage is to be located in the Windows Results Directory
box.

Click OK to save your entries and close the Results File Storage Properties dialog box.
The storage location appears in the File Storage Names list in the Results File Storage
dialog box.

Click Close to exit the Results File Storage dialog box and return to the Teradata Query
Scheduler Administrator.

Delete Results File Storage Locations


To delete a results file storage location
1

Click Configuration> Results File Storage.


The Results File Storage dialog box appears.

Select the file storage location that will be deleted from the File Storage Names list.
Note: The Edit and Delete buttons are available only after selecting a file storage location
from the list.

Click Delete.

Click Yes to confirm the deletion and close the message box.
The storage location no longer appears in the File Storage Names list in the Results File
Storage dialog box.

Click Close to close the Results File Storage dialog box and return to the Teradata Query
Scheduler Administrator.

Manage Scheduler Profiles


Profiles are used to control scheduled requests submitted to your Teradata QS Server. A profile
is a set of parameters assigned to individual users, accounts, Teradata Roles, or Teradata
Profiles that determines what scheduling capabilities are available and how your Teradata QS
Server handles their scheduled requests.
A default user profile is created and reserved by Teradata QS during installation and is used
when a user is not assigned to a user profile, a group profile, or an account profile. The default
user profile cannot be deleted, but it can be changed.

44

Teradata Query Scheduler Administrator Guide

Chapter 5: Use the Teradata QS Administrator


Manage Scheduler Profiles

Automatic Cleanup
Using the Job History box in the profile, specify the length of time that records of scheduled
request jobs will be saved before being automatically deleted from the system. Users can also
delete their own completed jobs at any time.
Using the Results Duration box in the profile, specify the length of time that the users results
data tables and files can be kept, if not updated, before being automatically deleted by
Teradata QS.

Create and Edit Scheduler Profiles


To create or edit a scheduler profile
1

Click Configuration>Scheduler Profiles.


The Scheduler Profiles dialog box appears.

From the Select Type list, choose one of the following types of scheduler profiles to create:

Account

Profile

Role

User

Do one of the following:

If creating a new profile, click New.

If editing an existing profile, click Edit.

The Scheduler Profile Properties dialog box appears with the Scheduling tab selected by
default.

Teradata Query Scheduler Administrator Guide

45

Chapter 5: Use the Teradata QS Administrator


Manage Scheduler Profiles

Complete the following options in the Scheduling tab:


Table 10: Scheduler Profile Properties: Scheduling Tab

Option

Description

Profile Type

(Read-only) See the profile type chosen from the Select Type list on the
Scheduler Profiles dialog box.

Name

(Read-only) See the name of the Teradata Database object selected from
the Objects list on the Scheduler Profiles dialog box.

Allowed Scheduling

Select the types of query requests that can be scheduled by this profile:
No scheduling: Disables scheduling. No requests can be scheduled,
effectively disabling the feature for this user, group, or account.
Onetime only: Runs the request once.
Onetime & Recurring: Runs the request more than once such as daily,
weekly, or monthly.

Workgroup

Select the workgroup specification indicating which scheduled request


workgroup the profile should use. The default is
DEFAULT_WORKGROUP.
The administrator configures the workgroup specification in the Settings
dialog box.

46

Teradata Query Scheduler Administrator Guide

Chapter 5: Use the Teradata QS Administrator


Manage Scheduler Profiles
Table 10: Scheduler Profile Properties: Scheduling Tab (continued)

Option

Description

Start Interval

Specify the greatest length of time from the submitted start time that a job
can begin to run in days and hours. Default value is one day.
New requests are not accepted if there is no time between the start time
and the maximum start interval that a request can execute due to rules
and/or unavailability of an execution time frame.

Job History

Specify the number of days between 1 and 365 that job records are
retained before Teradata QS automatically deletes them.

Select the Results Tables/Files tab.

Complete the following options in the Results Tables/Files tab to set up results parameters:

Teradata Query Scheduler Administrator Guide

47

Chapter 5: Use the Teradata QS Administrator


Manage Scheduler Profiles

Table 11: Scheduler Profile Properties: Results Tables/Files Tab

Option

Description

Allowed Results
Type

Select the location where results of a scheduled request are stored:


Save in database: Stores the results in a database table.
Save in file: Stores the results in a file.
Save in database or file: Stores the results in a database table, a file, or
either. If selecting this option, the user can choose the destination when
scheduling a request.

Results Tables Parameters


Results
Database

Specify the name of the results database to use as the default. This is the name
of the database in which the Teradata QS Server stores the results. This option
cannot be used if Save in file was selected as the Allowed Results Type.

Create as
Fallback

Specify that the results table is created with the fallback attribute. This option
cannot be used if Save in file was selected as the Allowed Results Type.

Create as
Multiset

Specify that the results table is created with the multiset attribute. This option
cannot be used if Save in file was selected as the Allowed Results Type.

Append user
name

Have Teradata QS to automatically append the user name to the results table.
This option cannot be used if Save in file was selected as the Allowed Results
Type.
Note: When the same results database is used by multiple users, the results
table name is modified to include the user name to avoid duplicates if this
check box is selected.

Results Files Parameters


Storage Location Select the results file storage specification where to store results files. This
option cannot be used if Save in database was selected as the Allowed Results
Type.
Configure the file storage location from the Results File Storage Properties
dialog box. See Manage Results File Storage on page 42 to learn how.
Optional
Sub-Directory

Specify a relative path beneath the results file storage location where results
from this profile are stored. The Teradata QS Server joins the directory
corresponding to the selected results file storage path and this relative path to
form the full directory path where results are stored. This option cannot be
used if Save in database was selected as the Allowed Results Type.

Field Separator
Character

Select the character to use to separate record fields when results are saved in a
file. This option cannot be used if Save in database was selected as the Allowed
Results Type.

Max File Size

Specify the greatest number of bytes (in thousand bytes) allowed for a results
file. This option cannot be used if Save in database was selected as the Allowed
Results Type.

Results Duration Specify the number of days between 1 and 365 that results tables or files are
retained before they are automatically deleted by Teradata QS. The timestamp
for results is reset when the results are replaced or appended to.

48

Teradata Query Scheduler Administrator Guide

Chapter 5: Use the Teradata QS Administrator


Manage Scheduler Profiles
7

Select the User Options tab.

Complete the following options in the User Options tab:


Table 12: Scheduler Profile Properties: User Options Tab

Option

Description

Modify start interval

Allow users to modify the maximum start interval in the Query Scheduler
Submit dialog box.

Modify results
database name

Allow users to modify the results database in the Query Scheduler Submit
dialog box.

Modify create Table


as Fallback option

Allow users to modify the Create as Fallback option in the Query


Scheduler Submit dialog box when saving results to a table.

Modify create Table


as Multiset option

Allow users to modify the Create as Multiset option in the Query


Scheduler Submit dialog box when saving results to a table.

Modify results File


field separator
character

Allow users to modify the Field Separator character for results files in the
Query Scheduler Submit dialog box when saving results to a file.

Click OK.

10 Click Close to close the Scheduler Profiles dialog box and return to the Teradata Query

Scheduler Administrator.

Teradata Query Scheduler Administrator Guide

49

Chapter 5: Use the Teradata QS Administrator


Manage Scheduler Profiles

Delete Scheduler Profiles


To delete a scheduler profile
1

Click Configuration>Scheduler Profiles.


The Scheduler Profiles dialog box appears.

Select the profile to delete from the Objects list.


Note: Delete is available only when the item selected has a scheduler profile associated
with it.

Click Delete.
A message box appears prompting confirmation of the deletion.

Click Close to exit the Scheduler Profiles dialog box and return to the Teradata Query
Scheduler Administrator.

Clean Up Scheduler Profiles


To clean up scheduler profiles
1

Click Configuration>Scheduler Profiles.


The Scheduler Profiles dialog box appears.

Click Cleanup.

Click Close to exit the Scheduler Profiles dialog box and return to the Teradata Query
Scheduler Administrator.
Teradata QS finds and deletes all scheduler profiles associated with Teradata Database
objects that no longer exist.

50

Teradata Query Scheduler Administrator Guide

Chapter 5: Use the Teradata QS Administrator


Manage Scheduler Profiles

View-Only Mode
View-only mode allows users, other than TDWM admin, to log on to Teradata QS
Administrator and view settings. In view-only mode, the user can open Teradata QS
Administrator, view the settings, but cannot make changes. The following section explains the
functions for view-only mode.
Table 13: Teradata QS Administrator Functions in View-Only Mode

Function

Sub Menu

Description of Use in View-Only Mode

Logon dialog

None

Database: Enter the name of a Teradata Database.


User Name: Enter the name of a Teradata user associated with the
Teradata Database.
Use the default TDWM for full administrative access to the Teradata
QS Administrator settings, or enter a different user name for viewonly access.
Password: Enter the password associated with the name entered into
the User Name box.
For more information on logging into Teradata QS in view mode, see
Open the Teradata Query Scheduler Administrator on page 35.

Configuration Scheduler
Profiles

TDWM can create, edit and delete scheduler profiles. View-only users
can only view the existing settings.
View replaces Edit in view-only mode.
View opens the Scheduler Profile Properties dialog so existing profiles
can be viewed. View is available if an item from the drop down menu
has an existing scheduler profile.

Workgroups

TDWM can create, edit and delete workgroups. View-only users can
only view the settings in workgroups.
View replaces Edit for users other than TDWM. Description: Opens
the Workgroup Properties dialog box where an existing workgroup can
be viewed.
Workgroup Properties Dialog Box: all options are read-only for users
other than TDWM.

Results File
Storage

TDWM can create, edit and delete results file storage. View-only users
can only view the existing settings.
View is available in view-only mode. View opens the Results File
Storage Properties dialog to view an existing file storage mapping.
View replaces the Edit in view-only mode.

Execution
TDWM can create, edit and delete time frames. View-only users can
Time Frames only view these settings.
Options

None

There are no options available in view-only mode.

Server

Server
Status

View-only users can see the Teradata QS Server status, but Delete is
available only to the TDWM user.

Teradata Query Scheduler Administrator Guide

51

Chapter 5: Use the Teradata QS Administrator


Manage Scheduler Profiles
Table 13: Teradata QS Administrator Functions in View-Only Mode (continued)

Function

Sub Menu

Description of Use in View-Only Mode

View

Refresh

Refresh options are available in view-only mode. See View Menu on


page 27 for more information on using this option.

Font

Font controls are available in view-only mode. See View Menu on


page 27 for more information on using this option.

None

The items under the Help menu are available in view-only mode.

Help

52

Teradata Query Scheduler Administrator Guide

CHAPTER 6

Work with Scheduled Requests

The Teradata Query Scheduler Administrator offers a number of features that help to manage
scheduled requests, user profiles, and execution time frames. Browse through these topics to
learn more:

View Scheduled Requests

Manage Scheduled Requests

Schedule Rejected Teradata SQL Assistant Queries

Set Up E-mail Notifications

View Scheduled Requests


To view all scheduled SQL requests in your system
Start the Teradata Query Scheduler Administrator and connect to the Teradata Database.

For instructions, see Open the Teradata Query Scheduler Administrator on page 35.
After connecting to the Teradata Database, all scheduled requests are retrieved and appear
in the Scheduled Requests list of the Teradata Query Scheduler Administrator. (See
Figure 4 on page 29).
View the following information for each of the scheduled jobs currently in the system:
Table 14: Scheduled Requests List: Teradata Query Scheduler Administrator

Column Name

Description

Request Name

The name assigned to the request when it was submitted using the Teradata
Query Scheduler Submit dialog box.

Request ID

Generated by Teradata QS to uniquely identify the request.

Job ID

Generated by Teradata QS to uniquely identify the job.

Scheduled

Current time the job is scheduled to run.

User Name

Name of the user who submitted the scheduled request.

Status

Current standing of the job.

Information

Details about how the job completed, such as rows returned, processing
time, database errors, and result file errors.

Teradata Query Scheduler Administrator Guide

53

Chapter 6: Work with Scheduled Requests


View Scheduled Requests

Refresh the Scheduled Requests List


Before working with scheduled requests, jobs, and results, the DBA can set the rate at which
the Scheduled Requests list is updated from the Teradata QS server. Although refresh is a
background process, it still adds to network traffic. Set the rate as low as possible.
Immediate Refresh

To immediately refresh the Scheduled Requests List


Click View>Refresh>Now.

The Scheduled Requests list is updated with information from the Teradata QS server.
Refresh Rate

To set the Refresh rate


1

Click View> Refresh>Interval.


The Refresh Interval dialog box appears.

For information about the Refresh Interval dialog box, see Appendix A: About the Dialog
Boxes.
2

Select the Set Refresh Interval check box.

Type an interval between 5 and 99 in the Refresh every __ box.

Click the Minute or the Hour option to set the refresh rate.

Click OK to close the Refresh Interval dialog box, and return to the Teradata Query
Scheduler Administrator.
Begin working with the scheduled jobs and requests. To learn more, see Manage
Scheduled Requests on page 55.

54

Teradata Query Scheduler Administrator Guide

Chapter 6: Work with Scheduled Requests


Manage Scheduled Requests

Manage Scheduled Requests


To some extent, the DBA can control which scheduled request jobs are executed by canceling
any job waiting to execute or forcing a job to execute immediately. The DBA can also view,
abort, delete, or modify scheduled SQL requests and jobs to avoid adversely affecting a
Teradata Database during prime usage periods.

View SQL Statements for a Scheduled Request


Use the Show SQL command to see the SQL statements for any request in the Scheduled
Requests list.

To see the SQL statements for a scheduled request


1

From from the Scheduled Jobs list of the Teradata Query Scheduler Administrator, select a
job.

Do one of the following:

Click Options>Show SQL.

Right-click the job to display a shortcut menu and click Show SQL.

The Show SQL dialog box appears showing the SQL statements used in the request.
3

View the information and click OK to close the Show SQL dialog box and return to the
Teradata Query Scheduler Administrator.

Change the Execute Time for a Scheduled Job


Use the Modify Execute Time command to change the execute time for a job with a Waiting
status in the Scheduled Requests list.

To change the execute time for a scheduled job


1

From the Scheduled Requests list of the Teradata Query Scheduler Administrator, select a
job with a Waiting status.

Do one of the following:

Click Options>Modify Execute Time.

Right-click the job to display a shortcut menu and click Modify Execute Time.

The Change Start Time dialog box appears.


3

Enter a new start time using the Hour and Minute boxes.

Click OK to close the dialog box and return to the Teradata Query Scheduler
Administrator.

Teradata Query Scheduler Administrator Guide

55

Chapter 6: Work with Scheduled Requests


Manage Scheduled Requests

Execute a Job Immediately


Use the Execute Now command to immediately run for a job with a Waiting status in the
Scheduled Requests list. Also use the same command to re-execute jobs that have failed for
any reason.
Jobs submitted for immediate execution are still subject to database management rules.

To immediately execute a scheduled job


1

From the Scheduled Requests list of the Teradata Query Scheduler Administrator, select a
job with a Waiting status or any job that failed to execute.

Do one of the following:

Click Options>Execute Now.

Right-click the job to display a shortcut menu, and click Execute Now.

A Teradata Query Scheduler Administrator dialog box appears asking for confirmation.
3

Click Yes to confirm the execution, close the dialog box, return to the Teradata Query
Scheduler Administrator, and execute the query.

Delete a Scheduled Request


Use the Delete Request command to delete a scheduled request. Deleting unwanted jobs saves
database space. When a request is deleted, all jobs associated with that request are deleted.

To delete a request
1

From from the Scheduled Requests list of the Teradata Query Scheduler Administrator,
select a request.

Do one of the following:

Click Options>Delete Request.

Right-click the request to display a shortcut menu and click Delete Request.

A Teradata Query Scheduler Administrator dialog box appears asking for confirmation.
3

Click Yes to confirm the deletion and close the dialog box.
A Teradata Query Scheduler Administrator message appears indicating the request was
deleted.

Click OK to close the dialog box and return to Teradata Query Scheduler Administrator.

Cancel a Job
Use the Cancel Job command, to cancel the scheduled execution of any selected job in a
Waiting status.

56

Teradata Query Scheduler Administrator Guide

Chapter 6: Work with Scheduled Requests


Manage Scheduled Requests

After a job is cancelled, it cannot be restarted. If the job is for a recurring request, a new job is
automatically generated by Teradata QS server before the next day. Otherwise, a new
scheduled request must be submitted.

To cancel a job
1

From from the Scheduled Requests list of the Teradata Query Scheduler Administrator,
select a job in a Waiting status.

Do one of the following:

Click Options>Cancel Job.

Right-click the job to display a shortcut menu and click Cancel Job.

A Teradata Query Scheduler Administrator dialog box appears asking for confirmation.
3

Click Yes to confirm the cancellation and close the dialog box.
Admin Cancelled appears under the Status column of the Jobs list in the Teradata Query
Scheduler Administrator for the cancelled job.

Delete a Job
Use the Delete Job command to delete any job that has completed successfully or
unsuccessfully.
If a completed job is deleted for a recurring request, the scheduled request is still available in
the system.
Deleting completed jobs allows for faster updates of the Scheduled Requests list. Jobs are also
periodically deleted as specified using the Teradata Query Scheduler Administrator.

To delete a job
1

From from the Scheduled Requests list of the Teradata Query Scheduler Administrator,
select any completed job.

Do one of the following:

Click Options>Delete Job.

Right-click the job to display a shortcut menu and click Delete Job.

A Teradata Query Scheduler Administrator dialog box appears asking for confirmation.
3

Click Yes to confirm the deletion and close the dialog box.
A Teradata Query Scheduler Administrator message appears indicating the job was deleted.

Click OK to close the dialog box and return to Teradata Query Scheduler Administrator.

Abort a Job
Use the Abort Job command to terminate any job with an Executing status. For example, abort
a job because the job is tying up Teradata Database resources.

Teradata Query Scheduler Administrator Guide

57

Chapter 6: Work with Scheduled Requests


Manage Scheduled Requests

To abort a job
1

From from the Scheduled Requests list of the Teradata Query Scheduler Administrator,
select a job with an Executing status.

Do one of the following:

Click Options>Abort Job.

Right-click the job to display a shortcut menu and click Abort Job.

A Teradata Query Scheduler dialog box appears asking for confirmation.


3

Click Yes to confirm the deletion and close the dialog box.

Drop Results
Use the Drop Results command to drop the results table or file associated with the selected
request or job. Dropping results cleans up tables or files generated for that request or job.
To use the same results table or file for each request, the results must be dropped. The Drop if
exists or Append if exists options can also be used to drop results when scheduling requests.
For information on that option, see Teradata Query Scheduler User Guide.

To drop results
1

From from the Scheduled Requests list of the Teradata Query Scheduler Administrator,
select a job.

Do one of the following:

Click Options>Drop Results.

Right-click the request to display a shortcut menu and click Drop Results.

A Teradata Query Scheduler Administrator dialog box appears confirming the deletion.
3

Click Yes to confirm the deletion, close the dialog box, and return to Teradata Query
Scheduler Administrator.
The results of the scheduled request are dropped and have been removed from the TDWM
database.

View Job Result Information


Frequently the text in the Information column of the Jobs list is too long to be completely
visible in the list. Use the Job Information command to view the entire text.

To view job result information


1

From from the Scheduled Requests list of the Teradata Query Scheduler Administrator,
select a job.

Do one of the following:

58

Click Options>Job Information.

Teradata Query Scheduler Administrator Guide

Chapter 6: Work with Scheduled Requests


Schedule Rejected Teradata SQL Assistant Queries

Right-click the job to display a shortcut menu and click Job Information.

A Job Result Information message appears displaying the entire job information text.

Click OK to close the message box and return to the Teradata Query Scheduler
Administrator.

Schedule Rejected Teradata SQL Assistant


Queries
End-users can use Teradata SQL Assistant (a Windows ODBC application) to submit SQL
requests to a Teradata Database. When a Teradata SQL Assistant query is rejected by the
Teradata Database because of workload management restrictions (Teradata DWM statuses
3149-3150), the DBA can make the Teradata Query Scheduler Submit dialog box available so
the end-user can re-schedule the request.
To learn how to set up this option, see the Teradata Query Scheduler User Guide. For more
information about Teradata DWM rules, see Teradata Dynamic Workload Manager User
Guide.

Set Up E-mail Notifications


When creating a scheduled request, end-users can specify an e-mail address where Teradata
QS will send a notification message when a request has completed its execution, successfully
or unsuccessfully.
Users specify their e-mail addresses in the Teradata Query Scheduler Submit Requests dialog
box. For more information, refer to the Teradata Query Scheduler User Guide.
Because Teradata QS 14.00 uses Teradata Viewpoint to generate e-mail notifications, Teradata
Viewpoint must first be installed and configured. See Teradata Viewpoint documentation for
more information.
For instructions on setting up, viewing, and managing alerts, see Teradata Viewpoint Alert
Setup and Teradata Viewpoint Alert Viewer documentation, in addition to the Teradata Query
Scheduler User Guide.

Teradata Query Scheduler Administrator Guide

59

Chapter 6: Work with Scheduled Requests


Set Up E-mail Notifications

60

Teradata Query Scheduler Administrator Guide

APPENDIX A

About the Dialog Boxes

While working with Teradata QS Administrator, information about the options and controls
is available. The following topics provide information about the various dialog boxes:

Refresh Interval Dialog Box

Results File Storage Dialog Box

Results File Storage Properties Dialog Box

Scheduler Profiles Dialog Box

Workgroups Dialog Box

Workgroup Properties Dialog Box

Refresh Interval Dialog Box


Use the Refresh Interval dialog box (Figure 6) to set the rate at which the Scheduled Requests
list is updated by the Teradata QS server.
To open this dialog box, go to the Teradata Query Scheduler Administrator, and click

View>Refresh>Interval.
Figure 6: Refresh Interval Dialog Box

Table 15: Refresh Interval Dialog Box Description

Option/Control

Description

Set Refresh Interval


check box

Select to enable the controls in the Refresh Interval dialog box

Teradata Query Scheduler Administrator Guide

Clear to disable the controls in the Refresh Interval dialog box

61

Appendix A: About the Dialog Boxes


Results File Storage Dialog Box
Table 15: Refresh Interval Dialog Box Description (continued)

Option/Control

Description

Refresh every box

Enter a value for the rate at which the Teradata QS Administrator will
update the Scheduled Requests list: 0 to 60 minutes, or 0 to 24 hours.
Enter an interval between 5 and 99 for the rate at which the Teradata QS
server will update the Scheduled Jobs list.

Minute option

Select this option to have the rate be measured in minutes.

Hour option

Select this option to have the rate be measured in hours.

OK

Saves entries and exits the Refresh Interval dialog box.

Cancel

Exits the Refresh Interval dialog box without saving entries.

Results File Storage Dialog Box


Use the Results File Storage dialog box (Figure 7) to create or manage existing results file
storage.
To open this dialog box, go to the Teradata Query Scheduler Administrator, and click

Configuration>Results File Storage.


Figure 7: Results File Storage Dialog Box

Table 16: Results File Storage Dialog Box Description

62

Option

Description

File Storage Names


list

Contains a list of the names related to a location where the scheduled


requests results are stored.

Teradata Query Scheduler Administrator Guide

Appendix A: About the Dialog Boxes


Results File Storage Properties Dialog Box
Table 16: Results File Storage Dialog Box Description (continued)

Option

Description

New

Creates a new file storage mapping in the New Results File Storage dialog
box.

Delete

Deletes the selected file storage mapping.

Edit

Opens an existing file storage mapping for editing in the Edit Results File
Storage.

Close

Closes the Results File Storage dialog box

Results File Storage Properties Dialog Box


Use the Results File Storage Properties dialog box (Figure 8) to enter the details about a new
file storage location.
To open this dialog box, go to the Teradata Query Scheduler Administrator, and click

Configuration>Results File Storage. Then click New.


Figure 8: Results File Storage Properties Dialog Box

Table 17: Results File Storage Properties Dialog Box Description

Option/Control

Description

Results File Storage

Defines the name of the results file storage. The names is limited to 30
characters.

Windows Results
Directory

Defines the Windows directory where the results are saved. The directory
name is limited to 128 characters.

OK

Saves entries and closes the Results File Storage Properties dialog box.

Cancel

Closes the Results File Storage Properties dialog box without saving
entries.

Teradata Query Scheduler Administrator Guide

63

Appendix A: About the Dialog Boxes


Scheduler Profiles Dialog Box

Scheduler Profiles Dialog Box


Use the Scheduler Profiles dialog box (Figure 9) to choose the type of scheduler profile to
create or edit.
To open this dialog box, go to the Teradata Query Scheduler Administrator, and click

Configuration>Scheduler Profiles.
If logged on to Teradata QS in View Mode, the Scheduler Profiles dialog box opens, but no
changes can be made. In View-Only mode, use the View button to view profiles.
Figure 9: Scheduler Profiles Dialog Box

Table 18: Scheduler Profiles Dialog Box Options Description

Option/Control

Description

Select Type list

Defines the type of scheduler profile to create. Select one of the following
items:
Account
Profile
Role
User
When an item is selected, an alphabetical list of all available accounts,
profiles, roles, or users appears. Scroll down the list and click the correct
name.

Profile

64

This list shows all objects for the type selected.

Teradata Query Scheduler Administrator Guide

Appendix A: About the Dialog Boxes


Workgroups Dialog Box
Table 18: Scheduler Profiles Dialog Box Options Description (continued)

Option/Control

Description

New

Create a profile for the selected account, profile, role, or user. New is
available if the selected account, profile, role, or user does not have an
existing profile.

Delete

Deletes the selected profile. Delete is available if the selected account,


profile, role, or user has an existing profile.

Edit

Modify the profile with the changes made. Edit is available if the selected
account, profile, role, or user has an existing profile.

Cleanup

Finds and deletes the Teradata QS profiles for all Teradata Database
objects that no longer exist.

View

View information about selected profiles. Available only in View Mode.

Close

Closes the Scheduler Profile dialog box.

Workgroups Dialog Box


Use the Workgroups dialog box (Figure 10) to create a new workgroup or manage existing
workgroups.
To open this dialog box, go to the Teradata Query Scheduler Administrator, and click

Configuration>Workgroups.
If logged on to Teradata QS in View Mode, the Workgroups dialog box opens, but no
changes can be made. In View-Only mode, use the View button to view workgroups.
Figure 10: Workgroups Dialog Box

Teradata Query Scheduler Administrator Guide

65

Appendix A: About the Dialog Boxes


Workgroup Properties Dialog Box

Table 19: Workgroups Dialog Box Description

Option

Description

Workgroup Names

Shows the names of the existing scheduled requests execution


workgroups.
Note: These are case sensitive.

New

Creates a new workgroup in the Workgroup Properties dialog box.

Delete

Deletes the selected workgroup.

Edit

Opens the selected workgroup for editing in the Edit Workgroup dialog
box.

View

View information about selected workgroups. Available only in View


Mode.

Close

Closes the Workgroup dialog box

Workgroup Properties Dialog Box


Use the Workgroup Properties dialog box (Figure 11) to define parameters for a workgroup.
To open this dialog box, go to the Teradata Query Scheduler Administrator, and click

Configuration>Workgroups. Then click New.


Figure 11: Workgroup Properties Dialog Box

Table 20: Workgroup Properties Dialog Box Description

66

Option/Control

Description

Workgroup Name

Defines the name of the workgroup. Names are limited to 30


characters.

Maximum queries running


simultaneously

Defines the maximum number (0 and 128) of concurrent queries


that can be run by the workgroup.

OK

Saves entries and closes the Workgroup Properties dialog box.

Cancel

Closes the Workgroup Properties dialog box without saving entries.

Teradata Query Scheduler Administrator 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 Administrator Guide

67

Glossary

DBCAREA values not set in the clispb.dat file by the user will default to the values contained
in CLI2SPB.

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.
DBC The default database associated with user DBC. When Teradata Database is first
installed on your server, it has only one user. This user is called User DBC and it owns all other
databases and users in the system.
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.
DBS

A Database system

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.

E
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 A period of time when Teradata DWM can execute scheduled
requests that are waiting to run.

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.

68

Teradata Query Scheduler Administrator Guide

Glossary

J
job

An individual instance a scheduled request is scheduled to run.

join In Teradata SQL, a join is a SELECT operation that allows columns and rows to be
combined from two or more tables to produce a result. Join types restricted by Teradata 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.

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
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.
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.

Teradata Query Scheduler Administrator Guide

69

Glossary

profiles A profile is a set of parameters assigned 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.

R
request A message sent from an application program, such as Teradata 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.
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. A file storage location is mapped 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 Teradata DWM to define what requests
are prohibited from being immediately executed on the Teradata Database. That is, the rules
enforced by Teradata DWM provide the Query Management capabilities.

S
scheduled requests The capability to store scripts of SQL requests and execute them at a
scheduled time in the future.
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.
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
TDWM The database shared by Teradata Dynamic Workload Manager and Teradata Query
Scheduler. Previously called the dbqrymgr database.
Teradata DWM Teradata Dynamic Workload Manager. A Teradata tool used to create and
manage rules that manage access to a Teradata Database.
Teradata QS

Teradata Query Scheduler. A Teradata tool used to schedule SQL requests.

Teradata Tools and Utilities See TTU.

70

Teradata Query Scheduler Administrator Guide

Glossary

TTU Teradata Tools and Utilities. A group of products designed to work with the Teradata
Database.

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.

Teradata Query Scheduler Administrator Guide

71

Glossary

72

Teradata Query Scheduler Administrator Guide

Index

A
Abort Job command 27, 58
aborting jobs 58
About Teradata QS Administrator command 28
About Teradata QS Administrator dialog box 28
accounts
profiles 44, 64
scheduled requests 44
workgroups 40
Allowed Results Type list 48
Allowed Scheduling list 46
Append user name check box 48
architecture, client/server 15

C
Cancel Job command 27, 57
canceling jobs 57
changing
execute time for job 55
scheduler profiles 45
workgroups 41
cleaning up, scheduler profiles 50
client software
optional 22
required 21
CLIv2
defining the system address 22
verifying connection 22
commands See specific command names
Configuration menu 26
configuring scheduled requests 37
copyright information, viewing 28
Create as Fallback check box 48
Create as Multiset check box 48
creating
execution time frames 38, 39
results file storage locations 44
scheduler profiles 45
workgroups 40, 41

D
Database Name box 36
database name, specifying 22
database requirements 22
DB Date 30

Teradata Query Scheduler Administrator Guide

DB Time 30
Delete Job command 27, 57
Delete Request command 27, 56
deleting
execution time frames 40
inactive Teradata QS Server 38
jobs 57
scheduled requests 56
scheduler profiles 50
workgroups 42
dialog box help, viewing 20
dialog boxes See specific dialog box name
Disable Scheduling command 26
disabling scheduled requests 37, 46
dispatching jobs 18
drivers
ODBC 22
TCP/IP 21
Token Ring packet 21
Drop Results command 27, 58
dropping results 58

E
Edit Results File Storage dialog box 63
editing
execution time frames 39
results file storage locations 43
scheduler profiles 45
workgroups 41
e-mail notifications, setting up 59
Enable Scheduling command 26
Enable Time Frame check box 39
enabling scheduled requests 37
Everyday check box 40
Execute Now command 27, 56
executing jobs 18
execution time frames
creating 39
deleting 40
editing 39
Execution Time Frames command 26
Execution Time Frames dialog box 39, 40
Exit command 26
exiting Teradata QS Administrator 37

73

Index

F
Field Separator Character list 48
File menu 26
file storage locations See results file storage locations
file storage See results file storage
Font command 28

G
glossary 67

H
Help menu 28
Help Topics command 28
help, opening online 20
HOSTS file, modifying 22

I
Information column 29, 53
Interval command 28
IP address, specifying 22

Modify results database check box 49


modifying
HOSTS file 22
scheduler profiles 45

N
Name box 46
network connection, verifying 22
New Results File Storage dialog box 63
Next Execute Time 30
notifications, setting up e-mail 59
Now command 27

O
online help, opening 20
operating systems, supported 21
Optional Sub-Directory box 48
Options menu 27
overviews
results file storage 42
scheduled requests 17
scheduler profiles 44
Teradata QS interfaces 25

Job History box 45, 47


Job ID column 29, 53
Job Information command 27, 58
jobs
aborting 58
automatic cleanup 45
canceling 57
deleting 57
dispatching 18
execute immediately 56
execute time, changing 55
executing 18
result information, viewing 58

Refresh command 27
Refresh Interval dialog box 54, 61
refresh rate, setting 54
rejected requests, scheduling 59
Request ID column 29, 53
Request Name column 29, 53
requests See scheduled requests
results
automatic cleanup of data tables 45
database table, saving to 43
dropping 58
Results Database box 48
Results Duration box 45, 48
results file storage
creating 42

managing
TDWM database 31
Teradata QS database 31
Max File Size box 48
Mechanism list box 36
menu bar 25
migrating
Teradata QS database 32
Modify create Table as Fallback option check box 49
Modify create Table as Multiset option check box 49
Modify Execute Time command 27
Modify Field Separator Char check box 49
Modify Maximum Start Interval check box 49

74

Parameter box 36
Password box 36
platforms, supported 3
product release numbers 3
Profile Type box 46
profiles See scheduler profiles

Q
Query Scheduler Server Status window 38

Teradata Query Scheduler Administrator Guide

Index

designating 42
overview 42
Results File Storage box 44
Results File Storage command 26
Results File Storage dialog box 43, 44, 62
Results File Storage list 48, 62
results file storage locations
creating 44
deleting 44
editing 43
Results File Storage Properties dialog box 44, 63
Results Tables/Files tab 47

S
Scheduled column 29, 53
Scheduled Profile Properties dialog box 45
scheduled requests
checking 18
configuring 37
deleting 56
disabling 37
enabling 37
overview 17
profiles See scheduler profiles
results
saving in a shared network directory 43
saving into files 43
scheduling rejected 59
SQL statements, viewing 55
time frames See execution time frames
viewing 53
Scheduled Requests list 25
columns, sorting 29
refresh rate, setting 54
Teradata QS Administrator 28
scheduler profiles
cleaning up 50
creating 45
deleting 50
modifying 45
overview 44
Scheduler Profiles command 26
Scheduler Profiles dialog box 45, 50, 64
Scheduling tab 46
Server Status command 27
Servers menu 27
Session Character Set list box 36
setting
execution time frames for scheduled requests 38
refresh rate, Scheduled Requests list 54
shortcut menu 29
Show SQL command 27, 55
software releases, supported 3

Teradata Query Scheduler Administrator Guide

sorting, Scheduled Requests list 29


Start Interval box 47
starting
Teradata QS Administrator 35
Teradata QS Server 20
Status 30
status bar
Teradata QS Administrator 25, 30
Status column 29, 53
supported operating systems 21

T
TCP/IP driver 21
TDWM database
managing 31
Teradata QS
view-only mode, opening in 36
Teradata QS Administrator
commands 25
exiting 37
Scheduled Requests list 28
shortcut menu 29
starting 35
status bar 25, 30
Teradata QS database
managing 31
migrating 32
Teradata QS Server
inactive server, deleting 38
starting 20
status, viewing 38
Teradata Query Scheduler Admin Logon dialog box 36
Teradata Query Scheduler Operations utility 16
Teradata Query Scheduler Viewer 16
Teradata SQL Assistant
client software, installing 22
rejected requests, scheduling 59
Time Frame Properties dialog box 39
time frames See execution time frames

U
Use Data Encryption check box 36
User Name box 36
User Name column 29, 53
User Options tab 49
user profiles, scheduled requests 44
users, scheduler profiles 44

V
version numbers
Teradata Database 3
Teradata QS Administrator 28

75

Index

Teradata Query Scheduler 3


Teradata Tools and Utilities 3
View menu 27
viewing
copyright information 28
job result information 58
scheduled requests 53
SQL statements for scheduled requests 55
Teradata QS Server status 38
version information 28
view-only mode
functionality in 51
opening Teradata QS in 36
Scheduler Profiles dialog box 64
Workgroups dialog box 65

W
Windows Results Directory box 44
Workgroup list 46
Workgroup Properties dialog box 41, 66
workgroups
creating 40, 41
deleting 42
editing 40, 41
Workgroups command 26
Workgroups dialog box 41, 42, 65

76

Teradata Query Scheduler Administrator Guide

You might also like