Loadrunner SOAP over JMS script for Websphere MQ

Question:
How to submit a SOAP over JMS request to Websphere MQ using LoadRunner SOA protocol?

Solution:
Prerequisite

1. JMS Queue details
2. Websphere MQ Client installed (if not installed, instructions are below)
3. Websphere MQ jar files installed (if not installed, instructions are below)
4. JDK installed (if not installed, instructions are below)

JMS Queue Details
Depending on which queue(s) you want to send and receive a message from as well as the MQ architecture design, you will require following MQ information from your Websphere MQ Admin.

• HostName
• Channel
• Port
• Queue Manager
• Input Queue
• Output Queue
• Queue Connection Factory
• Username and password

For example, in my case, to send a message to an Input Queue, following information was required:

• HostName – xxx.xxx.xxx
• Channel - ICF.DEF.SVRCONN
• Port - 1414(might be different)
• Queue Manager - Not Required
• Input Queue - Input_queue_name
• Output Queue - Not Required
• Queue Connection Factory - qcf
• Username and password - Not required

Webshere MQ Jar files

1. Install JAVA JDK on your local machine
2. Copy MQ jar files into the JDK...->Java ->jre-> ext folder. You will need to get these jar files from your Webpshere MQ admin
3. Also, since we are using fscontext as initial context factory, you will need to download and save fscontext and providerutil.jar files in the above mentioned folder

How to create JNDI binding

1. Install Websphere MQ Client application on your local machine.
2. Navigate to the location where JMSAdmin.config file is located and open it. We are going to select a context factory to use and path where to create the binding file. In my case this file is located at C:\Program Files (x86)\IBM\WebSphere MQ\Java\bin Update and save the file with following details:
INITIAL_CONTEXT_FACTORY=com.sun.jndi.fscontext.RefFSContextFactory PROVIDER_URL=file:/C:/JNDI


3. Create a new qm.scp file (make sure this file is in the same folder as JMSAdmin.bat file) and put there the MQ details. The .scp file will look like this:
DEFINE QCF(qcf) tran(client) chan(ICF.DEF.SVRCONN) host(xxx.xxx.xxx) port(1414) DISPLAY QCF(qcf) DEFINE Q(Input_queue) QUEUE(Input_queue) DISPLAY Q(Input_queue) end


4. Create the JNDI folder on your C drive. This is where your binding file will automatically be saved.
5. Navigate to “...\WebSphere MQ\Java\bin” and edit JMSAdmin.bat by replacing “java” text with the full java path incase it is not already defined in your System environment settings.
   
6. Navigate to Websphere MQ Java bin folder via the command prompt and execute the JMSAdmin Tool (JMSAdmin. Bat file) with qm.scp as the parameter. This will generate a .bindings file in the JNDI folder automatically.





You will see something like this when JMSAdmin bat application is executed.


Cool, JNDI binding is done.

Creating a Webservices Loadrunner Script

1. Open up a new web services script.
2. Press F4 to Navigate to Run-time setting and update the following fields in JMS->Advanced option:
-JVM Home: JAVA path
-JNDI initial context factory: com.sun.jndi.fscontext.RefFSContextFactory
-JNDI provider URL: file:/C:/JNDI/
-JMS connection factory: QCF name


3. Now you are ready to create your MQ script.
4. You can then use Web Services jms_set_general_property, jms_send_message_queue, jms_set_message_property and jms_receive_message_property functions.

NOTE: JMS Bindings Extensions are not supported in Loadrunner 11.

How to monitor JVM running in Loadrunner mmdrv process

If you are testing SOAP over JMS using Web Services protocol in Loadrunner, you can monitor JVM(in process) which is invoked by mmdrv.exe, either using JConsole or JVisualVM or any other tool that allows you to monitor JVM.

Before you use JConsole or JVisualVM, you will need to set jmxremote parameter in Loadrunner. To do so, add “-Dcom.sun.management.jmxremote” as a Value in the “Additional VM Parameters” textbox. See the figure below.

Now, run your script and open up JVisualVM to monitor the JVM running within the mmdrv process.

NOTE: If you are using JVisualVM tool for monitoring then you do not need to set remote jmx parameter. It is only required for Jconsole.