09.12.2012 Views

Advanced Queuing - Oracle

Advanced Queuing - Oracle

Advanced Queuing - Oracle

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

See Also: Table 9–1 for a list of adminstrative interface basic<br />

operations<br />

Altering a Queue<br />

Purpose<br />

Alter existing properties of a queue. Only max_retries, comment, retry_delay, and<br />

retention_time can be altered.<br />

Usage Notes<br />

To view retained messages, you can either dequeue by message ID or use SQL.<br />

When a queue, queue table, or subscriber is created, modified, or dropped, and if<br />

GLOBAL_TOPIC_ENABLED = TRUE, a corresponding LDAP entry is also created.<br />

Syntax<br />

See Chapter 3, "AQ Programmatic Environments" for a list of available functions in<br />

each programmatic environment. Use the following syntax references for each<br />

programmatic environment:<br />

PL/SQL (DBMS_AQADM Package): <strong>Oracle</strong>9i Supplied PL/SQL Packages and<br />

<br />

Types Reference, DBMS_AQADM.ALTER_QUEUE procedure<br />

Visual Basic (OO4O): There is no applicable syntax reference for this use case<br />

Java (JDBC): <strong>Oracle</strong>9i Supplied Java Packages Reference oracle.AQ, alter<br />

Examples<br />

See Chapter 3, "AQ Programmatic Environments" for a list of available functions in<br />

each programmatic environment. Examples are provided in the following<br />

programmatic environments:<br />

PL/SQL (DBMS_AQADM): Altering a Queue on page 9-29<br />

VB (OO4O): Example not provided.<br />

Java (JDBC): Altering a Queue on page 9-30<br />

PL/SQL (DBMS_AQADM): Altering a Queue<br />

/* Alter queue to change retention time, saving messages for 1 day after<br />

dequeueing: */<br />

EXECUTE dbms_aqadm.alter_queue (<br />

queue_name => ’aq.Anothermsg_queue’,<br />

retention_time => 86400);<br />

Administrative Interface 9-29

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!