This section describes the required configurations as well as the optional configurations available for the Solution Package for IBM MQ in the RTView Configuration Application. You must define the classpath to the IBM MQ jar files and you must also define data source connections for each connection that you want to monitor.

Configuring Data Collection

Note: See Creating Secure Connections for additional information on creating secure connections to IBM MQ.

To configure data collection:

• Navigate to the Solution Package Configuration > IBM MQ > CONNECTIONS tab.
• On the CONNECTIONS tab, provide the correct full path to the directory containing the IBM MQ jar files in the Classpath field.

• Click the  icon.

The Add Connection dialog displays.

• Specify the connection information and click SAVE where:

Connection Name: Name to use when referencing this connection.

Host: Name or IP address of the host computer.

Port: Port number of the connection.

Username: If necessary, enter the username required to access your connection.

Password: If necessary, enter the password required to access your connection.

SSL Connection

Do you want to connect using SSL?: Selecting Yes allows you to specify SSL connections to your specified host using the following fields:

Trusted Certificate Store Name: Enter the trusted certificate store name.

Trusted Certificate Store Password: Enter the trusted certificate store password.

Personal Certificate Store Name: Enter the personal certificate store name.

Personal Certificate Store Password: Enter the personal certificate store password.

SSL Cipher Suite: Enter the name of the SSL Cipher Suite.

Channel: Client Channel to use for this connection (use SYSTEM.DEF.SVRCONN).

Model Queue Name: Named model queue of the connection.

Handler Class: Specify the user-defined handler class name you want to use for the connection.

Wait Interval: Wait interval (in seconds) between attempts to create a connection. The default value is 10 seconds.

Retry Interval: Minimum interval (in seconds) between connection retry attempts. The default value is 30 seconds.

Max Retries: Maximum number of subsequent connection retry attempts. A retry will only be attempted when the initial connection failed or when a broken connection error has occurred. When a successful connection has been made, the connection attempt counter is reset to zero. If set to 0, only an initial connect attempt is made for this connection. If set to -1, unlimited connection attempts will be made until a connection is established, which may be useful when MQ servers are cycled for maintenance, or the servers are expected to be down for a period of time and a connection is wanted when the servers come back up. The default value is 5.

Expiry: The time (in seconds) in which the attempt to connect to the data source will expire. The default value is -1, which means the connection will not expire.

Once saved, the new connection displays in the Connections region on the CONNECTIONS tab.

• Repeat the previous two steps for each connection to be monitored.

• You can optionally define queue, channel, topic object, topic string name, and subscription name filters in the Filters region on the DATA COLLECTION tab. The filter name displays in the field after entering the name and typing a comma or by clicking the Tab or Enter key. You can enter more than one filter in each field. Once the filter is specified, you can delete the filter by clicking the X next to the name. The following table lists the filters and their associated caches:

• If you want to modify the default values for the update rates for the IBM MQ caches, you can update the default polling rates in the Solution Package Configuration > IBM MQ > DATA COLLECTION > Poll Rates region.