tibemsMsgProducer_GetPriority

Function

Purpose

Get the priority property of a producer object.

C Declaration

tibems_status tibemsMsgProducer_GetPriority(
    tibemsMsgProducer msgProducer,
    tibems_int* priority );

COBOL Call

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

Parameters

Parameter Description
msgProducer Get the property from this producer.
priority Store the property in this location.

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.