tibemsMsgProducer_SetPriority

Function

Purpose

Set the priority property of a producer object.

C Declaration

tibems_status tibemsMsgProducer_SetPriority(
    tibemsMsgProducer msgProducer,
    tibems_int priority );

COBOL Call

CALL "tibemsMsgProducer_SetPriority"
     USING BY VALUE msgProducer,
           BY VALUE priority,
           RETURNING tibems-status
END-CALL.
Note: msgProducer has usage pointer.

Parameters

Parameter Description
msgProducer Set the property of this producer.
priority Set the property to this value.

Remarks

Priority affects the order in which the server delivers messages to consumers (higher values first).

The Jakarta Messaging specification defines ten levels of priority value, from zero (lowest priority) to 9 (highest priority). The specification suggests that clients consider 0–4 as gradations of normal priority, and priorities 5–9 as gradations of expedited priority.

Programs can use this property to define a default priority for messages that this producer sends. Individual sending calls can override this default value.