jms-send

Home > Books > NetKernel API and Services Reference > Accessor Listing > JMS Connectivity > jms-send

Module

The jms-send accessor is exported by the urn:org:ten60:netkernel:jms module. Import this module to gain access to the accessor.

Syntax

URI

active:jms-send

Argument	Rules	Description
destination	Mandatory	the queue or topic uri, jms-queue:[logical JNDI queue name] or jms-topic:[logical JNDI topic name]
body	Mandatory	resource to be placed in the body of the message
header	Optional	an NVP (name value pair list) or canonical XML form for JMS header fields to set. The list of valid names are: JMSCorrelationID, JMSDeliveryMode, JMSExpiration, JMSMessageID, JMSPriority, JMSRedelivered, JMSTimestamp, JMSType and JMSReplyTo (use logical name). Not all headers maybe supported or set-able by all implementations.
properties	Optional	an NVP (name value pair list) or canonical XML form for a set of properties to set on the message.
config	Optional	an optional alternate JMS configuration instead of the default.

Example Usage

DPML

<instr>
  <type>jms-send</type>
  <destination>jms-queue:MyQueueName</destination>
  <body>var:body</body>
  <header>
    <nvp>
      <JMSMessageID>123</JMSMessageID>
    </nvp>
  </header>
  <properties>
    <nvp>
      <MyProperty>my property value</MyProperty>
    </nvp>
  </properties>
</instr>

NetKernel Foundation API

req=context.createSubRequest("active:jms-send");
req.addArgument("destination", [resource representation, aspect, or URI] );
req.addArgument("body", [resource representation, aspect, or URI] );
result=context.issueSubRequest(req);

Purpose

jms-send is a client service which may be called to publish / send a message to a JMS topic or queue. For more details on configuring Java Messaging Service connectivity see the guide.