ibmi_db 2.5.14-powerpc-aix-6

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 49ab48851a53065c832421e2d84ca89dae70c6ad
+  data.tar.gz: 6ddb8ca2d1992640c543ecf258e64260387ecad2
+SHA512:
+  metadata.gz: c0f1171662983775eef57ce6094fa0dd691b705212134aaed03f07ccbe3731b70fbcaa33dba58b90a7d4292bc6c88c7bde3afa93795c70b7b24b8a5e337fd6fa
+  data.tar.gz: fa29197f8c0f13558e2cad80721f723c704b3c9eeeb233a89e301817fafbe8dc4ba598e65e559261c27e280e09a047f0f9f0004963e47701be38f130214bbb6f

data/CHANGES

@@ -0,0 +1,3 @@
+Change Log
+==============
+

data/LICENSE

@@ -0,0 +1,18 @@
+Copyright (c) 2006, 2007, 2008, 2009, 2010 IBM Corporation
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the "Software"),
+to deal in the Software without restriction, including without limitation
+the rights to use, copy, modify, merge, publish, distribute, sublicense, 
+and/or sell copies of the Software, and to permit persons to whom the Software
+is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included
+in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
+INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A 
+PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT 
+HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION 
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE 
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/MANIFEST

@@ -0,0 +1,24 @@
+CHANGES
+LICENSE
+MANIFEST
+README
+README_IBM_i
+ext/extconf.rb
+ext/ibm_db.c
+ext/ruby_ibm_db_cli.c
+ext/ruby_ibm_db_cli.h
+ext/ruby_ibm_db.h
+ext/ruby_sql_com.h
+ext/ruby_sql_luw.h
+ext/ruby_sql_pase.h
+lib/mswin32/ibm_db.so
+lib/mswin32/ibm_db.so
+lib/IBM_DB.rb
+lib/active_record/connection_adapters/ibm_db_adapter.rb
+lib/active_record/connection_adapters/ibmdb_adapter.rb
+lib/active_record/connection_adapters/ibm_db_password.rb
+lib/active_record/connection_adapters/ibm_db_pstmt.rb
+lib/active_record/vendor/db2-i5-zOS.yaml
+test/IBMi/Rakefile
+test/IBMi/README_IBM_i
+MANIFEST

data/README

@@ -0,0 +1 @@
+See READ_ME_i

data/README_IBM_i

