Export (0) Print
Expand All
Expand Minimize

Message Queue Task Editor (Receive Page)

Use the Receive page of the Message Queue Task Editor dialog box to configure a Message Queue task to receive Microsoft Message Queuing (MSMQ) messages.

To learn about this task, see Message Queue Task.

RemoveFromMessageQueue

Indicate whether to remove the message from the queue after it is received. By default, this value is set to False.

ErrorIfMessageTimeOut

Indicate whether the task fails when the message times out, displaying an error message. The default is False.

TimeoutAfter

If you choose to display an error message on task failure, specify the number of seconds to wait before displaying the time-out message.

MessageType

Select the message type. This property has the options listed in the following table.

Value

Description

Data file message

The message is stored in a file. Selecting the value displays the dynamic option, DataFileMessage.

Variable message

The message is stored in a variable. Selecting the value displays the dynamic option, VariableMessage.

String message

The message is stored in the Message Queue task. Selecting the value displays the dynamic option, StringMessage.

String message to variable

The message

Selecting the value displays the dynamic option, StringMessage.

MessageType = Data file message

SaveFileAs

Type the path of the file to use, or click the ellipsis button (…) and then locate the file.

Overwrite

Indicate whether to overwrite the data in an existing file when saving the contents of a data file message. The default is False.

Filter

Specify whether to apply a filter to the message. This property has the options listed in the following table.

Value

Description

No filter

The task does not filter messages. Selecting the value displays the dynamic option, IdentifierReadOnly.

From package

The message receives only messages from the specified package. Selecting the value displays the dynamic option, Identifier.

Filter Dynamic Options

Filter = No filter

IdentifierReadOnly

This option is read-only. It may be blank or contain the GUID of a package when the Filter property was previously set.

Filter = From package

Identifier

If you choose to apply a filter, type the unique identifier of the package from which messages can be received, or click the ellipsis button (…) and then specify the package.

Related Topics: Select a Package

MessageType = Variable message

Filter

Specify whether to apply a filter to messages. This property has the options listed in the following table.

Value

Description

No filter

The task does not filter messages. Selecting the value displays the dynamic option, IdentifierReadOnly.

From package

The message receives only messages from the specified package. Selecting the value displays the dynamic option, Identifier.

Variable

Type the variable name, or click <New variable…> and then configure a new variable.

Related Topics: Add Variable

Filter Dynamic Options

Filter = No filter

IdentifierReadOnly

This option is blank.

Filter = From package

Identifier

If you choose to apply a filter, type the unique identifier of the package from which messages can be received, or click the ellipsis button (…) and then specify the package.

Related Topics: Select a Package

MessageType = String message

Compare

Specify whether to apply a filter to messages. This property has the options listed in the following table.

Value

Description

None

Messages are not compared.

Exact match

Messages must match exactly the string in the CompareString option.

Ignore case

Message must match the string in the CompareString option, but the comparison is not case sensitive.

Containing

Message must contain the string in the CompareString option.

CompareString

Unless the Compare option is set to None, provide the string to which the message is compared.

MessageType = String message to variable

Compare

Specify whether to apply a filter to messages. This property has the options listed in the following table.

Value

Description

None

Messages are not compared.

Exact match

The message must match exactly the string in the CompareString option.

Ignore case

The message must match the string in the CompareString option but the comparison is not case sensitive.

Containing

The message must contain the string in the CompareString option.

CompareString

Unless the Compare option is set to None, provide the string to which the message is compared.

Variable

Type the name of the variable to hold the received message, or click <New variable…> and then configure a new variable.

Related Topics: Add Variable

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft