Copyright © TIBCO Software Inc. All Rights Reserved

> tibemsMsg_GetPriority
> Function
> Purpose
> Get the priority header from a message.
> C Declaration
> tibems_status tibemsMsg_GetPriority(
> tibemsMsg message,
> tibems_int* value );
> COBOL Call
> CALL "tibemsMsg_GetPriority"
> USING BY VALUE message,
> BY REFERENCE value,
> RETURNING tibems-status
> END-CALL.

> | message has usage pointer.

> Parameters

> Parameter | Description
> message | Get the priority from this message.
> value | The function stores the priority in this location.

> Remarks
> Sending calls record the priority of a message in this header, based on either a property of the producer, or on a parameter to the send call.
> 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.
> Priority affects the order in which the server delivers messages to consumers (higher values first). The JMS specification does not require all providers to implement priority ordering of messages. (EMS supports priorities, but other JMS providers might not.)
> See Also
> tibemsMsg_SetPriority on page 65
> tibemsMsgProducer_Send on page 184
> tibemsMsgProducer_SetPriority on page 192

Copyright © TIBCO Software Inc. All Rights Reserved