GET_TRANSMISSION_STATUS (Transact-SQL)

**APPLIES TO:** ![yes](media/yes.png)SQL Server (starting with 2008) ![no](media/no.png)Azure SQL Database ![no](media/no.png)Azure SQL Data Warehouse ![no](media/no.png)Parallel Data Warehouse

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

Topic link icon Transact-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.