# OTL 4.0, Example 252 (OTL tracing, DB2 CLI)

# Example 252 (OTL tracing, DB2 CLI)

This example demonstrates how to use OTL tracing to trace OTL function calls.

## Source Code

    #include <iostream>
    #include <stdio.h>
    using namespace std;

    unsigned int my_trace_level=
       0x1 | // 1st level of tracing
       0x2 | // 2nd level of tracing
       0x4 | // 3rd level of tracing
       0x8 | // 4th level of tracing
       0x10; // 5th level of tracing
    // each level of tracing is represented by its own bit,
    // so levels of tracing can be combined in an arbitrary order.

    #define OTL_TRACE_LEVEL my_trace_level
       // enables OTL tracing, and uses my_trace_level as a trace control variable.

    #define OTL_TRACE_STREAM cerr
       // directs all OTL tracing to cerr

    #define OTL_TRACE_LINE_PREFIX "MY OTL TRACE ==> "
       // redefines the default OTL trace line prefix. This #define is optional

    #define OTL_DB2_CLI // Compile OTL 4.0/DB2-CLI
    #include <otlv4.h> // include the OTL 4.0 header file

    otl_connect db; // connect object

    void insert()
    // insert rows into table
    {
     otl_stream o(10, // buffer size
                  "insert into test_tab values(:f1<int>,:f2<char[31]>)",
                     // SQL statement
                  db // connect object
                 );
     char tmp[32];

     for(int i=1;i<=23;++i){
      sprintf(tmp,"Name%d",i);
      o<<i<<tmp;
     }
    }

    void select()
    {
     otl_stream i(5, // buffer size
                  "select * from test_tab where f1>=:f<int> and f1<=:ff<int>*2",
                     // SELECT statement
                  db // connect object
                 );
       // create select stream

     float f1;
     char f2[31];

     i<<8<<8; // assigning :f = 8; :ff = 8
       // SELECT automatically executes when all input variables are
       // assigned. First portion of output rows is fetched to the buffer

     while(!i.eof()){ // while not end-of-data
      i>>f1>>f2;
      cout<<"f1="<<f1<<", f2="<<f2<<endl;
     }

    }

    int main()
    {
     otl_connect::otl_initialize(); // initialize DB2 CLI environment
     try{

      db.rlogon("scott/tiger@db2sql"); // connect to the database

      otl_cursor::direct_exec
       (
        db,
        "drop table test_tab",
        otl_exception::disabled // disable OTL exceptions
       ); // drop table

      otl_cursor::direct_exec
       (
        db,
        "create table test_tab(f1 int, f2 varchar(30))"
        );  // create table

      insert(); // insert records into table
      select(); // select records from table

     }

     catch(otl_exception& p){ // intercept OTL exceptions
      cerr<<p.msg<<endl; // print out error message
      cerr<<p.stm_text<<endl; // print out SQL that caused the error
      cerr<<p.var_info<<endl; // print out the variable that caused the error
     }

     db.logoff(); // disconnect from the database

     return 0;

    }

