Delete-Object
JMS キューからメッセージを除去します。
|
|
この Webject を使用するには、メッセージの送受信用に環境を設定する必要があります。
|
構文
<ie:webject name="Delete-Object" type="MSG">
<ie:param name="DBUSER" data="username"/>
<ie:param name="GROUP_OUT" data="group_name"/>
<ie:param name="PASSWD" data="password"/>
<ie:param name="QUEUE" data="managed_queue_name"/>
<ie:param name="WHERE" data="message_selector"/>
</ie:webject>
パラメータ
|
必須
|
選択
|
オプション
|
|
QUEUE
|
|
DBUSER
|
|
|
SERVICE
|
|
|
GROUP_OUT
|
|
|
PASSWD
|
|
|
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 サービスを設定できます。このパラメータはオプションです。
GROUP_OUT
正常に終了すると作成されて返されるステータスグループの名前。このパラメータのデフォルトは delete-results です。このパラメータはオプションです。
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
JMS キューの LDAP 相対識別名を識別し、メッセージを除去します。値は設定されているベース URI を基準とする LDAP 相対識別名です。相対の場合に、明示的に指定されていない場合、cn= (共有名の属性) は暗黙的です。このパラメータは必須です。
WHERE
Sun Java Message Service 仕様の定義に従って、正しくフォーマットされた JMS メッセージセレクタを指定します。このパラメータは、メッセージキューから削除するメッセージのサブセットを選択するときに使用します。キューのサブセットの最初のメッセージが削除されます。このパラメータのデフォルトの動作は、キューの最初のメッセージの削除です。このパラメータはオプションです。
例
以下の例は、指定されたキューから JMS メッセージを削除します。
<%@page language="java" session="false"%>
<%@taglib uri="http://www.ptc.com/infoengine/taglib/core"
prefix="ie"%>
<ie:webject name="Delete-Object" type="MSG">
<ie:param name="DBUSER" data="$(@FORM[]dbuser[])"/>
<ie:param name="PASSWD" data="$(@FORM[]passwd[])"/>
<ie:param name="QUEUE" data="$(@FORM[]queue[])"/>
<ie:param name="WHERE" data="$(@FORM[]where[])"/>
<ie:param name="GROUP_OUT" data="results"/>
</ie:webject>
この例を実際に実行するには、dbuser、passwd、queue、および where 変数を識別するフォームを指定する必要があります。
