Validating the BTEQ Installation - Teradata Tools and Utilities

Teradata® Tools and Utilities for IBM z/OS Installation Guide

Product
Teradata Tools and Utilities
Release Number
16.20
Published
October 2018
Language
English (United States)
Last Update
2019-03-07
dita:mapPath
ovw1527114222335.ditamap
dita:ditavalPath
ovw1527114222335.ditaval
dita:id
B035-3128
lifecycle
previous
Product Category
Teradata Tools and Utilities
Refer to Basic Teradata® Query Reference (B035-2414) for detailed information on how to use BTEQ.
  1. Invoke BTEQ interactively. Output similar to the following appears:
    Teradata BTEQ 16.20.00.00 for platform.
    Copyright 1984-2017, Teradata Corporation. ALL RIGHTS RESERVED.
    Enter your logon or BTEQ command:
  2. Log on to the Teradata Database:

    .logon dbcpath/username

    Enter the BTEQ logon command with a logon ID. Include the dbcpath if the Teradata Database dbcpath is not the default i_dbcpath specified in clispb.dat.

  3. When prompted, enter the password. For example, if the Teradata Database has a dbcpath of Finance, the username is fml, and the password is fml, type:
    • .logon Finance/fml
    • Password: fml
    If the logon is successful, output similar to the following appears:
    *** Logon successfully completed.
    *** Teradata Database Release is 16.20.00.00
    *** Teradata Database Version is 16.20.00.00
    *** Transaction Semantics are BTET.
    *** Session Character Set Name is 'EBCDIC'. 
    
    *** Total elapsed time was 2.78 seconds. 
                        
    BTEQ -- Enter your SQL request or BTEQ command:
    For information about security and connecting to a Teradata Database, see Teradata® Database Security Administration (B035-1100).
  4. Submit a sample Teradata SQL query:

    SELECT time;

    If the test passes, output similar to the following appears.
    *** Query completed. One row found. One column returned.    
    *** Total elapsed time was 1 second.                      
                        Time                   
                      --------                  
                      11:09:11
  5. To see the version numbers for BTEQ and the key Teradata software it depends on, use the following BTEQ command:

    .SHOW VERSIONS

    which produces output similar to the following:
    .SHOW VERSIONS
     BTEQ Version 16.20.00.00 for platform
     CLIV2      : 16.20.00.00
     COPERR.H   : 16.20.00.00
     COPTYPES.H : 16.20.00.00
     DBCAREA.H  : 16.20.00.00
     DBCERR.H   : 16.20.00.00
     DBCHQEP.H  : 16.20.00.00
     MOSIIF.H   : 16.20.00.00
     PARCEL.H   : 16.20.00.00
     TERAGSS    : 16.20.00.00
     PIOM       : 16.20.00.00
     TDICU      : 16.20.00.00
     TDWALLET   : 16.20.00.00
     Database   : 16.20.00.00
      
      BTEQ linking date is Feb  4 2014
    
  6. Log off of the Teradata Database and exit BTEQ.