Linux - Parallel Transporter

Teradata Parallel Transporter Application Programming Interface Programmer Guide

Product
Parallel Transporter
Release Number
16.10
Published
May 2017
Language
English (United States)
Last Update
2018-05-15
dita:mapPath
pev1488824663354.ditamap
dita:ditavalPath
Audience_PDF_include.ditaval
dita:id
B035-2516
lifecycle
previous
Product Category
Teradata Tools and Utilities

To execute the precompiled TPTAPI applications available in \sample\runsamp directory:

  1. Change your working directory to <TPTAPI install directory>\sample\runsamp.
  2. Run the executable that is available in this directory.

    For example, to run a 32-bit TPTAPI application built on Linux, issue this command at the command prompt:

    ./runsamp_linux_32 tpdid userid password
  1. After you install Teradata PT, you should see the following directory structure:
    \lib 	(contains 32-bit .so files)
    \lib64    (contains 64-bit .so files)
        \inc  (contain .h files)
        \sample
    	   \blockloading  (Shows how to load rows in buffer mode with the load driver)
    	   \checkpoint    (Shows how checkpoint/restart works with the stream driver)
    	   \common        (Contains shared files used by all samples)
    	   \generic       (Shows how each driver works)
    	   \getbuffer     (Shows how to export the driver’s GetBuffer feature)
    	   \inc           (Contains shared .h files used by all samples)
    	   \multiple      (Shows how to use multiple drivers in the same application)
    	   \multi_node    (Shows how to use the multi-node protocol)
    	   \threads       (Shows how to write multi-threaded applications)
    	   \xsp           (Shows how to use Teradata PT in an XSP)
    	   \runsamp       (Contains precompiled TPTAPI applications)
     	  \runsamp_linux_32     (32-bit TPTAPI application built for Linux with gcc 4.1)
            \runsamp_linux_64     (64-bit TPTAPI application built for Linux with gcc 4.1)
            \runsamp_linux_390_32 (32-bit TPTAPI application built for z/Linux with gcc 4.1)
            \runsamp_linux_390_64 (64-bit TPTAPI application built for z/Linux with gcc 4.1)
  2. Become familiar with the Teradata PT methods in the sample programs (.cpp files).
  3. In the sample makefile, you can see the following settings. Run the makefile to build the samples.
    • C/C++ Additional Include Directories:
      ../inc  (Teradata PT common headers)
      ./inc   (sample-only header)
      ../common (sample shared files)
    • Linker Additional Library Directories:
      -ltelapi
      Edit the makefile and modify the values of the C++C and CC variables to the location of the compilers on your system.
  4. Set the CLIv2 environment variable THREADONOFF to one to run the Teradata PT multi-threaded application.
  5. Change the DBS machine name, DBS user name, and DBS user password in the BTEQ scripts setupTables.bteq and cleanupTables.bteq for each sample.
  6. Run the BTEQ script setupTables.bteq to set up the tables for the current sample.
  7. Execute the sample.
  8. Run the BTEQ script cleanupTables.bteq to clean up the tables used by the current sample.