Teradata RDBMS Utilities Volume 2 G-S - …dbmanagement.info/Books/MIX/Teradata_Vol_2_V2R4... ·...

of 618 /618
Teradata ® RDBMS Utilities - Volume 2 G-S V2R5.0 B035-1102-122A December 2002

Embed Size (px)

Transcript of Teradata RDBMS Utilities Volume 2 G-S - …dbmanagement.info/Books/MIX/Teradata_Vol_2_V2R4... ·...

  • Teradata RDBMSUtilities - Volume 2G-S

    V2R5.0

    B035-1102-122ADecember 2002

  • The product described in this book is a licensed product of NCR Corporation.

    BYNET is an NCR trademark registered in the U.S. Patent and Trademark Office.CICS, CICS/400, CICS/600, CICS/ESA, CICS/MVS, CICSPLEX, CICSVIEW, CICS/VSE, DB2, DFSMS/MVS, DFSMS/VM, IBM, NQS/MVS, OPERATING SYSTEM/2, OS/2, PS/2, MVS, QMS, RACF, SQL/400, VM/ESA, and VTAM are trademarks or registered trademarks of International Business Machines Corporation in the U. S. and other countries.DEC, DECNET, MICROVAX, VAX and VMS are registered trademarks of Digital Equipment Corporation.HEWLETT-PACKARD, HP, HP BRIO, HP BRIO PC, and HP-UX are registered trademarks of Hewlett-Packard Co.KBMS is a trademark of Trinzic Corporation.INTERTEST is a registered trademark of Computer Associates International, Inc.MICROSOFT, MS-DOS, MSN, The Microsoft Network, MULTIPLAN, SQLWINDOWS, WIN32, WINDOWS, WINDOWS 2000, and WINDOWS NT are trademarks or registered trademarks of Microsoft Corporation.SAS, SAS/C, SAS/CALC, SAS/CONNECT, and SAS/CPE are registered trademarks of SAS Institute Inc.SOLARIS, SPARC, SUN and SUN OS are trademarks of Sun Microsystems, Inc.TCP/IP protocol is a United States Department of Defense Standard ARPANET protocol.TERADATA and DBC/1012 are registered trademarks of NCR International, Inc.UNICODE is a trademark of Unicode, Inc.UNIX is a registered trademark of The Open Group.X and X/OPEN are registered trademarks of X/Open Company Limited.YNET is a trademark of NCR Corporation.

    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 NCR CORPORATION (NCR) 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 NCR intends to announce such features, functions, products, or services in your country. Please consult your local NCR 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. NCR may also make improvements or changes in the products or services described in this information at any time without notice.

    To maintain the quality of our products and services, we would like your comments on the accuracy, clarity, organization, and value of this document. Please e-mail: [email protected]

    or write:

    Information EngineeringNCR Corporation100 North Sepulveda BoulevardEl Segundo, CA 90245-4361U.S.A.

    Any comments or materials (collectively referred to as Feedback) sent to NCR will be deemed non-confidential. NCR 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, NCR 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 1996-2002, NCR CorporationAll Rights Reserved

    mailto:[email protected]

  • Preface

    Supported Software Release

    This book supports Teradata RDBMS V2R5.0.

    Changes to This Book

    This book, Teradata RDBMS Utilities, consists of three volumes:

    Volume 1 includes utilities A-F. Volume 2 includes utilities G-S. Volume 3 includes utilities T-Z.

    Some utilities are platform specific. Those are identified as either NCR UNIX MP-RAS Only or Microsoft Windows 2000 Only. If a utility runs on both platforms, no differentiation appears.

    This volume includes the following changes to support the current release:

    Date Utility Description

    December 2002 Gateway Control

    On Windows 2000, the valid range for fLogfilesize is 1000 through 2147483647.

    On Windows 2000, the default for sSessions is 600. The valid range is 0 through 21474836347.

    If you change the maximum sessions per node, the following occurs: On Windows 2000, the limit is effective immediately. On UNIX MP-RAS, the limit is effective immediately or after a tpareset,

    depending on the size of the limit at the last tpareset.

    Locking Logger In the "Producing a Lock Log Report" example, a locking modifier is added.

    A Messages section is added.

    A new session number added to the BLKINGSESSNO column in the Lock Log Report: 3 - Archive/Restore

    *63127 - The CREATE TABLE statement examples have been changed to reflect the following:

    column begdatetime has a format of 'zzz,zzz,zzz,zzz.zzz' instead of 'zzz,zzz,zzz,zzz.zz9'.

    column logondatetime to have a format of 'z,zzz,zzz,zzz,zzz.zzz' instead of 'z,zzz,zzz,zzz,zzz.zz9'.

    modmpplist An error in the WRITE command syntax diagram is corrected.

    Teradata RDBMS Utilities - G-S i

  • Preface

    December 2002 (cont.)

    pdeconfig This chapter is completely redesigned, including the following: Planning PDE configuration In-depth procedures and screens Example setup

    The new command line feature has the following options: Moves AMP and or PE vprocs. Runs in non-PDE environment. Runs in Multimedia environment, such as for Prospector. Reconstructs the vconfig.out file from the VCONFIG GDO and

    distributes the file to all nodes. Updates with current information from mpplist file.

    EMC disk arrays are supported.

    You must start pdeconfig on the PDN node of the existing system. If you run pdeconfig on any new nodes, you could lose all user data on the existing system.

    Priority Scheduler

    The new Priority Scheduler Simulator (PSS), a Microsoft Excel spreadsheet, allows you to generate what-if situations with different priority attributes. PSS allows you to emulate Priority Scheduler weighting configurations to determine expected relative weights for various activity situations.

    Performance Period milestone type Resource Usage is broken into two components:

    Session resource usage (S or R) milestone limits are specified in seconds and define an amount of session CPU resource consumption per node.

    Query resource usage (Q) milestone limit is specified in seconds and define an amount of query CPU resource consumption per node.

    In schmon -m and -M command displays, the % Use column is replaced with % Avg CPU and % Avg I/O columns:

    The CPU data is shown in two columns: % and msec. The I/O data is shown in two columns: % and sblks.

    The following options are added to the schmon -a command: -s displays Priority Scheduler data for all sessions controlled by the

    allocation group on the current node. -S displays Priority Scheduler data for all sessions controlled by the

    allocation group on all nodes of the system. X means that the allocation group is expected to process expedited

    work.

    Date Utility Description

    Teradata RDBMS Utilities - G-Sii

  • Preface

    December 2002 (cont.)

    Priority Scheduler (cont.)

    The following options are added to the schmon -b command: -s displays Priority Scheduler data for all sessions controlled by the

    resource partition on the current node. -S displays Priority Scheduler data for all sessions controlled by the

    resource partition on all nodes of the system. Limit is a percentage weight limit on total CPU usage by all processes

    controlled by a resource partition.

    The new -f command reads schmon commands from a file or standard input device.

    The new -l command sets the system CPU usage limit.

    The following options are added to the schmon -p command: -s displays Priority Scheduler data for all sessions controlled by the

    performance group on the current node. -S displays Priority Scheduler data for all sessions controlled by the

    performance group on all nodes of the system.

    The new -s command displays information about each session or request that is active on the node where you invoked the command as well as Priority Scheduler data for the specified sessions from the current node or all nodes in the system.

    The new -w command sets or displays the number of processes available on each vproc for use by work requests assigned to allocation groups having the Expedite attribute.

    Query Session You can exit Query Session by entering the quit; command.

    Query Session reports the index analysis state pertaining to the Teradata Index Wizard. If a workload is being analyzed for indexes, session state information is displayed.

    Reconfiguration The following options are added to the RECONFIG command: DISPLAY enables or disables output of Reconfiguration status. n TASKS limits the number of Reconfiguration sessions running in

    parallel. PRIORITY p is the priority string determined by Priority Scheduler. STATISTICS enables or disables output of Reconfiguration statistics.

    The new STATUS command allows you to determine the status of Reconfiguration at any time.

    Sample output for RECONFIG and STATUS commands is added.

    Date Utility Description

    Teradata RDBMS Utilities - G-S iii

  • Preface

    December 2002 (cont.)

    Reconfiguration Estimator

    The new Reconfiguration Estimator utility estimates an elapsed time for reconfiguration based upon the number and size of tables on your current system and provides estimates for the following phases:

    Redistribution Deletion NUSI building

    Resource Check Tools

    The following changes are made to options of the nodecheck command:

    -D displays threshold values for -nodeonly and -timercontrol tunables in syscheckrc format.

    -f log overrides the default log file location as specified in the -L option. -I lists threshold values for -nodeonly and -timercontrol tunables. -L logs the output to a file in the /tpi-data directory on the node where

    nodecheck is run. -r rscfile specifies an additional syscheckrc file to be read and processed

    that will override the values processed in the default syscheckrc file. -s is removed. -t directs nodecheck to read node-level resource data from a previously

    created log file.

    The following new sections are added to nodecheck: Creating a Log File Messages

    The following changes are made to options of the syscheck command: -D displays threshold values for -nodeonly and -timercontrol tunables

    in syscheckrc format. -f log overrides the default log file location as specified in the -L option. -I lists threshold values for -nodeonly and -timercontrol tunables. -L logs the output to a file in the /tpi-data directory on the node where

    nodecheck is run. -r rscfile specifies an additional syscheckrc file to be read and processed

    that will override the values processed in the default syscheckrc file. -t n directs nodecheck to read node-level resource data from a

    previously created log file (with a default name) on each node. -t logfilename is removed. -v displays all the resource values for each node, evaluates the resource

    values, and notifies you of the status of all tunable resources, regardless of level.

    Date Utility Description

    Teradata RDBMS Utilities - G-Siv

  • Preface

    December 2002 (cont.)

    Resource Check Tools (cont.)

    The following new sections are added to syscheckrc: The Default syscheckrc File Creating an Optional syscheckrc File Default syscheckrc File Example Testdriver Section Nodeonly Section Timercontrol Section Modified syscheckrc File Example

    nodecheck, syscheck, and syscheckrc have been completely updated with new examples.

    RSSMon The RSSMon utility now comes with seven standard configuration files.

    sysinit This chapter is completely reorganized into procedure format.

    Appendix B A Frequently Asked Questions appendix for Priority Scheduler is added.

    Appendix C This new appendix lists links to starting and exiting information for each utility.

    June 2001 Locking Logger Locking Logger has the following modifications:

    If the ratio of AMPs to IFPs is six to one or higher, Locking Logger cannot run in continuous mode.

    Information on how to enable Locking Logger using the DBS Control utility is included.

    To create a lock log table, you must have CREATE TABLE privileges. A new sample input is included.

    modmpplist The new utility modmpplist allows you to modify the node list file (mpplist).

    pdeconfig A new example is added for the RSG Vproc Mapping Screen.

    Priority Scheduler

    Priority Scheduler has the following modifications:

    The utility is available on Windows 2000. Additional examples, procedures, and expanded text are included. An overview of components and the default settings are added.

    Query Session Query Session now exits on Windows 2000 by pressing the Enter key.

    Resource Check Tools

    The new Resource Check Tools utility identifies a slow down or hang of the Teradata RDBMS and provides system statistics that could lead to the causes.

    Teradata MultiTool

    Teradata Utility has been renamed Teradata MultiTool and the graphical user interface and functionality is improved.

    Date Utility Description

    Teradata RDBMS Utilities - G-S v

  • Preface

    June 2001 (cont.)

    Update DBC The new Update DBC utility recalculates the following:

    The PermSpace and SpoolSpace values in the DBASE table for the user DBC

    The MaxPermSpace and MaxSpoolSpace values of the DATABASESPACE table for all databases based on the values in the DBASE table.

    Update Space The new Update Space utility recalculates the permanent, temporary, or spool space used by a single database or by all databases in a system.

    vpacd Now you can start vpacd using the new vpacadm script.

    xctl Information on using xctl in the non-windowing mode is added. In the DBS Settings window and Screen DBS command, the Minimum

    Nodes Per Clique is automatically calculated by PDE during initial system installation and each time the system is started. Manually revised values remain in effect until the system restarts.

    The DBS Settings window and Screen DBS command contain the new Battery Status field that allows you to set the battery status for the system.

    The RSS Settings window and Screen RSS command contain the new RSS Sub Table Enable section that allows you to enable or disable logging of SCSI or PDISK data to the ResUsageSldv table.

    The Screen Version command contains the Running RSG field and the Desired RSG fields to display the running versions.

    September 2000 Added Windows NT/Windows 2000 information to applicable utilities.

    June 2000 The Lock Display utility has been added. The Locking Logger utility processor query has changed. The pdeconfig utility automatically creates the alias

    SYSTEMNAMEbynetc for all the nodes in the configuration. (UNIX MP-RAS-only)

    The Query Session utility now displays the date as YY/MM/DD. The Reconfiguration utility has improved base performance and

    contains new stored procedures information. The Recovery Manager utility provides a method to measure and

    predict down AMP recovery time. The Table Rebuild utility contains new stored procedures information. The Teradata Utility has been added to access the ctl, Database

    Initialization Program, DBS Control, and Vproc Manager utilities. The xctl utility improvements include the following: Allows you to specify whether a snapshot dump will cause the

    Teradata RDBMS to crash or not. Notifies you when a change to a tunable value requires a reset or reboot

    to be effective.

    Date Utility Description

    Teradata RDBMS Utilities - G-Svi

  • Preface

    June 1999 The ctl utility has been added. The xctl utility has been revised for clarification. Added screen captures

    and menu bar information for windows and revised text for clarity.

    April 1999 The Ferret utility has been revised to clarify general command syntax and usage. In addition, much of the information in the PACKDISK and SCOPE commands has been expanded and revised.

    The Gateway Control utility has been revised into two separate chapters for clarification:

    Gateway Control utility Gateway Global Control Utility The PDE Priority Scheduler has been revised and updated.

    December 1998 The SCOPE command in the Ferret Utility has been updated. The Priority Scheduler is a new utility.

    Date Utility Description

    Teradata RDBMS Utilities - G-S vii

  • PrefaceAbout This Book

    About This Book

    Purpose

    This book describes the utility programs that support the Teradata Relational Database Management System (RDBMS). The subjects covered in this book include utilities G through T. Use this book in conjunction with Teradata RDBMS Utilities, Volume 1 and Teradata RDBMS Utilities, Volume 3.

    Audience

    The utilities described in this book are used primarily by Teradata Support Center (TSC) field engineers, RDBMS developers, System Test and Verification, and system administrators. For example, these utilities are used to display control parameters, display DBS control record fields, find and correct problems within the file system, initialize the Teradata RDBMS, rebuild tables in the database, and manage the virtual processors (vprocs). These utilities are used to abort transactions and processes; monitor system performance, resources, and status, perform internal system checking, and perform system configuration, initialization, recovery, and tuning.

    Users should also be familiar with the RDBMS console running the Database Window (DBW) and your client (host) system.

    Experienced utilities users can also refer to the simplified command descriptions in the Teradata RDBMS Utilities Quick Reference. This book provides the syntax diagrams and a brief description of the syntax variables for each Teradata RDBMS utility.

    How This Book Is Organized

    This document contains 16 chapters, three appendixes, and an index:

    Chapter 1: Gateway Control Utility describes how to modify default values in the fields of the gateway control globally distributed object (GDO).

    Chapter 2: Gateway Global Utility describes how to monitor and control the sessions of Teradata LAN-connected users.

    Chapter 3: Lock Display Utility provides a snapshot capture of all real-time database locks and their associated currently running jobs.

    Chapter 4: Locking Logger Utility describes how to create a table of information extracted from RDBMS transaction logs.

    Chapter 5: modmpplist Utility (Microsoft Windows 2000 Only) allows you to modify the node list file (mpplist).

    Chapter 6: pdeconfig Utility (NCR UNIX MP-RAS Only) describes how to configure the Parallel Database Extensions (PDE) on a system.

    Teradata RDBMS Utilities - G-Sviii

  • PrefaceAbout This Book

    Chapter 7: Priority Scheduler describes how to prioritize process scheduling through the use of resource partitions for groups of processes or users.

    Chapter 8: Query Configuration Utility describes how to display configuration information about a node in the RDBMS.

    Chapter 9: Query Session Utility describes how to monitor the states of all or selected database sessions on all or selected logical host IDs attached to the Teradata RDBMS.

    Chapter 10: Reconfiguration Utility describes how to define or modify an RDBMS.

    Chapter 11: Reconfiguration Estimator Utility estimates an elapsed time for reconfiguration based upon the number and size of tables on your current system.

    Chapter 12: Recovery Manager Utility describes how to monitor the progress of a system in recovery.

    Chapter 13: Resource Check Tools identifies a slow down or hang of the Teradata RDBMS and provides system statistics that could lead to the cause of the slow down or hang.

    Chapter 14: RSSmon Utility (NCR UNIX MP-RAS Only) describes how to collect data using the Resource Sampling System (RSS) of PDE.

    Chapter 15: Showlocks Utility describes how to display information about host utility locks placed on databases and tables by the Archive and Recovery utility during database operations.

    Chapter 16: System Initializer Utility describes how to initialize the Teradata RDBMS.

    Appendix A: How to Read Syntax Diagrams describes the conventions that apply to reading the syntax diagrams used in this book.

    Appendix B: Priority Scheduler Frequently Asked Questions (FAQ) contains frequently asked questions and answers about Priority Scheduler.

    Appendix C: Starting and Exiting Utilities includes links to starting and exiting information for each utility.

    Prerequisites

    You should be familiar with the following operations:

    Using a command line to run the pdeconfig utility on the Package Distribution Node (PDN).

    Using the Database Window (DBW) to run the other utilities.

    Teradata RDBMS Utilities - G-S ix

  • PrefaceAbout This Book

    In addition, you might want to review the following related books:

    Teradata RDBMS Database Window Teradata RDBMS Performance Optimization Teradata RDBMS Resource Usage Macros and Tables Platform-dependent Teradata RDBMS Installation/Upgrade/Migration

    documents

    For detailed information about Archive/Recovery, FastExport, FastLoad, MultiLoad, and TPump utilities, refer to the appropriate client utilities books.

    Teradata RDBMS Utilities - G-Sx

  • PrefaceList of Acronyms

    List of Acronyms

    The following acronyms, which the following table lists in alphabetical order:

    AMP Access Module Processor

    AWT AMP Work Task

    CPU Central Processing Unit

    DB Data Block

    DBW Database Window

    DIP Data Initialization Program

    DML Data Manipulation Language

    DUL Dump Unload/Load

    FSG Three-character functional code group name for a PDE code subsystem.

    GDO Globally Distributed Objects

    GRAW Group Resource Allocation Group

    LAN Local Area Network

    MLOAD MultiLoad

    MPP Massively Parallel Processing

    ODS Operational Data Store

    PDE Parallel Database Extensions

    PDN Package Distribution Node

    PE Parsing Engine

    PJ Permanent Journal

    PROC Procedural Management Subsystem

    QFC Query Capture Feature

    RDBMS Relational Database Management System

    RSS Resource Subsystem

    SMP Symmetric Multi-Processing

    SQL Structured Query Language

    TDP Teradata Director Program

    TLE Target Level Emulation

    Teradata RDBMS Utilities - G-S xi

  • PrefaceList of Acronyms

    TPA Trusted Parallel Application

    TSC Teradata Support Center

    TUVT Teradata Utilities Verification Tool

    UTC Universal Coordinated Time

    vpacd Virtual Process Controller

    vproc virtual processor

    xpsh Parallel Shell Tool

    xpt Cross Package Tools

    Teradata RDBMS Utilities - G-Sxii

  • PrefaceTechnical Information on the Web

    Technical Information on the Web

    The NCR home page (http://www.ncr.com) provides links to numerous sources of information about Teradata. Among the links provided are sites that deal with the following subjects:

    Contacting technical support Enrolling in customer education courses Ordering and downloading product documentation Accessing case studies of customer experiences with Teradata Accessing third party industry analyses of Teradata data warehousing

    products Accessing white papers Viewing or subscribing to various online periodicals

    Teradata RDBMS Utilities - G-S xiii

    http://www.ncr.com

  • PrefaceTechnical Information on the Web

    Teradata RDBMS Utilities - G-Sxiv

  • Contents

    Preface

    Supported Software Release ............................................................................................ iChanges to This Book ....................................................................................................... i

    About This Book .............................................................................................................. viiiList of Acronyms ................................................................................................................ xiTechnical Information on the Web.................................................................................xiii

    Chapter 1: Gateway Control UtilityStarting and Exiting Gateway Control on UNIX MP-RAS........................................ 12Starting and Exiting Gateway Control on Microsoft Windows 2000 ...................... 13Gateway Log Files ........................................................................................................... 14Inputting Gateway Control Options ............................................................................ 15Gateway Control Options .............................................................................................. 16Changing Maximum Sessions Per Node ................................................................... 110

    Chapter 2: Gateway Global UtilityStarting and Exiting Gateway Global on UNIX MP-RAS ......................................... 23

    From the Database Window ....................................................................................... 23From the Command Line ............................................................................................ 24From the X Windows Interface Command Line...................................................... 24

    Starting and Exiting Gateway Global on Microsoft Windows 2000 ........................ 25From the Database Window ....................................................................................... 25From Teradata Command Prompt ............................................................................ 26From Teradata MultiTool ............................................................................................ 27

    Gateway Global User Interfaces.................................................................................... 28Gateway Global Command Line Functions ................................................................ 29Specifying a Host........................................................................................................... 210Displaying Network and Session Information ......................................................... 211Administering Users and Sessions ............................................................................. 212Performing Special Diagnostics .................................................................................. 213Logging Sessions Off Using KILL............................................................................... 214Getting Help................................................................................................................... 215

    Teradata RDBMS Utililties - G-S xv

  • Contents

    DISABLE EXLOGON (UNIX MP-RAS Only) ........................................................... 216DISABLE LOGONS....................................................................................................... 217DISABLE TRACE .......................................................................................................... 218DISCONNECT SESSION (UNIX MP-RAS Only) ..................................................... 219DISCONNECT USER (UNIX MP-RAS Only) ........................................................... 220DISPLAY DISCONNECT............................................................................................. 222DISPLAY FORCE (Windows 2000 Only)................................................................... 223DISPLAY GTW .............................................................................................................. 224DISPLAY NETWORK................................................................................................... 227DISPLAY SESSION ....................................................................................................... 230DISPLAY STATS (Windows 2000 Only) .................................................................... 234DISPLAY TIMEOUT ..................................................................................................... 236DISPLAY USER ............................................................................................................. 237ENABLE EXLOGON (UNIX MP-RAS Only) ............................................................ 239ENABLE LOGONS........................................................................................................ 240ENABLE TRACE ........................................................................................................... 241FLUSH TRACE .............................................................................................................. 243HELP ............................................................................................................................... 244KILL SESSION ............................................................................................................... 246KILL USER...................................................................................................................... 247SELECT HOST ............................................................................................................... 249SET TIMEOUT ............................................................................................................... 250X Window Interface Gateway Global Functions (UNIX MP-RAS Only) .............. 251

    Starting the Gateway Global Graphical Interface .................................................. 251Exiting the Gateway Global Graphical Interface .................................................. 251

    Gateway Global Main Window................................................................................... 252Menu Bar......................................................................................................................... 254Display ............................................................................................................................ 255Summary and Session................................................................................................... 256Mode................................................................................................................................ 257Messages ......................................................................................................................... 259Session Window ............................................................................................................ 260

    Chapter 3: Lock Display UtilityStarting and Exiting Lock Display on NCR UNIX MP-RAS..................................... 32Starting and Exiting Lock Display on Microsoft Windows 2000 ............................. 33

    From the Database Window ....................................................................................... 33From Teradata Command Prompt............................................................................. 34From Teradata MultiTool ............................................................................................ 35

    Lock Modes ...................................................................................................................... 36Lock-Mode Contention................................................................................................... 37

    Teradata RDBMS Utililties - G-Sxvi

  • Contents

    Explicit and Implicit Lock Modes ................................................................................. 38Lock Request Status ........................................................................................................ 39Lock Display Utility Commands................................................................................. 310BLOCKERS..................................................................................................................... 311DB .................................................................................................................................... 315HELP ............................................................................................................................... 318QUIT................................................................................................................................ 319ROWHASH .................................................................................................................... 320ROWRANGE ................................................................................................................. 323TABLE ............................................................................................................................. 325TRAN .............................................................................................................................. 327

    Chapter 4: Locking Logger UtilityStarting and Exiting Locking Logger on NCR UNIX MP-RAS ................................ 42Starting and Exiting Locking Logger on Microsoft Windows 2000......................... 43

    From the Database Window ....................................................................................... 43From Teradata Command Prompt ............................................................................ 44From Teradata MultiTool ............................................................................................ 45

    Transaction Lock Log Information ............................................................................... 46Enabling the LockLogger Field in DBS Control Utility ............................................. 47Lock Logger Table Requirements ................................................................................. 48Lock Log Tables ............................................................................................................. 410Messages ......................................................................................................................... 415Producing a Lock Log Report...................................................................................... 416Example Log Files ......................................................................................................... 419Reducing the Size of the Tables................................................................................... 420Reducing the Size of the Lock Log Table .................................................................. 422Reducing the Size of the DBC.EventLog Table ........................................................ 423Inserting Rows ............................................................................................................... 424Determining the Blocked User .................................................................................... 427Hexadecimal and Non-Standard Names Support.................................................... 430

    Chapter 5: modmpplist Utility (Microsoft Windows 2000 Only)Starting modmpplist ....................................................................................................... 52Editing the Default mpplist ........................................................................................... 53Editing a User-Specified mpplist .................................................................................. 54Using modmpplist........................................................................................................... 55DISPLAY .......................................................................................................................... 56LIST.................................................................................................................................... 57

    Teradata RDBMS Utililties - G-S xvii

  • Contents

    OFF id_list ......................................................................................................................... 58ON id_list .......................................................................................................................... 59QUIT................................................................................................................................ 510WRITE ............................................................................................................................. 511!COMMAND .................................................................................................................. 512

    Chapter 6: pdeconfig Utility (NCR UNIX MP-RAS Only)About pdeconfig .............................................................................................................. 62Planning PDE Configuration ......................................................................................... 63Definitions of Terms Used in pdeconfig ...................................................................... 65Starting and Exiting pdeconfig...................................................................................... 67

    Applying Changes and Exiting pdeconfig ............................................................... 68Discarding Changes and Exiting pdeconfig ........................................................... 610

    Error Messages............................................................................................................... 612Configuring PDE ........................................................................................................... 613Task 1: Setting PDE to the NULL State ...................................................................... 614Task 2: Running pdeconfig .......................................................................................... 615pdeconfig Screens.......................................................................................................... 616Moving Between Screen Types.................................................................................... 617Jump Command ............................................................................................................ 618Continue Command...................................................................................................... 619Screen 1: TPA Summary ............................................................................................... 620Screen 2: Disk Array Summary ................................................................................... 622Screen 3: Disk Slicing Summary.................................................................................. 628Screen 4: Pdisk Mapping Summary............................................................................ 632Screen 5: LAN Summary .............................................................................................. 638Screen 6: Host Channel Summary............................................................................... 645Screen 7: Relay Services Gateway (RSG) TPA Mapping Summary ...................... 652Screen 8: Apply Changes.............................................................................................. 654Screen 9: Exit With No Changes to the System......................................................... 656Example Setup ............................................................................................................... 658Task 1: Gathering System Information....................................................................... 659Task 2: Configuring the Disk Array............................................................................ 661Task 3: Configuring Disk Slicing................................................................................. 663Task 4: Mapping Pdisks................................................................................................ 665Task 5: Mapping a LAN ............................................................................................... 667Task 6: Assigning Host Channels................................................................................ 669Task 7: Applying Changes ........................................................................................... 6716210 Disk Array Special Procedure............................................................................. 674

    Teradata RDBMS Utililties - G-Sxviii

  • Contents

    Chapter 7: Priority Scheduler About Priority Scheduler ............................................................................................... 73

    About Resource Partitions .......................................................................................... 73About Performance Groups and Allocation Groups .............................................. 73

    Overview of Priority Scheduler Components............................................................. 75Priority Scheduler Default Settings .............................................................................. 77Using the Priority Scheduler.......................................................................................... 78Resource Partitions.......................................................................................................... 79

    Resource Partition Parameters ................................................................................. 710Determining the Relative Weight of a Resource Partition ................................... 710Limiting Resource Partition CPU Usage................................................................. 711Suggestions for Using Resource Partitions............................................................. 711

    Performance Groups ..................................................................................................... 713Performance Groups and Allocation Groups......................................................... 713Performance Group and Weight Defaults for Resource Partition 0 ................... 714

    Performance Group Name........................................................................................... 715Recording the Performance Group Name in a User Record................................ 715Alternative Formatting for Default Resource Partition 0

    Performance Group Names ................................................................................... 716Associating a Performance Group Name to a User............................................... 716Supplying Performance Group Names During an RDBMS

    Session Logon........................................................................................................... 716Performance Group Value ........................................................................................... 717

    Performance Group Values in Default Resource Partition 0 ............................... 717Performance Periods ..................................................................................................... 719

    Performance Period Components ............................................................................ 720Performance Period Types and Limits....................................................................... 721

    Time-of-day ................................................................................................................. 721Resource Usage........................................................................................................... 722

    Allocation Groups ......................................................................................................... 723Allocation Group Parameters ................................................................................... 724Associating Allocation Groups to Performance Groups ...................................... 724

    Set Division Type........................................................................................................... 725Expedite Attribute......................................................................................................... 726Allocation Group Weight ............................................................................................. 727

    Determining Allocation Group Relative Weight ................................................... 727Number of Active Users Assigned to an Allocation Group

    Affects Query Response Time ............................................................................... 729Scheduling Policy .......................................................................................................... 731

    Using Scheduling Policies ......................................................................................... 734

    Teradata RDBMS Utililties - G-S xix

  • Contents

    Allocating Resources Using the ABSOLUTE Scheduling Policy......................... 734Allocating Resources Using the RELATIVE Scheduling Policy .......................... 736

    Resource Accounting .................................................................................................... 737Set Age Time ............................................................................................................... 737Set Active Time ........................................................................................................... 737I/O Concurrency Level (Windows 2000 Only)...................................................... 738System CPU Usage Limit .......................................................................................... 738

    AMP Work Task (AWT) Reservations and Limits ................................................... 739AWT Resource Allocation ......................................................................................... 739AWTs Reservation for Expedited Allocation Groups........................................... 740

    schmon Utility................................................................................................................ 745schmon -a........................................................................................................................ 746schmon -b........................................................................................................................ 749schmon -d ....................................................................................................................... 751schmon -e ........................................................................................................................ 756schmon -E ....................................................................................................................... 757schmon -f ........................................................................................................................ 758schmon -h ....................................................................................................................... 759schmon -i......................................................................................................................... 760schmon -I ........................................................................................................................ 761schmon -l......................................................................................................................... 762schmon -m ...................................................................................................................... 764schmon -M ...................................................................................................................... 770schmon -p ....................................................................................................................... 778schmon -r ........................................................................................................................ 781schmon -R ....................................................................................................................... 782schmon -s ........................................................................................................................ 783schmon -t......................................................................................................................... 785schmon -w ...................................................................................................................... 787xschmon Utility.............................................................................................................. 789xschmon Main Window ............................................................................................... 790Main Window Menus ................................................................................................... 792File Menu ........................................................................................................................ 793Edit Menu ....................................................................................................................... 795View Menu ................................................................................................................... 7101Getting Help................................................................................................................. 7103

    Chapter 8: Query Configuration UtilityStarting and Exiting Query Configuration on NCR UNIX MP-RAS....................... 82

    From the Database Window ....................................................................................... 82From the Remote Console ........................................................................................... 83

    Teradata RDBMS Utililties - G-Sxx

  • Contents

    Starting and Exiting Query Configuration on Microsoft Windows 2000 ............... 85From the Database Window ....................................................................................... 85From Teradata MultiTool ............................................................................................ 86

    About Query Configuration .......................................................................................... 88Vprocs and Physical Processors ................................................................................. 88Display Options ............................................................................................................ 88

    Query Configuration Options ....................................................................................... 89ALL Option .................................................................................................................... 810Processors Option.......................................................................................................... 811Online Processors or Offline Processors Options ..................................................... 812AMPs Option ................................................................................................................. 813Online AMPS or Offline AMPs Options .................................................................... 814PEs Option...................................................................................................................... 815Online PEs and Offline PEs Options .......................................................................... 816Getting HELP ................................................................................................................ 817

    Chapter 9: Query Session UtilityStarting and Exiting Query Session on NCR UNIX MP-RAS................................... 92

    From the Database Window ....................................................................................... 92From the Remote Console ........................................................................................... 93

    Starting and Exiting Query Session on Microsoft Windows 2000 ........................... 95From the Database Window ....................................................................................... 95From Teradata MultiTool ............................................................................................ 96

    Query Session States ....................................................................................................... 98Parent and Child Sessions.............................................................................................. 99Query Session Displays ................................................................................................ 910Session State Display .................................................................................................... 912

    Session State Details During Stored Procedure Execution................................... 913Session State Details Pertaining to the Teradata Index Wizard .......................... 913

    State Information Displays........................................................................................... 914ABORTING State........................................................................................................... 915ACTIVE State ................................................................................................................. 916BLOCKED State ............................................................................................................. 917IDLE State ....................................................................................................................... 918INDOUBT State ............................................................................................................. 919INDOUBT PARSING State .......................................................................................... 920PARSING State ............................................................................................................. 921QUIESCED ABORT State ............................................................................................ 922QUIESCED ABORT WITH LOGOFF State ............................................................... 923QUIESCED INDOUBT State ....................................................................................... 924RESPONSE State............................................................................................................ 925

    Teradata RDBMS Utililties - G-S xxi

  • Contents

    Archive and Recovery Sessions State Displays......................................................... 926Active Parent Session with Regular Request Display.............................................. 927Active Parent Session with Directed Request Display............................................. 928Inactive Parent Session Display................................................................................... 929Child Session Display ................................................................................................... 930FastLoad Sessions State Displays................................................................................ 931Active Parent Session in a Loading Phase Display .................................................. 932Active Parent Session in a Nonloading Phase Display............................................ 933Inactive Parent Session in a Loading Phase Display................................................ 934Inactive Parent Session in a Nonloading Phase Display ......................................... 935Child Sessions Display.................................................................................................. 936MultiLoad Sessions State Displays ............................................................................. 937Preliminary Phase Session Display............................................................................. 938Application Phase Session for Apply Task Display ................................................. 939Application Phase Session for Delete Task Display ................................................. 941Active Parent Session in an Acquisition Phase Display .......................................... 942Inactive Parent Session in an Acquisition Phase Display........................................ 943Child Session in an Acquisition Phase Display ........................................................ 944FastExport Sessions State Displays ............................................................................. 945

    Chapter 10: Reconfiguration UtilityBefore Starting Reconfiguration .................................................................................. 102

    Disabling Logons ........................................................................................................ 102Enabling Logons ......................................................................................................... 103

    Starting and Exiting Reconfiguration on NCR UNIX MP-RAS.............................. 104Starting and Exiting Reconfiguration on Microsoft Windows 2000 ...................... 106

    From the Database Window ..................................................................................... 106From Teradata MultiTool .......................................................................................... 107

    About Reconfiguration ................................................................................................. 109Vprocs........................................................................................................................... 109Physical Processors..................................................................................................... 109Configuration Utility Activities................................................................................ 109New Configuration Map ......................................................................................... 1010Reconfiguration Utility Activities .......................................................................... 1010Effects on Journal Tables ......................................................................................... 1011Timestamps ............................................................................................................... 1011

    Reconfiguration Utility Commands ......................................................................... 1012Reconfiguration Utility Process................................................................................. 1013RECONFIG................................................................................................................... 1021STATUS......................................................................................................................... 1024STOP.............................................................................................................................. 1027

    Teradata RDBMS Utililties - G-Sxxii

  • Contents

    Error Messages............................................................................................................. 1028Reconfiguration Example........................................................................................... 1029

    Chapter 11: Reconfiguration Estimator UtilityStarting and Exiting Reconfiguration Estimator on NCR UNIX MP-RAS ........... 112Starting and Exiting Reconfiguration Estimator on Microsoft Windows

    2000 ............................................................................................................................... 114From the Database Window ..................................................................................... 114From Teradata MultiTool .......................................................................................... 115

    Chapter 12: Recovery Manager UtilityStarting and Exiting Recovery Manager .................................................................... 122Starting and Exiting Recovery Manager on NCR UNIX MP-RAS......................... 123

    From the Database Window ..................................................................................... 123From the Remote Console ......................................................................................... 124

    Starting and Exiting Recovery Manager on Microsoft Windows 2000 ................. 126From the Database Window ..................................................................................... 126From Teradata MultiTool .......................................................................................... 127

    Priority Levels................................................................................................................ 129Online Transaction Recovery .................................................................................... 1211Transaction Recovery Sequence ................................................................................ 1212Multiple Recovery Sessions ...................................................................................... 1213Deferred Transaction Recovery ................................................................................ 1214Down AMP Recovery ................................................................................................. 1215

    Down AMP Recovery Operations Display........................................................... 1215Recovering Down AMPs............................................................................................ 1217Recovery Journal ........................................................................................................ 1218Types of Recovery Journal Records.......................................................................... 1219Changed Row Journal ................................................................................................ 1220Ordered System Change Journal ............................................................................. 1221Deferred Down AMP Recovery ............................................................................... 1222Offline Catchup ........................................................................................................... 1223Setting a Down AMP to Offline Catchup Mode ..................................................... 1224Verifying if an Offline AMP is in Catchup Mode................................................... 1226Online Catchup Mode ................................................................................................ 1227Startup/Restart Messages .......................................................................................... 1228Restarts.......................................................................................................................... 1230

    Automatic Restarts ................................................................................................... 1230User-Initiated Restarts ............................................................................................. 1230

    Teradata RDBMS Utililties - G-S xxiii

  • Contents

    Recovery Manager Commands ................................................................................. 1231HELP ............................................................................................................................. 1233LIST................................................................................................................................ 1234

    LIST STATUS ............................................................................................................ 1235LIST STATUS proc-id............................................................................................... 1239LIST LOCKS .............................................................................................................. 1242

    QUIT.............................................................................................................................. 1243REBUILD/RECOVERY PRIORITY........................................................................... 1244

    Chapter 13: Resource Check Toolsdbschk ............................................................................................................................. 132nodecheck ....................................................................................................................... 136

    Creating a Log File ..................................................................................................... 138syscheck ........................................................................................................................ 1323The Default syscheckrc File........................................................................................ 1330Creating an Optional syscheckrc File ....................................................................... 1333

    Chapter 14: RSSmon Utility (NCR UNIX MP-RAS Only)Starting and Exiting RSSmon....................................................................................... 142The Monitoring Configuration File............................................................................. 144Standard Configuration Files....................................................................................... 145Customized Configuration Files ................................................................................. 146Customizing a Configuration File............................................................................... 147Displaying ResUsage Data........................................................................................... 149

    Chapter 15: Showlocks UtilityStarting and Exiting Showlocks on NCR UNIX MP-RAS ....................................... 152

    From the Database Window ..................................................................................... 152From the Remote Console ......................................................................................... 153

    Starting and Exiting Showlocks on Microsoft Windows 2000................................ 155From the Database Window ..................................................................................... 155From Teradata MultiTool .......................................................................................... 156

    Host Utility Locks.......................................................................................................... 157Interpreting the Showlocks Display ........................................................................... 158

    Conflicts ....................................................................................................................... 159

    Teradata RDBMS Utililties - G-Sxxiv

  • Contents

    Chapter 16: System Initializer UtilityStarting and Exiting SYSINIT on NCR UNIX MP-RAS........................................... 162Starting and Exiting SYSINIT on Microsoft Windows 2000 ................................... 163

    From the Database Window ..................................................................................... 163From Teradata MultiTool .......................................................................................... 164

    About System Initializer............................................................................................... 165Initializing the Teradata RDBMS ............................................................................. 165Setting a New System ................................................................................................ 165Setting a Previously Initialized System................................................................... 165Globally Distributed Objects..................................................................................... 165Configuration Maps ................................................................................................... 166Configuration and Reconfiguration Utilities.......................................................... 166

    Using System Initializer ............................................................................................... 167

    Appendix A: How to Read Syntax DiagramsSyntax Diagram Conventions........................................................................................A-2

    Appendix B: Priority Scheduler Frequently Asked Questions (FAQ)Basic Concepts ................................................................................................................. B-2Priority Weighting & Resource Allocation .................................................................. B-8Performance Periods & Allocation Groups ............................................................... B-11

    Appendix C: Starting and Exiting Utilities

    Index ......................................................................................................................... Index1

    Teradata RDBMS Utililties - G-S xxv

  • Contents

    Teradata RDBMS Utililties - G-Sxxvi

  • Chapter 1:

    Gateway Control Utility

    The Gateway Control Utility is a tool that you use to modify default values in the fields of the gateway control Globally Distributed Object (GDO).

    For Teradata RDBMS for NCR UNIX MP-RAS and Teradata RDBMS 2.0.1 for Windows NT, gateways are limited to one per node.

    For Teradata RDBMS 3.0.1 for Microsoft Windows NT, multiple gateways per node are supported, as long as the gateways belong to different host groups and have different IP addresses to listen on.

    Each gateway can support up to 1200 sessions, depending on available system resources and the number of allotted Parser Engines (PEs).

    Audience

    Users of Gateway Control include the following:

    System engineers

    Users should be familiar with the configuration of the Teradata RDBMS and performance of the gateway.

    Teradata RDBMS Utilities - G-S 1 1

  • Chapter 1: Gateway Control UtilityStarting and Exiting Gateway Control on UNIX MP-RAS

    Starting and Exiting Gateway Control on UNIX MP-RAS

    You can start Gateway Control from the command line.

    To start Gateway Control, do the following:

    Step Action

    1 Change to the /tgtw/bin directory.

    2 At the command line, type the following:

    gtwcontrol -option

    Note: You must type an option when using Gateway Control. For a list of options, see Gateway Control Options on page 1-6.

    3 Press Enter.

    Teradata RDBMS Utilities - G-S1 2

  • Chapter 1: Gateway Control UtilityStarting and Exiting Gateway Control on Microsoft Windows 2000

    Starting and Exiting Gateway Control on Microsoft Windows 2000

    You can start Gateway Control from the Teradata Command Prompt.

    To start Gateway Control, do the following:

    Step Action

    1 Select Start ->Programs ->Teradata RDBMS -> Teradata Command Prompt.

    2 At the Teradata Command Prompt, type the following:

    gtwcontrol -option

    Note: You must type an option when using Gateway Control. For a list of options, see Gateway Control Options on page 1-6.

    Teradata RDBMS Utilities - G-S 1 3

  • Chapter 1: Gateway Control UtilityGateway Log Files

    Gateway Log Files

    Function

    The gateway log files include the assign and connect files. On Windows 2000, the assign and connect files are combined into a single file. The default location for these files is /tmp for the UNIX MP-RAS PDE. The default location for these files for Teradata for Windows 2000 is the temporary directory you specified for PDE at installation time. These log files are represented by the following format:

    UNIX MP-RAS Syntax

    TNT 2.0.1 Syntaxgtwyyyymmddhhmmss.log

    TNT 3.0.1/Windows 2000 SyntaxGtw_vvvvv_yyyymmddhhmmss.log

    where:

    Syntax element Is the

    g gateway.

    a assign process.

    c connect process.

    y last digit of the four-digit year.

    ddd day of the year (365 days).

    hh hour (24-hour clock).

    mm minutes.

    ss seconds.

    log log files.

    yyyy four-digit year.

    vvvvv vproc number.

    ydddhhmmsslog

    GT07A028

    g

    a

    c

    Teradata RDBMS Utilities - G-S1 4

  • Chapter 1: Gateway Control UtilityInputting Gateway Control Options

    Inputting Gateway Control Options

    Gateway Control options are case sensitive and must include a dash before the option letters when using either the UNIX MP-RAS or Windows 2000 operating system.

    The following example gives the syntax for the help option that you use to list the syntax for all gateway control options.

    gtwcontrol -h

    When a gateway option requires a field value, that option includes a field name where you define the value.

    For example, to select the host group number 1 on which to perform an action, you would use the option gHostnumber as shown in the example below:

    gtwcontrol -g1

    where the Hostnumber for the option is 1.

    You can combine options by entering them, separated by a space. Using the above example, you can set the maximum number of sessions for host group 1 to 600 by entering the following command:

    gtwcontrol -g1 -s600

    Teradata RDBMS Utilities - G-S 1 5

  • Chapter 1: Gateway Control UtilityGateway Control Options

    Gateway Control Options

    The following table describes these options:

    Gateway Control options that run only on Teradata RDBMS for Windows 2000.

    gtwcontrol control options that run only on Teradata RDBMS for UNIX MP-RAS

    Gateway Control options that run on both Teradata RDBMS for Windows 2000 and UNIX MP-RAS.

    Option DescriptionWindows 2000/UNIX MP-

    RAS

    aSSO Enables or disables permission of single sign on by a host group. You can set each value individually on each host group. The setting are as follows:

    On or ON allows single sign on if the RDBMS allows single sign on.

    Off or OFF does not allow single sign on even if the RDBMS allows single sign on.

    Only or ONLY allows only single sign on only if the RDBMS allows only single sign on.

    Note: By default, the gateway single sign on option defaults to off when V4.1 of the gateway software is installed. If you set the RDBMS setting to Only or Off, that setting overrides the gateway setting.

    Windows 2000

    d Displays current GDO. Both

    eEventcnt Specifies the number of event trace entries. Both

    fLogfilesize Specifies the maximum log file size.

    On Windows 2000, the valid range is 1000 through 2147483647.

    The default is 5000000.

    Both

    gHostnumber Selects the host group.

    When you do not specify this option in combination with another option, all hosts are selected.

    Both

    h Displays gtwcontrol options. Both

    Teradata RDBMS Utilities - G-S1 6

  • Chapter 1: Gateway Control UtilityGateway Control Options

    iInitialIothreads Initially starts up the number of threads specified by this option for the processing of LAN messages.

    Two types of threads exist:

    One handles traffic from the client (that is, TCP/IP connections).

    One handles traffic from the database (that is, the PDE msgsystem).

    The default is 5.

    Windows 2000

    lLogonname For remote gateway global access. (Not implemented in V2R4.1.)

    Windows 2000

    mMaximumIothreads Specifies maximum number of threads per type.

    Two types of threads exist:

    One handles traffic from the client (that is, TCP/IP connections).

    One handles traffic from the database (that is, the PDE msgsystem).

    The default is 50.

    Windows 2000

    pPathname Specifies path to gateway log files. UNIX MP-RAS

    rIoThreadCheck Determines the frequency in minutes that the gateway checks to see if all the threads are busy.

    If they are all busy, a new thread of the appropriate type is started.

    If more than one thread has not run during the rIoThreadCheck period, the gateway stops a thread.

    Two types of threads exist:

    One handles traffic from the client (that is, TCP/IP connections).

    One handles traffic from the database (that is, the PDE msgsystem).

    The default is 10 minutes.

    Windows 2000

    sSessions Specifies maximum sessions for host group.

    Limited to system resources.

    UNIX MP-RAS

    Specifies maximum sessions per vproc.

    The valid range is 0 through 2147483647.

    The default is 600.

    Note: NCR recommends that you do not set the session number to 0 because you will be unable to logon.

    Windows 2000

    Option DescriptionWindows 2000/UNIX MP-

    RAS

    Teradata RDBMS Utilities - G-S 1 7

  • Chapter 1: Gateway Control UtilityGateway Control Options

    tTimeoutvalue Determines how long a disconnected session has to reconnect. If the client has not reconnected within the specified time period, the client is logged off automatically.

    Note: During this time period, the session still counts against the number of sessions allocated to a PE.

    The default is 20 minutes.

    Both

    vVprocnumber Selects a vproc.

    When this option is not specified, all vprocs are selected.

    Both

    A Toggles assign tracing. Both

    C Toggles connect wait.

    Unnecessary for Windows 2000 because there is an assign task that runs as part of the connect task. Therefore, the W option is sufficient for both.

    UNIX MP-RAS

    Toggles connection tracing. Windows 2000

    D Toggles no gtwdie. Both

    E Toggles event trace. Windows 2000

    F Toggles fast logon.

    Toggling fast logon for Windows 2000 is unnecessary because fast logon is always enabled.

    UNIX MP-RAS

    Toggles append domain names on single sign on logon. Windows 2000

    H Toggles connect heap trace. Both

    I Toggles interactive mode. Windows 2000

    J Toggles log LAN errors.

    Logs any LAN-related errors even when properly handled by the gateway.

    Windows 2000

    K Toggles session ctx lock trace.

    This option shows the session locking to make the session context multiprocessor safe.

    Windows 2000

    L Toggles enable logons. Both

    M Toggles message tracing. Both

    O Toggles output LAN header on errors.

    Causes an error message to be written to the gateway log file.

    Windows 2000

    P Toggles assign heap trace. Both

    Option DescriptionWindows 2000/UNIX MP-

    RAS

    Teradata RDBMS Utilities - G-S1 8

  • Chapter 1: Gateway Control UtilityGateway Control Options

    Caution: The following options are only useful for debugging gateway problems and, in general, should not be specified: lGtwGlobal logon name, A, C, D, E, F, H, I, J, K, L, M, O, P, R, S, T, W, X, Y. Turning these options on results in slower gateway performance and in a potentially large amount of disk space consumption by the gateway control log files. Options lGtwGlobal logon name, L, and Z are the only options not specifically related to debugging.

    R Toggles xport log all.

    By default, the Xport trace does not log every LAN operation. The xport log all options causes all LAN operations to be logged.

    This option only takes effect if the Y trace is on.

    Windows 2000

    S Toggles assign wait. UNIX MP-RAS

    Toggles the action log.

    The E event trace does not log the actions.

    The S option turns on the action trace. It only takes effect if the E trace is on.

    Windows 2000

    T Toggles connect trace. UNIX MP-RAS

    Toggles allow gateway testing. Windows 2000

    W Toggles connect and assign wait. UNIX MP-RAS

    Toggles wait for debugger to attach. Windows 2000

    X Toggles xport trace. Both

    Y Toggles handle trace. Windows 2000

    Z Resets GDO to defaults. Windows 2000

    Option DescriptionWindows 2000/UNIX MP-

    RAS

    Teradata RDBMS Utilities - G-S 1 9

  • Chapter 1: Gateway Control UtilityChanging Maximum Sessions Per Node

    Changing Maximum Sessions Per Node

    If your site runs jobs that are CPU or I/O intensive, you might find that a lower session limit gives better performance. To view the current maximum sessions per node, type the following:

    gtwcontrol -d

    On Windows 2000, the valid range for maximum sessions is 0 through 2147483647. NCR recommends that you do not set the session number to 0 because you will be unable to logon. Also, you cannot set the maximum sessions to a negative number.

    To set the maximum sessions to 1000, type the following:

    gtwcontrol -g1 -s1000

    where 1 is the number of the host group and 1000 is the maximum sessions you want.

    On Windows 2000, the new limit is effective immediately.

    On UNIX MP-RAS, the following table describes when the new limit takes effect.

    gtwcontrol notifies you of the following:

    Whether a tpareset is required for the new maximum session limit to become effective

    The current maximum sessions limit and the new maximum sessions limit if you did not restart the Teradata RDBMS after a change.

    If more sessions are active than the new maximum sessions limit allows, then no new sessions are started. No new sessions can log on until the number of sessions is below the maximum sessions limit.

    IF the new maximum session limit is THEN the new limit takes effect

    less than 600 or less than the limit at the last tpareset (whichever is bigger)

    immediately.

    more than 600 and more than the limit at the last tpareset

    after the next tpareset.

    The current maximum session limit will default to the value at the last tpareset.

    Teradata RDBMS Utilities - G-S1 10

  • Chapter 2:

    Gateway Global Utility

    The Gateway Global utility allows you to monitor and control the sessions of Teradata database LAN-connected users. The gateway software runs as a separate operating system task and is the interface between the network and the Teradata RDBMS.

    Client programs that communicate through the gateway to the Teradata RDBMS may be resident on the system, or they may be installed and running on network-attached workstations. Client programs that run on a channel-attached host bypass the gateway completely.

    For Teradata RDBMS for NCR UNIX MP-RAS and Teradata RDBMS 2.0.1 for Microsoft Windows NT, gateways are limited to one per node.

    For Teradata RDBMS 3.0.1 for Windows NT, multiple gateways per node are supported, as long as the gateways belong to different host groups and have different IP addresses to listen on.

    Each gateway can support up to 1200 sessions, depending on available system resources and the number of allotted Parsing Engines (PEs). At least one PE that can support up to 120 sessions is required for each logical network attachment.

    Note: When all the PEs in the DBS configuration are offline, Gateway Global exits, and the following message appears:

    xgtwglobal cannot proceed as no PEs are online.

    When all of the PEs in some of the host groups in the DBS configuration are offline, then Gateway Global displays the following notice and continues to process information for the host groups with at least one PE online:

    NOTICE: xgtwglobal cannot process all the host groups as all the PEs on one or more of the host groups are offline.

    The number of sessions per gateway is defined using the gtwcontrol utility. For information on configuring gateway options, see Chapter 1: Gateway Control Utility.

    For information about configuring the gateway, see platform-dependent Teradata RDBMS Installation/Migration/Upgrade documents.

    Note: Gateway errors are handled in the same manner as other RDBMS errors.

    Teradata RDBMS Utilities - G-S 2 1

  • Chapter 2: Gateway Global Utility

    Audience

    Users of Gateway Global include the following:

    Field service representatives Network administrators System administrators

    Users should be familiar with the administration of their network environment and the Teradata database software.

    Teradata RDBMS Utilities - G-S2 2

  • Chapter 2: Gateway Global UtilityStarting and Exiting Gateway Global on UNIX MP-RAS

    Starting and Exiting Gateway Global on UNIX MP-RAS

    You can type the command in uppercase letters, lowercase letters, or any combination of uppercase and lowercase letters.

    Gateway Global is located in the tgtw/bin directory.

    You can start and exit Gateway Global from the following:

    Database Window Command Line X Windows Interface Command Line

    From the Database Window

    To start Gateway Global, do the following:

    Note: For details on the Database and Supervisor windows, see Teradata RDBMS Database Window.

    Step Action

    1 In the Database Window, select the Supervisor (Supvr) icon.

    The Supervisor window appears.

    2 In the Enter a command input subwindow of the Supervisor window, type the following:

    start xgtwglobal -nw

    3 Press Enter.

    The Supervisor window displays the following:

    Started 'xgtwglobal' in window 4.

    The number represents the application window in which Gateway Global is running. The Gateway Global window appears.

    Teradata RDBMS Utilities - G-S 2 3

  • Chapter 2: Gateway Global UtilityStarting and Exiting Gateway Global on UNIX MP-RAS

    To exit Gateway Global, do the following:

    From the Command Line

    To start Gateway Global, do the following:

    From the X Windows Interface Command Line

    To start Gateway Global, do the following:

    Step Action

    1 In the Enter a command subwindow of the Gateway Global window, type one of the following:

    quit

    2 Press Enter.

    The following message appears:

    gtwglobal exiting. . .

    3 In the Gateway Global window, select File -> Close.

    4 In the Supervisor window, select File -> Close.

    Step Action

    1 Change to the tgtw/bin directory.

    2 At the command line, type the following:xgtwglobal -nw

    3 Press Enter.

    The Gateway Global window appears.

    Step Action

    1 Change to the tgtw/bin directory.

    2 At the X Windows interface command line, type the following:xgtwglobal

    3 Press Enter.

    The Gateway Global window appears.

    Teradata RDBMS Utilities - G-S2 4

  • Chapter 2: Gateway Global UtilityStarting and Exiting Gateway Global on Microsoft Windows 2000

    Starting and Exiting Gateway Global on Microsoft Windows 2000

    You can type the command in uppercase letters, lowercase letters, or any combination of uppercase and lowercase letters.

    Gateway Global is located in the tgtw/bin directory.

    You can start and exit Gateway Global from the following:

    Database Window Teradata Command Prompt Teradata MultiTool

    From the Database Window

    To start Gateway Global, do the following:

    Note: For detailed information on the Database and Supervisor Windows, see Teradata RDBMS Database Window.

    Step Action

    1 Select Start -> Programs -> Teradata RDBMS -> Database Window.

    The Database Window appears.

    2 In the Database Window, select the Supervisor (Supvr) icon.

    The Supervisor window appears.

    3 In the Enter a command subwindow of the Supervisor window, type one of the following:

    start gtwglobal start xgtwglobal

    4 Press Enter.

    The Supervisor window displays the following:

    Started 'gtwglobal' in window 4.

    The number represents the application window in which Gateway Global is running. The Gateway Global window appears.

    Teradata RDBMS Utilities - G-S 2 5

  • Chapter 2: Gateway Global UtilityStarting and Exiting Gateway Global on Microsoft Windows 2000

    To exit Gateway Global, do the following:

    From Teradata Command Prompt

    To start Gateway Global, do the following:

    To exit Gateway Global, do the following: