WMQ Message Handle Setup (Magic xpa 3.x)
The WMQ Message Handle Setup program sets up the message, setting properties that are different from the defaults. When this program is called, the new settings are used in every subsequent Send / Receive message. The parameters and return value for the WMQ Message Handle Setup program are:
|
|
|
|
Queue Handle
|
Numeric (18). Input. The numeric value that was returned from the WMQ.Open Destination program.
|
|
Persistence
|
Alpha (1). Indicates whether the message survives system failures. The valid values are:
|
|
Msg Life Time
|
Numeric (N10). The message lifespan. The valid values are:
|
|
Msg Priority
|
Numeric (2). The message priority can range from 0, the lowest priority, to 9, the highest priority. The default is 0.
|
|
Group ID
|
BLOB. Optional input. Identifies a group of messages to be processed together.
Note: The maximum size is 24 bytes.
For specifying a NULL Group ID, use the following keyword: MG_NULL_ID.
|
|
Start Sequence ID
|
Numeric (N10). Specifies the start sequence number of the message in the group. If this is zero and the Group ID has a value, the component will handle and increase the value accordingly. This will begin from this value for each open queue.
|
|
Message Fetch Order
|
Alpha (1). The order in which messages are read when the order is different from the order in the Open Queue mode. The valid values are:
|
|
Message Fetch Mode
|
Alpha (1). Determines how to handle read messages. The valid values are:
|
|
Return value
|
Numeric. 0 for success and a negative value for failure.
|
