db-derby-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Kim Haase (JIRA)" <j...@apache.org>
Subject [jira] [Updated] (DERBY-5191) Documentation needed for connection URL attribute retrieveMessageText
Date Mon, 02 May 2011 14:55:03 GMT

     [ https://issues.apache.org/jira/browse/DERBY-5191?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]

Kim Haase updated DERBY-5191:
-----------------------------

    Attachment: rrefattribderegister.html
                rrefattribretrievemsgtext.html
                DERBY-5191-2.stat
                DERBY-5191-2.diff

Attaching a second patch: DERBY-5191-2.diff, DERBY-5191-2.stat, rrefattribretrievemsgtext.html,
and rrefattribderegister.html. 

A       src/ref/rrefattribretrievemsgtext.dita
M       src/ref/rrefattribderegister.dita
M       src/ref/refderby.ditamap

For these two attributes, the titles have been changed to retrieveMessageText=false and deregister=false
to reflect the fact that for these attributes, the default is true, whereas for all other
boolean attributes it is false.

> 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, 10.8.1.2
>            Reporter: Kim Haase
>            Assignee: Kim Haase
>            Priority: Minor
>         Attachments: DERBY-5191-2.diff, DERBY-5191-2.stat, DERBY-5191.diff, DERBY-5191.stat,
rrefattribderegister.html, rrefattribretrievemsgtext.html, 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

Mime
View raw message