Configuration of 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. The parameters associated with this will be displayed at the bottom of this page.

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

• In the HOST text box, the host name of the server for which the test is to be configured has to be specified.

• The port number to which the selected server is listening has to be specified in the PORT text box. 

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

• If multiple components of the same component type are awaiting configuration, then an APPLY TO OTHER COMPONENTS check box will appear in this page. Clicking on this check box will allow you to apply the configuration to all/selected components of that type.

• Once the necessary values have been provided, clicking on the UPDATE button will register the changes made.

When changing the configuration for specific servers, a “*” beside the text box corresponding to the parameter signifies that these values have to be manually configured by the user. The parameter values that require to be configured will typically be prefixed with a “$” or contain a series of “*”. A value of "none" in the parameter value indicates that the corresponding parameter value can be changed if required.