Teradata Preprocessor2 for Embedded SQL. Programmer Guide

Transcription

1 Teradata Preprocessor2 for Embedded SQL Programmer Guide Release B K March 2013

2 The product or products described in this book are licensed products of Teradata Corporation or its affiliates. Teradata, Active Enterprise Intelligence, Applications-Within, Aprimo, Aprimo Marketing Studio, Aster, BYNET, Claraview, DecisionCast, Gridscale, MyCommerce, Raising Intelligence, Smarter. Faster. Wins., SQL-MapReduce, Teradata Decision Experts, "Teradata Labs" logo, "Teradata Raising Intelligence" logo, Teradata ServiceConnect, Teradata Source Experts, "Teradata The Best Decision Possible" logo, The Best Decision Possible, WebAnalyst, and Xkoto are trademarks or registered trademarks of Teradata Corporation or its affiliates in the United States and other countries. Adaptec and SCSISelect are trademarks or registered trademarks of Adaptec, Inc. AMD Opteron and Opteron are trademarks of Advanced Micro Devices, Inc. Apache, Apache Hadoop, Hadoop, and the yellow elephant logo are either registered trademarks or trademarks of the Apache Software Foundation in the United States and/or other countries. Axeda is a registered trademark of Axeda Corporation. Axeda Agents, Axeda Applications, Axeda Policy Manager, Axeda Enterprise, Axeda Access, Axeda Software Management, Axeda Service, Axeda ServiceLink, and Firewall-Friendly are trademarks and Maximum Results and Maximum Support are servicemarks of Axeda Corporation. Data Domain, EMC, PowerPath, SRDF, and Symmetrix are registered trademarks of EMC Corporation. GoldenGate is a trademark of Oracle. Hewlett-Packard and HP are registered trademarks of Hewlett-Packard Company. Hortonworks, the Hortonworks logo and other Hortonworks trademarks are trademarks of Hortonworks Inc. in the United States and other countries. Intel, Pentium, and XEON are registered trademarks of Intel Corporation. IBM, CICS, RACF, Tivoli, and z/os are registered trademarks of International Business Machines Corporation. Linux is a registered trademark of Linus Torvalds. LSI is a registered trademark of LSI Corporation. Microsoft, Active Directory, Windows, Windows NT, and Windows Server are registered trademarks of Microsoft Corporation in the United States and other countries. NetVault is a trademark or registered trademark of Quest Software, Inc. in the United States and/or other countries. Novell and SUSE are registered trademarks of Novell, Inc., in the United States and other countries. Oracle, Java, and Solaris are registered trademarks of Oracle and/or its affiliates. QLogic and SANbox are trademarks or registered trademarks of QLogic Corporation. Red Hat is a trademark of Red Hat, Inc., registered in the U.S. and other countries. Used under license. SAS and SAS/C are trademarks or registered trademarks of SAS Institute Inc. SPARC is a registered trademark of SPARC International, Inc. Symantec, NetBackup, and VERITAS are trademarks or registered trademarks of Symantec Corporation or its affiliates in the United States and other countries. Unicode is a registered trademark of Unicode, Inc. in the United States and other countries. UNIX is a registered trademark of The Open Group in the United States and other countries. Other product and company names mentioned herein may be the trademarks of their respective owners. THE INFORMATION CONTAINED IN THIS DOCUMENT IS PROVIDED ON AN "AS-IS" BASIS, WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT. SOME JURISDICTIONS DO NOT ALLOW THE EXCLUSION OF IMPLIED WARRANTIES, SO THE ABOVE EXCLUSION MAY NOT APPLY TO YOU. IN NO EVENT WILL TERADATA CORPORATION BE LIABLE FOR ANY INDIRECT, DIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, INCLUDING LOST PROFITS OR LOST SAVINGS, EVEN IF EXPRESSLY ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. The information contained in this document may contain references or cross-references to features, functions, products, or services that are not announced or available in your country. Such references do not imply that Teradata Corporation intends to announce such features, functions, products, or services in your country. Please consult your local Teradata Corporation representative for those features, functions, products, or services available in your country. Information contained in this document may contain technical inaccuracies or typographical errors. Information may be changed or updated without notice. Teradata Corporation may also make improvements or changes in the products or services described in this information at any time without notice. To maintain the quality of our products and services, we would like your comments on the accuracy, clarity, organization, and value of this document. Please teradata-books@lists.teradata.com. Any comments or materials (collectively referred to as "Feedback") sent to Teradata Corporation will be deemed non-confidential. Teradata Corporation will have no obligation of any kind with respect to Feedback and will be free to use, reproduce, disclose, exhibit, display, transform, create derivative works of, and distribute the Feedback and derivative works thereof without limitation on a royalty-free basis. Further, Teradata Corporation will be free to use any ideas, concepts, know-how, or techniques contained in such Feedback for any purpose whatsoever, including developing, manufacturing, or marketing products or services incorporating Feedback. Copyright by Teradata Corporation. All Rights Reserved.