@@ -0,0 +1,458 @@
+==================
+Introduction
+==================
+The following notes are for Ruby with IBM i.
+
+======================
+Environment variables:
+======================
+Compile time:
+ IBM_DB_HOME            - LUW compile IBM_DB_HOME=/home/db2inst2/sqllib (LUW DB2)
+ IBM_DB_UTF8            - LUW & IBM i compile with UTF-8 override (UTF8_ONLY)
+Run time:
+ IBM_DB_ON_ERROR=on     - ALL ignore missing attributes older drivers
+ IBM_DB_TRACE           - dump trace all CLI calls used
+  =on                   - dump trace to STDOUT
+  =/path/my.log         - dump trace to log
+ IBM_DB_TRACE_ERROR=on  - used with IBM_DB_TRACE, select only SQLGetDiagRec
+ IBM_DB_STOP            - ONLY if trace active, force exit on SQLGetDiag
+ IBM_DB_GIL             - map allow GIL/GVL release during operation
+                          (note IBM_DB_GIL may be removed)
+                        
+Env var for GIL/GVL map:
+                   00000000001111111111222222222233333333334444
+                   01234567890123456789012345678901234567890123
+                   ||||||||||||||||||||||||||||||||||||||||||||
+export IBM_DB_GIL="11111111111111111111111111111111111111111111"
+                   ||||||||||||||||||||||||||||||||||||||||||||
+                   |||||||||||||||||||||||||||||||||||||||||||SQLBindParameter
+                   ||||||||||||||||||||||||||||||||||||||||||SQLBindFileToParam
+                   ||||||||||||||||||||||||||||||||||||||||||SQLRowCount
+                   |||||||||||||||||||||||||||||||||||||||||SQLNumParams
+                   ||||||||||||||||||||||||||||||||||||||||SQLNumResultCols
+                   |||||||||||||||||||||||||||||||||||||||SQLFetch
+                   ||||||||||||||||||||||||||||||||||||||SQLFetchScroll
+                   |||||||||||||||||||||||||||||||||||||SQLNextResult
+                   ||||||||||||||||||||||||||||||||||||SQLGetSubString
+                   |||||||||||||||||||||||||||||||||||SQLGetLength
+                   ||||||||||||||||||||||||||||||||||SQLGetData
+                   |||||||||||||||||||||||||||||||||SQLPutData
+                   ||||||||||||||||||||||||||||||||SQLColAttributes
+                   |||||||||||||||||||||||||||||||SQLParamData
+                   ||||||||||||||||||||||||||||||SQLExecute
+                   |||||||||||||||||||||||||||||SQLFreeStmt
+                   ||||||||||||||||||||||||||||SQLGetEnvAttr
+                   |||||||||||||||||||||||||||SQLGetConnectAttr
+                   |||||||||||||||||||||||||SQLGetStmtAttr
+                   ||||||||||||||||||||||||SQLSetEnvAttr
+                   |||||||||||||||||||||||SQLSetConnectAttr
+                   ||||||||||||||||||||||SQLSetStmtAttr
+                   |||||||||||||||||||||SQLGetDiagRec
+                   ||||||||||||||||||||SQLGetInfo
+                   |||||||||||||||||||SQLPrepare
+                   ||||||||||||||||||SQLDropDB
+                   |||||||||||||||||SQLCreateDB
+                   ||||||||||||||||SQLExecDirect
+                   |||||||||||||||SQLTables
+                   ||||||||||||||SQLTablePrivileges
+                   |||||||||||||SQLStatistics
+                   ||||||||||||SQLSpecialColumns
+                   |||||||||||SQLProcedures
+                   ||||||||||SQLProcedureColumns
+                   |||||||||SQLForeignKeys
+                   ||||||||SQLPrimaryKeys
+                   |||||||SQLColumns
+                   ||||||SQLColumnPrivilege
+                   |||||SQLBindCol
+                   ||||SQLDescribeCol
+                   |||SQLDescribeParam
+                   ||SQLEndTran
+                   |SQLDisconnect
+                   SQLConnect
+
+
+==================
+Release minimums
+==================
+IBM i: V7R1   -- enable lib/file and schema.table syntax in system naming mode (*LIBL mode) 
+LUW:   V10.5  -- enables system naming mode and other attributes LUW -> IBM i (*LIBL, attr job, etc.)
+If you choose a lower release LUW, unsupported extended attributes will fail.
+However, you may be able to run partially using a new on-error env var.
+IBM_DB_ON_ERROR=yes
+
+==================
+Traditional open passwords
+==================
+database.yml 
+  db2profile: &db2profile
+    adapter: ibm_db
+    database: "*LOCAL"
+    username: DB2
+    password: MYPWD
+  development:
+    <<: *db2profile
+  test:
+    <<: *db2profile
+  production:
+    <<: *db2profile
+
+==================
+Encrypted passwords
+==================
+ibm_db APIS:
+1) generate site encryption key (key.yml)
+  pwd_key = ActiveRecord::Base.ibm_db_generate_key()
+   result:
+    pwd_key  - 32 character encryption key site key.yml
+               (one key all passwords, read by ibm_db runtime)
+   example:
+    puts ActiveRecord::Base.ibm_db_generate_key
+
+2) generate encrypted passord (password.yml)
+  pwd_enc = ActiveRecord::Base.ibm_db_generate_password(password,pwd_key)
+   parameters:
+    password - user password (clear text)
+    pwd_key  - 32 character encryption key
+   result:
+    pwd_enc  - encrypted password cut/paste password.yml
+   example:
+     puts ActiveRecord::Base.ibm_db_generate_password("MYPASS","YIPS4321AAAAAAAAAAAAAAA132424245")
+
+Example files:
+database.yml
+  db2profile: &db2profile
+    adapter: ibm_db
+    database: "*LOCAL"
+    username: DB2
+    pwd_yaml: /my/safe/path/password.yml
+  development:
+    <<: *db2profile
+  test:
+    <<: *db2profile
+  production:
+    <<: *db2profile
+
+/my/safe/path/password.yml (userid:, pwd_enc:)
+  key_yaml: /my/really/safe/path/key.yml
+  DB2:
+    pwd_enc: "alkqap/Ao7ACWwizSQ2JvZ86+s0yR5FdDmIU68JuQv4=%0A"
+  FLINROCK:
+    pwd_enc: "alkqap/Ao7ACWwizSQ2Jvrdt+s0yR5FdDmIU68JuQv4=%0A"
+  SLATER:
+    pwd_enc: "alkqap/Ao7A123izSQ2Jvrdt+s0yR5FdDmIU68JuQv4=%0A"
+
+/my/really/safe/path/key.yml (pwd_key:)
+  pwd_key: "YIPS4321AAAAAAAAAAAAAAA132424245"
+
+=================
+ibm_db IBM i tests (IBM i or LUW -> IBM i)
+=================
+cd test/IBMi/tests (see README_IBM_I)
+> rake
+Note: 
+DB2 authorization test/IBMi/tests/config.yml,
+update with your DB2 profile for testing.
+
+=================
+ibm_db IBM i samples (IBM i or LUW -> IBM i)
+=================
+cd test/IBMi/samples (see README_IBM_I)
+Note: 
+DB2 authorization test/IBMi/samples/config.yml,
+update with your DB2 profile.
+
+==================
+Use attribute IBMi_
+-> IBM i (1-tier)
+-> LUW->IBM i (2-tier) 
+==================
+IBM_DB::SQL_IBMi_FMT_ISO (not platform unique IBM_DB::SQL_FMT_ISO)
+IBM_DB::SQL_IBMi_FMT_USA (not platform unique IBM_DB::SQL_FMT_USA)
+IBM_DB::SQL_IBMi_FMT_EUR (not platform unique IBM_DB::SQL_FMT_EUR)
+IBM_DB::SQL_IBMi_FMT_JIS (not platform unique IBM_DB::SQL_FMT_JIS)
+IBM_DB::SQL_IBMi_FMT_MDY (not platform unique IBM_DB::SQL_FMT_DMY)
+IBM_DB::SQL_IBMi_FMT_DMY (not platform unique IBM_DB::SQL_FMT_MDY)
+IBM_DB::SQL_IBMi_FMT_YMD (not platform unique IBM_DB::SQL_FMT_YMD)
+IBM_DB::SQL_IBMi_FMT_JUL (not platform unique IBM_DB::SQL_FMT_JUL)
+IBM_DB::SQL_IBMi_FMT_JOB (not platform unique IBM_DB::SQL_FMT_JOB)
+IBM_DB::SQL_IBMi_FMT_HMS (not platform unique IBM_DB::SQL_FMT_HMS)
+
+==================
+Rubtime CLI debug help
+==================
+If you wish to see all the CLI calls, set the
+following env var before running your script
+IBM_DB_TRACE=on  (STDOUT)
+-- or --
+IBM_DB_TRACE=/path/my.log
+
+
+==================
+compile IBM i PASE
+==================
+0) Most use gcc compiler (download http://www.youngiprofessionals.com/wiki/index.php/PASE/GCC ) 
+1) Copy SQ headers
+zzcopyincludes_ibm_i.sh:
+#!/QOpenSys/usr/bin/ksh
+ls /QIBM/include/sql* > ./list2
+for i in $(< ./list2)
+do
+  echo "PREPARATION COPY"
+  system -v "CPY OBJ('$i') TODIR('/usr/include/') TOCCSID(*STDASCII) DTAFMT(*TEXT) REPLACE(*YES)"                                      
+done 
+2) Create sqlcli1.h to match LUW compiles
+/usr/include/sqlcli1.h 
+#ifndef SQL_H_SQLCLI1
+#include "sqlcli.h";
+#endif
+3) gem install ./ibm_db-n.n.n.gem
+
+==================
+2-tier compile consistent with IBM i PASE on LUW (optional)
+==================
+For a consistent utf-8 environment LUW<>IBM i, please set following env var ...
+export IBM_DB_UTF8=yes
+gem install ./ibm_db-n.n.n.gem
+- Forces LUW compile to use traditional CLI APIs with utf-8, 
+  bypassing utf-16 wide CLI APIs (matching PASE utf-8).
+- utf-8 provides a consistent IBM i business model ruby script
+  edit, run, debug and deploy using combination of 1-tier and 2-tier 
+
+
+==================
+LUW operational help 
+==================
+export PATH=/opt/ibm/db2/V10.5/bin:$PATH
+export IBM_DB_HOME=/home/db2inst1/sqllib
+
+$ sudo cp /opt/IBM/db2/V10.5/cfg/db2cli.ini.sample /home/db2inst1/sqllib/cfg/db2cli.ini
+$ sudo chmod +w /home/db2inst1/sqllib/cfg/db2cli.ini
+$ sudo e /home/db2inst1/sqllib/cfg/db2cli.ini &
+; Comment lines start with a semi-colon.
+; Database name can be found WRKRDBDIRE
+[LP0364D]
+Database=LP0364D
+Protocol=tcpip
+Hostname=lp0364d.rch.stglabs.ibm.com
+Servicename=446
+SchemaList=”*USRLIBL”
+
+================
+Ruby threads with DB2
+================
+PASE ibm_db automatically enters server mode for thread saftey, which
+simply means attach a pooled QSQSRVR job to each thread connection.
+-> ruby-thread-1 IBM::connect('*LOCAL','FRED','PWD') -> QSQSRVR-job-1
+-> ruby-thread-2 IBM::connect('*LOCAL','TONY','PWD') -> QSQSRVR-job-2
+-> ... and so on ...
+Golden Rule:
+Do NOT share a connection across ruby threads. 
+
+==================
+ext - ibm_db.so internal notes
+==================
+PASE changes tested are UNICODE_SUPPORT_VERSION ...
+  YES - ruby 2.0 path UNICODE_SUPPORT_VERSION (default)
+  YES - ruby 1.9 path UNICODE_SUPPORT_VERSION (default)
+  NO  - ruby 1.8 no IBM i team effort made (1.8 retired by ruby)
+
+PASE chooses not support CLI wide interfaces (UTF-16) ...
+- PASE is using UTF8_OVERRIDE and SQLOverrideCCSID400 with CCSID 1208. 
+  UTF-8 (1208) is asserted "good enough" for
+  world wide business, fitting PASE tooling.
+- PASE overrides various ibm_db _to_utf16 to implement UTF-8 (name remains utf16)
+- UTF8_OVERRIDE redefines all CLI wide APIs (see below),
+  because wide interfaces are not required UTF-8 ...
+    undef SQLWCHAR
+    define SQLWCHAR SQLCHAR
+    undef SQL_C_WCHAR
+    define SQL_C_WCHAR SQL_C_CHAR
+
+SQLOverrideCCSID400 using 1208 ...
+- CCSID 1208 will allow libdb400.a to simply pass
+  UTF-8 data directly "untouched" to DB2 (ILE code).
+- ANY other CCSID setting will result in iconv conversion
+  (not very good conversion for literals SQL statements)
+- libdb400.a 1208 forces ...
+  paseCCSID = 1208;
+  UTF8Value = SQL_TRUE;
+  SQLSetEnvAttr(*ohnd,SQL_ATTR_PASE_CCSID,(SQLPOINTER)&paseCCSID,sizeof(paseCCSID));
+  SQLSetEnvAttr(*ohenv,SQL_ATTR_UTF8,(SQLPOINTER)&UTF8Value,sizeof(UTF8Value));
+
+PASE code allows both sql/system naming ...
+- sql naming is schema.table (default) 
+  IBM_DB::SQL_ATTR_DBC_SYS_NAMING=>IBM_DB::SQL_NAMING_OFF
+    LIBL/CURLIB will be ignored unqualified resolves, instead
+    a single library will be used (match connect userid),
+    but may be specified using 
+    IBM_DB::SQL_ATTR_DBC_DEFAULT_LIB=>"MYLIB"
+- system naming is lib/file.mbr
+  IBM_DB::SQL_ATTR_DBC_SYS_NAMING=>IBM_DB::SQL_NAMING_ON
+    allows for LIBL/CURLIB style unqualified resolves,
+    LIBL/CURLIB may be specified using ...
+    1) LIBL   - IBM_DB::SQL_ATTR_DBC_LIBL=>"DB2 QTEMP QGPL"
+    2) CURLIB - IBM_DB::SQL_ATTR_DBC_CURLIB=>"DB2"
+  V7 system naming supports BOTH ...
+    1) system naming syntax (lib/file.mbr)
+    2) sql naming syntax (schema.table)
+    BUT does NOT work prior V7 without V6 PTFs,
+    and completely forbidden V5 below (move off V5R4)
+
+PASE added many IBM i attribute settings (below),
+also work with LUW DB2 Connect 10.5 enhancements.
+
+== mandatory parameters 
+:adapter           'ibm_db'                           - DB2 driver
+:database          '*LOCAL', 'LP0364D', ...           - IBM i see WRKRDBDIRE 
+:username          'FRED', 'BOB', ...                 - profile name
+:password          'MYPASS', 'SHHHME', ...            - profile password
+== remote TCP/IP connection when no local database (unused on IBM i)
+:host              'socrates','9.5.158.88', ...       - fully qualified hostname or IP address
+:port              '446','448', ...                   - data server TCP/IP port number
+:security          'SSL'                              - optional parameter enabling SSL encryption
+:authentication    'SERVER'                           - AUTHENTICATION type which the client uses
+:timeout           0 - 32767                          - time in seconds wait reply server
+== optional (highly recommended for data server auditing and monitoring purposes)
+:schema            "SET SCHEMA #{schema}"             - schema.table ('rails123')
+:app_user          IBM_DB::SQL_ATTR_INFO_USERID       - connection's user info ('test11')
+:account           IBM_DB::SQL_ATTR_INFO_ACCTSTR      - connection's account info ('tester')
+:application       IBM_DB::SQL_ATTR_INFO_APPLNAME     - connection's application info ('rtests')
+:workstation       IBM_DB::SQL_ATTR_INFO_WRKSTNNAME   - connection's workstation info ('plato')
+== Parameterized Queries Support
+:parameterized     prepared statement support of IBM_DB Adapter on/off
+== IBM i connection attributes
+:ibm_i_naming      IBM_DB::SQL_ATTR_DBC_SYS_NAMING    - connection's i5 naming mode 
+ =>"system"        =>IBM_DB::SQL_SYSTEM_NAMING_ON     - lib/file.mbr - system naming
+ =>"sql"           =>IBM_DB::SQL_SYSTEM_NAMING_OFF    - schema.table - sql naming (default)
+:ibm_i_libl        IBM_DB::SQL_ATTR_DBC_LIBL          - connection's i5 *LIBL (system naming)
+:ibm_i_curlib      IBM_DB::SQL_ATTR_DBC_CURLIB        - connection's i5 CURLIB (system naming)
+:ibm_i_lib         IBM_DB::SQL_ATTR_DBC_DEFAULT_LIB   - connection's i5 default lib (sql naming) 
+:ibm_i_sort_seq    IBM_DB::SQL_ATTR_CONN_SORT_SEQUENCE- connection's i5 sort sequence
+ =>"job"           =>IBM_DB::SQL_JOB_SORT_ON          - job attribute sort order
+ =>"system"        =>IBM_DB::SQL_JOB_SORT_OFF         - system attribute sort (hex)
+:ibm_i_isolation   IBM_DB::SQL_ATTR_TXN_ISOLATION     - connection's i5 isolation level
+ =>"none"          =>IBM_DB::SQL_TXN_NO_COMMIT        - isolation none
+                   =>IBM_DB::SQL_COMMIT_NONE            - alias NO_COMMIT
+                   =>IBM_DB::SQL_TXN_NOCOMMIT           - alias NO_COMMIT
+ =>"ur"            =>IBM_DB::SQL_TXN_READ_UNCOMMITTED - isolation read uncommitted
+                   =>IBM_DB::SQL_COMMIT_CHG             - alias READ_UNCOMMITTED
+                   =>IBM_DB::SQL_COMMIT_UR              - alias READ_UNCOMMITTED
+ =>"cs"            =>IBM_DB::SQL_TXN_READ_COMMITTED   - isolation read committed
+                   =>IBM_DB::SQL_COMMIT_CS              - alias READ_COMMITTED
+ =>"rs"            =>IBM_DB::SQL_TXN_REPEATABLE_READ  - isolation repeatable read
+                   =>IBM_DB::SQL_COMMIT_ALL               - alias REPEATABLE_READ
+                   =>IBM_DB::SQL_COMMIT_RS                - alias REPEATABLE_READ
+ =>"rr"            =>IBM_DB::SQL_TXN_SERIALIZABLE     - isolation serializable
+                   =>IBM_DB::SQL_COMMIT_RR                - alias SERIALIZABLE
+:ibm_i_date_fmt    IBM_DB::SQL_ATTR_DATE_FMT          - connection's i5 date format
+ =>"iso"           =>IBM_DB::SQL_FMT_ISO
+ =>"usa"           =>IBM_DB::SQL_FMT_USA
+ =>"eur"           =>IBM_DB::SQL_FMT_EUR
+ =>"jis"           =>IBM_DB::SQL_FMT_JIS
+ =>"dmy"           =>IBM_DB::SQL_FMT_DMY
+ =>"mdy"           =>IBM_DB::SQL_FMT_MDY
+ =>"ymd"           =>IBM_DB::SQL_FMT_YMD
+ =>"jul"           =>IBM_DB::SQL_FMT_JUL
+ =>"job"           =>IBM_DB::SQL_FMT_JOB
+:ibm_i_time_fmt    IBM_DB::SQL_ATTR_TIME_FMT          - connection's i5 time format
+ =>"iso"           =>IBM_DB::SQL_FMT_ISO
+ =>"usa"           =>IBM_DB::SQL_FMT_USA
+ =>"eur"           =>IBM_DB::SQL_FMT_EUR
+ =>"jis"           =>IBM_DB::SQL_FMT_JIS
+ =>"hms"           =>IBM_DB::SQL_FMT_HMS
+:ibm_i_date_sep    IBM_DB::SQL_ATTR_DATE_FMT          - connection's i5 date seperator
+ =>"slash"         =>IBM_DB::SQL_SEP_SLASH
+ =>"dash"          =>IBM_DB::SQL_SEP_DASH
+ =>"period"        =>IBM_DB::SQL_SEP_PERIOD
+ =>"comma"         =>IBM_DB::SQL_SEP_COMMA
+ =>"blank"         =>IBM_DB::SQL_SEP_BLANK
+ =>"job"           =>IBM_DB::SQL_SEP_JOB
+:ibm_i_time_sep    IBM_DB::SQL_ATTR_TIME_FMT          - connection's i5 time seperator
+ =>"colon"         =>IBM_DB::SQL_SEP_COLON
+ =>"period"        =>IBM_DB::SQL_SEP_PERIOD
+ =>"comma"         =>IBM_DB::SQL_SEP_COMMA
+ =>"blank"         =>IBM_DB::SQL_SEP_BLANK
+ =>"job"           =>IBM_DB::SQL_SEP_JOB
+:ibm_i_decimal_sep IBM_DB::SQL_ATTR_DECIMAL_SEP       - connection's i5 decimal seperator
+ =>"period"        =>IBM_DB::SQL_SEP_PERIOD
+ =>"comma"         =>IBM_DB::SQL_SEP_COMMA
+ =>"job"           =>IBM_DB::SQL_SEP_JOB
+:ibm_i_query_goal  IBM_DB::SQL_ATTR_QUERY_OPTIMIZE_GOAL- connection's i5 query optimize goal
+ "first"           =>IBM_DB::SQL_FIRST_IO              - queries optimized goal first page
+ "all"             =>IBM_DB::SQL_ALL_IO                - queries optimized goal entire query (default)
+:ibm_i_dump_savf                                       - task_structure_dump perform SAVLIB
+ true
+ false
+
+== for testing ... YAML.load
+ActiveRecord::Base.establish_connection(
+:adapter => "ibm_db",
+:yaml  => "path/auth.yaml",
+:level => "development"
+)
+path/auth.yaml:
+development:
+  adapter: ibm_db
+  database: LP0364D
+  username: DB2
+  password: NICEPASS
+  ibm_i_naming: system
+  ibm_i_libl: FRED QTEMP
+  ibm_i_curlib: FRED
+production:
+  adapter: ibm_db
+  database: LP0364D
+  username: DB2
+  password: NICEPASS
+  ibm_i_naming: system
+  ibm_i_libl: BOB QTEMP
+  ibm_i_curlib: BOB
+
+
+PASE is using server mode SQL_ATTR_SERVER_MODE (QSQSRVR jobs) for thread saftey ...
+
+ IBM_DB::connect:
+  browser/client -->Apache_thread1->socket->
+  ->ruby_app1_thread1-->QSQSRVR(profile DB2)   ... connection #0
+    ruby_app1_thread2-->QSQSRVR(profile DB2)   ... connection #1
+    ruby_app1_thread3-->QSQSRVR(profile SALLY) ... connection #2
+    ruby_app1_thread4-->QSQSRVR(profile BOB)   ... connection #3
+    ruby_app1_thread5-->QSQSRVR(profile DB2)   ... connection #4
+
+  - PASE libdb400.a does NOT enforce thread safety DB2 CLI APIs (simply a call through to ILE DB2)
+  - ibm_db c-code is hard coded to always use "server mode" surrogate QSQSRVR jobs (SQL_ATTR_SERVER_MODE)
+  - ibm_db full open/close connection aquires a QSQSRVR job each connection (slow connection)
+  - ibm_db will close implicitly on script end (close returns QSQSRVR to pre-start pool)
+  - ibm_db allows many connections per profile/per thread (each connection aquires it's own QSQSSRVR job)
+  - connection/QSQ job limiting is at the script level (ConnectionPool.rb)
+  - QTEMP for DB2 actions is found in the QSQSRVR job (not ruby job)
+  - QPRTJOB added for spool out QSQSRVR jobs due to use profile not owning profile (see QSPRILSP to understand)
+  - do NOT share a single connection across ruby threads
+  - allows for consistent/safe independent transactions IBM_DB::commit(@@conn)
+    which is CLI API SqlEndTran(SQL_HANDLE_DBC , conn, COMMIT, ROLLBACK, etc)
+  - allows other non-thread safe statement level work to be scoped to the connection
+    because it is all running anchored to the surrogate QSQSRVR job (no worries)
+
+ IBM_DB::pconnect:
+  browser/client -->Apache_thread1->socket->
+  ->ruby_app1_thread1-->QSQSRVR(profile DB2) ..........> "shared" connection #0 (1-only-1 limited by ibm_db hKey)
+    ruby_app1_thread2-| ConnectionPool.rb waiting for DB2 to finish transaction ... ZZZZZ
+    ruby_app1_thread3-| ConnectionPool.rb waiting for DB2 to finish transaction ... ZZZZZ
+    ruby_app1_thread4-->QSQSRVR(profile SALLY) ........> "shared" connection #1 (1-only-1 limited by ibm_db hKey)
+    ruby_app1_thread5-| ConnectionPool.rb waiting for SALLY to finish transaction ... ZZZZZ
+
+  - PASE libdb400.a does NOT enforce thread safety DB2 CLI APIs (simply a call through to ILE DB2)
+  - ibm_db c-code is hard coded to always use "server mode" surrogate QSQSRVR jobs (SQL_ATTR_SERVER_MODE)
+  - ibm_db persistent/shared/pooled connection aquires a QSQSRVR job only ONCE (1st use)
+  - ibm_db will NEVER close implicitly on script end (QSQSRVR "alive" forever)
+  - ibm_db allows ONE SHARED connection per profile (hash userid+password+"__ibm_db_")
+  - Control of single connection/QSQ job limiting is at the script level (ConnectionPool.rb)
+  - QTEMP for DB2 actions is found in the QSQSRVR job (not ruby job)
+  - QPRTJOB added for spool out QSQSRVR jobs due to use profile not owning profile (see QSPRILSP to understand)
+  - do NOT share a single connection across ruby threads
+  - This design choice suited DB2 LUW (Linux/Unix/Windows), and basically removed customers from
+    understanding the hash key used to achieve ibm_db persistent/pooled connections, in short,
+    user just changed connect(*LOCAL,user,pwd) to pconnect(*LOCAL,user,pwd) and all ran
+    up to 40% faster.
+
+