Ultra Messaging® Configuration Guide
Prev	Chapter 4. Reference	Next

4.28. Event Queue Options

4.28.1. event_queue_name (event_queue)

The name of an event queue, limited to 128 alphanumeric characters, hyphens or underscores.

Scope:	event_queue
Type:	string
When to Set:	Can only be set during object initialization.
Version:	This option was implemented in LBM 4.3/UMP 3.3/UMQ 2.3.

4.28.2. queue_age_enabled (event_queue)

Controls whether the length of time each event spends on the event queue is measured. Useful only if you are monitoring event queue statistics.

Scope:	event_queue
Type:	int
Default value:	0
When to Set:	May be set during operation.

Value	Description
1	Enables measuring of event queue entry ages.
0	Disables measuring of event queue entry ages. Default for all.

4.28.3. queue_cancellation_callbacks_enabled (event_queue)

Flag indicating whether the event queue is to do appropriate locking to provide cancellation callback support for cancel/delete functions.

Scope:	event_queue
Type:	int
When to Set:	Can only be set during object initialization.

Value	Description
1	Provide support for cancellation callbacks.
0	Do not provide cancellation callback support. Default for all.

4.28.4. queue_count_enabled (event_queue)

Controls whether the numbers of each type of queue entry are counted. Useful only if you are monitoring event queue statistics.

Scope:	event_queue
Type:	int
Default value:	0
When to Set:	May be set during operation.

Value	Description
1	Enables counting event queue entries.
0	Disables counting of event queue entries. Default for all.

4.28.5. queue_delay_warning (event_queue)

The event queue delay threshold (in microseconds) at which the monitor function for the event queue is called. This delay is the time that an event has been queued before being dispatched. A value of 0 indicates the event queue delay is not to be monitored and checked.

Scope:	event_queue
Type:	lbm_ulong_t
Units:	microseconds
Default value:	0 (not monitored)
When to Set:	May be set during operation.

4.28.6. queue_enqueue_notification (event_queue)

Flag indicating whether to call the monitor function when an event is enqueued into the given event queue. The thread enqueuing the event is the one that calls this function. So, when this is called, the monitoring function in use should only assume this is only notification of enqueuing. The monitor function should not dispatch events directly.

Scope:	event_queue
Type:	int
When to Set:	May be set during operation.

Value	Description
1	Enable notification.
0	Disable notification. Default for all.

4.28.7. queue_objects_purged_on_close (event_queue)

Flag indicating whether the event queue should be immediately purged of any pending events associated with a recently closed object (e.g. source, receiver) during the close operation, or be left on the queue to be discarded as the event queue drains normally. In either case, UM does not deliver the defunct events to the application. The Immediate purge setting reclaims memory immediately, while the Delay purge. setting spreads the reclamation work over time, reducing the CPU impact of closing objects associated with the queue.

Scope:	event_queue
Type:	int
When to Set:	Can only be set during object initialization.

Value	Description
1	Immediate purge. Default for all.
0	Delay purge.

4.28.8. queue_service_time_enabled (event_queue)

Controls whether the amount of time required to service each event on the event queue is measured. Useful only if you are monitoring event queue statistics.

Scope:	event_queue
Type:	int
Default value:	0
When to Set:	May be set during operation.

Value	Description
1	Enables measuring of event queue service times.
0	Disables measuring of event queue service times. Default for all.

4.28.9. queue_size_warning (event_queue)

The event queue size threshold (in number of events) at which the monitor function for the event queue is called. A value of 0 indicates the event queue size is not to be monitored and checked.

Scope:	event_queue
Type:	lbm_ulong_t
Units:	number of events
Default value:	0 (not monitored)
When to Set:	May be set during operation.

Prev	Home	Next
Wildcard Receiver Options	Up	Ultra Messaging Persistence Options