GET_TRANSMISSION_STATUS (Transact-SQL)

Returns the status for the last transmission for one side of a conversation.

Topic link iconTransact-SQL Syntax Conventions

Syntax

GET_TRANSMISSION_STATUS (conversation_handle)

Arguments

  • conversation_id
    Is the conversation handle for the conversation. This parameter is of type uniqueidentifier.

Return Types

nchar

Remarks

Returns a string describing the status of the last transmission attempt for the specified conversation. Returns an empty string if the last transmission attempt succeeded, if no transmission attempt has yet been made, or if the conversation_handle does not exist.

The information returned by this function is the same information displayed in the last_transmission_error column of the management view sys.transmission_queue. However, this function can be used to find the transmission status for conversations that do not currently have messages in the transmission queue.

Note

GET_TRANSMISSION_STATUS does not provide information for messages that do not have a conversation endpoint in the current instance. That is, no information is available for messages to be forwarded.

Examples

The following example reports the transmission status for the conversation with the conversation handle 58ef1d2d-c405-42eb-a762-23ff320bddf0.

SELECT Status =
    GET_TRANSMISSION_STATUS('58ef1d2d-c405-42eb-a762-23ff320bddf0') ;

Here is a sample result set, edited for line length:

Status

-------------------------------

The Service Broker protocol transport is disabled or not configured.

In this case, SQL Server is not configured to allow Service Broker to communicate over the network.