3 Preface Purpose This book provides information about PP2, which is a Teradata Tools and Utilities product. Teradata Tools and Utilities is a group of products designed to work with Teradata Database. PP2 is used to incorporate Structured Query Language (SQL) statements into application programs that access data in a Teradata Database. Audience This book is intended for use by application programmers who must incorporate Teradata SQL statements into COBOL, C, or PL/I application programs to access data stored in a Teradata Database. Supported Releases This book supports the following releases: Teradata Database Teradata Tools and Utilities PP Note: See Release Number Information on page 27 to verify the PP2 version number. To locate detailed supported-release information: 1 Go to 2 Click General Search under Online Publications. 3 Type 3119 in the Publication Product ID box. 4 Under Sort By, select Date. 5 Click Search. 6 Open the version of the Teradata Tools and Utilities ##.# Supported Platforms and Product Versions spreadsheet associated with this release. The spreadsheet includes supported Teradata Database versions, platforms, and product release numbers. Teradata Preprocessor2 for Embedded SQL Programmer Guide 3

4 Preface Prerequisites Prerequisites The following prerequisite knowledge is required for this product: Basic computer technology Developing application programs in PL/I, C, or COBOL SQL Teradata Database Changes to This Book The following changes were made to this book in support of the current release. Changes are marked with change bars. For a complete list of changes to the product, see the Release Definition (B ) associated with this release. Date and Release March Description Documented need of required include statements to avoid issue with Teradata-supplied samples and some C compilers. See C Language Support on page 95. Code example in Array Support on page 98 corrected. Additional Information Additional information that supports this product and Teradata Tools and Utilities is available at the web sites listed in the table that follows. Type of Information Description Access to Information Release overview Late information Use the Release Definition for the following information: Overview of all of the products in the release Information received too late to be included in the manuals Operating systems and Teradata Database versions that are certified to work with each product Version numbers of each product and the documentation for each product Information about available training and the support center 1 Go to 2 Click General Search under Online Publications. 3 Type 2029 in the Publication Product ID box. 4 Click Search. 5 Select the appropriate Release Definition from the search results. 4 Teradata Preprocessor2 for Embedded SQL Programmer Guide

5 Preface Additional Information Type of Information Description Access to Information Additional product information CD-ROM images Ordering information for manuals Use the Teradata Information Products web site to view or download specific manuals that supply related or additional information to this manual. Access a link to a downloadable CD-ROM image of all customer documentation for this release. Customers are authorized to create CD-ROMs for their use from this image. Use the Teradata Information Products web site to order printed versions of manuals. 1 Go to 2 Click Data Warehousing under Online Publications, Browse by Category. 3 Do one of the following: For a list of Teradata Tools and Utilities documents, click Teradata Tools and Utilities, and then select an item under Releases or Products. Select a link to any of the data warehousing publications categories listed. Specific books related to PP2 are as follows: Teradata Call-Level Interface Version 2 Reference for Mainframe-Attached Systems B Teradata Call-Level Interface Version 2 Reference for Network-Attached Systems B Data Dictionary B SQL Data Definition Language B SQL Fundamentals B SQL Stored Procedures and Embedded SQL B Teradata Director Program Reference B Messages B Security Administration B SQL Data Types and Literals B SQL Data Manipulation Language B Go to 2 Click Data Warehousing under Online Publications, Browse by Category. 3 Click CD-ROM Images. 1 Go to 2 Click How to Order under Print & CD Publications. 3 Follow the ordering instructions. Teradata Preprocessor2 for Embedded SQL Programmer Guide 5

