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. 

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 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