AQ Emit Service (com.ibi.agents.XDAQEmitAgent)

Syntax:

com.ibi.agents.XDAQEmitAgent

iIT Service Object:

misc: AQ Emit Agent

Description:

This service sends a message to an Oracle AQ queue.

Parameters:

Parameter

Description

Queue Name *

Name of the input queue to be monitored.

Host

Host of the server connection.

SID *

SID of the server connection.

Port

Port to use for the server connection.

Driver *

Driver to use for the server connection.

User *

User login ID at the broker machine.

Password *

User password at the broker machine.

Table Owner/Schema *

Usually the same as the login.

Table Name

Table in which the queue resides.

Connection Type *

Connection to Oracle JMS or Oracle AQ.

  • aq
  • jms

AQ

Message Type

Select one of the following message type formats to send or create (when creating a dynamic queue on the listener):

  • clob
  • raw

Payload Class

When using custom defined objects, specify a class that is in the classpath.

Payload Object

When using custom defined objects, specify the Oracle object that the class will map to. The owner of the schema will be prepended.

Object Owner

Name of the input queue to be monitored.

RAC

RAC Hosts

Enter additional hosts for RAC failover/load balancing (host1:port, host2:port, host3:port).

RAC Load balance

Use the RAC connection for load balancing.

  • false
  • true

RAC Failover

Use the RAC connection for failover.

  • false
  • true

ONS Hosts

Hosts emitting ONS information, for example host:port, host:port.

Cache Minimum

The minimum number of connections to the queue to be held in the cache.

Cache Maximum

The maximum number of connections to the queue to be held in the cache.

Cache Initial

The initial number of connections to create in the cache.

Cache Inactive Timeout

The maximum time a cached physical connection can remain idle.

Cache Abandoned Timeout

The maximum time that a connection can remain unused before the connection is closed and returned to the cache.

Cache Maximum Statements

The maximum number of statements that a connection keeps open.

Cache Property Interval

Sets the time interval at which the cache manager inspects and enforces all specified cache properties.

JMS

Message Priority

The outgoing message priority. If no value is specified, the incoming message priority is used.

Message Type

Select one of the following message type formats to send or create (when creating a dynamic queue on the listener):

  • bytes
  • text

Set Reply Correlation ID

If set to a value, this is used as the correlation ID of the response.

Delivery Mode

Retention of a message at the destination until its receipt is acknowledged is not guaranteed by a PERSISTENT delivery mode.

JMSReplyTO

Queue or Topic (used for JNDI lookup).

Time to Live

The lifetime of a message (in milliseconds). The default is the message will live forever.

Agent Specific Parameters

Return *

Return from this agent.

  • response
  • status

Preemitter

Determines if any preemitter be avoided.

  • true
  • false

Edges:

The following table lists the available line edges for the AQ Emit Service (com.ibi.agents.XDAQEmitAgent).

Line Edge

Description

OnError

Error

OnSuccess

Success

OnFailure

Failure

OnCustom

  • OnError
  • OnSuccess
  • OnFailure
  • fail_connect

The result of the Oracle AQ post appears in the <native> section of the <emitstatus> result. For more information, see the iWay Adapter for OracleAQ User's Guide.