6 Preface Additional Information Type of Information Description Access to Information General information about Teradata The Teradata home page provides links to numerous sources of information about Teradata. Links include: Executive reports, case studies of customer experiences with Teradata, and thought leadership Technical information, solutions, and expert advice Press releases, mentions, and media resources 1 Go to Teradata.com. 2 Select a link. 6 Teradata Preprocessor2 for Embedded SQL Programmer Guide

7 Table of Contents Preface Purpose Audience Supported Releases Prerequisites Changes to This Book Additional Information Chapter 1: Introduction PP2 Processes Using Static and Dynamic SQL Upgrading PP2 and CLIv Mainframe and Windows Platforms UNIX/LINUX Platforms Supported Operating Systems and Host Programming Languages PP2 Input PP2 Output Contents of PP2 Output Listing Release Number Information OPTIONS, SOURCE, and XREF Sections PRINT Option Diagnostic Messages Client Language Source Code Server Failure and Recovery PP2 Behavior Application Behavior StatementInformation Parcel Auto Generated Key Retrieval Retrieving the Identity Column Value Retrieving the Row Inserting More than One Row Teradata Preprocessor2 for Embedded SQL Programmer Guide 7

8 Table of Contents Using Structures and Arrays to Insert StatementInformation Parcel Period Datatypes PERIOD(DATE) PERIOD(TIME) PERIOD(TIME WITH TIMEZONE) PERIOD(TIMESTAMP) PERIOD(TIMESTAMP WITH TIMEZONE) Query Banding LOB Support Inline Method Restriction User-Defined Types Distinct UDTs Structured UDTs Creating a UDT Importing and Exporting Values into a UDT Column User-Defined Methods Finding Information Chapter 2: Connecting to the Database and Invoking PP Connecting to the Teradata Database PP2 Connection Runtime Execution Connection Explicit Connection Implicit Connection Invoking PP IBM Mainframe Environment: z/os Network-Attached Environments PP2 Options How to Read the Option Syntax APOST QUOTE -a -q APOSTSQL QUOTESQL -as -qs CHARSET(charset) -cs charset CURPREFIX(prefix) -c prefix Teradata Preprocessor2 for Embedded SQL Programmer Guide

9 Table of Contents DATABASE(dbname) -db dbname DATE(D E I J U) -d D E I J U DYNPREFIX (prefix) -dp prefix FLAG(I W E S) -f I W E S INPUT(file spec) -i filespec ld logdata LINECOUNT(integer) -lc integer lm logmech MARGINS(m,n[,c]) -m m,n[,c] NULLSCAN NONULLSCAN -ns -nns OPTIONS NOOPTIONS -lo -nlo PRINT[(file spec)] NOPRINT -l [filespec] -nl PUNCH[(file spec)] NOPUNCH -o [filespec] -no SOURCE NOSOURCE -ls -nls SQLCHECK(FULL NOSYNTAX) -sc FULL NOSYNTAX SQLFLAGGER (NONE ENTRY INTERMEDIATE) -sf (NONE ENTRY INTERMEDIATE) TDPID(tdpid network group name) -t tdpid network group name TERM[(file spec)] NOTERM -e [filespec] -ne TRANSACT(ANSI BTET COMMIT 2PC) -tr ANSI BTET COMMIT USERID(userid[,password[,accountid]]) -u userid[,password[,accountid]] VERSION(COBOL COBOLII COBOL3) -v MF1 MF2 LPI XREF NOXREF -lx -nlx Teradata Preprocessor2 for Embedded SQL Programmer Guide 9

