
IBM.Broker.Plugin NBMessage
IBM.Broker.Plugin NBCollectionMessage
Namespace: IBM.Broker.Plugin
Assembly: IBM.Broker.Plugin (in IBM.Broker.Plugin.dll) Version: 9.0.0.0
Conversion between these two formats is managed by parsers. Different parsers are invoked by the root parser as required during the parsing of a message. The following diagram shows a typical message.
+------+ | Root | +------+ / / \ / \ / \ / \ +----------+ +----+ +------+ |Properties|----|MQMD|----|XMLNSC| +----------+ +----+ +------+
The root parser at the top will invoke the parsers along the bottom in the order shown to parse the bit stream into a tree. This tree will then have same structure as shown in the diagram with sub-trees off each parser element representing its part of the message. For example the MQMD header is the first sibling of the first child of Root and the MQMD fields are children of this.
The element representing the root is returned by the property RootElement. This is an object of type NBElement which contains methods to navigate and modify the tree.
Also, see the topic "Working with Messages. Appendix A: Message Parsers - element definitions" in the Information Center.
Warning: caching NBMessage objects over multiple message flow invocations is unsupported because the internal state may be reset at the end of each message flow invocation.