Client Test Tool

Client Test Tool

From Online MQ

Jump to: navigation, search

OnlineMQ provides a Windows Client Tester tool that enables developers to validate the OnlineMQ service operation quickly, you need to open an account in order to use the Client Tester, if you don't already have a one already obtain a free one here.

Download the Client Tester Tool for free here, Java Runtime is required to use the OnlineMQ Client, if you don't have one install you can download it here


Contents

Running the OnlineMQ Client

  • Just extract the zip file you downloaded to any folder, no installation is required.
  • After extracting the files, just run launch.cmd to launch the client.


Image:client-tutorial-1.png

Setting up the preferences

  • Setup the account and queue options in the preferences page: Go to Preferences -> Edit


Image:client-tutorial-2-preferences.png


  • Enter your username and password, choose which queue-manager and queue you want to work with.


Image:client-tutorial-3-preferences.png


  • Don't forget to save the new preferences

Checking connection

Check Connection is used to verify your account credentials and your connectivity to OnlineMQ Servers (in terms of internet connectivity, firewalls and so on...)


  • Go to Actions-> Connection-> Check Connection


Image:client-tutorial-check-connection1.png


  • Click Check Connection.


Image:client-tutorial-check-connection2.png


  • Make sure the Check Connection Successful appears below:


Image:client-tutorial-check-connection3.png

Sending a message

  • Go to Actions-> Message -> Send


Image:client-tutorial-4-send.png


  • Choose Send text message (or Send XML file if you want to send a file)
  • Write your message in the textbox.
  • Click Send.


Image:client-tutorial-5-send2.png


  • Make sure the message was sent successfully:


Image:client-tutorial-5-send3.png

Peeking at a message

Peek message is used for browsing the first message on the queue, it does not delete the message from the queue, if you want to delete the message from the queue use the Receive (get) message.

  • Go to Actions-> Message -> Peek


Image:client-tutorial-6-peek1.png


  • Just click Peek to browse the message


Image:client-tutorial-6-peek2.png


  • you will see the message content now below:


Image:client-tutorial-6-peek3.png


* You can also peek at the content of messages using the web admin console, check out the Web Admin Console Introduction for more info.

Receiving a message

Receive message is used for getting the first message on the queue, once you get the message, it is deleted from the queue for good. When writing applications you can use transaction to make sure you run your business logic before the message is deleted from queue.


  • Go to Actions-> Message -> Receive


Image:client-tutorial-6-receive1.png


  • Just click Receive to get the message


Image:client-tutorial-6-receive2.png


  • you will see the message content now below:


Image:client-tutorial-6-receive3.png