The structure of delivered events

This section covers the structure of events delivered to the external JMS queue.

The CBE event document structure

The CBE event document structure is complex, so the description of it is broken down into two parts:

For the full canonic description of the CBE structure, see the schema file, located at \B2BIntegrate\events\schemas\commonbaseevent1_0_1.xsd. In the same directory there is an additional schema file, eventdelivery.xsd. This file defines a WBI-C extension to the main schema which serves to define the OtherSituation type of the SituationType type used in the situation element in the main schema. Further information on CBE and the schema can be found at the Eclipse.org website, in the context of the Hyades project: www.eclipse.org/hyades/

The basic CBE document structure

The root element of a CommonBaseEvent document is a CommonBaseEvent element. The children of the CommonBaseEvent are as follows:

CBE event structure for WBI-C message events and business document events

This section provides an element by element description of the CBE elements supplied in the event documents generated by the WBI-C external event delivery system. It includes a detailed listing of the main elements' attributes. Some descriptions includes a brief example of that element as it would appear in CBE XML for message and business document events, as appropriate.

The CommonBaseEvent element

This is the root element of all CBE event documents. The following table describes this element and its attributes.

Table 2. The CommonBaseEvent element

Property Name Description
Version 1.0.1
WBI-C 4.2.2 supports this version of the schema
localInstanceId Unique identifier in WBI-C store:
  • Message events: the event ID of the source event
  • Business document events: the UUID of the business document
creationTime Creation time of this CBE event:
  • Message events: the creation time of the event
  • Business document events: since logging time is not stored in business document, set to current time
severity
  • Message events:
    • Debug: 8
    • Information: 10
    • Warn: 30
    • Error: 50
  • Business document events: business documents have no severity, so this is set at 10 (Information)

priority WBI-C has no notion of priority. Always set at 50
msg
  • Message event: description of this event Localized.
  • Business document event: not specified

repeatCount Not specified by WBI-C
elapsedTime Not specified by WBI-C
extensionName Used to distinguish message events from business document events
  • Message event: BCG_EVENT
  • Business document event:
    BCG_BUSINESSDOCUMENT
sequenceNumber Not specified by WBI-C

This is a sample of the CommonBaseEvent element for a message event:

<cbe:CommonBaseEvent 
         creationTime="2004-06-20T06:26:01"
         extensionName="BCG_EVENT"
         localInstanceId="1087712761674000C766F006F0178601DF89630A39DF6CA"
         msg="ASValidation" 
         priority="50" 
         severity="10"
         version="1.0.1"
         xsi:schemaLocation=
                        "http://www.ibm.com/AC
                        /commonbaseevent1_0_1commonbaseevent1_0_1.xsd">
:
:
<cbe:CommonBaseEvent />

This is a sample of the CommonBaseEvent element for a business document event:

<cbe:CommonBaseEvent 
          creationTime="2004-06-20T06:26:02"
          extensionName="BCG_BUSINESSDOCUMENT"
          localInstanceId="1087712759944000C766F006F017860B7583EB51E26A336"
          priority="50" 
          severity="10" 
          version="1.0.1"
          xsi:schemaLocation="http://www.ibm.com/AC
             /commonbaseevent1_0_1 commonbaseevent1_0_1.xsd">
:
:
<cbe:CommonBaseEvent />

The sourceComponentId element

This element specifies the component that generated the event. WBI-C fills this in in the normal CBE way. Please see the schema for more information.

The situation element

This element describes the type of situation that generated the event. The following table describes this element and its attributes.

Table 3. The situation element

Property Name Description
categoryName OtherSituation
reasoningScope INTERNAL
faultType WBI-C defines this attribute for OtherSituation in eventdelivery.xsd.
Message events:
  • SOURCE
  • TARGET
  • SYSTEM
  • UNKNOWN
Business document events:
  • UNKNOWN

This is an example of the situation element for a message event:

<cbe:situation categoryName="OtherSituation">
               <cbe:situationType 
               reasoningScope="INTERNAL" 
                xsi:type="cbe:OtherSituation">
               <bcg:faultType/>
           </cbe:situationType>
</cbe:situation>

The extendedDataElements element

This element captures information not captured directly by the basic CBE structure. The following three tables describes this element, its attributes, and its specialized child elements, covering message event extended elements and business document event extended elements.

Table 4. The extendedDataElements element

