Quantity (-QTY)

Use the Quantity adapter command (-QTY) to specify the number of messages to retrieve from the source queue. If the Quantity adapter command (-QTY) is not specified, the default value is 1.

-QTY {value|S}
Option
Description
S
This value returns all messages on the queue.
value
This is a positive integer representing the number of concurrent multiple messages to be retrieved.

For example, to specify a quantity of ten messages, the syntax would be:

-QTY 10

The Quantity adapter command (-QTY) defines the maximum number of messages across all bursts for a map.

When the Quantity adapter command (-QTY) is used, the message cursor is not returned to the head of the queue for other source cards in the same map using the identical queue.

The number of bursts in a single map execution can be controlled with the combination of values set in the Map Designer SourceRule > FetchAs > FetchUnit setting and the Quantity adapter command (-QTY).

When using the Quantity adapter command (-QTY) with the S option through either the Launcher or the Command Server, the Listen adapter command (-LSN) is also required with a value specified other than S.