Queue and Computer Administration
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
Message Queuing 3.0 introduces API functions, COM objects and methods, and a new set of queue and computer management properties that can be used to administer Message Queuing programmatically.
As of version 3.0, MSMQ no longer needs to be installed on a domain controller (DC), though you may need to install the MSMQ Downlevel Client Service on a DC to support Windows 2000 clients.
The MQMgmtAction function can be used to connect or disconnect a computer from the network and the directory service, clean up empty message storage files, pause and resume the transmission of messages from an outgoing queue, and resend a pending transaction sequence. The equivalent COM methods are:
Read-Only Management Properties
Another new API function for computer and queue management is MQMgmtGetInfo, which retrieves the new read-only management properties of a computer or a queue. This function receives a MQMGMTPROPS structure, which specifies the properties to be retrieved, as an In parameter. The read-only management properties for a computer and their COM equivalents include:
Indicates whether the queue manager on the computer has been disconnected from the network, and will not attempt to reconnect to the network or to access the directory service.
Returns the name of the current directory service (DS) server for the computer.
Returns a list of the path names of all the private queues registered on the computer.
Returns version and build information for the computer operating system and Message Queuing installation.
New Read-Only Management Properties
The new read-only management properties returned by MQMgmtGetInfo for a specified queue and the equivalent COM properties, which belong to the new MSMQManagement, MSMQQueueManagement, and MSMQOutgoingQueueManagement objects, include:
Returns the number of message bytes in the queue journal.
Returns the number of message bytes in the queue.
Indicates whether the queue is a foreign queue.
Returns the format name of the queue.
Returns the number of messages in the queue journal.
Indicates whether the queue is located on the computer.
Returns the number of messages in the queue.
Returns the address or a list of possible addresses for routing messages to the destination queue in the next hop.
Returns the path name of the queue.
Returns the connection state of the outgoing queue.
Indicates whether the queue is a public, private, system, connector, or multicast outgoing queue.
Indicates whether the queue is transactional.