TechNet
Export (0) Print
Expand All

Broker:Conversation Event Class

 

Applies To: SQL Server 2016

SQL Server generates a Broker:Conversation event to report the progress of a Service Broker conversation.

Data columnTypeDescriptionColumn numberFilterable
ApplicationNamenvarcharThe name of the client application that created the connection to an instance of SQL Server. This column is populated with the values passed by the application instead of the displayed name of the program.10Yes
ClientProcessIDintThe 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.9Yes
DatabaseIDintThe ID of the database that is specified by the USE database statement. If no USE databasestatement has been issued, the ID of the default database. SQL Server Profiler 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.3Yes
EventClassintThe type of event class captured. Always 124 for Broker:Conversation.27No
EventSequenceintSequence number for this event.51No
EventSubClassnvarcharThe type of event subclass. This provides more information about each event class.21Yes
GUIDuniqueidentifierThe conversation ID of the dialog. This identifier is transmitted as part of the message, and is shared between both sides of the conversation.54No
HostNamenvarcharThe 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.8Yes
IsSystemintIndicates whether the event occurred on a system process or a user process.

0 = user

1 = system
60No
LoginSidimageThe security identification number (SID) of the logged-in user. Each SID is unique for each login in the server.41Yes
MethodNamenvarcharThe conversation group that the conversation belongs to.47No
NTDomainNamenvarcharThe Windows domain to which the user belongs.7Yes
NTUserNamenvarcharThe name of the user that owns the connection that generated this event.6Yes
ObjectNamenvarcharThe conversation handle of the dialog.34No
PriorityintThe priority level of the conversation5Yes
RoleNamenvarcharThe role of the conversation handle. This is either initiator or target.38No
ServerNamenvarcharThe name of the instance of SQL Server that is being traced.26No
SeverityintThe SQL Server error severity, if this event reports an error.29No
SPIDintThe server process ID that is assigned by SQL Server to the process that is associated with the client.12Yes
StartTimedatetimeThe time when the event started, when available.14Yes
TextDatantextThe current state of the conversation. Can have one of the following values:1Yes
SO. Started outbound. SQL Server processed a BEGIN CONVERSATION for this conversation, but no messages have been sent.
SI. Started inbound. Another instance of the Database Engine started a new conversation with the current instance, but the current instance has not finished receiving the first message. SQL Server might create the conversation in this state if the first message is fragmented or SQL Server receives messages out of order. However, SQL Server might create the conversation in the CO state if the first transmission that was received for the conversation contains the complete first message.
CO. Conversing. The conversation is established, and both sides of the conversation can send messages. Most communication for a typical service happens when the conversation is in this state.
DI. Disconnected inbound. The remote side of the conversation has issued an END CONVERSATION. The conversation remains in this state until the local side of the conversation issues an END CONVERSATION. An application can still receive messages for the conversation. Because the remote side of the conversation has ended the conversation, an application cannot send messages on this conversation. When an application issues an END CONVERSATION, the conversation moves to the Closed (CD) state.
DO. Disconnected outbound. The local side of the conversation has issued an END CONVERSATION. The conversation remains in this state until the remote side of the conversation acknowledges the END CONVERSATION. An application cannot send or receive messages for the conversation. When the remote side of the conversation acknowledges the END CONVERSATION, the conversation moves to the Closed (CD) state.
ER. Error. An error has occurred on this endpoint. The Error, Severity, and State columns contain information about the specific error that occurred.
CD. Closed. The conversation endpoint is no longer in use.
Transaction IDbigintThe system-assigned ID of the transaction.4No

The following table lists the subclass values for this event class.

IDSubclassDescription
1SEND MessageSQL Server generates a SEND Message event when the Database Engine executes a SEND statement.
2END CONVERSATIONSQL Server generates an END CONVERSATION event when the Database Engine executes an END CONVERSATION statement that does not include the WITH ERROR clause.
3END CONVERSATION WITH ERRORSQL Server generates an END CONVERSATION WITH ERROR event when the Database Engine executes an END CONVERSATION statement that includes the WITH ERROR clause.
4Broker Initiated ErrorSQL Server generates a Broker Initiated Error event whenever Service Broker creates an error message. For example, when Service Broker cannot successfully route a message for a dialog, the broker creates an error message for the dialog and generates this event. SQL Server does not generate this event when an application program ends a conversation with an error.
5Terminate DialogService Broker terminated the dialog. Service Broker terminates dialogs in response to conditions that prevent the dialog from continuing, but which are not errors or the normal end of a conversation. For example, dropping a service causes Service Broker to terminate all dialogs for that service.
6Received Sequenced MessageSQL Server generates a Received Sequenced Message event class when SQL Server receives a message that contains a message sequence number. All user-defined message types are sequenced messages. Service Broker generates an unsequenced message in two cases:

Error messages generated by Service Broker are unsequenced.

Message acknowledgements might be unsequenced. For efficiency, Service Broker includes message any available acknowledgement as part of a sequenced message . However, if an application does not send a sequenced message to the remote endpoint within a certain period of time, Service Broker creates an unsequenced message for the message acknowledgement.
7Received END CONVERSATIONSQL Server generates a Received END CONVERSATION event when SQL Server receives an End Dialog message from the other side of the conversation.
8Received END CONVERSATION WITH ERRORSQL Server generates a Received END CONVERSATION WITH ERROR event when SQL Server receives a user-defined error from the other side of the conversation. SQL Server does not generate this event when SQL Server receives a broker-defined error.
9Received Broker Error MessageSQL Server generates a Received Broker Error Message event when Service Broker receives a broker-defined error message from the other side of the conversation. SQL Server does not generate this event when Service Broker receives an error message that was generated by an application.

For example, if the current database contains a default route to a forwarding database, Service Broker routes a message with an unknown service name to the forwarding database. If that database cannot route the message, the broker in that database creates an error message and returns that error message to the current database. When the current database receives the broker-generated error from the forwarding database, the current database generates a Received Broker Error Message event.
10Received END CONVERSATION AckSQL Server generates a Received END CONVERSATION Ack event class when the other side of a conversation acknowledges an End Dialog or Error message sent by this side of the conversation.
11BEGIN DIALOGSQL Server generates a BEGIN DIALOG event when the Database Engine executes a BEGIN DIALOG command.
12Dialog CreatedSQL Server generates a Dialog Created event when Service Broker creates an endpoint for a dialog. Service Broker creates an endpoint whenever a new dialog is established, regardless of whether the current database is the initiator or the target of the dialog.
13END CONVERSATION WITH CLEANUPSQL Server generates an END CONVERSATION WITH CLEANUP event when the Database Engine executes an END CONVERSATION statement that includes the WITH CLEANUP clause.

SQL Server Service Broker

Community Additions

ADD
Show:
© 2016 Microsoft