Connector business object structure

After installing the connector, you must create business objects for MQ Integrator Broker. There are no requirements regarding the structure of the business objects other than those imposed by the configured data handler. The business objects that the connector processes can have any name allowed by InterChange Server. For more on naming conventions see Naming IBM WebSphere InterChange Server Components.

The connector retrieves messages from a queue and attempts to populate a business object (defined by the meta-object) with the message contents. Strictly speaking, the connector neither controls nor influences business object structure. Those are functions of meta-object definitions as well as the connector's data handler requirements. In fact, there is no business-object level application information. Rather, the connector's main role when retrieving and passing business objects is to monitor the message-to-business-object (and vice versa) process for errors.

Sample Business Object Properties

This section describes sample business object properties for an connector with a Name-Value data handler.

[ReposCopy]
 Version = 3.0.0
 [End]
 [BusinessObjectDefinition]
 Name = Example_SimpleOrder
 Version = 1.0.0
 AppSpecificInfo = m_SimpleOrder
  
 [Attribute]
 Name = ProductCode
 Type = String
 Cardinality = 1
 MaxLength = 3
 IsKey = true
 IsForeignKey = false
 IsRequired = true
 AppSpecificInfo = e_ProductCode;type=pcdata;
 DefaultValue = W02
 IsRequiredServerBound = false
 [End]
  
 [Attribute]
 Name = ProductDescription
 Type = String
 Cardinality = 1
 MaxLength = 20
 IsKey = false
 IsForeignKey = false
 IsRequired = false
 AppSpecificInfo = e_ProductDescription;type=pcdata;
 DefaultValue = Deluxe Widget
 IsRequiredServerBound = false
 [End]
 [Attribute]
 Name = ProductQuantity
 Type = Integer
 Cardinality = 1
 MaxLength = 1
 IsKey = false
 IsForeignKey = false
 IsRequired = true
 AppSpecificInfo = e_ProductQuantity;type=pcdata;
 DefaultValue = 1
 IsRequiredServerBound = false
 [End]
  
 [Attribute]
 Name = ObjectEventId
 Type = String
 MaxLength = 255
 IsKey = false
 IsForeignKey = false
 IsRequired = false
 IsRequiredServerBound = false
 [End]
  
 [Verb]
 Name = Create
 [End]
  
 [Verb]
 Name = Delete
 [End]
  
 [Verb]
 Name = Retrieve
 [End]
  
 [Verb]
 Name = Update
 [End]
 [End]
  
 [BusinessObjectDefinition]
 Name = Example_SimpleOrder_MRM
 Version = 1.0.0
 AppSpecificInfo = MRM
  
 [Attribute]
 Name = xmlns
 Type = String
 Cardinality = 1
 MaxLength = 255
 IsKey = false
 IsForeignKey = false
 IsRequired = false
 AppSpecificInfo = xmlns;type=attribute
 DefaultValue = www.mrmnames.net/DIN94VC078001
 IsRequiredServerBound = false
 [End]
 [Attribute]
 Name = SimpleOrder
 Type = Example_SimpleOrder
 ContainedObjectVersion = 1.0.0
 Relationship = Containment
 Cardinality = 1
 MaxLength = 1
 IsKey = true
 IsForeignKey = false
 IsRequired = false
 AppSpecificInfo = m_SimpleOrder
 IsRequiredServerBound = false
 [End]
 [Attribute]
 Name = ObjectEventId
 Type = String
 MaxLength = 255
 IsKey = false
 IsForeignKey = false
 IsRequired = false
 IsRequiredServerBound = false
 [End]
  
 [Verb]
 Name = Create
 [End]
  
 [Verb]
 Name = Delete
 [End]
  
 [Verb]
 Name = Retrieve
 [End]
  
 [Verb]
 Name = Update
 [End]
 [End]
  
 [BusinessObjectDefinition]
 Name = Example_SimpleOrder_XMLDoc
 Version = 1.0.0
  
 [Attribute]
 Name = XMLDeclaration
 Type = String
 MaxLength = 255
 IsKey = true
 IsForeignKey = false
 IsRequired = false
 AppSpecificInfo = type=pi;
 DefaultValue = xml version="1.0"
 IsRequiredServerBound = false
 [End]
 [Attribute]
 Name = Doctype
 Type = String
 MaxLength = 255
 IsKey = true
 IsForeignKey = false
 IsRequired = false
 AppSpecificInfo = type=doctype;
 DefaultValue = DOCTYPE MRM PUBLIC "www.mrmnames.net/DIN94VC078001" "DIN94VC078001"
 IsRequiredServerBound = false
 [End]
  
 [Attribute]
 Name = MRM_Wrapper
 Type = Example_SimpleOrder_MRM
 ContainedObjectVersion = 1.0.0
 Relationship = Containment
 Cardinality = 1
 MaxLength = 1
 IsKey = true
 IsForeignKey = false
 IsRequired = true
 AppSpecificInfo = MRM
 IsRequiredServerBound = false
 [End]
  
 [Attribute]
 Name = ObjectEventId
 Type = String
 MaxLength = 255
 IsKey = false
 IsForeignKey = false
 IsRequired = false
 IsRequiredServerBound = false
 [End]
  
 [Verb]
 Name = Create
 [End]
  
 [Verb]
 Name = Delete
 [End]
  
 [Verb]
 Name = Retrieve
 [End]
  
 [Verb]
 Name = Update
 [End]
 [End]
 

Copyright IBM Corp. 1997, 2003