前へ	次へ		目次	索引	用語集

procedure DequeueEventDetail

    (dequeuemode in number,

     navigation in number default 1,

     correlation in varchar2 default null,

     itemtype in out varchar2,

     itemkey out varchar2,

     actid out number,

     function_name out varchar2,

     param_list out varchar2,

     message_handle in out raw,

     timeout out boolean);

説明

指定のメッセージに対するすべてのイベントの詳細を、送信キューからデキューします。このAPIはDequeueOutboundと同様ですが、ペイロード・タイプを参照しません。そのかわりにペイロードの一部であるitemkey、actid、function_nameおよびparam_listを出力します。

注意: このプロシージャをループ内でコールする場合は、戻されるメッセージ・ハンドルをNULLに設定しないと、プロシージャで同じメッセージが再度デキューされます。これは望ましくない動作であり、無限ループの原因となることがあります。

引数（入力）

dequeuemode	番号1、2および3にそれぞれ対応するDBMS_AQ.BROWSE、DBMS_AQ.LOCKEDまたはDBMS_AQ.REMOVEという値で、デキューのロック動作を表します。DBMS_AQ.BROWSEモードでは、メッセージのロックを取得せずにキューからメッセージを読み込みます。DBMS_AQ.LOCKEDモードでは、メッセージを読み込み、トランザクションが完了するまでメッセージの書込みロックを取得します。DBMS_AQ.REMOVEモードでは、メッセージを読み込んでから更新か削除を行います。
navigation	番号1、2にそれぞれ対応するDBMS_AQ.FIRSTMESSAGEまたはDBMS_AQ.NEXTMESSAGEを指定し、取り出されるメッセージの場所を示します。DBMS_AQ.FIRSTMESSAGEという値では、取出し可能で相関基準と合致している最初のメッセージを取り出します。キューの始まりの位置もリセットします。DBMS_AQ.NEXTMESSAGEという値では、取出し可能で相関基準に合致している次のメッセージを取り出します。 デフォルトは1です。
correlation	デキューされるメッセージのオプションの相関識別子を指定します。Oracle Advanced Queuingでは、特定の相関値に基づいてメッセージのキューを検索できます。「%」などのLIKE比較演算子を使用して、識別子の文字列を指定できます。NULLの場合、ワークフロー・エンジンではWorkflowスキーマ名と項目タイプに基づいて相関識別子が作成されます。
acctname	Oracle Workflowデータベースのアカウント名。アカウント名がNULLの場合、デフォルトはUSERという疑似列になります。
itemtype	相関を指定していない場合、デキューするメッセージに対するオプションの項目タイプを指定します。
message_handle	デキューされる特定のイベントに対する、オプションのメッセージ・ハンドルIDを指定します。メッセージのハンドルIDを指定すると相関識別子は無視されます。

注意: キューから読み込むものがなくなると、タイムアウト出力はTRUEという値を戻します。