## Output

    MY OTL TRACE ==> otl_connect(this=0043E598)::rlogon(connect_str="scott/*****@db2sql", auto_commit=0);
    MY OTL TRACE ==> otl_cursor::direct_exec(connect=0043E590,sqlstm="drop table test_tab",exception_enabled=0);
    MY OTL TRACE ==> otl_cursor::direct_exec(connect=0043E590,sqlstm="create table test_tab(f1 int, f2 varchar(30))",exception_enabled=1);
    MY OTL TRACE ==> otl_stream(this=0012FE50)::open(buffer_size=10, sqlstm=insert into test_tab values(:f1<int>,:f2<char[31]>), connect=0043E590, implicit_select=0);
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator <<(int: ftype=4, placeholder=:f1, value=1);
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator <<(char*: ftype=1, placeholder=:f2, value="Name1");
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator <<(int: ftype=4, placeholder=:f1, value=2);
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator <<(char*: ftype=1, placeholder=:f2, value="Name2");
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator <<(int: ftype=4, placeholder=:f1, value=3);
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator <<(char*: ftype=1, placeholder=:f2, value="Name3");
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator <<(int: ftype=4, placeholder=:f1, value=4);
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator <<(char*: ftype=1, placeholder=:f2, value="Name4");
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator <<(int: ftype=4, placeholder=:f1, value=5);
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator <<(char*: ftype=1, placeholder=:f2, value="Name5");
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator <<(int: ftype=4, placeholder=:f1, value=6);
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator <<(char*: ftype=1, placeholder=:f2, value="Name6");
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator <<(int: ftype=4, placeholder=:f1, value=7);
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator <<(char*: ftype=1, placeholder=:f2, value="Name7");
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator <<(int: ftype=4, placeholder=:f1, value=8);
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator <<(char*: ftype=1, placeholder=:f2, value="Name8");
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator <<(int: ftype=4, placeholder=:f1, value=9);
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator <<(char*: ftype=1, placeholder=:f2, value="Name9");
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator <<(int: ftype=4, placeholder=:f1, value=10);
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator <<(char*: ftype=1, placeholder=:f2, value="Name10");
    MY OTL TRACE ==> otl_stream, executing SQL Stm=insert into test_tab values(?       ,?            ), current batch size=10, row offset=0
    MY OTL TRACE ==> otl_connect(this=0043E590)::commit();
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator <<(int: ftype=4, placeholder=:f1, value=11);
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator <<(char*: ftype=1, placeholder=:f2, value="Name11");
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator <<(int: ftype=4, placeholder=:f1, value=12);
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator <<(char*: ftype=1, placeholder=:f2, value="Name12");
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator <<(int: ftype=4, placeholder=:f1, value=13);
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator <<(char*: ftype=1, placeholder=:f2, value="Name13");
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator <<(int: ftype=4, placeholder=:f1, value=14);
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator <<(char*: ftype=1, placeholder=:f2, value="Name14");
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator <<(int: ftype=4, placeholder=:f1, value=15);
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator <<(char*: ftype=1, placeholder=:f2, value="Name15");
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator <<(int: ftype=4, placeholder=:f1, value=16);
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator <<(char*: ftype=1, placeholder=:f2, value="Name16");
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator <<(int: ftype=4, placeholder=:f1, value=17);
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator <<(char*: ftype=1, placeholder=:f2, value="Name17");
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator <<(int: ftype=4, placeholder=:f1, value=18);
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator <<(char*: ftype=1, placeholder=:f2, value="Name18");
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator <<(int: ftype=4, placeholder=:f1, value=19);
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator <<(char*: ftype=1, placeholder=:f2, value="Name19");
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator <<(int: ftype=4, placeholder=:f1, value=20);
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator <<(char*: ftype=1, placeholder=:f2, value="Name20");
    MY OTL TRACE ==> otl_stream, executing SQL Stm=insert into test_tab values(?       ,?            ), current batch size=10, row offset=0
    MY OTL TRACE ==> otl_connect(this=0043E590)::commit();
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator <<(int: ftype=4, placeholder=:f1, value=21);
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator <<(char*: ftype=1, placeholder=:f2, value="Name21");
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator <<(int: ftype=4, placeholder=:f1, value=22);
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator <<(char*: ftype=1, placeholder=:f2, value="Name22");
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator <<(int: ftype=4, placeholder=:f1, value=23);
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator <<(char*: ftype=1, placeholder=:f2, value="Name23");
    MY OTL TRACE ==> otl_stream(this=0012FE50)::close();
    MY OTL TRACE ==> otl_stream, executing SQL Stm=insert into test_tab values(?       ,?            ), current batch size=3, row offset=0
    MY OTL TRACE ==> otl_connect(this=0043E590)::commit();
    MY OTL TRACE ==> otl_stream(this=0012FE50)::open(buffer_size=5, sqlstm=select * from test_tab where f1>=:f<int> and f1<=:ff<int>*2, connect=0043E590, implicit_select=0);
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator <<(int: ftype=4, placeholder=:f, value=8);
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator <<(int: ftype=4, placeholder=:ff, value=8);
    MY OTL TRACE ==> otl_stream, executing SQL Stm=select * from test_tab where f1>=?       and f1<=?       *2, buffer size=5
    MY OTL TRACE ==> otl_stream, fetched the first batch of rows, SQL Stm=select * from test_tab where f1>=?       and f1<=?       *2, RPC=5
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator >>(float& : ftype=4, placeholder=, value=8);
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator >>(char* : ftype=1, placeholder=, value=Name8);
    f1=8, f2=Name8
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator >>(float& : ftype=4, placeholder=, value=9);
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator >>(char* : ftype=1, placeholder=, value=Name9);
    f1=9, f2=Name9
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator >>(float& : ftype=4, placeholder=, value=10);
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator >>(char* : ftype=1, placeholder=, value=Name10);
    f1=10, f2=Name10
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator >>(float& : ftype=4, placeholder=, value=11);
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator >>(char* : ftype=1, placeholder=, value=Name11);
    f1=11, f2=Name11
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator >>(float& : ftype=4, placeholder=, value=12);
    MY OTL TRACE ==> otl_stream, fetched the next batch of rows, SQL Stm=select * from test_tab where f1>=?       and f1<=?       *2, RPC=9
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator >>(char* : ftype=1, placeholder=, value=Name12);
    f1=12, f2=Name12
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator >>(float& : ftype=4, placeholder=, value=13);
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator >>(char* : ftype=1, placeholder=, value=Name13);
    f1=13, f2=Name13
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator >>(float& : ftype=4, placeholder=, value=14);
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator >>(char* : ftype=1, placeholder=, value=Name14);
    f1=14, f2=Name14
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator >>(float& : ftype=4, placeholder=, value=15);
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator >>(char* : ftype=1, placeholder=, value=Name15);
    f1=15, f2=Name15
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator >>(float& : ftype=4, placeholder=, value=16);
    MY OTL TRACE ==> otl_stream(this=0012FE50)::operator >>(char* : ftype=1, placeholder=, value=Name16);
    f1=16, f2=Name16
    MY OTL TRACE ==> otl_stream(this=0012FE50)::close();
    MY OTL TRACE ==> otl_connect(this=0043E590)::logoff();

Examples Contents Go Home

Copyright © 1996, 2007, Sergei Kuchin, email: skuchin@ispwest.com, skuchin@yahogmail
.

Permission to use, copy, modify and redistribute this document for any purpose is hereby granted without fee, provided that the above copyright notice appear in all copies.