jms_send_message_queue

Sends a message to a queue.

Example: jms_send_message_queueWeb Services Functions (SOAP, WEB_SERVICE, Silverlight)
int jms_send_message_queue( const char * StepName, const char * SentMessage, const char * SendQueueName);

This function returns LR_PASS (0) on success or LR_FAIL (1) on failure. Note that LR_PASS and LR_FAIL generally indicate whether the function call completed without an exception, and not that the test step succeeded.

All input string arguments (char type) except the step name can be parameterized using standard parameterization.

StepName The name of the step, as it appears in the test tree. Any text can be used.
SentMessage The message to send.
SendQueueName The JNDI name of the send queue.

The jms_send_message_queue function sends a message to a queue.

VuGen identifies the queue by calling a lookup method on a JNDI context defined in the JMS runtime settings.

The message type is defined in the contentType message header. The default is a text message.

To set a JMS header or property for the next message to be sent, insert the jms_set_message_property function before this function.

This function fails, causing the script to stop (if the Continue on Error runtime setting is not selected) if:

  • The JNDI context is incorrect.

  • The queue cannot be located.

  • The message is empty.

  • A communication error occurs.