FMQ Queues Test

This test tracks various statistics pertaining to the queues on a FioranoMQ server.

Target of the test : A FioranoMQ Server

Agent deploying the test : An internal agent

Outputs of the test : One set of results for every queue on a FioranoMQ server.

Configurable parameters for the test
Parameter Description

Test Period

How often should the test be executed.

Host

The IP address of the host for which this test is to be configured.

Port

The port at which the specified host listens.

HomeDir

The location of the directory in which the FioranoMQ server has been installed. For example, the HomeDir for a Windows installation of the FioranoMQ server will be of the following format: C:\PROGRA~1\Fiorano\FIORAN~1.0. The format for a Unix installation will be: /user/egurkha/Fiorano/FioranoMQ7.0.

SvrBinDir

The full path to the bin directory of the FioranoMQ server installation that contains the file ConnectionManager.xmlin FioranoMQ server 6.0, or the FMQListeners.xmlin the FioranoMQ7.0. These files, which are required for starting the respective FioranoMQ servers, also help the test in determining the version number of the FioranoMQ server (whether 6 or 7). For example, the svrbindir for a Windows installation of the server will be of the format: C:\PROGRA~1\Fiorano\FIORAN~1.0\bin. The format for Unix installations will be: /user/egurkha/Fiorano/FioranoMQ7.0/bin.

ServerMode

The mode in which the FioranoMQ server is running. This parameter can take any of the following values:

  • tcp: In this mode, the FioranoMQ server accepts non-secure TCP connections. This is the default value for ServerMode parameter.
  • ssljsse: In this mode, the FioranoMQ server accepts secure connections which are serviced using Sun's JSSE implementation.
  • sslphaos: In this mode, the FioranoMQ server accepts secure TCP connections and secure connections using Phaos.
  • http: In this mode, the FioranoMQ server accepts non-secure HTTP connections.
  • httpjsse: In this mode, the FioranoMQ server accepts secure HTTPS connections which are serviced using Sun's JSSE implementation.
  • httpphaos: In this mode, the FioranoMQ server accepts secure HTTPS connections using Phaos.

AdminID

The user name of the FioranoMQ server's administrator. The default is "admin".

Admin Password

The password corresponding to the specified admin user.

Confirm Password

Confirm the password by retyping it here.

ACF

ACF stands for Admin Connection Factory object. Specify the name of an existing ACF object in this text box. This object is used to obtain a handle to an Admin connection.

TCF

TCF stands for Topic Connection Factory object. Specify the name of an existing TCF object in this text box.  This object is used to set up a connection with the provider.

TrustStore

The truststore or keystore database which the JVM uses to verify certificates. For example, this parameter can take the value c:\FioranoMQ\bin\jssecacerts on Windows (on Unix, the path would be expressed as: /user/egurkha/Fiorano/FioranoMQ7.0/bin/jssecacerts), where jssecacerts is the truststore database which the JVM uses.

Note:

Refer to page How to find the ServerMode, ACF and TCF parameters for a FioranoMQ server? to know the values of the ServerMode, ACF and TCF test parameters.

Measurements made by the test
Measurement Description Measurement Unit Interpretation

Total deliverable messages

The number of messages in the queue that are awaiting delivery

Number

If the value of this measure has been consistently high, then it indicates that the receivers are not receiving the messages in the queue. This could be due to either of the following reasons:

  • The client may not be active to receive messages
  • The client may be unable to connect to the server

Total undeleted messages

The number of undeleted messages in the queue. Undeleted messages are those for which the server has not received acknowledgment from the client.

Number

MQ servers mostly consider a message as delivered only if an acknowledgment is received from the client after delivery. Undeleted messages are those messages for which the MQ server has not received the acknowledgment from the client, and are waiting for deletion from the queue.

Too many undeleted messages could unnecessarily burden the server and seriously hamper performance.  Alternately it can mean that due to some reasons the clients are not able to connect/send acknowledgment to the FioranoMQ server.