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

Copyright © Cloud Software Group, Inc. All rights reserved.