10 Table of Contents Chapter 3: Writing Embedded SQL Applications in C C Language Support Program Status Information Teradata Mode Communications Area ANSI-Compatible Mode Communications Variables BIGINT Support C Coding Considerations Embedded SQL Statement Format Array Support Comments Continuation for SQL Statements Dynamic SQL Including Code Margins Sequence Numbers SQL Strings Statement Labels String Delimiters User Defined Functions Multi-Session Programming Considerations Special Considerations Host Variables Using C Structures as Output Host Variables Using C Structures as Input Host Variables Example Overview Requirements for Host Variables C Language and Host Variables SQL and Host Variables Indicator Variables PP2 Issues Host Variable Declaration Host Variable Values Server to Host Assignment Conversion Rules Byte String Assignment Character Assignment Single Character Data Varying Character Data Character String Data Character String Padding Teradata Preprocessor2 for Embedded SQL Programmer Guide

11 Table of Contents Character Truncation Numeric Value Assignment Date Assignment Host to Server Assignment Assignment Rules Host Variable Declaration Indicator Variables Rules for Indicator Variables Indicator Variables and Input Indicator Variables and Output Indicator Variables and Structures SQL Error Return ANSI Mode SQLCODE Variable SQLSTATE Variable Using PPRTEXT to Retrieve Return Codes SQL Error Return Teradata Mode SQLCODE Field Using PPRTEXT to Retrieve Return Codes Exception Conditions: WHENEVER Exception Conditions WHENEVER Is Declarative Rules for Using WHENEVER Dynamic Statement Example A Caution When Using Dynamic SQL Include SQLDA Example Multi-Session Programming Online Archive Performing a Stored Procedure Period Datatype Example Using Descriptor Using Stored Procedure Dynamic Result Sets Using UPSERT in Embedded SQL Chapter 4: Writing Embedded SQL Applications in COBOL COBOL Language Support COBOL Application Requirements Program Status Information Teradata Mode Communications Area ANSI-Compatible Mode Communications Variables Teradata Preprocessor2 for Embedded SQL Programmer Guide 11

12 Table of Contents BIGINT Support Large Decimal Support COBOL Coding Considerations Array Support Embedded SQL Statement Format Comments Continuation for SQL Statements Dynamic SQL Including Code Margins Paragraph Names Sequence Numbers SQL Strings String Delimiters APOSTSQL Example QUOTESQL Example User Defined Functions Multisession Programming Considerations Special Considerations Host Variables Using COBOL Structures as Output Host Variables Using COBOL Structures as Input Host Variables Example Overview Requirements for Host Variables COBOL and Host Variables SQL and Host Variables PP2 Issues Host Variable Values Server to Host Assignment Host to Server Assignment Host Variable Declaration Indicator Variables Rules for Indicator Variables Indicator Variables and Input Indicator Variables and Output Indicator Variables and Structures SQL Error Return ANSI Mode SQLCODE Variable SQLSTATE Variable Using PPRTEXT to Retrieve Return Codes SQL Error Return Teradata Mode SQLCODE Field Teradata Preprocessor2 for Embedded SQL Programmer Guide

13 Table of Contents Using PPRTEXT to Retrieve Return Codes Exception Conditions: WHENEVER Exception Conditions WHENEVER Is Declarative Rules for Using WHENEVER Dynamic Statement Example Online Archive Period Datatype Examples Chapter 5: Writing Embedded SQL Applications in PL/I PL/I Language Support PL/I Application Requirements Program Status Information Teradata Mode Communications Area ANSI-Compatible Mode Communications Variables BIGINT Support Large Decimal Support PL/I Coding Considerations Array Support Embedded SQL Statement Format Comments Continuation for SQL Statements Dynamic SQL Including Code Macro Processor Margins Sequence Numbers SQL Strings Statement Labels String Delimiters Multi-Session Programming Considerations Special Considerations Host Variables Using PL/I Structures as Output Host Variables Using PL/I Structures as Input Host Variables Example Overview Requirements for PL/I Host Variables Server to Host Assignment Teradata Preprocessor2 for Embedded SQL Programmer Guide 13

