[
https://issues.apache.org/jira/browse/DERBY-5191?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
Kim Haase updated DERBY-5191:
-----------------------------
Attachment: rrefattribretrievemsgtext.html
DERBY-5191.stat
DERBY-5191.diff
Attaching DERBY-5191.diff, DERBY-5191.stat, and the new topic
rrefattribretrievemsgtext.html, with the following changes:
A src/ref/rrefattribretrievemsgtext.dita
M src/ref/refderby.ditamap
I guessed that retrieveMessageText can be combined with other attributes, since
that is the case for the other client-specific attributes listed in the Admin
Guide ("Accessing the Network Server by using the network client driver"). Hope
that's the case.
Please let me know if further changes are needed. I'll commit the patch by the
end of the week if I don't hear anything. Thanks very much.
> Documentation needed for connection URL attribute retrieveMessageText
> ---------------------------------------------------------------------
>
> Key: DERBY-5191
> URL: https://issues.apache.org/jira/browse/DERBY-5191
> Project: Derby
> Issue Type: Bug
> Components: Documentation
> Affects Versions: 10.7.1.1
> Reporter: Kim Haase
> Assignee: Kim Haase
> Priority: Minor
> Attachments: DERBY-5191.diff, DERBY-5191.stat,
> rrefattribretrievemsgtext.html
>
>
> The connection URL attribute retrieveMessageText, mentioned in the Admin
> Guide in the topic "Accessing the Network Server by using the network client
> driver (cadminappsclient.dita), is not documented in the Reference Manual but
> should be.
> I can't find any javadoc comments on this attribute in the implementation
> code in java/client/org/apache/derby/jdbc/ClientBaseDataSource.java or
> client/org/apache/derby/client/am/Connection.java.
> The Admin Guide just says the following, noting that the default setting is
> true:
> "Retrieve message text from the server. A stored procedure is called to
> retrieve the message text with each SQLException and might start a new unit
> of work. Set this property to false if you do not want the performance impact
> or when starting new units of work."
> This last sentence is confusing. Seems like it should be something like "Set
> this property to false if you do not want the performance impact or do not
> want to start a new unit of work." Does that make more sense?
> I know the attribute is client-specific.
> Must it be combined with any other attributes, or are there some that it must
> NOT be combined with?
> What else needs to be said?
> I'll pick this up if someone can clear up these few points.
--
This message is automatically generated by JIRA.
For more information on JIRA, see: http://www.atlassian.com/software/jira
