Delete-Results
Info*Engine のタスクキューからのメッセージを読み込み、削除します。メッセージには既知の Info*Engine オブジェクトが含まれていると見なされます。通常これはユーザーに返すグループです。
|
この Webject を使用するには、タスクをキューに入れるように環境を設定する必要があります。
|
構文
<ie:webject name="Delete-Results" type="MSG">
<ie:param name="DBUSER" data="username"/>
<ie:param name="PASSWD" data="password"/>
<ie:param name="QUEUE" data="<managed_queue_name>"/>
<ie:param name="WHERE" data="<message_selector>"/>
</ie:webject>
パラメータ
必須
|
選択
|
オプション
|
|
|
DBUSER
|
|
|
SERVICE
|
|
|
PASSWD
|
|
|
QUEUE
|
|
|
WHERE
|
DBUSER
MOM への接続時に使用するユーザー名。このパラメータを指定すると、そのパラメータ値は、認証済みユーザーの既存の資格証明マッピング、または MOM への接続に使用するサービスの
.msg.username および
.jms.username プロパティで指定されている値よりも優先されます。詳細については、
MOM の資格証明マッピングを参照してください。
このパラメータを省略すると、Info*Engine のメッセージ送受信ソフトウェア用のマッピングされた認証が使用されます。このようなマッピングが見つからない場合は、Java Messaging Service (JMS) 用のマッピングされた認証が使用されます。これらのマッピングされた資格証明がいずれも見つからない場合は、.msg.username プロパティで設定されている値が使用されます。.msg.username プロパティが設定されていない場合は、.jms.username プロパティで設定されている値が使用されます。いずれのプロパティも設定されておらず、この DBUSER パラメータに値を指定しない場合、Info*Engine は MOM に接続するときにユーザー名を指定せず、匿名の接続を試みます。
このパラメータはオプションです。
SERVICE
特定の JMS サービスに接続できるように設定されている Info*Engine プロパティセットの名前。これにより、単一の Info*Engine 仮想マシン (VM) に対して複数の JMS サービスを設定できます。このパラメータはオプションです。
PASSWD
MOM への接続時に使用するパスワード。このパラメータを指定すると、そのパラメータ値は、認証済みユーザーの既存の資格証明マッピング、または MOM への接続に使用するサービスの
.msg.password および
.jms.password プロパティで指定されている値よりも優先されます。詳細については、
MOM の資格証明マッピングを参照してください。
このパラメータを省略すると、Info*Engine のメッセージ送受信ソフトウェア用のマッピングされた認証が使用されます。このようなマッピングが見つからない場合は、Java Messaging Service (JMS) 用のマッピングされた認証が使用されます。このようなマッピングされた資格証明がいずれも見つからない場合は、.msg.password プロパティで設定されている値が使用されます。.msg.password プロパティが設定されていない場合は、.jms.password プロパティで設定されている値が使用されます。いずれのプロパティも設定されず、この PASSWD パラメータに値を指定していない場合は、MOM に接続するときに Info*Engine はパスワードを指定しません。
このパラメータはオプションです。
QUEUE
管理キューの LDAP 識別名。値は設定されているベース URI を基準とする LDAP 相対識別名です。相対の場合に、明示的に指定されていない場合、cn= (共有名の属性) は暗黙的です。このパラメータのデフォルトでは、com.infoengine.msg.defaultResponseQueue プロパティで指定されている値を使用します。
このパラメータはオプションです。
WHERE
Sun Java Message Service 仕様の定義に従って、正しくフォーマットされた JMS メッセージセレクタを指定します。このパラメータは、メッセージキューから削除するメッセージのサブセットを選択するときに使用します。キューのサブセットの最初のメッセージが削除されます。
Queue-Task Webject の CORRELATION_ID パラメータの値を WHERE 値として使用して該当する結果を選択できます。
このパラメータのデフォルトは、SERVER コンテキストグループ内にあるユーザー ID から導出され、このユーザーメッセージを含んでいるサブセットになります。このパラメータはオプションです。
例
以下の例は、指定されたキューからメッセージを読み込み、その後メッセージを削除します。
<%@page language="java" session="false" %>
<%@taglib uri="http://www.ptc.com/infoengine/taglib/core"
prefix="ie"%>
<ie:webject name="delete-results" type="MSG">
<ie:param name="QUEUE" data="$(FORM[]QUEUE[0])"/>
<ie:param name="CORRELATION_ID"
data="$(FORM[]CORRID[0])"/>
<ie:param name="WHERE" data="$(@FORM[]where[0])"/>
<ie:param nam
<ie:webject name="Return-Groups" type="GRP">
<ie:param name="GROUP_IN" data="*"/>
</ie:webject>
この例を実際に実行するには、QUEUE、CORRID、および where 変数を識別するフォームを指定する必要があります。