WebSphere Message Brokers
File: ad06110_
Writer: Terry Cowling

Reference topic

This build: July 31, 2007 21:22:18

Element reference logical properties

Property Type Meaning
Reference Name Enumerated type The Reference Name is the name of the object that this object is referring to. The objects available to reference can be selected from the drop-down list.

Occurrences

Property Type Meaning
Min Occurs Integer Specify the minimum number of times that the object can repeat. The default is 1.

If the value is set to 0, then the object is optional.

With the exception of Max Occurs being set to -1, if a value is set for Min Occurs, it must be less than or equal to the value in Max Occurs.

Max Occurs Integer Specify the maximum number of times that the object can repeat. The default is 1.

If this property is not set, then the object can not occur more than once.

If this property is set to 0, it is interpreted as if the object does not exist in the message.

It can also be set to -1 to indicate that the limit is unbounded and there is no maximum to the number of occurrences.

The Min Occurs and Max Occurs properties are used in conjunction with an element's Value properties. The table below summarizes how an element reference can be constrained.

Min Occurs Max Occurs Fixed Default Notes
1 1     The element must appear once and can have any value.
1 1 Delta   The element must appear once and it must match the data that has been entered in the Value property. In this example the element must contain the text Delta.
2 -1 Delta   The element must appear twice or more and it must match the data that has been entered in the Value property. In this example there will be at least two elements that must contain the text Delta.
0 1     The element is optional and can appear once and have any value.
0 1 Delta   The element is optional and can appear once. If it does appear, its value must match the data that has been entered in the Value property. If it does not appear its value will be the data that has been entered in the Value property.
0 1   Delta The element is optional and can appear once. If it does not appear, its value will be the data that has been entered in the Value property. If it does appear it must be the value given in the element.
0 2   Delta The element is optional and can appear once, twice or not at all. If the element does not appear it is not provided. If the element appears and it is empty, it set to the data held in the Value property, else it is the value given in the element.
0 0     The element is prohibited and must not appear.
Related concepts
The message model
Related tasks
Working with message model objects
Related reference
Message model object properties
Logical properties for message model objects
Message model object properties by object
Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2007Copyright IBM Corporation 1999, 2007. All Rights Reserved.
This build: July 31, 2007 21:22:18

ad06110_ This topic's URL is: