Sonic Read Service (com.ibi.agents.XDSonicReadAgent)

Syntax:

com.ibi.agents.XDSonicReadAgent

iIT Service Object:

Description:

This service reads data using the Sonic version of JMS from a queue or topic. For more Information on Sonic, see the Queuing Adapters chapter in the iWay Service Manager Protocol Guide.

Parameters:

Parameter

Description

Name

The name of the queue or topic to be read.

Broker URL

URL of Sonic Broker. The format of the URL is Protocol://host:port.

User ID

User ID for challenges.

Password

Password for challenges.

Acknowledgement

Acknowledgment mode, or transactional. Select one of the following options from the dropdown list:

  • Auto Acknowledge. The session automatically acknowledges the client receipt of a message by successfully returning from a call to receive (synchronous mode) or when the session message listener successfully returns (asynchronous mode).
  • Client Acknowledge. An explicit acknowledge on a message acknowledges the receipt of all messages that were produced and consumed by the session that gives the acknowledgement. When a session is forced to recover, it restarts with its first unacknowledged message.
  • Dups OK Acknowledge - The session slowly acknowledges the delivery of messages to consumers, possibly allowing some duplicate messages after a system outage.

Edges:

The following table lists the available line edges for the Sonic Read Service (com.ibi.agents.XDSonicReadAgent).

Line Edge

Description

OnError

Error

OnSuccess

Success

OnFailure

Failure

OnCustom

  • OnError
  • OnSuccess
  • OnFailure