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 returns all messages on the queue.

value

This is a positive integer representing the total number of 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 that use the same queue. The number of bursts in a single map invocation can be controlled using 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.