/******************************************************************************************
*         Licensed Materials - Property of GBase
*
*
*         "Restricted Materials of GBase"
*
*
*
*         GBase 8s GCI Interface demo
*
*
*         (C) Copyright GBase Corporation 2015 All rights reserved.
*
*   TItle:          readme
*
*   Description:    readme file describing the GBase 8s GCI interface demo
*                   programs and containing instructions on setting up and 
*                   running the demos
***************************************************************************************/

The GBase 8s GCI interface demo programs
________________________________________

This release of the GCI interface program contains a number of 
GCI demo programs.
These demo programs are located in -
     %GCICLIENTDIR%/demo

The following files are included - 

(I) Files for creating the sample database (2 files)
_____________________________________________________

1.test_dbcreate.h
2.test_dbcreate.c
  --Creates and populates the demo database - 'gci_demodb'.
    In the demo database three tables are also created and
    initialized. The tables are 'customer', 'item' and 
    'orders'.

    This example must be run before running any of the 
    other examples.

(II) General GCI examples (12 files)
____________________________________
1.test_connect.c
  --The demo is used to connect the database by
    GCILogon interface or GCIServerAttach interface. 

2.test_rcselect.c
  --The demo is used to retrieve results from the database
    and display it. This example also illustrates the fact
    that the same client functions can use row and column
    store buffer.

3.test_iudssql.c
  --The demo is used to test insert, update and delete 
    functions by GCIBind** and GCIDefine** interface.

4.test_iudssql.c
 --The demo achieve the same function as test_iudssql.c
   but use the dci interface.

5.test_trans.c
  --The demo is used to show how to use the transaction
    interface.

6.test_multithread.c
 --The demo is used to show how the interface works in
   multithread environment.

7.test_dirpath.c
 --The demo is used to show how to use the dirpath related
   functions.

8.test_lobselect.c
 --The demo is used to show how to use the lob related 
   funcions.

9.test_lobwrite.c
 --the demo is used to show how to use the lob write

10.test_lobproc.c
 --the demo is used to show how to use the proc object descriptor 
 

(III) Miscellaneous files (11 files)
___________________________________
1.README
  --this file containing an expanation of what each demo
    does and how to set up & run demos

2.CMakeLists.txt
  --to compile the demo programs and create the executalbles

3.item_1.txt
4.item_2.txt
5.item_3.txt
6.item_4.txt
7.item_1
8.item_2
9.item_3
10.item_4
  --files containing CLOB and BLOB data 

7.clean.sh
  --to clean up the medium files created during compiling the
    demo programs.

Setting up and running the demos
________________________________

1.Using the CMakeLists.txt
__________________________

   You can use the CmakeLists.txt to compile the demo program
   individually or compile them all at one time. To compile 
   only a single demo, you should use the '#' to comment the 
   other demos.

   To compile the demos, you should locate the path to 'demo',
   then use the following command at the command prompt-
      ./build_linux64_xxxx_xxxx.sh
      make

   build_linux64_xxxx_xxxx.sh could be one of list:
      build_linux64_debug_shared.sh   -- build shared lib with debug info
      build_linux64_debug_static.sh   -- build static lib with debug info
      build_linux64_release_shared.sh -- build shared lib without debug info
      build_linux64_release_static.sh -- build static lib without debug info

   To successfully run the command, the include directories and link
   directories must be set to the directories where the target file
   (path) is installed.(Normally the default value would be OK)


2.Run the demos
_______________


   To run the demo programs, user should set the environment variables first 
   by using the following command at the command prompt-
      source ../etc/client.ksh    
  

