Agents Administration - Tests
 

Default Parameters for WsMqLocalQTest

The WsMqLocalQTest connects to a WebSphere MQ server, auto-discovers the local queues that have been configured for this server, and monitors the status of each of the local queues.

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

  • 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.

  • In the NUMDDMESSAGES text box, specify the number of messages to be displayed in the detailed diagnosis information. For instance, if NUMDDMESSAGES is set as 20, then the details for the first 20 messages in the queue will be displayed in detailed diagnosis. If this value is ‘all’ or -1, then every message in the queue will be available as part of the detailed diagnosis information.

  • 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.