14 Table of Contents Conversion Rules Byte String Assignment Character String Assignment String Truncation Numeric Value Assignment Date Assignment Host to Server Assignment Graphic Literals for Multibyte Characters Host Variable Declaration Indicator Variables Rules for Indicator Variables Indicator Variables and Input Indicator Variables and Output Indicator Variables and Structures SQL Error Return ANSI Mode SQLCODE Variable SQLSTATE Variable Using PPRTEXT to Retrieve Return Codes SQL Error Return Teradata Mode SQLCODE Field Using PPRTEXT to Retrieve Return Codes Exception Conditions: WHENEVER Exception Conditions WHENEVER Is Declarative Rules for Using WHENEVER Dynamic Statement Example Online Archive Appendix A: SQL Data Type Codes Unused/Internal Data Type Codes Appendix B: Sample Application Linkage Procedure Overview Bit Platform Linking Concerns Application Linking for z/os Teradata Preprocessor2 for Embedded SQL Programmer Guide

15 Table of Contents Application Linking for CICS Application Linking for IMS Application Linking for C on a UNIX System Linkage Script for a 64-Bit Application on AIX Linkage Script for a 32- Bit Application on Itanium HP-UX Linkage Script for a 64- Bit Application on Itanium HP-UX Linkage Script for a 64-Bit Application on 64-Bit Itanium RH Linkage Script for a 32-Bit Application on Opteron Solaris Linkage Script for a 64-Bit Application on Opteron Solaris Application Linking for C on z/linux Linkage Script for a 32-bit Application on z/linux Linkage Script for a 64-bit Application on z/linux Application Linking for Micro Focus COBOL on a UNIX System Linkage Script for a 64-Bit Application on AIX Linkage Script for a 32-Bit Application on Itanium HP-UX Linkage script for a 64-bit Application on Itanium HP-UX Script Notes Application Linking for Visual C++ on Windows Appendix C: Embedded SQL Examples About the Examples LAB Files Setting Up the Examples Procedure Overview z/os Operating Systems Where to Find Source Code and LAB Files Which Setup Files to Use z/os JCL Network-Attached Operating Systems Where to Find Source Code and LAB Files Which Setup Files to Use Operator Messages EMPLOYEE Table Source Code LAB6 and LAB7 Macros Source Code EMPLOYEE Table Teradata Preprocessor2 for Embedded SQL Programmer Guide 15

16 Table of Contents Glossary Index Teradata Preprocessor2 for Embedded SQL Programmer Guide

17 List of Figures Figure 1: PP2 Operation Teradata Preprocessor2 for Embedded SQL Programmer Guide 17

18 List of Figures 18 Teradata Preprocessor2 for Embedded SQL Programmer Guide

19 List of Tables Table 1: Upgrading PP2 and CLIv2 on UNIX and LINUX Systems Table 2: Supported Host Programming Languages Listed by Operating System Table 3: OPTIONS, SOURCE, and XREF Section Information Table 4: PERIOD(TIME) MEMBERS Table 5: PERIOD(TIME WITH TIMEZONE) MEMBERS Table 6: PERIOD(TIMESTAMP) MEMBERS Table 7: PERIOD(TIMESTAMP WITH TIMEZONE) MEMBERS Table 8: Finding information in the Teradata Database SQL Reference book set Table 9: Teradata-Defined Character Sets for Mainframe Environments Table 10: Site-Defined Character Sets for Mainframe Environments Table 11: Teradata-Defined Character Sets for Network-Attached Environments Table 12: Site-Defined Character Sets for Network-Attached Environments Table 13: C Definitions for Teradata Database Data Types Table 14: COBOL Definitions for Teradata Database Data Types Table 15: PL/I Definitions for Teradata Database Data Types Teradata Preprocessor2 for Embedded SQL Programmer Guide 19

20 List of Tables 20 Teradata Preprocessor2 for Embedded SQL Programmer Guide

