Software AG Products 10.7 | Integrate Software AG Products Using Digital Event Services | Using Digital Event Services to Communicate between Software AG Products | Digital Event Services MBeans | Universal Messaging Service MBean
 
Universal Messaging Service MBean
Retrieves information about the Universal Messaging (UM) services configured in a service group that is associated with an event type.
MBean Name
com.softwareag.events.routing:type=EventTypes,eventType=event_type_name,
category=Services,serviceName=service_name
where event_type_name is the name of the event type and service_name is the name of the Universal Messaging service.
MBean Attributes
The following table lists the attributes of the Universal Messaging Service MBean and their descriptions:
Attribute
Description
name
String. The name of the service.
usage
String. The usage of the service. Values are:
*SourceOnly - you can subscribe to the service, but you cannot use the service to send events.
*DestinationOnly - you can use the service to only send events.
*SourceAndDestination - you can both subscribe to the service and use the service to send events.
providerUrl
String. The URL of the Universal Messaging server. The providerUrl attribute has the following format: protocol://host: port. The default value is nsp://localhost:9000.
connected
Boolean. Indicates whether the service is connected to the configured Universal Messaging server.
connectTime
Instant. The time when the service connected to the Universal Messaging server, or reconnected to the server after losing connection.
disconnectTime
Instant. The time when the service disconnected from the Universal Messaging server.
activeExclusiveDurable-SubscribersCount
Integer. The number of active exclusive durable subscribers to the service. If the service usage is DestinationOnly, the value of this attribute is empty.
activeExclusiveDurable-SubscribersIds
List<String>. The identifiers of the active exclusive durable subscribers to the service. If the service usage is DestinationOnly, the value of this attribute is empty.
activeSharedDurable-SubscribersCount
Integer. The number of active shared durable subscribers to the service. If the service usage is DestinationOnly, the value of this attribute is empty.
activeSharedDurable-SubscribersIds
List<String>. The identifiers of the active shared durable subscribers to the service. If the service usage is DestinationOnly, the value of this attribute is empty.
activeSerialDurable-SubscribersCount
Integer. The number of active serial durable subscribers to the service. If the service usage is DestinationOnly, the value of this attribute is empty.
activeSerialDurable-SubscribersIds
List<String>. The identifiers of the active serial durable subscribers to the service. If the service usage is DestinationOnly, the value of this attribute is empty.
inactiveExclusiveDurable-SubscribersCount
Integer. The number of exclusive durable subscribers to the service that are inactive but still subscribed. If the service usage is DestinationOnly, the value of this attribute is empty.
inactiveExclusiveDurable-SubscribersIds
List<String>. The identifiers of the exclusive durable subscribers to the service that are inactive but still subscribed. If the service usage is DestinationOnly, the value of this attribute is empty.
inactiveSharedDurable-SubscribersCount
Integer. The number of shared durable subscribers to this service that are inactive but still subscribed. If the service usage is DestinationOnly, the value of this attribute is empty.
inactiveSharedDurable-SubscribersIds
List<String>. The identifiers of the shared durable subscribers to the service that are inactive, but still subscribed. If the service usage is DestinationOnly, the value of this attribute is empty.
inactiveSerialDurable-SubscribersCount
Integer. The number of serial durable subscribers to the service that are inactive but still subscribed. If the service usage is DestinationOnly, the value of this attribute is empty.
inactiveSerialDurable-SubscribersIds
List<String>. The identifiers of the serial durable subscribers to the service that are inactive but still subscribed. If the service usage is DestinationOnly, the value of this attribute is empty.
nonDurable-SubscribersCount
Integer. The number of non-durable subscribers to the service. If the service usage is DestinationOnly, the value of this attribute is empty.
receivedEvents
Long. The number of events received by all subscribers to the service since the service became active. If the service usage is DestinationOnly, the value of this attribute is empty.
lastSendingStatus
String. The status of the last sending operation performed by the service. Values are:
*Green - when the last sending operation to the Universal Messaging server is successful.
*Red - when the last sending operation to the Universal Messaging server failed. Possible reasons for a Red sending status are:
*The Universal Messaging server is unavailable.
*The Universal Messaging server is overloaded and responds with a delay.
*The events that DES sends exceed the capacity of the Universal Messaging channel in use.
*There is no network connectivity or it is slow.
Important:
If the Universal Messaging server becomes unavailable, but no events are sent for long time, the lastSendingStatus might still be Green because the status is updated only after a transaction to the server.
To determine whether the server is available without sending events, check the connected, connectTime, and disconnectTime attributes.
lastSendingStatusDetails
String. Information about the last sending status. When the status is Red, the explanation contains the exception that caused the sending operation to fail.
sentEvents
Long. The number of events sent to the service. If the service usage is SourceOnly, the value of this attribute is empty.
acknowledgedSentEvents
Long. The number of events sent to the service and successfully acknowledged by the Universal Messaging server. If the service usage is SourceOnly, the value of this attribute is empty.
lastSendingTime
Instant. The time when the last event was sent to the Universal Messaging server.
Note:
The lastSendingTime attribute reflects the time when an event was last sent to the destination service. The lastSendingTime attribute does not carry information about whether an event was acknowledged by the destination service.
To see whether an event was acknowledged by the destination service, check the lastCompletedAcknowledgementTime attribute.
lastCompletedAcknowled-gementTime
Instant. The last time when an event sent to the service was successfully acknowledged by the Universal Messaging server. If the service usage is SourceOnly, the value of this attribute is empty.
regularDelivery-InterruptionsCount
Integer. The number of times when the service switched to redelivery mode because of a failure to deliver an event to the Universal Messaging server. If the service usage is SourceOnly, the value of this attribute is empty.