AMH Queue Test

A key component of AMH is the AMH node, which runs a user interface, a database, and a messaging system. The AMH node provides the web front end that runs the user interface and Signal Transfer Point (STP) message processing.

The AMH node runs on JBoss Enterprise Application Platform (EAP) on Red Hat Enterprise Linux (RHEL).
The database runs on Oracle.
The messaging system typically is JMS–compliant messaging service.
Additional virtual machines (HA-VM 1 and HA-VM 2) monitor and maintain the route tables of SAG, NSL, and other components.

The AMH queue ensures that messages are stored until they are used for processing. For reliable delivery of messages it is important to have message queue in operational status.

This test monitors the AMH queues and reports the current status of queue which helps administrators plan the workloads better and ensures system is available and ready to use for important financial transactions.

Target of the test : A Swift AMH messaging node instance

Agent deploying the test : An internal agent

Outputs of the test : One set of results for each JMS Queue in Swift AMH node being monitored.

Configurable parameters for the test
Parameter	Description
Test period	How often should the test be executed.
Host	The host for which the test is to be configured.
Port	The port at which the specified host listens.
SSL	If the JBoss AS/EAP server being monitored is an SSL-enabled server, then set the SSL flag to Yes. If not, then set the SSL flag to No.
JMX Remote Port	Specify the port at which the JMX listens for requests from remote hosts. Ensure that you specify the same port that you configured in the management.properties file in the <JAVA_HOME>\jre\lib\management folder used by the target application Java Applications chapter.
JNDI Name	Specify the lookup name for connecting to the JMX connector of the Swift AMH.
JMX User, JMX Password and Confirm Password	These parameters appear only if the Measurement Mode is set to jmx. If JMX requires authentication only (but no security), then ensure that the JMX User and JMX Password parameters are configured with the credentials of a user with read-write access to JMX. To know how to create this user, refer to the How to Monitor JBoss Application Server Using eG Enterprise? chapter. Confirm the password by retyping it in the Confirm Password text box.

Measures made by the test
Measurement	Description	Measurement Unit	Interpretation
Total size	Indicates the total size of this AMH queue.	Number
Total Processed	Indicates the total number of messages processed through the current queue.	Number
Window size used normal	Indicates the current average window size of current AMH queue.	Number
Execution	Indicates the time it takes for one message to be processed by current AMH queue.	Seconds
Execution time low	Indicates the lowest time it took for the message to be processed by the current AMH queue.	Seconds
Enqueue time low	Indicates the lowest time for which the message was queued before it was picked for processing in current AMH queue.	Seconds
Swap in	Indicates the average time it took to swap the content of another queue with current AMH queue.	Seconds
Batch size	Indicates the current batch size for the current AMH JMS queue.	Number	Batch size is the number of messages which are received and buffered before the processing of messages is invoked.
Sliding time window execution rate	Indicates the current execution rate at which the messages are being processed by the current AMH queue.	Seconds	The sliding window rate is algorithmically adjusted based on the current traffic and congestion status. If the rate is too high it might indicate high network congestion.
Last swapin time high	Indicates the last high time it took to swap the content of another queue with current AMH queue.	Seconds
Window size used low	Indicates how much of the lowest window size is being used in current AMH queue.	Number
Swapin low	Indicates the lowest time it took to swap the content of another queue with current AMH queue.	Seconds
Total size high	Indicates the highest size of the current AMH queue..	Number
Total size low	Indicates the lowest size of the current AMH queue..	Number
Total size normal	Indicates the average size of the current AMH queue..	Number
Window size used high	Indicates how much of the highest window size is being used of the current AMH queue.	Number
Swapin normal	Indicates the average time it took to swap the content of another queue with current AMH queue.	Seconds
Enqueue time high	Indicates the highest time for which the message was queued before it was picked for processing by current AMH queue.	Seconds
Work pending commands scheduled	Indicates the number of command which are pending execution by current AMH queue.	Number
Last swapin time normal	Indicates the last recorded average time it took to swap the content of current queue with current AMH queue.	Number
Enqueue time normal	Indicates the average time for which the message was queued before it was picked for processing by current AMH queue.	Number
Window size used	Indicates how much of the window size is being used for current AMH queue.	Number
Swapin high	Indicates the highest time it took to swap the content of another queue with current AMH queue.	Seconds