Machine and Connector Format Names

 

Updated: July 19, 2016

Applies To: Windows 10, Windows 7, Windows 8, Windows 8.1, Windows Server 2008, Windows Server 2008 R2, Windows Server 2012, Windows Server 2012 R2, Windows Server Technical Preview, Windows Vista

Machine format names are used to reference computer journals and dead-letter queues for a specific computer and connector format names are used to reference the connector queues on a connector server.

Machine format names contain the string "MACHINE=" followed by the identifier of the computer and the keyword that identifies which system queue to open. The following is the general form of the machine format names used to open a computer journal, a nontransactional dead-letter queue, and a transactional dead-letter queue:

MACHINE=ComputerGUID;JOURNAL             *Computer journal.  
MACHINE=ComputerGUID;DEADLETTER          *Nontransactional dead-letter queue.  
MACHINE=ComputerGUID;DEADXACT            *Transactional dead-letter queue.  

The following lines of code are examples of computer journal, nontransactional dead-letter queue, and transactional dead-letter queue format name strings (note that the format name strings are null-terminated Unicode strings).

LPWSTR wsz = L"MACHINE=308FB580-1EB2-11CA-923B-08002B1075A7;JOURNAL";  
LPWSTR wsz = L"MACHINE=308FB580-1EB2-11CA-923B-08002B1075A7;DEADLETTER";  
LPWSTR wsz = L"MACHINE=308FB580-1EB2-11CA-923B-08002B1075A7;DEADXACT";  

In MSMQ 2.0 and later, computer journals and dead-letter queues can also be referenced by direct format names.

Connector format names contain the string "CONNECTOR=" followed by the identifier of the foreign enterprise. The foreign identifier is the identifier of the foreign site where the foreign queue resides (for MSMQ 1.0 applications, the identifier is the identifier of the foreign connected network where the foreign queue resides). The following is the general form of the connector format names used to open the nontransactional and transactional connector queue:

CONNECTOR=ForeignCNGUID                 *Connector queue (nontransactional).  
CONNECTOR=ForeignCNGUID;XACTONLY        *Connector queue (transactional).  

The following lines of code are example of nontransactional and transactional connector format name strings (note that the format name strings are null-terminated Unicode strings).

LPWSTR wsz = L"CONNECTOR=308FB580-1EB2-11CA-923B-08002B1075A7";  
LPWSTR wsz = L"CONNECTOR=308FB580-1EB2-11CA-923B-08002B1075A7;XACTONLY";  

For information onSee
Ways to obtain a format nameObtaining Format Names
The elements and syntax of public format namesPublic Format Names
The elements and syntax of private format namesPrivate Format Names
The elements and syntax of distribution list format namesDistribution List Format Names
The elements and syntax of multiple-element format namesMultiple-Element Format Names
The syntax of direct format namesDirect Format Names

Community Additions

ADD
Show: