***********************************************************************
      ** (c) Copyright IBM Corp. 2007 All rights reserved.
      ** 
      ** The following sample of source code ("Sample") is owned by International 
      ** Business Machines Corporation or one of its subsidiaries ("IBM") and is 
      ** copyrighted and licensed, not sold. You may use, copy, modify, and 
      ** distribute the Sample in any form without payment to IBM, for the purpose of 
      ** assisting you in the development of your applications.
      ** 
      ** The Sample code is provided to you on an "AS IS" basis, without warranty of 
      ** any kind. IBM HEREBY EXPRESSLY DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR 
      ** IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF 
      ** MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. Some jurisdictions do 
      ** not allow for the exclusion or limitation of implied warranties, so the above 
      ** limitations or exclusions may not apply to you. IBM shall not be liable for 
      ** any damages you suffer as a result of using, copying, modifying or 
      ** distributing the Sample, even if IBM has been advised of the possibility of 
      ** such damages.
      ***********************************************************************
      **
      ** SOURCE FILE NAME: tabscont.sqb 
      **
      ** SAMPLE: How to get tablespace container information
      **
      **         This program shows how to 
      **         - obtain tablespace container information using
      **           lower level service APIs (OPEN, FETCH, CLOSE)
      **         - obtain tablespace container information using
      **           higher level APIs (TABLESPACE CONTAINER QUERY)
      **
      ** DB2 APIs USED:
      **         sqlgtcq -- TABLESPACE CONTAINER QUERY
      **         sqlgotcq -- OPEN TABLESPACE CONTAINER QUERY
      **         sqlgftcq -- FETCH TABLESPACE CONTAINER QUERY
      **         sqlgctcq -- CLOSE TABLESPACE CONATINER QUERY
      **         sqlgfmem -- FREE MEMORY
      **         sqlgdref -- DEREFERENCE ADDRESS
      **
      ** SQL STATEMENTS USED:
      **         BEGIN DECLARE SECTION 
      **         END DECLARE SECTION 
      **         CONNECT
      **
      **                           
      ***********************************************************************
      **
      ** For more information on the sample programs, see the README file. 
      **
      ** For information on developing embedded SQL applications see the Developing Embedded SQL Applications book.
      **
      ** For information on DB2 APIs, see the Administrative API Reference.
      **
      ** For information on using SQL statements, see the SQL Reference. 
      **
      ** For the latest information on programming, compiling, and running
      ** DB2 applications, visit the DB2 Information Center: 
      **     http://publib.boulder.ibm.com/infocenter/db2luw/v9r7/index.jsp
      ***********************************************************************

       Identification Division.
       Program-ID. "tabscont".

       Data Division.
       Working-Storage Section.

           copy "sqlutil.cbl".
           copy "sql.cbl".
           copy "sqlca.cbl".
           copy "sqlutbcq.cbl".

           EXEC SQL BEGIN DECLARE SECTION END-EXEC.
       01 dbname            pic x(8).
       01 userid            pic x(8).
       01 passwd.
         49 passwd-length   pic s9(4) comp-5 value 0.
         49 passwd-name     pic x(18).
           EXEC SQL END DECLARE SECTION END-EXEC.

      * Local Variables
       77 rc            pic s9(9) comp-5.
       77 idx           pic s9(9) comp-5.
       77 errloc        pic x(80).

      * Variables for OPEN TABLESPACE CONTAINER QUERY API
       77 tsc-id        pic s9(9) comp-5.
       77 num-tsc       pic s9(9) comp-5.

      * Variables for FETCH TABLESPACE CONTAINER API
       77 tsc-count     pic s9(9) comp-5.
       77 max-tsc       pic s9(9) comp-5.

      * Variables for TABLESPACE CONTAINER QUERY API
       77 tcq-ptr       pic s9(9) comp-5.
       77 tcq-ptr-save  pic s9(9) comp-5.

       Procedure Division.
       Main Section.
           display "Sample COBOL program: TABSCONT.SQB".

      * Get database connection information.
           display "Enter in the database name : " with no advancing.
           accept dbname.

           display "Enter your user id (default none): " 
                with no advancing.
           accept userid.

           if userid = spaces
             EXEC SQL CONNECT TO sample END-EXEC
           else
             display "Enter your password : " with no advancing
             accept passwd-name.

      * Passwords in a CONNECT statement must be entered in a VARCHAR
      * format with the length of the input string.
           inspect passwd-name tallying passwd-length for characters
              before initial " ".

           EXEC SQL CONNECT TO :dbname USER :userid USING :passwd
               END-EXEC.
           move "CONNECT TO" to errloc.
           call "checkerr" using SQLCA errloc.

           display " ".
           display "Using the following APIs:".
           display "   OPEN TABLESPACE CONTAINER QUERY".
           display "   FETCH TABLESPACE CONTAINER QUERY".
           display "   CLOSE TABLESPACE CONTAINER QUERY".
           display "=========================".

      ***********************************
      * OPEN TABLESPACE CONTAINER QUERY *
      ***********************************

           move SQLB-ALL-TABLESPACES to tsc-id.

           call "sqlgotcq" using
                                 by reference   sqlca
                                 by value       tsc-id
                                 by reference   num-tsc
                           returning rc.

           move "OPEN TABLESPACE CONTAINER QUERY" to errloc.
           call "checkerr" using SQLCA errloc.

           display "the number of tablespace containers " num-tsc.

           move 1 to max-tsc.
           move num-tsc to tsc-count.
           move 0 to idx.

           perform Fetch-Loop thru End-Fetch-Loop
              until idx equal tsc-count.

      ************************************
      * CLOSE TABLESPACE CONTAINER QUERY *
      ************************************
           call "sqlgctcq" using
                                 by reference   sqlca
                           returning rc.
           move "CLOSE TABLESPACE CONTAINER QUERY" to errloc.
           call "checkerr" using SQLCA errloc.

      ******************************
      * TABLESPACE CONTAINER QUERY *
      ******************************
           display " ".
           display "Using the following API:".
           display "   TABLESPACE CONTAINER QUERY".
           display "=========================".
           call "sqlgtcq" using
                                by reference    sqlca
                                by value        tsc-id
                                by reference    num-tsc
                                by reference    tcq-ptr
                          returning rc.
           move "TABLESPACE CONTAINER QUERY" to errloc.
           call "checkerr" using SQLCA errloc.

           move num-tsc to tsc-count.
           move 0 to idx.
           move tcq-ptr to tcq-ptr-save.

           perform TCQ-Print-Loop 
              until idx equal tsc-count.

           call "sqlgfmem" using
                                 by reference    sqlca
                                 by value        tcq-ptr-save
                          returning rc.
           move "FREE TABLESPACE CONTAINER QUERY INFO" to errloc.
           call "checkerr" using SQLCA errloc.

           EXEC SQL CONNECT RESET END-EXEC.
           move "CONNECT RESET" to errloc.
           call "checkerr" using SQLCA errloc.

       End-Main. stop run.

      *****************************************
      * Print TABLESPACE CONTAINER QUERY Info *
      *****************************************
       Print-Container-Info Section.
           display "Tablespace    = " sql-tbs-id of SQLB-TBSCONTQRY-DATA.
           display "Container ID  = " sql-id of SQLB-TBSCONTQRY-DATA.
           display "Name          = " 
             sql-name of SQLB-TBSCONTQRY-DATA
               (1:sql-name-len of SQLB-TBSCONTQRY-DATA).
           if sql-cont-type equal sqlb-cont-path then
             display "Type          = path"
           else if sql-cont-type equal sqlb-cont-disk then
             display "Type          = raw"
           else if sql-cont-type equal sqlb-cont-file then
             display "Type          = file".

       TCQ-Print-Loop Section.
      ******************************************
      * Get TABLESPACE CONTAINER QUERY Results *
      ******************************************
           call "sqlgdref" using
                                 by value     SQLB-TBSCONTQRY-DATA-SIZE
                                 by reference SQLB-TBSCONTQRY-DATA
                                 by reference tcq-ptr.

           perform Print-Container-Info.
           add 1 to idx.
           add SQLB-TBSCONTQRY-DATA-SIZE to tcq-ptr.

       Fetch-Loop Section.

      ************************************
      * FETCH TABLESPACE CONTAINER QUERY *
      ************************************
           call "sqlgftcq" using
                                 by reference   sqlca
                                 by value       max-tsc
                                 by reference   SQLB-TBSCONTQRY-DATA
                                 by reference   num-tsc
                           returning rc.
           move "FETCH TABLESPACE CONTAINER QUERY" to errloc.
           call "checkerr" using SQLCA errloc.
           perform Print-Container-Info.
           add 1 to idx.
       End-Fetch-Loop.