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. 

msgProducer has usage pointer.

Parameters

Parameter
Description
msgProducer
Get the property from this producer.
priority
The function stores the property in this location.

Remarks

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

The JMS 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.


TIBCO Enterprise Message Service™ C and COBOL Reference
System Release 4.3, February 2006
Copyright © TIBCO Software Inc. All rights reserved
www.tibco.com