Property Name Description
name Used to distinguish message events from business document events
  • Message event: BCG_EVENT
  • Business document event:
    BCG_BUSINESSDOCUMENT
type WBI-C sets this to noValue
children One or more elements are created, depending on the type (message or business document) of event. Descriptions in the tables below

The message event extended data elements:

Table 5. Message event extended data elements

Name Value
BCG_EVENTCD Event code from the message event
BCG_HOSTIPADDRESS Host IP address. Specified if available
BCG_PARTNERID1 Internal ID for participant. Specified if available
BCG_PARTNERID2 Internal ID for participant. Specified if available
BCG_STACKTRACE Stack trace. Specified if available
BCG_FRIPADDRESS From: IP address. Specified if available
BCG_PARENTBCGDOCID Unique ID for parent business document. Specified if available
BCG_BCGDOCID The ID of the business document with which this message event is associated

Note: Monitoring applications can use this element for correlating this event with any associated business document

BCG_USERID User ID. Specified if available
BCG_BUSINESSID1 From: business ID. Specified if available
BCG_INITBUSINESSID Initiating business ID. Specified if available
BCG_INITASMESSAGEID Initiating AS message ID. Specified if available
BCG_BUSINESSID2 To: business ID. Specified if available

A partial example of an extendedDataElements element in a message event.

<cbe:extendedDataElements name="BCG_EVENT" type="noValue">
        <cbe:values/>
               <cbe:children name="BCG_EVENTTIMESTAMP" type="string">
               <cbe:values>1087712761674</cbe:values>
           </cbe:children>
              <cbe:children name="BCG_PARENTBCGDOCID" type="string">
              <cbe:values>1087712759944000C766F006F017860B7583EB51E26A336
              </cbe:values>
          </cbe:children>
              <cbe:children name="BCG_ARGUMENTSTRING" type="string">
              <cbe:values>ASValidation</cbe:values>
          </cbe:children>
              <cbe:children name="BCG_HOSTIPADDRESS" type="string">
             <cbe:values>127.0.0.1</cbe:values>
          </cbe:children>
 
  :
  :
  :
 
</cbe:extendedDataElements>

The business document event extended data elements:

Table 6. The business document event extended data elements

Attribute Value
BCG_BCGDOCID Business document's unique
document ID
BCG_PARENTBCGDOCID Document ID for parent business document. Specified if available
BCG_DOCLOCATION Location of business document with complete path. Specified if available
BCG_DOCSTATE Current state of the business
document.
  • DOC_IN_PROCESS="In Process"
  • DOC_SENT = "Sent"
  • DOC_RECEIVED = "Received"
  • DOC_FAILED = "Failed"
BCG_DOCSIZE Obtained from business
document. Specified if available
Business document related
data
In addition, business document events may contain other information concerning:
  • routing related data
  • flow related data
  • business protocol related data
The name attribute of the child elements will be set to one of the constants specified in the BCGDocumentConstants class. See BCGDocumentConstants for further information. Specified only if available

A partial example of an extendedDataElements element in a business document event.

<cbe:extendedDataElements name="BCG_BUSINESSDOCUMENT" type="noValue">
   <cbe:values/>
          <cbe:children name="BCG_BCGDOCID" type="string">
         <cbe:values>1087712755684000C766F006F01786046684D6EAC6FAC22
         </cbe:values>
      </cbe:children>
          <cbe:children name="BCG_DOCLOCATION" type="string">
            <cbe:values>
              /opt/IBM/WBIConnect/common/data/Inbound/process
              /520/D9
              /1087712753565000C766F006F003149F07FF1FC6C41D8D9.ascontent
        </cbe:values>
      </cbe:children>
          <cbe:children name="BCG_PARENTBCGDOCID" type="string">
        <cbe:values>1087712753565000C766F006F003149F07FF1FC6C41D8D9
        </cbe:values>
      </cbe:children>
          <cbe:children name="BCG_DOCSTATE" type="string">
        <cbe:values>In Process</cbe:values>
      </cbe:children>
          <cbe:children name="BCG_DOCRESTARTED" type="string">
        <cbe:values>false</cbe:values>
      </cbe:children>
          <cbe:children name="BCG_FRPARTNERTYPE" type="string">
        <cbe:values>0</cbe:values>
      </cbe:children>
 
      :
      :
      :
 
   </cbe:extendedDataElements>

Copyright IBM Corp. 2003, 2004