Default Parameters for WsMqQDetailsTest

The WsMqQDetailsTest monitors connects to a WebSphere MQ server, auto-discovers the local queues that have been configured for this server, and provides detailed reports on the messages being added to and removed from each of the local queues.

This page depicts the default parameters that need to be configured for the WsMqQDetailsTest.

• The TEST PERIOD list box helps the user to decide how often this test needs to be executed.

• If you want to login as a specific MQ user to execute this test, then specify a valid user name in the USER text box. The test will fail if an invalid user name is specified here. If no such authentication is required, then this parameter can be set to ‘none’.

• If a specific USER is entered, then the password of that user has to be specified in the PASSWORD text box.

• Confirm the password by retyping it in the CONFIRM PASSWORD text box.

• In the SERVERCONNCHANNEL text box, enter the name of the server connection channel for the WebSphere MQ server. The default value is “SYSTEM.DEF.SVRCONN”.

• If SYSTEM queues are to be monitored, then set the IGNORESYSTEMQUEUES flag to False. If not, set the flag to True.

• The IGNOREQUEUES parameter takes a default value of “none”. If so, none of the queues (other than the SYSTEM queues) are ignored while monitoring an MQ server. Otherwise, this parameter represents a comma separated list of patterns. Any queue name that matches one of the patterns specified for a test is not considered for monitoring by the eG agent.

• Specify a comma separated list of patterns that are to be included in the scope of monitoring in the INCLUDE QUEUES text box. By default, this parameter takes a value of none.

• The DELAYLIMIT denotes the time limit beyond which the eG agent regards a message as a delayed message. For e.g., if the delayLimit is 300, the eG agent will regard all messages that have remained in the queue for 5 mins or more as a delayed message.

• Specify the number of messages to be displayed in the detailed diagnosis of the test against the NUMDDMESSAGES parameter.

• When the number of messages lying in the queues exceed a limit specified in the MESSAGELIMIT text box, an alert will be generated to notify administrator of large number of messages be kept in the queues.

• Once the necessary value has been been provided, click on the UPDATE button to register the changes made.

When changing default configurations of tests, the values with “$” indicate variables that will be replaced by the eG system according to the specific server being managed - for instance, $hostName is the host/nickname of the target host, $port is the port number of the server being monitored. E.g., for a server xyz:80, $hostName will be changed automatically by the eG manager to “xyz” and $port will be changed to “80” when configuring a test.