Configuring a WebSphere MQ observation point

To configure an observation point for IBM® WebSphere® MQ, you must specify enough information so that HCL OneTest™ API can connect to the IBM WebSphere MQ server.

Before you begin

The HCL OneTest API MQ Exit must be installed on the WebSphere MQ server before you can configure a WebSphere MQ observation point.


  1. To add an observation point that is not registered with HCL Quality Server, locate the Configurable table and click the Add... icon
  2. On the Observation point type page, click Next. WebSphere MQ is the only configurable observation point that can be added.
  3. On the Observation point configuration page, enter the configuration information for your WebSphere MQ server. The following table shows the requested information. All fields are optional unless labeled otherwise.
    Table 1. Configuration fields for WebSphere MQ
    Field Description
    Name Required: Specify a free-form name to describe this WebSphere MQ observation point.
    Populate from existing resource Click to copy settings from an existing WebSphere MQ physical resource in the current project. A list of available resources is displayed. Select a resource and click OK to complete the Host, Port, Channel, and Queue Manager fields automatically.
    Test connection Click to verify that a connection to WebSphere MQ can be made based on the provided settings.
    Settings page
    Host Required: Specify the host name or IP address of the WebSphere MQ server.
    Port Required: Specify the port number where WebSphere MQ is listening (the default is 1414).
    Channel Required: Specify the name of the WebSphere MQ communication channel that is used for sending and receiving messages. This name is case sensitive and must be a Server Connection type because HCL OneTest API is a client application.
    Queue Manager Required: Specify the case-sensitive name of the WebSphere MQ queue manager to use.
    Username Specify the ID of the user who is sending or receiving messages from HCL OneTest API.
    Password Specify the password (if required) associated with the user name.
    Application Name This field is preset to RIT Discovery, but can be changed.
    Application Type This field is preset to MQSeries.
    Properties A set of properties that defines the connection. Click the New icon and specify a case-sensitive name, type, and value for each property to be added. You can edit or delete any displayed properties.
    Note: The property type must match that of the property selected. If you are unsure as to which property type to select, use String.
    SSL page
    Peer Name Specify the distinguished name (DN) of the queue manager to be used by SSL. The queue manager identifies itself by using an SSL certificate, which contains a DN. HCL OneTest API can use this DN to ensure that it is communicating with the correct queue manager.

    In WebSphere MQ, a DN pattern is specified by using the sslPeerName variable of the MQEnvironment class. Connections succeed only if Peer Name matches the specified pattern.

    Cipher Suite Select one of the available cipher suites to encrypt the transport communications.
    Fips Required Select if the requested cipher suite must use FIPS-certified cryptography in WebSphere MQ.
    KeyResetCount The total number of unencrypted bytes sent and received within an SSL conversation before the secret key is renegotiated, including control information that is sent by the MCA. If left blank or set to zero (default), the secret key is never renegotiated. This value is ignored if no cipher suite is specified. Valid values are integers 0 - 999,999,999.
    Trust Store To enable server authentication, select the server identity store that was configured in the HCL OneTest API Physical view.
    Key Store To enable client authentication, select the client identity store that was configured in the HCL OneTest API Physical view.
    Advanced page
    Use Default Model Queue Select to specify SYSTEM.DEFAULT.MODEL.QUEUE as the object from which to copy attributes.
    Model Queue If you do not want to use the default model queue, clear Use Default Model Queue and specify a model queue name from which to copy attributes.
    Open Options You can override default options when you open model queues. By default, the Open Options field is left blank and the value of 1 (MQOO_INPUT_AS_Q_DEF) is used. Entering a valid numeric value in the field overrides the default.
    Important: Change this field only if you are an advanced user of HCL OneTest API with a deep understanding of WebSphere MQ. Any value that you enter in this field is not validated. However, an invalid value causes a warning message to be displayed when you start recording or when you start a stub.
    Queue Prefix Specify a prefix for temporary dynamic queues. By default, the Queue Prefix field is blank and the prefix "AMQ" is used. If you enter a value in the field, it is prefixed by "AMQ." and suffixed by "." For example, if you enter "RIT" in the Queue Prefix field, temporary queues are named "AMQ.RIT.*" where "*" represents a 16-character string.
    Specify the prefix for the queues that you want to observe Complete this field only if queues whose names begin with the specified prefix are to be observed.
    Include admin messages Select to include administrative messages in the observations.
  4. Click Finish. The observation point is configured. To start topology discovery, see Starting the topology discovery process.