Machine and Connector Format Names

  • Article

 

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 name syntax

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 name syntax

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 on See
Ways to obtain a format name Obtaining Format Names
The elements and syntax of public format names Public Format Names
The elements and syntax of private format names Private Format Names
The elements and syntax of distribution list format names Distribution List Format Names
The elements and syntax of multiple-element format names Multiple-Element Format Names
The syntax of direct format names Direct Format Names