Return-Path: 
 <commits-return-8371-apmail-openjpa-commits-archive=openjpa.apache.org@openjpa.apache.org>
Delivered-To: apmail-openjpa-commits-archive@www.apache.org
Received: (qmail 61273 invoked from network); 13 Jan 2011 22:07:26 -0000
Received: from hermes.apache.org (HELO mail.apache.org) (140.211.11.3)
  by minotaur.apache.org with SMTP; 13 Jan 2011 22:07:26 -0000
Received: (qmail 78737 invoked by uid 500); 13 Jan 2011 22:07:26 -0000
Delivered-To: apmail-openjpa-commits-archive@openjpa.apache.org
Received: (qmail 78687 invoked by uid 500); 13 Jan 2011 22:07:25 -0000
Mailing-List: contact commits-help@openjpa.apache.org; run by ezmlm
Precedence: bulk
List-Help: <mailto:commits-help@openjpa.apache.org>
List-Unsubscribe: <mailto:commits-unsubscribe@openjpa.apache.org>
List-Post: <mailto:commits@openjpa.apache.org>
List-Id: <commits.openjpa.apache.org>
Reply-To: dev@openjpa.apache.org
Delivered-To: mailing list commits@openjpa.apache.org
Received: (qmail 78679 invoked by uid 99); 13 Jan 2011 22:07:25 -0000
Received: from nike.apache.org (HELO nike.apache.org) (192.87.106.230)
    by apache.org (qpsmtpd/0.29) with ESMTP; Thu, 13 Jan 2011 22:07:25 +0000
X-ASF-Spam-Status: No, hits=-2000.0 required=10.0
	tests=ALL_TRUSTED
X-Spam-Check-By: apache.org
Received: from [140.211.11.4] (HELO eris.apache.org) (140.211.11.4)
    by apache.org (qpsmtpd/0.29) with ESMTP; Thu, 13 Jan 2011 22:07:23 +0000
Received: by eris.apache.org (Postfix, from userid 65534)
	id D6A1223889CB; Thu, 13 Jan 2011 22:06:56 +0000 (UTC)
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Subject: svn commit: r1058760 -
 /openjpa/branches/1.3.x/openjpa-project/src/doc/manual/supported_databases.xml
Date: Thu, 13 Jan 2011 22:06:56 -0000
To: commits@openjpa.apache.org
From: mikedd@apache.org
X-Mailer: svnmailer-1.0.8
Message-Id: <20110113220656.D6A1223889CB@eris.apache.org>
X-Virus-Checked: Checked by ClamAV on apache.org

Author: mikedd
Date: Thu Jan 13 22:06:56 2011
New Revision: 1058760

URL: http://svn.apache.org/viewvc?rev=1058760&view=rev
Log:
OPENJPA-1699: Add documentation for fully materialized LOB issue with streaming LOBs and DB2

Modified:
    openjpa/branches/1.3.x/openjpa-project/src/doc/manual/supported_databases.xml

Modified: openjpa/branches/1.3.x/openjpa-project/src/doc/manual/supported_databases.xml
URL: http://svn.apache.org/viewvc/openjpa/branches/1.3.x/openjpa-project/src/doc/manual/supported_databases.xml?rev=1058760&r1=1058759&r2=1058760&view=diff
==============================================================================
--- openjpa/branches/1.3.x/openjpa-project/src/doc/manual/supported_databases.xml (original)
+++ openjpa/branches/1.3.x/openjpa-project/src/doc/manual/supported_databases.xml Thu Jan 13 22:06:56 2011
@@ -467,6 +467,23 @@ of DESCSTAT, DB2 metadata tables must be
 See DB2 for z/OS documentation for additional information.
                     </para>
                 </listitem>
+                <listitem>
+                    <para>
+When using LOBs with persistent attributes of a streaming data type (e.g. 
+<literal>java.io.InputStream</literal>) in the case of very large lob, DB2 JCC 
+driver will automatically use progressive streaming to retrieve the Lob data. 
+With progressiveStreaming, the inputStream retrieved must be fully materialized 
+before the next iteration of call to rs.next(). By default
+this will result in a LobClosedException when OpenJPA processes the InputStream.
+                    </para>
+                    <para>
+To work around this condition you may force fullyMaterializedLobData to true in 
+the connection URL as shown below :
+<programlisting>
+openjpa.ConnectionURL: jdbc:db2://localhost:50000/demodb:fullyMaterializeLobData=true;progressiveStreaming=NO 
+</programlisting> 
+                    </para>
+                </listitem>
             </itemizedlist>
         </section>
     </section>