コネクターの構成プロパティーには、標準構成プロパティーとアダプター固有の構成プロパティーという 2 つのタイプがあります。アダプターを実行する前に、これらのプロパティーの値を設定する必要があります。
コネクターのプロパティーを構成するには、Connector Configurator Express を使用します。
コネクターは、始動時に構成値を取得します。実行時セッション中に、1 つ以上のコネクター・プロパティーの値の変更が必要になることがあります。AgentTraceLevel など一部のコネクター構成プロパティーへの変更は、即時に有効になります。その他のコネクター・プロパティーへの変更を有効にするには、変更後にコンポーネントまたはシステムを再始動する必要があります。あるプロパティーが動的 (即時に有効になる) か静的 (コネクター・コンポーネントまたはシステムを再始動する必要がある) かを判別するには、Connector Configurator Express の「コネクター・プロパティー」ウィンドウ内の「更新メソッド」列を参照してください。
標準構成プロパティーにより、すべてのコネクターによって使用される情報が提供されます。標準構成プロパティーの資料については、付録 A, コネクターの標準構成プロパティーを参照してください。
コネクター固有の構成プロパティーには、コネクターが実行時に必要とする情報が用意されています。コネクター固有の構成プロパティーは、エージェントを再コーディングまたは再ビルドせずに、コネクター内部の静的情報またはロジックを変更する手段にもなっています。
次の表に、アダプターのコネクター固有構成プロパティーを示します。プロパティーの説明については、以下の各セクションを参照してください。
名前 | 指定可能な値 | デフォルト値 | 必須 |
---|---|---|---|
ApplicationPassword | ログイン・パスワード |
| いいえ |
ApplicationUserName | ログイン・ユーザー ID |
| いいえ |
ArchiveQueue | 正常に処理されたメッセージのコピーが送信されるキュー | queue://crossworlds. queue.manager/MQCONN.ARCHIVE | いいえ |
CCSID | キュー・マネージャーの接続に使用する文字セット | null | いいえ |
Channel | MQ サーバー・コネクター・チャネル |
| はい |
ConfigurationMetaObject | 構成メタオブジェクトの名前 |
| はい |
DataHandlerClassName | データ・ハンドラー・クラス名 | com.crossworlds.DataHandlers. text.xml | いいえ |
DataHandlerConfigMO | データ・ハンドラー・メタオブジェクト | MO_DataHandler_ Default | はい |
DataHandlerMimeType | MIME ファイル・タイプ | text/xml | いいえ |
DefaultVerb | コネクターがサポートする任意の動詞 | Create |
|
ErrorQueue | 未処理のメッセージ・キュー | queue://crossworlds. queue.manager/MQCONN.ERROR | いいえ |
FeedbackCodeMappingMO | フィードバック・コード・メタオブジェクト |
| いいえ |
HostName | WebSphere MQ サーバー |
| はい |
InDoubtEvents | FailOnStartup Reprocess IgnoreLogError | Reprocess | いいえ |
InputQueue | ポーリング・キュー | queue://crossworlds. queue.manager/MQCONN.IN | いいえ |
InProgressQueue | 進行中のイベント・キュー | queue://crossworlds. queue.manager/MQCONN.IN_PROGRESS | いいえ |
PollQuantity | InputQueue プロパティー内で指定された各キューから検索されるメッセージの数 | 1 | いいえ |
Port | WebSphere MQ リスナー用に設定されたポート |
| はい |
ReplyToQueue | コネクターからの要求発行時に応答メッセージが配信されるキュー | queue://crossworlds. queue.manager/MQCONN.REPLYTO | いいえ |
UnsubscribedQueue | アンサブスクライブされたメッセージが送信されるキュー | queue://crossworlds. queue.manager/MQCONN.UNSUBSCRIBE | いいえ |
UseDefaults | true または false | false |
|
WebSphere MQ にログインするために、UserID とともに使用されるパスワードです。
デフォルト = 設定値なし
ApplicationPassword の値がブランクのままか、または除去された場合、コネクターは WebSphere MQ によって提供されるデフォルトのパスワードを使用します。注*
WebSphere MQ にログインするために、Password とともに使用されるユーザー ID です。
デフォルト = 設定値なし
ApplicationUserName の値がブランクのままか、または除去された場合、コネクターは WebSphere MQ によって提供されるデフォルトのユーザー ID を使用します。注*
正常に処理されたメッセージのコピーが送信されるキューです。
デフォルト = queue://crossworlds.queue.manager/MQCONN.ARCHIVE
キュー・マネージャーの接続に使用する文字セット。このプロパティーの値は、キュー URI 内の CCSID プロパティーの値と一致する必要があります。キューの Uniform Resource Identifiers (URI)を参照してください。
デフォルト値はヌルです。
コネクターが WebSphere MQ と通信するときに使用する MQ サーバー・コネクター・チャネルです。
デフォルト = 設定値なし
Channel の値がブランクのままか、または除去された場合、コネクターは WebSphere MQ によって提供されるデフォルトのサーバー・チャネルを使用します。注*
コネクターの構成情報を含む静的なメタオブジェクトの名前です。
デフォルト = 設定値なし
ビジネス・オブジェクトとの間でのメッセージ変換に使用するデータ・ハンドラー・クラスです。
デフォルト = com.crossworlds.DataHandlers.text.xml
構成情報を提供するために、データ・ハンドラーに渡されるメタオブジェクト。
デフォルト = MO_DataHandler_Default
使用すると、特定の MIME タイプに基づいたデータ・ハンドラーを要求できます。
デフォルト = text/xml
着信ビジネス・オブジェクト内に設定する動詞を指定します。ただし、この動詞がポーリング中にデータ・ハンドラーにより設定されていないことが前提です。
デフォルト= Create
処理されなかったメッセージが送信されるキューです。
デフォルト = queue://crossworlds.queue.manager/MQCONN.ERROR
メッセージの受信を InterChange Server Express に同期的に確認するために使用されるデフォルトのフィードバック・コードをオーバーライドして再割り当てするプロパティーです。このプロパティーを使用すると、フィードバック・コードを表示するために各属性名を解釈するときのメタオブジェクトを指定できます。フィードバック・コードの対応する値は、InterChange Server Express に渡される戻り状況値です。デフォルトのフィードバック・コードのリストは、"同期デリバリー"を参照してください。コネクターは、WebSphere MQ 固有のフィードバック・コードを表す以下の属性値を受け入れます。
コネクターは、以下の WebSphere Business Integration Server Express システム固有の状況コードを、メタオブジェクトの属性値として受け入れます。
以下の表に、サンプル・メタオブジェクトを示します。
属性名 | デフォルト値 |
MQFB_APPL_FIRST | SUCCESS |
MQFB_APPL_FIRST + 1 | FAIL |
MQFB_APPL_FIRST + 2 | UNABLE_TO_LOGIN |
デフォルト = 設定値なし
WebSphere MQ をホスティングしているサーバーの名前です。
デフォルト = 設定値なし
コネクターの予期しないシャットダウンのために、処理が完了していない進行中イベントの処理方法を指定します。初期化中に進行中のキューにイベントが見つかった場合に実行するアクションを、以下の 4 つから選択してください。
デフォルト = Reprocess
コネクターが新規のメッセージの有無を確認するためにポーリングするメッセージ・キューです。コネクターは、セミコロンで区切られた複数のキュー名を受け入れます。例えば、MyQueueA、MyQueueB、および MyQueueC の 3 つのキューにポーリングするには、コネクター構成プロパティー InputQueue の値を MyQueueA;MyQueueB;MyQueueC とします。
InputQueue プロパティーが指定されていない場合、コネクターは正常に始動して警告メッセージを印刷し、要求処理のみを実行します。この場合はイベント処理は実行しません。
コネクターはラウンドロビン方式でキューをポーリングし、各キューから pollQuantity で指定された値を最大数とするメッセージを検索します。例えば、pollQuantity が 2 であり、MyQueueA に 2 件のメッセージがあり、MyQueueB に 1 件のメッセージがあり、MyQueueC に 5 件のメッセージがある場合は、コネクターは以下のようにメッセージを取得します。
PollQuantity が 2 に設定されているため、コネクターは、pollForEvents への 1 回の呼び出しごとに各キューからそれぞれ最大 2 つのメッセージを検索します。最初のサイクル (2 回のうちの 1 回目) では、コネクターは、MyQueueA、MyQueueB、および MyQueueC の各キューの 1 番目のメッセージを検索します。これによって、ポーリングの第 1 ラウンドが完了します。PollQuantity が 1 に設定されている場合、コネクターはこの時点で停止します。この例では PollQuantity が 2 に設定されているため、コネクターは第 2 ラウンド (2/2 ラウンド) のポーリングを開始し、MyQueueA と MyQueueC の各キューからそれぞれ 1 つずつのメッセージを検索します。このとき、MqQueueB は空になっているためスキップされます。すべてのキューを 2 回ずつポーリングしたら、メソッド pollForEvents への呼び出しは完了します。以下に、メッセージ検索の順序を示します。
デフォルト = queue://crossworlds.queue.manager/MQCONN.IN
処理中にメッセージが保留されるメッセージ・キューです。 System Manager を使用してデフォルトの InProgressQueue 名をコネクター固有のプロパティーから除去することにより、このキューなしで動作するようにコネクターを構成できます。このようにすると、始動時にイベントが保留されているときにコネクターをシャットダウンするとイベント・デリバリーで問題が発生する場合があることを示す警告メッセージが出されます。
デフォルト = queue://crossworlds.queue.manager/MQCONN.IN_PROGRESS
pollForEvents スキャン中に、InputQueue プロパティーで指定した各キューから取得するメッセージの数です。
デフォルト = 1
WebSphere MQ リスナー用に設定されたポートです。
デフォルト = 設定値なし
コネクターからの要求発行時に応答メッセージが配信されるキューです。子動的メタオブジェクトの属性を使用して応答を無視することもできます。このような属性の詳細については、JMS ヘッダー、WebSphere MQ メッセージ・プロパティー、および動的子メタオブジェクト属性を参照してください。
デフォルト = queue://crossworlds.queue.manager/MQCONN.REPLYTO
アンサブスクライブされたメッセージが送信されるキューです。
デフォルト = queue://crossworlds.queue.manager/MQCONN.UNSUBSCRIBED
Create 操作の場合、UseDefaults を true に設定すると、コネクターは、各 isRequired ビジネス・オブジェクト属性に有効値またはデフォルト値が指定されているかどうかをチェックします。値が指定されている場合、Create 操作は成功します。このパラメーターを false に設定すると、コネクターは有効値の有無だけをチェックし、有効値が指定されていない場合、Create 操作は失敗します。デフォルトは false です。