Label (-LABEL)

Use the Label adapter command (-LABEL) to select a message using a specified message label value for a data source, or to create a message with a specified message label value for a data target. Use the following syntax:

-LABEL message_label

Option

Description

message_label

Specify the application-defined message label, that is represented in MSMQ with the property definition PROPID_M_LABEL. The value can be between 1 and 250 alphanumeric characters. If the value contains spaces it must be enclosed in double quotes.

When the Label adapter command (-LABEL) is used for a data source, it is a filter that selects messages from the queue based upon the message label properties. The MSMQ Adapters do not support Boolean operations on message properties other than AND. However, when a message to be mapped cannot be identified using the two message identification properties, additional message selection criteria can be performed using standard mapping techniques such as conditional mapping expressions, runtime functions, or functional maps.

When the Label adapter command (-LABEL) is used for a data target, the message is generated with the specified filter property. Double quotation marks are not allowed in the LABEL value character string.

Wildcards might be specified for the value of the message_label when running under the Launcher. See "Wildcard Support".