Bug 673230 - XID Size - 25 or 53 bytes?
Summary: XID Size - 25 or 53 bytes?
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Enterprise MRG
Classification: Red Hat
Component: Messaging_Programming_Reference
Version: 1.3
Hardware: Unspecified
OS: Unspecified
low
low
Target Milestone: 2.0
: ---
Assignee: Alison Young
QA Contact: ecs-bugs
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2011-01-27 19:01 UTC by mdarretta
Modified: 2012-09-21 12:58 UTC (History)
4 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2011-06-24 02:55:20 UTC
Target Upstream Version:


Attachments (Terms of Use)

Description mdarretta 2011-01-27 19:01:29 UTC
Section 6.4.4, example 6.2, defines the size of the XID size at 53 bytes, while the previous paragraph defines it as 25 bytes. Which one is accurate?

Comment 1 Lana Brindley 2011-02-03 00:02:55 UTC
Please provide further information for documentation.

LKB

Comment 2 mdarretta 2011-02-07 22:45:08 UTC
There's nothing else I can provide. Engineering will need to clarify which numbers are correct. Thanks.

Comment 3 Lana Brindley 2011-02-07 23:42:45 UTC
Gordon,

Are you able to help out with source documentation?

LKB

Comment 4 Gordon Sim 2011-02-08 10:12:39 UTC
Kim, can you have a look at the apparent inconsistency in the journal sizing text and comment on corrections needed?

Comment 5 Kim van der Riet 2011-02-08 15:28:48 UTC
I can't find any reference to 25 bytes, but 24 bytes is the size used for local transactions according to the text, I assume this is what you mean in comment #1.

Section 6.4.4, paragraph 1 starts with:

"When transactions are used, a transaction ID (XID) is added to each record. The size of the XID is 24 bytes for local transactions. For distributed transactions, the user supplies the XID, which is usually obtained from the transaction monitor, and may be any size. ..."

In the following sections describing each record type, the transaction is described as:

"Transaction ID (XID) size (24 bytes for local transactions, arbitrary size for distributed transactions)"

The confusion probably arises from Example 6.2 not explicitly stating that the transactions will be distributed, and are supplied by the user. In this example, the supplied XID is a human-readable UUID format of 53 bytes (as opposed to the local transaction format which is binary and 24 bytes).

I suggest the following changes to the text of Example 6.2:

Old text:
"This example shows how to calculate journal size when transactions are used with a persistent queue. Here are the characteristics of the messaging queue for this example:"

New text:
"This example shows how to calculate journal size when distributed transactions are used with a persistent queue. The XID will be supplied by the user in this case. Here are the characteristics of the messaging queue for this example:"


Note You need to log in before you can comment on or make changes to this bug.