Agents Administration - Tests
 

Default Parameters for WsMqChlInstTest

This test connects to a WebSphere MQ server, auto-discovers the channels that have been configured for this server and monitors the instances of each channel. Using this test, administrators can figure out the utilization of the instances in each channel and identify the channel that is overloaded in terms of instances. This test also throws light on the maximum number of instances configured for the channels.

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

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

  • Specify the name of the server connection channel for the WebSphere MQ server in the SERVERCONNCHANNEL text box. The default value is “SYSTEM.DEF.SVRCONN”. If you prefer not to use this default server connection channel for monitoring purposes, then you can create a custom channel in the WebSphere MQ server and use it for monitoring. The steps for achieving this have been detailed in Creating a Custom Channel topic.

  • Specify the full path to the install directory of the IBM WebSphere MQ server in the MQ HOME text box. For example, if the IBM WebSphere MQ server is installed on a Windows operating system, then the path will be C:\Program Files\IBM\WebSphere MQ. On the other hand, if the target server is installed on Linux operating system, then, the path will be /opt/mqm.

  • Specify the full path to the install directory of the Queue Manager in the QUEUE MANAGER HOME text box. For example, if the IBM WebSphere MQ server is installed on a Windows operating system, then, the path will be C:\Program Files\IBM\WebSphere MQ\Qmgrs\MAS!EG!QM1. On the other hand, if the IBM WebSphere MQ is installed on Linux operating system, then, the full path to the Queue Manager Home will be /var/mqm/qmgrs/IB9QMGRx.

  • Specify the time duration (in seconds) beyond which this test should time out in the TIMEOUT text box. The default is 60 seconds.

  • The DD FREQUENCY parameter refers to the frequency with which detailed diagnosis measures are to be generated for this test. The default is 1:1. This indicates that, by default, detailed measures will be generated every time this test runs, and also every time the test detects a problem. You can modify this frequency, if you so desire. Also, if you intend to disable the detailed diagnosis capability for this test, you can do so by specifying none against DD FREQUENCY .

  • Once the above value is 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.