home *** CD-ROM | disk | FTP | other *** search
/ PC Professionell 2004 December / PCpro_2004_12.ISO / files / webserver / xampp / xampp-perl-addon-1.4.9-installer.exe / Changes.pm < prev    next >
Encoding:
Perl POD Document  |  2004-02-21  |  30.5 KB  |  742 lines

  1. =head1 NAME
  2.  
  3. DBD::ODBC::Changes - Log of significant changes to the DBD::ODBC
  4.  
  5. =cut
  6.  
  7. =head1 Todo
  8.  
  9.  I'll be building this list shortly.
  10.  ++ done ++ Make ODBC version 3.0 default!
  11.  ++ done ++ Document more of the DBD::ODBC private attributes/functions.
  12.  Add array parameter binding (per new DBI Spec)
  13.  Add row caching/multiple row fetches to speed selects
  14.  Better/more tests on multiple statement handles which ensure the correct number of rows
  15.  Better/more tests on all queries which ensure the correct number of rows and data
  16.  Better tests on SQLExecDirect/do
  17.  ++ done ++ Change default behaviour to use SQLDescribeParam instead of SQL_VARCHAR.
  18.  
  19.  Keep checking Oracle's ODBC drivers for Windows to fix the Date binding problem
  20.  
  21. =head1 CHANGES
  22.  
  23. =item Changes in DBD::ODBC 1.07 February 19, 2003
  24.  
  25.  Added to Subversion version control hosted by perl.org.  Thanks Robert!  See ODBC.pm POD for more information.
  26.  Added contributing section to ODBC.pm POD -- see more details there!
  27.  Added parameter to odbc_errhandler for the NativeError -- thanks to Martin Busek.
  28.  Fix for Makefile.PL not having tab in front of $(NOOP) (Finally).
  29.  Fix for SQLForeignKeys thanks to Kevin Shepherd.
  30.  
  31. =item Changes in DBD::ODBC 1.06 June 19, 2003
  32.  
  33.  Fixed test in t/02simple.t to skip if the DSN defined by the user has DSN= in it.
  34.  Added tests for wrong DSN, ensuring the DBI::errstr is appropriately set.
  35.  Fixed small issue in Makefile.PL for Unix systems thanks to H.Merijn Brand.
  36.  Update to NOT copy user id and password to connect string if UID or PWD parameter in connect string.
  37.  Updated Makefile.PL for dmake, per patch by Steffen Goldner.  Thanks Steffen!
  38.  
  39. =item Changes in DBD::ODBC 1.05 March 14, 2003
  40.  
  41.  Cleaned up Makefile.PL and added Informix support thanks to Jonathan Leffler (see README.informix)
  42.  Added nicer error message when attempting to do anything while the database is disconnected. 
  43.  Fixed fetchrow_hashref('NAME_uc | NAME_lc') with odbc_more_results.
  44.  Added exporter to allow perl -MDBD::ODBC=9999 command line to determine version
  45.  Fixed for building with DBI 1.33 and greater
  46.  Removed all C++ style comments
  47.  Ensured files are in Unix format, with the exception of the README type information and Makefile.PL
  48.  
  49. =item Changes in DBD::ODBC 1.04 January 24, 2003
  50.  
  51.  It seems that case insensitive string comparison with a limit causes problems for
  52.  multiple platforms.  strncmpi, strncasecmp, _strcmpin are all functions hit and
  53.  it seems to be a hit-or-miss.  Hence, I rewrote it to upper case the string
  54.  then do strncmp, which should be safe...sheesh.  A simple thing turned into
  55.  a headache...
  56.  
  57. =item Changes in DBD::ODBC 1.03 January 17, 2003
  58.  
  59.  Add automatic detection of DRIVER= or DSN= to add user id and password to
  60.  connect string.
  61.  
  62.  
  63. =item Changes in DBD::ODBC 1.02 January 6, 2003
  64.  
  65.  Fix to call finish() automatically if execute is re-called in a loop 
  66. (and test in t/02simple.t to ensure it's fixed)
  67.  
  68.  Augmented error message when longs are truncated to help users determine where
  69.  to look for help.
  70.  
  71.  Fixes for build under Win32 with Perl5.8.  
  72.  
  73.  
  74. =item Changes in DBD::ODBC 1.01 December 9, 2002
  75.  
  76.  Forgot to fix require DBI 1.201 in ODBC.pm to work for perl 5.8.  Fixed
  77.  
  78. =item Changes in DBD::ODBC 1.00 December 8, 2002
  79.  
  80.  (Please see all changes since version 0.43)
  81.  
  82.  Updated Makefile.PL to handle SQL_Wxxx types correctly with unixODBC and linking 
  83.  directly with EasySoft OOB.  Note that I could not find where iODBC defines SQL_WLONG_VARCHAR,
  84.  so I'm not sure it's fixed on all other platforms.  Should not have been a problem under
  85.  Win32...
  86.  
  87.  Found that the fix in _18 was only enabled if debug enabled and it broke something else.
  88.  removed the fix.
  89.  
  90.  Updated Makefile.PL to use DBI version 1.21 instead of 1.201 to facilitate builds under
  91.  latest development versions of Perl.
  92.  
  93.  Updated code to use the *greater* of the column display size and the column length for
  94.  allocating column buffers.  This *should* workaround a problem with DBD::ODBC and the 
  95.  Universe database.
  96.  
  97.  Added code thanks to Michael Riber to handle SQLExecDirect instead of SQLPrepare.  There are 
  98.  two ways to get this:
  99.     $dbh->prepare($sql, { odbc_execdirect => 1}); 
  100.  and
  101.     $dbh->{odbc_execdirect} = 1;
  102.  When $dbh->prepare() is called with the attribute "ExecDirect" set to a non-zero value 
  103.  dbd_st_prepare do NOT call SQLPrepare, but set the sth flag odbc_exec_direct to 1.
  104.  
  105.  Fixed numeric value binding when binding non-integral values.  Now lets the driver 
  106.  or the database handle the conversion.
  107.  
  108.  Fixed makefile.pl generation of makefile to force the ODBC directory first in the 
  109.  include list to help those installing ODBC driver managers on systems which 
  110.  already have ODBC drivers in their standard include path.
  111.  
  112. =item Changes in DBD::ODBC 0.45_18 September 26, 2002
  113.  
  114.  Updated MANIFEST to include more of the mytest/* files (examples, tests)
  115.  Fixed problem when attempting to get NUM_OF_FIELDS after execute returns no rows/columns.
  116.  
  117. =item Changes in DBD::ODBC 0.45_17 August 26, 2002
  118.  
  119.  More fixes for multiple result sets.  Needed to clear the DBIc_FIELDS_AV
  120.  when re-executing the multiple-result set stored procedure/query.
  121.  
  122. =item Changes in DBD::ODBC 0.45_16 August 26, 2002
  123.  
  124.  Updated to fix output parameters with multiple result sets.  The output
  125.  parameters are not set until the last result set has been retrieved.
  126.  
  127. =item Changes in DBD::ODBC 0.45_15 August 20, 2002
  128.  
  129.  Updated for new DBIc_STATE macros (all debug, as it turned out) to be thread safer in the long run
  130.  
  131.  Updated for the new DBIc_LOGFP macros
  132.  
  133.  Added CLONE method
  134.  
  135.  Fix for SQL Server where multiple result sets being returned from a stored proc,
  136.  where one of the result sets was empty (insert/update).
  137.  
  138.  Added new attribute odbc_force_rebind, which forces DBD::ODBC to
  139.  check recheck for new result sets every execute.  This is only
  140.  really necessary if you have a stored procedure which returns different
  141.  result sets with each execute, given the same "prepare".  Many times
  142.  this will be automatically set by DBD::ODBC, however, if there is only
  143.  one result set in the stored proc, but it can differ with each call,
  144.  then DBD::ODBC will not know to set it. 
  145.  
  146.  Updated the DBD::ODBC POD documentation to document DBD::ODBC 
  147.  private attributes and usage.
  148.  
  149. =item Changes in DBD::ODBC 0.45_14 August 13, 2002
  150.  
  151. Added support to handle (better) DBI begin_work().
  152.  
  153. Fix for binding undef parameters on SQL Server.
  154.  
  155. Fix bug when connecting twice in the same script.  Trying to set the environment ODBC version
  156. twice against the same henv caused an error.
  157.  
  158. =item Changes in DBD::ODBC 0.45_13 August 9, 2002
  159.  
  160. Workaround problem with iODBC where SQLAllocHandleStd is not present in iODBC.
  161. Made Changes file accessible via perldoc DBD::ODBC::Changes.  In the near future
  162. the change log will be removed from here and put in changes to tidy up a bit.
  163.  
  164. =item Changes in DBD::ODBC 0.45_12 August 9, 2002
  165.  
  166. Fixed global destruction access violation (which was seemingly random).
  167.  
  168. =item Changes in DBD::ODBC 0.45_11 August 8, 2002
  169.  
  170. Updated manifest to include more samples.
  171. Working on checking for leaks on Linux, where I might get more information about
  172. the process memory.
  173.  
  174. Working on fixing problems with MS SQL Server binding parameters.  It seems that SQLServer
  175. gets "confused" if you bind a NULL first.  In "older" (SQLServer 2000 initial release) versions
  176. of the driver, it would truncate char fields.  In "newer" versions of the SQL Server
  177. driver, it seems to only truncate dates (actually, round them to the nearest minute).  If you have
  178. problems in the SQL Server tests, please upgrade your driver to the latest version on
  179. Microsoft's website (MDAC 2.7 or above) http://www.microsoft.com/data
  180.  
  181. =item Changes in DBD::ODBC 0.45_10 July 30, 2002
  182.  
  183. Added database specific tests to ensure things are working.  Some of the tests may
  184. not work for all people or may not be desirable.  I have tried to keep them as
  185. safe as possible, but if they don't work, please let me know.
  186.  
  187. Added support for the internal function GetFunctions to handle ODBC 3's
  188. SQL_API_ODBC3_ALL_FUNCTIONS.  Would have caused a memory overwrite on the
  189. stack if it was called. 
  190.  
  191.  
  192. =item Changes in DBD::ODBC 0.45_9 July 30, 2002
  193.  
  194. Fixed bug in procedure handling for SQLServer.  Was not re-describing the result sets
  195. if the SQLMoreResults in the execute needs to be called.
  196.  
  197. =item Changes in DBD::ODBC 0.45_8 July 25, 2002
  198.  
  199. Fixed bug in tracing code when binding an undef parameter which did not
  200. happen to have a valid buffer with tracing level >= 2
  201.  
  202. Fixed bug when binding undef after a valid data bind on a timestamp.  The
  203. Scale value was being calculated based upon the string that had been bound
  204. prior to the bind of the undef and if that had a sub-second value, then
  205. the scale would be set to the wrong value...
  206.  I.e. bind_param(1, '2000-05-17 00:01:00.250', SQL_TYPE_TIMESTAMP) then
  207.        execute
  208.       bind_param(1, undef, SQL_TYPE_TIMESTAMP) then
  209.  
  210. Fixed SQL Server issue when binding a null and the length was set to 0 instead of 1
  211.  
  212. =item Changes in DBD::ODBC 0.45_7 July 25, 2002
  213.  
  214. Adding support for array binding, but not finished.
  215.  
  216. Fixed bug where SqlServer Stored procedures which perform INSERT would not correctly
  217. return a result set.  Thanks to Joe Tebelskis for finding it and Martin Evans for
  218. supplying a fix.
  219.  
  220. Fixed bug where binding the empty string would cuase a problem.  Fixed and added
  221. test in t/07bind.t.
  222.  
  223. =item Changes in DBD::ODBC 0.45_6 July 24, 2002
  224.  
  225. Added support for new DBI ParamValues feature.
  226.  
  227. =item Changes in DBD::ODBC 0.45_5 July 23, 2002
  228.  
  229. Added odbc_err_handler and odbc_async_exec thanks to patches by David L. Good.
  230. See example in mytest/testerrhandler.pl
  231.  
  232. Here's the notes about it:
  233.  
  234. > I've implemented two separate functions.  The first is an "error
  235. > handler" similar to that in DBD::Sybase.  The error handler can be used
  236. > to intercept error and status messages from the server.  It is the only
  237. > way (at least currently) that you can retrieve non-error status messages
  238. > when execution is successful.
  239. >
  240. > To use the error handler, set the "odbc_err_handler" attribute on
  241. > your database handle to a reference to a subroutine that will act
  242. > as the error handler.  This subroutine will be passed two args, the
  243. > SQLSTATE and the error message.  If the subroutine returns 0, the
  244. > error message will be otherwise ignored.  If it returns non-zero,
  245. > the error message will be processed normally.
  246. >
  247. > The second function implemented is asynchronous execution.  It's only
  248. > useful for retrieving server messages with an error handler during an
  249. > execute() that takes a long time (such as a DBCC on a large database) ODBC
  250. > doesn't have the concept of a callback routine like Sybase's DBlib/CTlib
  251. > does, so asynchronous execution is needed to be able to get the server
  252. > messages before the SQL statement is done processing.
  253. >
  254. > To use asynchronous execution, set the "odbc_async_exec" attribute on
  255. > your database handle to 1.  Not all ODBC drivers support asynchronous
  256. > execution.  To see if yours does, set odbc_async_exec to 1 and then check
  257. > it's value.  If the value is 1, your ODBC driver can do asynchronous
  258. > execution.  If the value is 0, your ODBC driver cannot.
  259.  
  260. =item Changes in DBD::ODBC 0.45_4 July 22, 2002
  261.  
  262. More fixes for DB2 tests and timestamp handling.
  263.  
  264. =item Changes in DBD::ODBC 0.45_3 July 22, 2002
  265.  
  266. Changes to internal timestamp type handling and test structure to ensure tests
  267. work for all platforms.  DB2 was giving me fits due to bad assumptions.  Thanks
  268. to Martin Evans (again) for help in identifying the problems and helping research
  269. solutions.  This includes the scale/precision values to correctly store full timestamps.
  270.  
  271. =item Changes in DBD::ODBC 0.45_2 July 19, 2002
  272.  
  273. Moving API usage to ODBC 3.0 specifications.  With lots of help from Martin Evans (again!).
  274. Thanks Martin!!!!!
  275.  
  276. =head2 Changes in DBD::ODBC 0.44 July 18, 2002
  277.  
  278. .44 was never officially released.
  279. Fix for do() and execute to handle DB2 correctly.  Patch/discovery thanks to Martin Evans.
  280. Partly moving towards defaulting to ODBC 3.x standards.
  281.  
  282. =head2 Changes in DBD::ODBC 0.43 July 18, 2002
  283.  
  284.  Fix for FoxPro (and potentially other) Drivers!!!!!
  285.  
  286.  Add support for DBI column_info
  287.  
  288.  Fix for binding undef value which comes from dereferencing hash
  289.  
  290.  Fix to make all bound columns word (int) aligned in the buffer.
  291.  
  292. =head2 Changes in DBD::ODBC 0.42 July 8, 2002
  293.  
  294.  Added patches to the tests to support ActiveState's automated build process.
  295.  
  296.  Fix ping() to try SQLTables for a test, instead of a strange query.  
  297.  
  298. =head2 Changes in DBD::ODBC 0.41 April 15, 2002
  299.  
  300.  Fixed problem where SQLDescribeParam would fail (probably
  301.  bug in ODBC driver).  Now reverts to SQL_VARCHAR if that
  302.  happens, instead of failing the query.
  303.  
  304.  Fixed error report when using Oracle's driver.  There is
  305.  a known problem.  Left the error on the test, but added
  306.  warning indicating it's a known problem.
  307.  
  308. =head2 Changes in DBD::ODBC 0.40 April 12, 2002
  309.  
  310.  Most significant change is the change in the default binding
  311.  type which forces DBD::ODBC to attempt to determine the bind
  312.  type if one is not passed.  I decided to make this the default
  313.  behavior to make things as simple as possible.
  314.  
  315. Fixed connection code put in 0.39 to work correctly.
  316.  
  317.  Two minor patches for building, one for Cygwin one
  318.  if both iODBC and unixODBC libraries are installed.
  319.  Probably need better command line on this, but if 
  320.  someone has the problem, please let me know (and 
  321.  hopefully send a patch with it).
  322.  
  323. =head2 Changes in DBD::ODBC 0.39 March 12, 2002
  324.  
  325.  See mytest/longbin.pl for demonstration of inserting and retrieving
  326.  long binary files to/from the db.  Uses MD5 algorithm to verify data.
  327.  Please do some similar test(s) with your database before using it
  328.  in production.  The various bind types are different for each database!
  329.  
  330.  Finally removed distribution of old iODBC.  See www.iodbc.org or
  331.  www.unixodbc.org for newer/better versions of the ODBC driver
  332.  manager for Unix (and others?). 
  333.  
  334.  Added ability to force ODBC environment version.
  335.  
  336.  Fix to SQLColAttributes.
  337.  
  338.  Changes to connect sequence to provide better error
  339.  messages for those using DSN-less connections.
  340.  
  341. =head2 Changes in DBD::ODBC 0.38 February 12, 2002
  342.  
  343.  Fixed do function (again) thanks to work by Martin Evans.
  344.  
  345. =head2 Changes in DBD::ODBC 0.37 February 10, 2002
  346.  
  347.  Patches for get_info where return type is string.  Patches
  348.  thanks to Steffen Goldner.  Thanks Steffen!
  349.  
  350.  Patched get_info to NOT attempt to get data for SQL_DRIVER_HSTMT
  351.  and SQL_DRIVER_HDESC as they expect data in and have limited value
  352.  (IMHO).
  353.  
  354.  Further fixed build for ODBC 2.x drivers.  The new SQLExecDirect
  355.  code had SQLAllocHandle which is a 3.x function, not a 2.x function.
  356.  Sigh.  I should have caught that the first time.  Signed, the Mad-and-
  357.  not-thorough-enough-patcher.
  358.  
  359.  Additionally, a random core dump occurred in the tests, based upon the
  360.  new SQLExecDirect code.  This has been fixed.
  361.  
  362.  
  363. =head2 Changes in DBD::ODBC 0.36 February 10, 2002
  364.  
  365.  Fixed build for ODBC 2.x drivers.  The new SQLExecDirect code
  366.  had SQLFreeHandle which is a 3.x function, not a 2.x function.
  367.  
  368. =head2 Changes in DBD::ODBC 0.35 February 9, 2002
  369.  
  370.  Fixed (finally) multiple result sets with differing
  371.  numbers of columns.  The final fix was to call
  372.  SQLFreeStmt(SQL_UNBIND) before repreparing
  373.  the statement for the next query.
  374.  
  375.  Added more to the multi-statement tests to ensure
  376.  the data retrieved was what was expected.
  377.  
  378.  Now, DBD::ODBC overrides DBI's do to call SQLExecDirect
  379.  for simple statements (those without parameters).
  380.  Please advise if you run into problems.  Hopefully,
  381.  this will provide some small speed improvement for
  382.  simple "do" statements.  You can also call
  383.  $dbh->func($stmt, ExecDirect).  I'm not sure this has
  384.  great value unless you need to ensure SQLExecDirect
  385.  is being called.  Patches thanks to Merijn Broeren.
  386.  Thanks Merijn!
  387.    
  388. =head2 Changes in DBD::ODBC 0.34 February 7, 2002
  389.  
  390.  Further revamped tests to attempt to determine if SQLDescribeParam
  391.  will work to handle the binding types.  The t/08bind.t attempts
  392.  to determine if SQLDescribeParam is supported.  note that Oracle's
  393.  ODBC driver under NT doesn't work correctly when binding dates
  394.  using the ODBC date formatting {d } or {ts }.  So, test #3 will
  395.  fail in t/08bind.t
  396.  
  397.  New support for primary_key_info thanks to patches by Martin Evans.
  398.  New support for catalog, schema, table and table_type in table_info
  399.  thanks to Martin Evans.  Thanks Martin for your work and your
  400.  continuing testing, suggestions and general support!
  401.  
  402.  Support for upcoming dbi get_info.
  403.  
  404. =head2 Changes in DBD::ODBC 0.33_3 February 4, 2002
  405.  
  406.  Revamped tests to include tests for multiple result sets.
  407.  The tests are ODBC driver platform specific and will be skipped
  408.  for drivers which do not support multiple result sets.
  409.  
  410. =head2 Changes in DBD::ODBC 0.33_2 February 4, 2002
  411.  
  412.  Finally tested new binding techniques with SQL Server 2000,
  413.  but there is a nice little bug in their MDAC and ODBC
  414.  drivers according to the knowledge base article # Q273813, titled
  415.  
  416.    "FIX: "Incorrect Syntax near the Keyword 'by' "
  417.    Error Message with Column Names of "C", "CA" or "CAS" (Q273813)
  418.  
  419.  DBD::ODBC now does not name any of the columns A, B, C, or D
  420.  they are now COL_A, COL_B, COL_C, COL_D.
  421.  
  422.  *** NOTE: *** I AM STRONGLY CONSIDERING MAKING THE NEW
  423.  BINDING the default for future versions.  I do not believe
  424.  it will break much existing code (if any) as anyone binding
  425.  to non VARCHAR (without the ODBC driver doing a good conversion
  426.  from the VARCHAR) will have a problem.  It may be subtle, however,
  427.  since much code will work, but say, binding dates may not with
  428.  some drivers.
  429.    
  430.  Please comment soon...
  431.    
  432. =head2 Changes in DBD::ODBC 0.33_1 February 4, 2002
  433.  
  434. *** WARNING: ***
  435.  
  436.  Changes to the binding code to allow the use of SQLDescribeParam
  437.  to determine if the type of column being bound.  This is
  438.  experimental and activated by setting
  439.  
  440.   $dbh->{odbc_default_bind_type} = 0; # before creating the query...
  441.  
  442.  Currently the default value of odbc_default_bind_type = SQL_VARCHAR
  443.  which mimicks the current behavior.  If you set
  444.  odbc_default_bind_type to 0, then SQLDescribeParam will be
  445.  called to determine the columen type.  Not ALL databases
  446.  handle this correctly.  For example, Oracle returns
  447.  SQL_VARCHAR for all types and attempts to convert to the
  448.  correct type for us.  However, if you use the ODBC escaped
  449.  date/time format such as: {ts '1998-05-13 00:01:00'} then
  450.  Oracle complains.  If you bind this with a SQL_TIMESTAMP type,
  451.  however, Oracle's ODBC driver will parse the time/date correctly.
  452.  Use at your own risk!
  453.  
  454.  Fix to dbdimp.c to allow quoted identifiers to begin/end
  455.  with either " or '.
  456.  The following will not be treated as if they have a bind placeholder:
  457.    "isEstimated?"
  458.    '01-JAN-1987 00:00:00'
  459.    'Does anyone insert a ?'
  460.  
  461.                     
  462. =head2 Changes in DBD::ODBC 0.32 January 22, 2002
  463.  
  464.  More SAP patches to Makfile.PL to eliminate the call to Data Sources
  465.  
  466.  A patch to the test (for SAP and potentially others), to allow
  467.  fallback to SQL_TYPE_DATE in the tests
  468.  
  469. =head2 Changes in DBD::ODBC 0.31 January 18, 2002
  470.  
  471.  Added SAP patches to build directly against SAP driver instead of
  472.  driver manager thanks to Flemming Frandsen (thanks!)
  473.  
  474.  Added support to fix ping for Oracle8.  May break other databases,
  475.  so please report this as soon as possible.  The downside is that
  476.  we need to actually execute the dummy query.
  477.  
  478.  
  479. =head2 Changes in DBD::ODBC 0.30 January 8, 2002
  480.  
  481.  Added ping patch for Solid courtesy of Marko Asplund
  482.  
  483.  Updated disconnect to rollback if autocommit is not on.
  484.  This should silence some errors when disconnecting.
  485.  
  486.  Updated SQL_ROWSET_SIZE attribute.  Needed to force it to
  487.  odbc_SQL_ROWSET_SIZE to obey the DBI rules.
  488.  
  489.  Added odbc_SQL_DRIVER_ODBC_VER, which obtains the version of
  490.  the Driver upon connect.  This internal capture of the version is
  491.  a read-only attributed and is used during array binding of parameters.
  492.  
  493.  Added odbc_ignore_named_placeholders attribute to facilicate
  494.  creating triggers within SAPDB and Oracle, to name two. The
  495.  syntax in these DBs is to allow use of :old and :new to
  496.  access column values before and after updates.  Example:
  497.  
  498.  $dbh->{odbc_ignore_named_placeholders} = 1; # set it for all future statements
  499.                       # ignores :foo, :new, etc, but not :1 or ?
  500.  $dbh->do("create or replace etc :new.D = sysdate etc");
  501.  
  502.  
  503. =head2 Changes in DBD::ODBC 0.29 August 22, 2001
  504.  
  505.  Cygwin patches from Neil Lunn (untested by me).  Thanks Neil!
  506.  
  507. SQL_ROWSET_SIZE attribute patch from Andrew Brown 
  508. > There are only 2 additional lines allowing for the setting of
  509. > SQL_ROWSET_SIZE as db handle option.
  510. >
  511. > The purpose to my madness is simple. SqlServer (7 anyway) by default
  512. > supports only one select statement at once (using std ODBC cursors).
  513. > According to the SqlServer documentation you can alter the default setting
  514. > of
  515. > three values to force the use of server cursors - in which case multiple
  516. > selects are possible.
  517. >
  518. > The code change allows for:
  519. > $dbh->{SQL_ROWSET_SIZE} = 2;    # Any value > 1
  520. >
  521. > For this very purpose.
  522. >
  523. > The setting of SQL_ROWSET_SIZE only affects the extended fetch command as
  524. > far as I can work out and thus setting this option shouldn't affect
  525. > DBD::ODBC operations directly in any way.
  526. >
  527. > Andrew
  528. >
  529.  
  530. VMS and other patches from Martin Evans (thanks!)
  531.  
  532. [1] a fix for Makefile.PL to build DBD::ODBC on OpenVMS.
  533.  
  534. [2] fix trace message coredumping after SQLDriverConnect
  535.  
  536. [3] fix call to SQLCancel which fails to pass the statement handle properly.
  537.  
  538. [4] consume diagnostics after SQLDriverConnect/SQLConnect call or they remain
  539.     until the next error occurs and it then looks confusing (this is due to
  540.     ODBC spec for SQLError). e.g. test 02simple returns a data truncated error
  541.     only now instead of all the informational diags that are left from the
  542.     connect call, like the "database changed", "language changed" messages you
  543.     get from MS SQL Server.
  544.  
  545. Replaced C++ style comments with C style to support more platforms more easily.
  546.  
  547. Fixed bug which use the single quote (') instead of a double quote (") for "literal" column names.  This
  548.    helped when having a colon (:) in the column name.
  549.  
  550. Fixed bug which would cause DBD::ODBC to core-dump (crash) if DBI tracing level was greater than 3.
  551.  
  552. Fixed problem where ODBC.pm would have "use of uninitialized variable" if calling DBI's type_info.
  553.  
  554. Fixed problem where ODBC.xs *may* have an overrun when calling SQLDataSources. 
  555.  
  556. Fixed problem with DBI 1.14, where fprintf was being called instead of PerlIO_printf for debug information
  557.  
  558. Fixed problem building with unixODBC per patch from Nick Gorham   
  559.  
  560. Added ability to bind_param_inout() via patches from Jeremy Cooper.  Haven't figured out a good, non-db specific
  561.    way to test.  My current test platform attempts to determine the connected database type via
  562.    ugly hacks and will test, if it thinks it can.  Feel free to patch and send me something...Also, my
  563.    current Oracle ODBC driver fails miserably and dies.
  564.  
  565. Updated t/02simple.t to not print an error, when there is not one.
  566.    
  567. =head2 Changes in DBD::ODBC 0.28 March 23, 2000
  568.  
  569. Added support for SQLSpecialColumns thanks to patch provided by Martin J. Evans [martin@easysoft.com]
  570.  
  571. Fixed bug introduced in 0.26 which was introduced of SQLMoreResults was not supported by the driver.
  572.  
  573. =head2 Changes in DBD::ODBC 0.27 March 8, 2000
  574.  
  575. Examined patch for ping method to repair problem reported by Chris Bezil.  Thanks Chris!
  576.  
  577. Added simple test for ping method working which should identify this in the future.
  578.  
  579. =head2 Changes in DBD::ODBC 0.26 March 5, 2000
  580.  
  581. Put in patch for returning only positive rowcounts from dbd_st_execute.  The original patch
  582. was submitted by Jon Smirl and put back in by David Good.  Reasoning seems sound, so I put it
  583. back in.  However, any databases that return negative rowcounts for specific reasons,
  584. will no longer do so.
  585.  
  586. Put in David Good's patch for multiple result sets.  Thanks David!  See mytest\moreresults.pl for
  587. an example of usage.
  588.  
  589. Added readme.txt in iodbcsrc explaining an issue there with iODBC 2.50.3 and C<data_sources>.
  590.  
  591. Put in rudimentary cancel support via SQLCancel.  Call $sth->cencel to utilize.  However, it is largely
  592. untested by me, as I do not have a good sample for this yet.  It may come in handy with threaded
  593. perl, someday or it may work in a signal handler.
  594.    
  595. =head2 Changes in DBD::ODBC 0.25 March 4, 2000
  596.  
  597. Added conditional compilation for SQL_WVARCHAR and SQL_WLONGVARCHAR.  If they
  598. are not defined by your driver manager, they will not be compiled in to the code.
  599. If you would like to support these types on some platforms, you may be able to
  600.  #define SQL_WVARCHAR (-9)
  601.  #define SQL_WLONGVARCHAR (-10)
  602.  
  603. Added more long tests with binding in t\09bind.t.  Note use of bind_param!
  604.  
  605. =head2 Changes in DBD::ODBC 0.24 February 24, 2000
  606.  
  607. Fixed Test #13 in 02simple.t.  Would fail, improperly, if there was only one data source defined.
  608.  
  609. Fixed (hopefully) SQL Server 7 and ntext type "Out of Memory!" errors via patch from Thomas Lowery.  Thanks Thomas!
  610.  
  611. Added more support for Solid to handle the fact that it does not support data_sources nor SQLDriverConnect.
  612.  Patch supplied by Samuli Karkkainen [skarkkai@woods.iki.fi].  Thanks!  It's untested by me, however.
  613.  
  614. Added some information from Adam Curtin about a bug in iodbc 2.50.3's data_sources.  See
  615.    iodbcsrc\readme.txt.
  616.  
  617. Added information in this pod from Stephen Arehart regarding DSNLess connections.
  618.  
  619. Added fix for sp_prepare/sp_execute bug reported by Paul G. Weiss.
  620.  
  621. Added some code for handling a hint on disconnect where the user gets an error for not committing.
  622.  
  623. =head2 Changes in DBD::ODBC 0.22 September 8, 1999
  624.  
  625. Fixed for threaded perl builds.  Note that this was tested only on Win32, with no threads in use and using DBI 1.13.
  626. Note, for ActiveState/PERL_OBJECT builds, DBI 1.13_01 is required as of 9/8/99.  
  627. If you are using ActiveState's perl, this can be installed by using PPM.
  628.  
  629.  
  630. =head2 Changes in DBD::ODBC 0.21 
  631.  
  632. Thanks to all who provided patches!
  633.  
  634. Added ability to connect to an ODBC source without prior creation of DSN.  See mytest/contest.pl for example with MS Access.
  635. (Also note that you will need documentation for your ODBC driver -- which, sadly, can be difficult to find).
  636.  
  637. Fixed case sensitivity in tests.
  638.  
  639. Hopefully fixed test #4 in t/09bind.t.  Updated it to insert the date column and updated it to find the right
  640. type of the column.  However, it doesn't seem to work on my Linux test machine, using the OpenLink drivers 
  641. with MS-SQL Server (6.5).  It complains about binding the date time.  The same test works under Win32 with 
  642. SQL Server 6.5, Oracle 8.0.3 and MS Access 97 ODBC drivers.  Hmmph.
  643.  
  644. Fixed some binary type issues (patches from Jon Smirl)
  645.  
  646. Added SQLStatistics, SQLForeignKeys, SQLPrimaryKeys (patches from Jon Smirl)
  647. Thanks (again), Jon, for providing the build_results function to help reduce duplicate code!
  648.  
  649. Worked on LongTruncOk for Openlink drivers.
  650.  
  651. Note: those trying to bind variables need to remember that you should use the following syntax:
  652.  
  653.     use DBI;
  654.     ...
  655.     $sth->bind_param(1, $str, DBI::SQL_LONGVARCHAR);
  656.  
  657. Added support for unixodbc (per Nick Gorham)
  658. Added support for OpenLinks udbc (per Patrick van Kleef)
  659. Added Support for esodbc (per Martin Evans)
  660. Added Support for Easysoft (per Bob Kline)
  661.  
  662. Changed table_info to produce a list of views, too.
  663. Fixed bug in SQLColumns call.
  664. Fixed blob handling via patches from Jochen Wiedmann.
  665. Added data_sources capability via snarfing code from DBD::Adabas (Jochen Wiedmann)
  666.  
  667. =head2 Changes in DBD::ODBC 0.20 August 14, 1998
  668.  
  669. SQLColAttributes fixes for SQL Server and MySQL. Fixed tables method
  670. by renaming to new table_info method. Added new tyoe_info_all method.
  671. Improved Makefile.PL support for Adabase.
  672.  
  673. =head2 Changes in DBD::ODBC 0.19
  674.  
  675. Added iODBC source code to distribution.Fall-back to using iODBC header
  676. files in some cases.
  677.  
  678. =head2 Changes in DBD::ODBC 0.18
  679.  
  680. Enhancements to build process. Better handling of errors in
  681. error handling code.
  682.  
  683. =head2 Changes in DBD::ODBC 0.17 
  684.  
  685. This release is mostly due to the good work of Jeff Urlwin.
  686. My eternal thanks to you Jeff.
  687.  
  688. Fixed "SQLNumResultCols err" on joins and 'order by' with some
  689. drivers (see Microsoft Knowledge Base article #Q124899).
  690. Thanks to Paul O'Fallon for that one.
  691.  
  692. Added more (probably incomplete) support for unix ODBC in Makefile.PL
  693.  
  694. Increased default SQL_COLUMN_DISPLAY_SIZE and SQL_COLUMN_LENGTH to 2000
  695. for drivers that don't provide a way to query them dynamically. Was 100!
  696.  
  697. When fetch reaches the end-of-data it automatically frees the internal
  698. ODBC statement handle and marks the DBI statement handle as inactive
  699. (thus an explicit 'finish' is *not* required).
  700.  
  701. Also:
  702.  
  703.   LongTruncOk for Oracle ODBC (where fbh->datalen < 0)
  704.   Added tracing into SQLBindParameter (help diagnose oracle odbc bug)
  705.   Fixed/worked around bug/result from Latest Oracle ODBC driver where in
  706.      SQLColAttribute cbInfoValue was changed to 0 to indicate fDesc had a value
  707.   Added work around for compiling w/ActiveState PRK (PERL_OBJECT)
  708.   Updated tests to include date insert and type
  709.   Added more "backup" SQL_xxx types for tests                                  
  710.   Updated bind test to test binding select
  711.   NOTE: bind insert fails on Paradox driver (don't know why)
  712.  
  713. Added support for: (see notes below)
  714.  
  715.   SQLGetInfo       via $dbh->func(xxx, GetInfo)
  716.   SQLGetTypeInfo   via $dbh->func(xxx, GetTypeInfo)
  717.   SQLDescribeCol   via $sth->func(colno, DescribeCol)
  718.   SQLColAttributes via $sth->func(xxx, colno, ColAttributes)
  719.   SQLGetFunctions  via $dbh->func(xxx, GetFunctions)
  720.   SQLColumns       via $dbh->func(catalog, schema, table, column, 'columns')
  721.  
  722. Fixed $DBI::err to reflect the real ODBC error code
  723. which is a 5 char code, not necessarily numeric.
  724.  
  725. Fixed fetches when LongTruncOk == 1.
  726.  
  727. Updated tests to pass more often (hopefully 100% <G>)
  728.  
  729. Updated tests to test long reading, inserting and the LongTruncOk attribute.
  730.  
  731. Updated tests to be less driver specific.  
  732.  
  733. They now rely upon SQLGetTypeInfo I<heavily> in order to create the tables.
  734. The test use this function to "ask" the driver for the name of the SQL type
  735. to correctly create long, varchar, etc types.  For example, in Oracle the
  736. SQL_VARCHAR type is VARCHAR2, while MS Access uses TEXT for the SQL Name.  
  737. Again, in Oracle the SQL_LONGVARCHAR is LONG, while in Access it's MEMO.
  738. The tests currently handle this correctly (at least with Access and Oracle,
  739. MS SQL server will be tested also).
  740.  
  741. =cut
  742.