Queue parameters

The following table describes the queue parameters for Control-M Messaging API.

Parameter

Description

Input Queue

Queue Name

Defines the name of the input queue. Mandatory. For a description of the Browse button, see Selecting JDNI or WSMQ names using the Browse option.

Input Queue Administration

Click Input Queue Administration. The sub-window displays the number of messages currently in the queue. Click Update to refresh this quantity. You can also empty the message queue. Three options are available:

  • Empty queue of all messages
  • Empty queue according to the Correlation ID prefix. For example, enter XYZ to remove all messages with a Correlation ID beginning with XYZ.
  • Empty queue according to a date range criteria

    NOTE: When emptying a queue according to a date range criteria, you must ensure that your computers’ dates are synchronized.

Reply Queue Parameters

Reply queue name

Defines the name of the reply queue.

NOTE: If the incoming message has a ReplyTo queue attribute, the reply message goes to the specified queue, regardless of the specification of this parameter. If the ReplyTo queue attribute in the incoming message is not specified, the reply queue is as specified in this parameter. If this parameter is not specified, no reply message is sent. For a description of the Browse option, see Selecting JDNI or WSMQ names using the Browse option.

NOTE: This value cannot be the same as the destination queue value.

Message Priority

Defines the outgoing message priority. Mandatory.

Value values: Any digit between 0-9 Default: 4

Use input message priority

Checkbox. Optional

If selected, the reply message priority is the same as that of the incoming message. If not selected, the reply message priority is taken from the value specified in the Message priority parameter.

Message expiration time (sec)

Defines the amount of time in seconds before the message expires. Optional.

NOTE: If left blank (default), or a value of 0 is entered, the message will never expire. Maximum length: 7 digits

Parent Topic

Creating a Control-M for Messaging API account