MQ JMeter Extension.
github:GitHub - JoseLuisSR/mqmeter: MQ JMeter Extension.
A JMeter Plugin to put and get message on IBM MQ Queue, also publish message on Topic. It connect to MQ Server through server channel using ip address, port number, userID and password (if the channel has CHLAUTH rules).
Install
Build the extension:
mvn package
Install the extension mqmeter-x.y.z.jar
into
`$JMETER_HOME/lib/ext`.
Also you can install it through JMeter Plugins, search "IBM MQ Support".
Usage
After installing mqmeter
, you can choose two kind of Java Sampler, these are:
MQClientSampler
Use it to put and get message (optional) on MQ queue. On JMeter add a Java Request Sampler and select the MQClientSampler
class name. The following parameter are necessary.
- mq_manager: MQ Manager name. You can find it through IBM WebSphere MQ Explore or console.
- mq_queue_put: MQ Queue name to put message. Could be Local or Remote queue.
- mq_queue_get: MQ Queue name to get message. Could be Local or Remote queue. Leave it empty if you don't want get response message.
- mq_correlate_msg: Correlate the response message with request message to get the right message from the queue. Put 'messageId' or 'correlationId' values. Leave it empty if you don't want get response message.
- mq_wait_interval: Set wait interval that the get message call waits for a suitable message to arrive. Similar to time-out to get response message on queue.
- mq_hostname: Host name or ip address where MQ Server is running.
- mq_port: Port number of the MQ Server listener.
- mq_channel: The Server channel name on MQ Server.
- mq_user_id: The userID to connect to MQ server channel. Leave it empty if you don't need user id to connect to MQ.
- mq_user_password: The user password to connect to MQ server channel. Leave it empty if you don't need user id and password to connect to MQ.
- mq_use_mqcsp_authentication: The connection authentication used. Set false for Compatibility mode, or true for MQCSP authentication.
- mq_encoding_message: Character encoding standard for your message: For EBCDIC put Cp1047. ASCII just put ASCII.
- mq_message: The content of the message that you want.
Put & Get Message on Queue
Put Message on Queue
MQPublishSampler
MQ can manage topics also and you can publish and subscribe to it, use this class to publish message on MQ Topic. On JMeter add a Java Request Sampler and select the MQPublishSampler
class name. The following parameters are necessary.
- mq_manager: MQ Manager name. You can find it through IBM WebSphere MQ Explore or console.
- mq_topic: MQ topic name to publish message.
- mq_hostname: Host name or ip address where MQ Server is running.
- mq_port: Port number of the MQ Server listener.
- mq_channel: The Server channel name on MQ Server.
- mq_user_id: The userID to connect to MQ server channel. Leave it empty if you don't need user id to connect to MQ.
- mq_user_password: The user password to connect to MQ server channel. Leave it empty if you don't need user id and password to connect to MQ.
- mq_encoding_message: Character encoding standard for your message: For EBCDIC put Cp1047. ASCII just put ASCII.
- mq_message: The content of the message that you want.