[DERBY-3579] The Developer's Guide incorrectly describes the behavior of transactions inside procedures and functions

• Type: Bug
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 10.3.2.1
• Fix Version/s: 10.4.2.0, 10.5.1.1
• Component/s: Documentation
• Assignee: Camilla Haase
• Reporter: Richard N. Hillegas
• Created: 28/Mar/08 18:01
• Updated: 04/May/09 18:22
• Resolved: 24/Jul/08 19:36

Description

The "Programming database-side JDBC procedures" section of the Developer's Guide misleads users about how transactions can be managed inside database procedures. For instance, the section titled "Invoking a procedure using the CALL command" says the following: "Procedures that use nested connections, on the other hand, are not permitted to commit or roll back and can therefore be rolled back after the calling statement." This is not true. User-coded procedures can issue both commit() and rollback() on the nested connection bound to the "jdbc:default:connection" URL and those methods have the desired behavior. The whole "Programming database-side JDBC procedures" section could use an overhaul since it appears to make other misleading statements about the behavior of transactions inside routines. Thanks to Dag for pointing out the following email thread: http://www.nabble.com/Transaction-Problems-of-a-Derby-Stored-Procedure-td15494178.html