Query-Results

Info*Engine タスクキューからメッセージを読み込み、結果を返します。デフォルト設定では、その後でキューからメッセージを削除します。メッセージには既知の Info*Engine オブジェクトが含まれていると見なされます。通常これはユーザーに返すグループです。

<ie:webject name="Query-Results" type="MSG">
  <ie:param name="CORRELATION_ID" data="message_selector"/>
  <ie:param name="DBUSER" data="username"/>
  <ie:param name="DELETE" data="[TRUE | FALSE]"/>
  <ie:param name="PASSWD" data="password"/>
  <ie:param name="QUEUE" data="managed_queue_name"/>
  <ie:param name="WAIT_TIME" data="wait_time"/>
  <ie:param name="WHERE" data="message_selector"/>
</ie:webject>

JMS ヘッダーの相関識別子。この値は、レスポンスキューから結果を選択するために使用され、Queue-Task Webject で実行するためにタスクをキューに入れる際に使用される CORRELATION_ID パラメータの値と一致しています。このパラメータはオプションです。

MOM への接続時に使用するユーザー名。このパラメータを指定すると、そのパラメータ値は、認証済みユーザーの既存の資格証明マッピング、または MOM への接続に使用するサービスの .msg.username および .jms.username プロパティで指定されている値よりも優先されます。詳細については、MOM の資格証明マッピングを参照してください。

このパラメータを省略すると、Info*Engine のメッセージ送受信ソフトウェア用のマッピングされた認証が使用されます。このようなマッピングが見つからない場合は、Java Messaging Service (JMS) 用のマッピングされた認証が使用されます。これらのマッピングされた資格証明がいずれも見つからない場合は、.msg.username プロパティで設定されている値が使用されます。.msg.username プロパティが設定されていない場合は、.jms.username プロパティで設定されている値が使用されます。いずれのプロパティも設定されておらず、この DBUSER パラメータに値を指定しない場合、Info*Engine は MOM に接続するときにユーザー名を指定せず、匿名の接続を試みます。

このパラメータはオプションです。

特定の JMS サービスに接続できるように設定されている Info*Engine プロパティセットの名前。これにより、単一の Info*Engine 仮想マシン (VM) に対して複数の JMS サービスを設定できます。このパラメータはオプションです。

正常にユーザーにメッセージを返したときに、キューからそのメッセージを削除するかどうかを示します。値を TRUE に指定すると、メッセージは削除されます。値を FALSE に指定すると、メッセージは削除されません。このパラメータのデフォルトは TRUE です。このパラメータはオプションです。

MOM への接続時に使用するパスワード。このパラメータを指定すると、そのパラメータ値は、認証済みユーザーの既存の資格証明マッピング、または MOM への接続に使用するサービスの .msg.password および .jms.password プロパティで指定されている値よりも優先されます。

このパラメータを省略すると、Info*Engine のメッセージ送受信ソフトウェア用のマッピングされた認証が使用されます。このようなマッピングが見つからない場合は、Java Messaging Service (JMS) 用のマッピングされた認証が使用されます。このようなマッピングされた資格証明がいずれも見つからない場合は、.msg.password プロパティで設定されている値が使用されます。.msg.password プロパティが設定されていない場合は、.jms.password プロパティで設定されている値が使用されます。いずれのプロパティも設定されず、この PASSWD パラメータに値を指定していない場合は、MOM に接続するときに Info*Engine はパスワードを指定しません。

このパラメータはオプションです。

管理キューの LDAP 識別名です。値は設定されているベース URI を基準とする LDAP 相対識別名です。相対の場合に、明示的に指定されていない場合、cn= (共有名の属性) は暗黙的です。このパラメータのデフォルトでは、com.infoengine.msg.defaultResultsQueue プロパティで指定されている値を使用します。

このパラメータはオプションです。

指定されたキューに結果が到達するまでの待ち時間 (秒単位)。このパラメータのデフォルトは 0 です。このパラメータはオプションです。

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="Query-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 name="DELETE" data="$(@FORM[]delete[])"/>
  <ie:param name="WAIT_TIME" data="10"/>
</ie:webject>
<ie:webject name="Return-Groups" type="GRP">
  <ie:param name="GROUP_IN" data="*"/>
</ie:webject>

必須	選択	オプション
		CORRELATION_ID
		DBUSER
		SERVICE
		DELETE
		PASSWD
		QUEUE
		WAIT_TIME
		WHERE