Derby
  1. Derby
  2. DERBY-5191

Documentation needed for connection URL attribute retrieveMessageText

    Details

    • Type: Bug Bug
    • Status: Closed
    • Priority: Minor Minor
    • Resolution: Fixed
    • Affects Version/s: 10.7.1.1, 10.8.1.2
    • Fix Version/s: 10.8.2.2, 10.9.1.0
    • Component/s: Documentation
    • Labels:
      None

      Description

      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.

      1. rrefattribretrievemsgtext.html
        4 kB
        Kim Haase
      2. rrefattribretrievemsgtext.html
        4 kB
        Kim Haase
      3. rrefattribderegister.html
        5 kB
        Kim Haase
      4. DERBY-5191-2.stat
        0.1 kB
        Kim Haase
      5. DERBY-5191-2.diff
        4 kB
        Kim Haase
      6. DERBY-5191.stat
        0.1 kB
        Kim Haase
      7. DERBY-5191.diff
        3 kB
        Kim Haase

        Issue Links

          Activity

          No work has yet been logged on this issue.

            People

            • Assignee:
              Kim Haase
              Reporter:
              Kim Haase
            • Votes:
              0 Vote for this issue
              Watchers:
              0 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved:

                Development