21 CHAPTER 1 Introduction PP2 (PP2) provides an easy-to-use method of accessing data stored in the Teradata Database. PP2 does this by interpreting and expanding Teradata SQL statements that have been embedded in an application program. Interpretation of the statements allows the program to perform tasks supported by Teradata SQL, such as data retrieval. The application program is called an embedded SQL host program. The language in which the host program is written is called the host programming language. Therefore, the host program consists of Teradata SQL code that provides the database interface, plus the host programming language, which provides remaining instructions for application execution. Review the next sections in this chapter for information on: PP2 Processes Using Static and Dynamic SQL Upgrading PP2 and CLIv2 Supported Operating Systems and Host Programming Languages PP2 Input PP2 Output Contents of PP2 Output Listing Diagnostic Messages Client Language Source Code Server Failure and Recovery Period Datatypes Query Banding LOB Support User-Defined Types User-Defined Methods Finding Information PP2 Processes PP2 includes a precompiler as well as the services that execute or provide runtime support for a compiled application. A precompiler is necessary to interpret the embedded SQL statements in the host program. Regardless of the host language, PP2 operation consists of two stages: Teradata Preprocessor2 for Embedded SQL Programmer Guide 21

22 Chapter 1: Introduction PP2 Processes 1 The precompile phase, which precedes application compilation and linking. 2 Execution, or runtime support, of the application. During precompilation, PP2 reads and replaces all the SQL statements embedded in the host program with CLIv2 calls that are acceptable to the native compiler for the host language. The host programming language syntax remains unchanged. At runtime, the inserted syntax runs in conjunction with Call-Level Interface version 2 (CLIv2) and Teradata Director Program (TDP) modules to provide a convenient interface between the application program and the Teradata Database. Note: In a mainframe environment, start a TDP module before PP2 performs the precompile step. Do this even if no data access is required (that is, using NOSYNTAX). The steps that PP2 performs, from logging on to the Teradata Database through precompilation, are shown below. The example uses a COBOL program, though the process is similar for other languages: 1 Logs a session onto the Teradata Database and determines whether it is to be a Teradata mode or ANSI-compatible mode session. 2 Checks the syntax of SQL statements in the host language source program, validating database objects against the entries in the Data Dictionary. 3 Builds code in the DATA division for the data elements. 4 Builds code in the PROCEDURE division to handle SQL statement passing to the Teradata Database. 5 Comments out the SQL source code. 6 Produces COBOL source for input to the COBOL compiler. Figure 1 gives a high-level view of starting with a PL/I embedded SQL program as the source input file, then precompiling, compiling, linking, and finally, running the PL/I program. 22 Teradata Preprocessor2 for Embedded SQL Programmer Guide

23 Chapter 1: Introduction Using Static and Dynamic SQL Figure 1: PP2 Operation PL/I PP2 PL/I embedded SQL programs CICS precompiler In CICS environment precompiler Translates embedded SQL into appropriate host language COMPILE LOAD/LINK (For CICS, use Teradata CICS libraries) EXECUTION Execute program with communication to Teradata RDBMS 2446B051 Using Static and Dynamic SQL Both static and dynamic SQL statements are allowed in the embedded SQL host program. Static SQL statements, as the name implies, remain static each time the program is run. Dynamic SQL statements are built at runtime. To use static SQL statements in a host program, the SQL statement type, and the database table and column names are required. Only the specific data values the statement is looking for are unknown: use host language variables to represent those unknown values. For example, use a static SQL statement to enter an order, and a host language variable to represent the quantity of an item in the order. Static SQL statements are hard-coded into the program, therefore the statements require parsing, and so forth, only once. Using static SQL results in faster processing. Dynamic SQL is useful for programs in which the content of a SQL statement is unknown at the time the program is written. For example, an interactive application that prompts the user for a table name would be a good situation in which to use dynamic SQL. Each host programming language handles dynamic SQL statements differently. Refer to Chapter 3: Writing Embedded SQL Applications in C, Chapter 4: Writing Embedded SQL Applications in COBOL, Chapter 5: Writing Embedded SQL Applications in PL/I, and Appendix C: Embedded SQL Examples for more information. Teradata Preprocessor2 for Embedded SQL Programmer Guide 23

