Correlation ID (-CID)

Use the Correlation ID adapter command (-CID) to specify a particular correlation identifier (CID) for a source or target. Use this adapter command for a data source to retrieve messages from a queue with a specific correlation ID. You can also use it for a data target to assign a correlation ID to a message when placing it on a queue. To select a message with a specific correlation identifier, or to assign a specified value to a message for a data target, use the following syntax:

-CID value
Specify the application-defined correlation identifier. The value can be an alphanumeric string containing between 1 and 20 characters. For more information about the content and usage of MSMQ message properties, see the Microsoft MSMQ property definition PROPID_M_CORRELATIONID.

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 Correlation ID adapter command (-CID) and the Label adapter command (-LABEL) to specify the message identification properties PROPID_M_CORRELATIONID and PROPID_M_LABEL, additional message selection criteria can be performed using standard mapping techniques such as conditional mapping expressions, runtime functions, or functional maps.

When the Correlation ID adapter command (-CID) is specified on the command line of an output map card, the message is generated with the specified property.

Wildcards can be specified as the value for the correlation ID when running under the Launcher. See "Wildcard Support".