DISPATCHER.THREAD_EXITED

Advisory

Subject Name Syntax

_RV.INFO.SYSTEM.DISPATCHER.THREAD_EXITED.thread_name

Purpose

A dispatcher thread exited, producing an error status code.

Remarks

Dispatcher threads are a programmer convenience. Programs that do not use dispatcher threads never present this advisory.

When the dispatcher thread has a name, it appears as the thread_name element of the advisory subject; otherwise a default thread name appears in that position.

The process transport presents this advisory.

If a program is listening for this advisory, the event driver places it on the queue associated with the listener event. It is good practice to use the default queue for this advisory, since it never discards an event.

Message Fields

Field Name

Description

status

The status code.

This field has datatype TIBRVMSG_U32.

description

A string corresponding to the status code.

This field has datatype TIBRVMSG_STRING.

Diagnosis

This advisory reports these program situations:

The dispatch thread exited because its dispatch timeout elapsed; that is, the thread waited for that time period, during which no events were ready for dispatch.
An error occurred while attempting to dispatch the queue or queue group. This status usually indicates that the queue or queue group is destroyed or invalid.
The dispatcher thread was destroyed.

See Also

Dispatcher Threads