Advanced Queuing - Oracle

Deploying the AQ XML Servlet
To create AQ agents that can access the servlet using SMTP, use the DBMS_
AQADM.CREATE_AQ_AGENT procedure.
Example
Create an AQ agent for the appl application to access the AQ servlet using SMTP
and the digital certificate of the application owner, Kurt:
DBMS_AQADM.CREATE_AQ_AGENT(
agent_name => ’appl’,
enable_http => true,
enable_smtp => true,
certificate_location => ’cn=kurt,cn=acme,cn=com’);
The certificate_location parameter is required to authenticate the appl
application when a message is received.
Web Server Setup
1. Establish a user called ORACLE_SMTP_AGENT on the Web server that is allowed
to access the AQ servlet.
The Oracle e-mail server will connect to the servlet using user ORACLE_SMTP_
AGENT.
2. Specify the e-mail server host name or the IP address in the servlet’s init( )
method.
Use setEmailServerHost(hostname) or setEmailServerAddr(ip_
address)in the AQxmlServlet to do this.
Example: Specify the e-mail server host as follows:
setEmailServerAddr("144.25.186.236"); or
setEmailServerHost("email-srv.us.oracle.com");
3. Set up an LDAP context in the servlet, as described in "Using an LDAP Server
with an AQ XML Servlet" on page 17-54.
The LDAP server is used to retrieve certificates for the AQ agent and verify the
signature in the incoming message.
E-mail Server Setup
Internet access to AQ using SMTP requires Oracle Email Server 5.5. Do the
following:
1. Check that DBMS_AQST is installed on the e-mail server.
17-56 Oracle9i Application Developer’s Guide - Advanced Queuing