24 Chapter 1: Introduction Upgrading PP2 and CLIv2 Upgrading PP2 and CLIv2 Mainframe and Windows Platforms When upgrading to a newer version of the Teradata Database, install the latest versions of PP2 and CLIv2. If changes to the source code have not been made in the existing application programs, execute the programs using the latest versions of PP2 and CLIv2. It is not necessary to precompile, compile, and link the existing applications again. If changes to the source code have been made in the existing application programs, run the PP2 precompiler, compile, then link the applications. UNIX/LINUX Platforms When upgrading to a newer version of the Teradata Database, install the latest versions of PP2 and CLIv2. Refer to Table 1 for instructions on whether or not it is necessary to precompile, compile, and link the existing applications before executing them with the new PP2 and CLIv2 versions. Table 1: Upgrading PP2 and CLIv2 on UNIX and LINUX Systems Changes Made to Source Code in Existing Application Program 32-Bit Platforms 64-Bit Platforms no Relink the application with the latest PP2 runtime library. If the application was last precompiled with TTU 8.2 PP2, relink the application with the latest PP2 runtime library. If the application was last precompiled with a version of PP2 earlier than TTU 8.2 PP2: precompile, compile, then link the application again. yes Precompile, compile, then link the application again. Supported Operating Systems and Host Programming Languages PP2 operates with host programming languages in several environments: Table 2: Supported Host Programming Languages Listed by Operating System Operating System HP-UX 11.0, 11.11, and 11iv2 (11.23) (PA-RISC) (32-bit) HP-UX 11.0, 11.11, and 11iv2 (11.23) (PA-RISC) (64-bit) Host Programming Language C and Micro Focus COBOL (32-bit) C (32-bit and 64-bit) 24 Teradata Preprocessor2 for Embedded SQL Programmer Guide

25 Chapter 1: Introduction Supported Operating Systems and Host Programming Languages Table 2: Supported Host Programming Languages Listed by Operating System (continued) Operating System HP-UX and (Itanium) (64-bit) HP-UX IA32 (32-bit) IBM AIX 5.3 (32-bit) IBM AIX 5.3 (64-bit) IBM AIX 6.1 (32-bit) IBM AIX 6.1 (64-bit) IBM z/os Note: USS is not supported. Microsoft Windows bit SP4 Microsoft Windows.NET Server 2003 (32-bit and 64-bit) Microsoft Windows Server 2003, Standard Edition/Enterprise Edition on Intel EM64T Microsoft Windows Server 2008, Standard Edition/Enterprise Edition on Intel EM64T/Opteron Microsoft Windows Vista Microsoft Windows XP Professional (32-bit and 64-bit) Microsoft Windows XP Professional on Intel EM64T Novell SUSE Linux Enterprise 9 on 32-bit Intel x86 Novell SUSE Linux Enterprise 9 on Intel EM64T Novell SUSE Linux Enterprise 9 and 10 on 64-bit AMD Opteron Novell Suse Linux Enterprise 10 on Intel EM64T Novell Suse z/linux 32-bit and 64-bit RedHat Enterprise Linux Advanced Server 4.0 on AMD Opteron Red Hat Linux Advanced Server 3.0 (32-bit) RedHat Linux Advanced Server 4.0 on 32-bit Intel x86 RedHat Linux Advanced Server 4.0 on Intel EM64T Red Hat Linux Advanced Server 4.0 and above on 64-bit AMD Opteron Red Hat Linux Advanced Server 5.0 on EM64T/AMD Opteron Host Programming Language C (64-bit) C and COBOL C and Micro Focus COBOL (32-bit) C and Micro Focus COBOL (64-bit) C and Micro Focus COBOL (32-bit) C and Micro Focus COBOL (64-bit) IBM C, IBM COBOL, IBM PL/I (32-bit) C (32-bit) C (32-bit and 64-bit) C (32-bit and 64-bit) C (32-bit and 64-bit) C (32-bit and 64-bit) C (32-bit and 64-bit) C (32-bit and 64-bit) C (32-bit) C (32-bit and 64-bit) C (32-bit and 64-bit) C (32-bit and 64-bit) C (32-bit and 64-bit) C (32-bit and 64-bit) C (32-bit) C (32-bit) C (32-bit and 64-bit) C (32-bit and 64-bit) C (32-bit and 64-bit) Teradata Preprocessor2 for Embedded SQL Programmer Guide 25

