Update DatabaseTransport example code to match correct usage

Since 2b255d9, DatabaseTransport now expects a PEP-249 compliant
connection object and no longer supports passing parameters used
to connect via ibm_db_dbi. Update the examples to reflect this.

Author: kadler

README.md

@@ -11,8 +11,10 @@ itoolkit is a Python interface to the [XMLSERVICE](https://bitbucket.org/inext/x
 ```python
 from itoolkit import *
 from itoolkit.transport import DatabaseTransport
+import ibm_db_dbi
 
-itransport = DatabaseTransport()
+conn = ibm_db_dbi.connect()
+itransport = DatabaseTransport(conn)
 itool = iToolKit()
 
 itool.add(iCmd5250('wrkactjob', 'WRKACTJOB'))
@@ -22,7 +24,7 @@ wrkactjob = itool.dict_out('wrkactjob')
 print(wrkactjob)
 ```
 
-For more, check out the [samples](samples/icmd_rtvjoba.py).
+For more, check out the [samples](samples).
 
 Feature Support
 ---------------

samples/config.py.sample

@@ -8,11 +8,18 @@ Transports:
   from itoolkit.transport import DirectTransport
   itransport = DirectTransport()
 
-  2) XMLSERVICE db2 call (QSQSRVR job)
+  2) XMLSERVICE db2 call
   from itoolkit.transport import DatabaseTransport
-  itransport = DatabaseTransport(config.user,config.password)
-  -- or --
-  conn = ibm_db.connect(database, user, password)
+
+  # Connect to any PEP-249 compliant driver which can call XMLSERVICE stored procedures
+  # eg. ibm_db_dbi
+  import ibm_db_dbi
+  conn = ibm_db_dbi.connect()
+
+  # eg. or PyODBC
+  import pyodbc
+  conn = pyodbc.connect('DSN=mydsn;UID=...')
+
   itransport = DatabaseTransport(conn)
 
   3) XMLSERVICE http/rest/web call (Apache job)

samples/ipgm_bad_trace_db2.py

@@ -1,7 +1,9 @@
 from itoolkit import *
 from itoolkit.transport import DatabaseTransport
+import ibm_db_dbi
 
-itransport = DatabaseTransport('adc') # export PASSWORD=mypass
+conn = ibm_db_dbi.connect()
+itransport = DatabaseTransport(conn)
 
 itool = iToolKit()
 itool.add(

src/itoolkit/README

@@ -77,9 +77,15 @@ Import:
   2) XMLSERVICE db2 call (QSQSRVR job) - local/remote
   from itoolkit import *
   from itoolkit.transport import DatabaseTransport
-  itransport = DatabaseTransport(user,password)
-  -- or -
-  conn = ibm_db.connect(database, user, password)
+  # Connect to any PEP-249 compliant driver which can call XMLSERVICE stored procedures
+  # eg. ibm_db_dbi
+  import ibm_db_dbi
+  conn = ibm_db_dbi.connect()
+
+  # eg. or PyODBC
+  import pyodbc
+  conn = pyodbc.connect('DSN=mydsn;UID=...')
+
   itransport = DatabaseTransport(conn)
   Note:
   XMLSERVICE library search order:

src/itoolkit/itoolkit.py

@@ -53,8 +53,6 @@ class iXml(iBase):          IBM i XMLSERVICE raw xml input
   2) XMLSERVICE db2 call (QSQSRVR job) - local/remote
   from itoolkit import *
   from itoolkit.transport import DatabaseTransport
-  itransport = DatabaseTransport()
-  -- or -
   conn = ibm_db_dbi.connect()
   itransport = DatabaseTransport(conn)