Viewing Channel Connections
When a Universal Messaging client connects to a realm server, the server maintains information about the connection, which is available through the Universal Messaging Administration API. The API also provides mechanisms for receiving notifications when connections are added and deleted (See the code example "Connection Watch" that uses the Administration API).
Connection information is also maintained when Universal Messaging clients subscribe to channels.
The Universal Messaging Enterprise Manager enables you to view the connections (channel subscriptions) on a realm as well as more detailed information about each connection, such as the last event sent or received, and the rate of events sent by and received from each connection.
You view connections for a channel on the Connections tab for the channel. Connections have the following attributes:
Protocol - The protocol used in the connection.
User - The username of the connected user.
Host - The host machine from which the user has connected.
Connection - The local connection ID, defined as
hostname:local_port.
Filter - The filter string for the subscription, if one is provided.
To view details for a channel connection, select the connection and click Show Details. You can view the following information:
Connection Details
The Connection Details panel shows information about the user connection, such as user name, host, protocol, connection ID, and whether multicast is enabled.
Client Environment
The Client Environment panel shows information about the client environment for this user, such as API language/version, host operating system, and Universal Messaging build number.
The Tx Event History and Rx Event History graphs show the total (yellow) and rates (red) for events received from the server (TX) and sent to the server (RX), respectively, for the selected connection.
Events Sent
The Events Sent panel shows the following information:
Total - The total number of events sent by the realm server to this connection.
Rate - The rate at which events are sent by the realm server to this connection.
Max - The maximum rate at which events have been sent by the realm server to this connection.
Last Event Type - The type of the last event sent from the realm server.
Bytes - Total bytes sent by the realm server to this connection.
Events Received
The Events Received panel shows the following information:
Total - The total number of events sent by this connection to the realm server.
Rate - The rate at which events are sent by connection to the realm server.
Max - The maximum rate at which events have been sent by this connection to the realm server.
Last Event Type - The type of the last event sent from the connection to the realm server.
Bytes - Total bytes sent by this connection to the realm server.
Status
The Events Sent panel shows the following information:
Connect Time - The amount of time this connection has been connected to the realm server.
Queue Size - The number of events in the outbound queue of this connection, that is events waiting to be sent to the realm server.
Last Tx - The time since the last event was received by this connection from the realm server.
Last Rx - The time since the last event was sent to the server from this connection.