Message sequence number

Use this property to specify the sequential number of the logical message within a message group.

Each logical message in a message group is assigned a number beginning with 1 for the first message. This number is increased at a rate of one for each new logical message in this group. Physical messages that are not part of a group are all assigned a sequence number of 1.

For input links and request links, this property is available only if you set Header version to 2.

For input links and request links, the default value is 1. You can type a single integer between 1 and 999999999.

For output links, there is no default value. If this value is blank, this property is not used for filtering messages. When you want to filter messages, you can type multiple values in this property.

For output links, you can type the value of this property in different ways:

A list of comma-delimited or space-delimited integers
A range of integers in the following format: a-b
A combination of lists and ranges that are comma-delimited or space-delimited

Each integer must be between 1 and 999999999. The total length of the combined values in this property must not exceed 256 characters. There is no default value. If this value is blank for an output link, the default value for the source message is used.

You can use different ways to specify this value for input links and output links:

Specify the value at the job level. You type the value in this property, which sets the value at design time for all messages in this job. If, for some reason, you also specify the data element as a column in the schema (see below), the data element takes precedence over the property.
For input links, you can specify the value at the message level. Instead of this property, you specify a column in the schema for this value by selecting the corresponding value (see below) as the Data element value on the Columns tab. The value that is stored in each incoming message is then used during runtime processing when it is put on the queue. The value in the input link schema overrides the design-time value of this property at runtime.
For output links, you can view only the value in the Data element column that was retrieved when the message was read from the queue. Generally speaking, you use the data element on an output link when you plan to use this value later on in your job processing.

The data element for this property is WSMQ.MSGSEQNUMBER.