MQ JMS Emit Agent Service (com.ibi.agents.XDMQJMSEmitAgent)

Syntax:

com.ibi.agents.XDMQJMSEmitAgent

iIT Service Object:

format: MQ JMS Emit Agent

Description: Emits an input document to IBM MQ using the JMS API.

Parameters:

Parameter

Description

Receiver Name *

The name of the queue or topic to be read.

Queue Manager

The Websphere MQ queue manager name.

Host

The host name or IP address. It is only needed for an MQ client connection.

Port

The port number. It is only needed for an MQ client connection.

Channel

The server connection channel name. It is only needed for an MQ client connection.

SSL CipherSpec

The MQ CipherSpec determines that SSL is to be used. This is configured for the channel by the IBM Websphere MQ Administrator. SSL can be used only in client mode.

SSL Context Provider

The iWay Security Provider for SSL Context. If the SSL Context Provider is left blank, the SSL truststore and keystore come from global system properties which can easily lead to conflicts.

User

The user logon id at broker.

Password

The user's password at the broker machine.

Messaging Style

Select queue for point-to-point or topic for publish-and-subscribe.

Output Message Type

The class of message sent. Dynamic will select BytesMessage, TextMessage or MapMessage depending on the document contents.

JMSCorrelationID

The value of the JMSCorrelationID header field.

Message Priority

The outgoing message priority. Value must be between 0 and 9, with 9 being the most expedited. If omitted, it uses the incoming priority.

JMSReplyTo

The value of the JMSReplyTo header field.

JMSType

The value of the JMSType header field.

Request Header Namespace

The special register namespace from which protocol headers for the outbound request will be taken.

Acknowledgement

Makes the JMS Session transactional or else specifies how received messages are acknowledged.

Delivery Mode

Non-Persistent mode has low overhead but may lose messages. Persistent mode takes extra care to ensure the message is not lost in transit, but makes no absolute guarantee.

Time to Live

The message's lifetime (in milliseconds). The default will live forever

Delivery Delay

The minimum length of time in milliseconds that must elapse after a message is sent before the JMS provider may deliver the message to a consumer. JMS 2 only.

Preemitter

Determines if any preemitter be avoided.

Return Document

Determines whether the output document will be a status document or the input document.

Edges:

The following table lists the available Line Edges for the MQ JMS Emit Agent Service (com.ibi.agents.XDMQJMSEmitAgent).

Line Edge

Description

OnError

An exception occurred during execution.

OnSuccess

The operation was successful.

OnFailure

A fail condition occurred during execution.

OnFailConnection

Could not connect to the extenal system.