Default Parameters for WsMqChannelTest

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

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

• 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, specify the name of the server connection channel for the WebSphere MQ server. 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 Monitoring Messaging Servers document.

• If SYSTEM channels are to be monitored, then set the IGNORESYSTEMCHANNELS flag to No. If not, set the flag to Yes.

• In the INCLUDE CHANNELS text box, specify a comma-separated list of channel names or channel name patterns to be monitored. For example, your specification can be: *.EG.*,CLNT.JPM.*,*.CSI.SVRCONN. In this case, the test will monitor only those channels with names that embed the string “.EG.”, names that start with “CLNT.JPM”, and names that end with “.CSI.SVRCONN”.

  Note:

  If a SYSTEM channel or a pattern that matches a SYSTEM channel is configured in the INCLUDE CHANNELS text box, then this test will monitor such SYSTEM channels, even if the IGNORESYSTEMCHANNELS flag is set to Yes.

• By default, the IGNORECHANNELS parameter is set to “none”. If so, none of the channels (other than the SYSTEM channels) are ignored while monitoring an MQ server. Otherwise, this parameter represents a comma separated list of pattern of pattern names that should be excluded from monitoring. Any channel name that matches one of the patterns specified for this test will not considered for monitoring by the eG agent. For example, your specification can be: *.DTC.*,CUST.CIT.*. In this case, the test will not monitor all those channels with names that embed the string “.DTC.” and names that begin with “CUST.CIT.”.

• Specify the version the WebSphere MQ server that is being monitored in the MQVERSION text box. For instance, 6 or 7.

• Indicate whether the inactive channels are to be monitored or not, using the SHOWINACTIVECHANNELS flag. If you prefer to monitor the inactive channels, then set this flag to Yes. If not, set this flag to No. By default, this flag is set to No.

• Specify the comma-separated list of inactive channels that are to be excluded for monitoring in the EXCLUDECHANNELS text box. By default, the value of this parameter is none.

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