Skip to content

Latest commit

 

History

History
55 lines (49 loc) · 5.66 KB

broker-message-drop-event-class.md

File metadata and controls

55 lines (49 loc) · 5.66 KB
title description author ms.author ms.reviewer ms.date ms.service ms.subservice ms.topic helpviewer_keywords monikerRange
Broker:Message Undeliverable Event Class
Use the Broker:Message Undeliverable event class when Service Broker is unable to retain a received message that should have been delivered to a service in this instance.
WilliamDAssafMSFT
wiassaf
randolphwest
03/30/2025
sql
supportability
reference
Broker:Message Undeliverable event class
>=sql-server-2016 || >=sql-server-linux-2017 || =azuresqldb-mi-current

Broker:Message Undeliverable event class

[!INCLUDE SQL Server SQL MI]

[!INCLUDE ssNoVersion] generates a Broker:Message Undeliverable event when Service Broker is unable to retain a received message that should have been delivered to a service in this instance. For messages that should have been forwarded, see Broker:Forwarded Message Dropped Event Class.

Broker:Message Undeliverable event class data columns

Data column Type Description Column number Filterable
Application Name nvarchar The name of the client application that created the connection to an instance of [!INCLUDE ssNoVersion]. This column is populated with the values passed by the application rather than the displayed name of the program. 10 Yes
BigintData1 bigint The sequence number of the undeliverable message. 52 No
BigintData2 bigint The sequence number of the last message successfully acknowledged. 53 No
ClientProcessID int The ID assigned by the host computer to the process where the client application is running. This data column is populated if the client process ID is provided by the client. 9 Yes
DatabaseID int The ID of the database specified by the USE <database> statement, or the ID of the default database if no USE <database> statement was issued for a given instance. [!INCLUDE ssSqlProfiler] displays the name of the database if the ServerName data column is captured in the trace and the server is available. Determine the value for a database by using the DB_ID function. 3 Yes
Error int The message ID number in sys.messages for the text in the event. 31 No
EventClass int The type of event class captured. Always 160 for Broker:MessageUndeliverable. 27 No
EventSequence int Sequence number for this event. 51 No
EventSubClass nvarchar Indicates whether the undeliverable message was a sequenced message. One of two values:

Sequenced Message. The undeliverable message was a sequenced message.

Unsequenced Message. The undeliverable message wasn't a sequenced message.		 21 Yes
GUID uniqueidentifier The conversation ID of the conversation that the undeliverable message belongs to. This identifier is transmitted as part of the message, and is shared between both sides of the conversation. 54 No
HostName nvarchar The name of the computer on which the client is running. This data column is populated if the host name is provided by the client. To determine the host name, use the HOST_NAME function. 8 Yes
IntegerData int The fragment number of the undeliverable message. 25 No
IntegerData2 int The message fragment number that the undeliverable message was acknowledging. 55 No
IsSystem int Indicates whether the event occurred on a system process or a user process.

0 = user
1 = system		 60 No
LoginName nvarchar The name of the login of the user (either [!INCLUDE ssNoVersion] security login or the Windows login credentials in the form of <DOMAIN>\<Username>). 11 No
LoginSid image The security identification number (SID) of the logged-in user. Each SID is unique for each login in the server. 41 Yes
NTDomainName nvarchar The Windows domain to which the user belongs. 7 Yes
NTUserName nvarchar The name of the user that owns the connection that generated this event. 6 Yes
ObjectName nvarchar The conversation handle of the dialog. 34 No
RoleName nvarchar The role of the conversation handle. This is either initiator or target. 38 No
ServerName nvarchar The name of the instance of [!INCLUDE ssNoVersion] being traced. 26 No
Severity int Severity number for the text in the event. 29 No
SPID int The session ID assigned by [!INCLUDE ssNoVersion] to the process associated with the client. 12 Yes
StartTime datetime Specifies time at which the event started, when available. 14 Yes
State int Indicates the location within the [!INCLUDE ssNoVersion] source code that produced the event. Each location that might produce this event has a different state code. A Microsoft support engineer can use this state code to find where the event was produced. 30 No
TextData ntext The reason that [!INCLUDE ssNoVersion] couldn't deliver the message. 1 Yes
TransactionID bigint The system-assigned ID of the transaction. 4 No

Related content