26 Chapter 1: Introduction PP2 Input Table 2: Supported Host Programming Languages Listed by Operating System (continued) Operating System Red Hat z/linux 32-bit and 64-bit Oracle Solaris 8 and 9 SPARC (32-bit) Oracle Solaris 8 and 9 SPARC (64-bit) Oracle Solaris 10 on 64-bit AMD Opteron Oracle Solaris 10 SPARC (32-bit and 64-bit) Host Programming Language C (32-bit and 64-bit) C (32-bit) C (32-bit and 64-bit) C (32-bit and 64-bit) C (32-bit and 64-bit) Note: The IBM mainframes are mainframe-attached to the Teradata hardware platform running the Teradata Database. Other environments are referred to as network-attached systems. PP2 Input The PP2 input file is the embedded SQL host program (also called the source input file). In addition to the PP2 input file, when using SQL INCLUDE, more files might be required. The requirement depends on the program environment. PP2 Output The source output program is the source input program as modified by PP2. Modifications to the program are: Inclusion of host language comments that identify the program as output from PP2, and that provide the date and time of precompilation. These comments are inserted near the beginning. Conversion of all embedded Teradata SQL statements to host language comments. Insertion of host data variable declarations and procedural statements to implement the embedded Teradata SQL statements. Contents of PP2 Output Listing The output listing is headed by the release number and date and time information (see Release Number Information on page 27). Following the heading, the next three sections of the listing are based on the OPTIONS, SOURCE, and XREF PP2 options (see OPTIONS, SOURCE, and XREF Sections on page 28). The line-by-line listing of the input program is augmented by: An analysis of the PP2 options specified and defaulted 26 Teradata Preprocessor2 for Embedded SQL Programmer Guide

27 Chapter 1: Introduction Contents of PP2 Output Listing Input line numbers assigned by PP2 PP2 diagnostics Cross-references of host variables, cursor, and dynamic statement names A summary of diagnostics A summary of input and output file record counts Release Number Information The first block of the PP2 output listing indicates the date and time of compilation, the PP2 release number, and, if known, the Teradata Database release number. When precompiling using the NOSYNTAX option or if the Teradata Database level is earlier than V2R6.2, the Teradata Database release number does not appear. Next is an example in which the Teradata Database release number is not known: /* THIS PROGRAM WAS PREPROCESSED ON JAN 30, 2006 AT 12:08:48 BY THE C PREPROCESSOR2 PREPROCESSOR SOFTWARE RELEASE: PP DBS N/A */ Teradata Preprocessor2 for Embedded SQL Programmer Guide 27

28 Chapter 1: Introduction Contents of PP2 Output Listing OPTIONS, SOURCE, and XREF Sections Table 3: OPTIONS, SOURCE, and XREF Section Information Section Contents of Section Option that Controls Output or Suppression of the Section Other Information OPTIONS PP2 options that have been specified at invocation options used by PP2 option errors detected by PP2 OPTIONS/NOOPTIONS This section does not contain specified userid. SOURCE the same source that is input to PP2. The section format depends on the host language and includes line numbers known to PP2 and any included lines brought in using INCLUDE statements. source errors detected by PP2 SOURCE/NOSOURCE - XREF host variable, cursor, and dynamic statement declarations and usages summary of input/output records summary of the warnings and errors detected by PP2 XREF/NOXREF Asterisks in the variable declaration type field indicate that the size of the field exceeds the capability of the cross reference. However, this variable remains valid for use in SQL requests. PRINT Option To produce an output listing, specify the PRINT option. The listing is placed in the file specified or defaulted for the PRINT option. For no listing, specify the NOPRINT PP2 option. 28 Teradata Preprocessor2 for Embedded SQL Programmer Guide