You are here: Reference > Data classes > MQ Server data instances > MQ Server form - Completing the Environment tab

MQ Server form
Completing the Environment tab

  1. About 
  2. New 
  3. Environment 
  4. History 
  5. More... 

Use the Environment tab to specify information for connecting to a WebSphere MQ server.

Field

Description

Apply MQ bindings transport

Select to use MQ bindings transport to connect to the WebSphere MQ server.

On Windows-based servers, this setting requires that the IBM-provided file mqjbnd05.dll be present and included on the system classpath.

Host Name

Enter the network name of the WebSphere MQ server host.

This field supports the Global Resource Settings syntax (=PageName.PropertyName). The default property name for this field is pyHostName. For more information, see Using the Global Resource Settings feature.

Port Number

Enter a TCP/IP port for communicating with the WebSphere MQ server.

This field supports the Global Resource Settings syntax (=PageName.PropertyName). The default property name for this field is pyPortNumber. For more information, see Using the Global Resource Settings feature.

Channel

Enter the channel name on the WebSphere MQ server.

This field supports the Global Resource Settings syntax (=PageName.PropertyName). The default property name for this field is pyChannelName. For more information, see Using the Global Resource Settings feature.

User ID

Optional:Identify an MQ user ID for connecting to the WebSphere MQ server.

This field supports the Global Resource Settings syntax (=PageName.PropertyName). The default property name for this field is pyUserID. For more information, see Using the Global Resource Settings feature.

Password

Optional:Enter a password for connecting to the WebSphere MQ server.

This field supports the Global Resource Settings syntax (=PageName.PropertyName). The default property name for this field is pyPassword. For more information, see Using the Global Resource Settings feature.

Apply TCP security settings (SSL/TLS) Select to enable your application to send and receive queued messages securely with IBM MQ by using SSL or TLS.
Cryptographic security level (Filters IBM MQ cipher suites) Select the category of IBM MQ cipher suites that the system uses to filter the IBM MQ cipher suite list.
IBM MQ cipher suite Select a cipher suite that is used to negotiate the security settings between the Pega 7 Platform client and the IBM MQ server by using SSL or TLS.
Truststore Enter or create a Truststore record that contains the IBM MQ server certificate to use in the SSL or TLS handshake.
Keystore Optional:Enter or create a Keystore record that stores the Pega 7 Platform client's private/public key pair that is used by the IBM MQ server to authenticate the client.
Secret key reset count (# of bytes sent/received before TLS negotiation)

Optional:Enter the number of bytes that are sent or received within the SSL or TLS conversation before the SSL or TLS secret key is renegotiated.

Note: The default value of this field is zero, which indicates that secret keys are not renegotiated by default.

Peer name

Optional:Enter a distinguished name pattern that allows the queue manager to identify itself by using an SSL or TLS certificate. This pattern ensures that your application communicates with the correct queue manager.

Test Connectivity

After you complete this form and save the data instance, click to confirm that your system can connect to the MQ server.

The system attempts to connect to the server only; no messages are processed. The system presents test results in a separate window, identifying the parameters used in the test, the steps attempted, and the outcome of each step.

MQ Explore

Click this button to display the MQ Queue Details in a separate window.

In the MQ Explorer, choose a Queue Manager and Queue Name using the SmartPrompt. The Destination field is automatically populated. Click the Browse Messages button to view all messages in the queue.

If your system's production level is both lower than 5, and you have the proper Role/Privilege, you can:

  • To add messages to the queue, click Put Messages and fill out the corresponding form.
  • To remove messages from the queue, click Remove Messages.
For an example, see the PDN article How to debug MQ connectors using BROWSE, PUT and GET message operations.

About MQ Server data instances