コネクターの構成

コネクターの構成プロパティーには、標準構成プロパティーとアダプター固有の構成プロパティーという 2 つのタイプがあります。アダプターを実行する前に、必ずこれらのプロパティーの値を設定してください。

Connector Configurator Express を使用して、コネクター・プロパティーを構成することができます。

コネクターは、始動時に構成値を取得します。実行時のセッション中に、1 つ以上のコネクター・プロ パティーの値を変更できます。AgentTraceLevel など一部のコネクター構成プロパティーへの変更は、即時に有効になります。その他のコネクター・プロパティーへの変更を有効にするには、変更後にコンポーネントまたはシステムを再始動する必要があります。あるプロパティーが動的 (即時に有効になる) か静的 (コネクター・コンポーネントまたはシステムを再始動する必要がある) かを判別するには、Connector Configurator Express の「コネクター・プロパティー」ウィンドウ内の「更新メソッド」列を参照してください。

標準コネクター・プロパティー

標準構成プロパティーにより、すべてのコネクターによって使用される情報が提供されます。標準構成プロパティーの資料については、付録 A, コネクターの標準構成プロパティーを参照してください。

注:
Connector Configurator Express で構成プロパティーを設定するときは、BrokerType プロパティーを InterChange Server Express に設定します。InterChange Server Express に関連するプロパティーが「Connector Configurator Express」ウィンドウに表示されます。

コネクター固有のプロパティー

コネクター固有の構成プロパティーは、コネクターが実行時に必要とする情報を提供します。また、コネクター固有のプロパティーを使用すれば、エージェントを再コーディングまたは再ビルドせずに、コネクター内の静的情報やロジックを変更できます。

注:
WebSphere MQ が提供する値が誤っていたり、不明である可能性があるので、必ずこれらの値をチェックしてください。供給された値が不適切であれば、その値を明示的に指定してください。

表 11 に、Connector for SWIFT のコネクター固有の構成プロパティーを示します。プロパティーの説明については、以下の各セクションを参照してください。

表 11. コネクター固有のプロパティー
名前 指定可能な値 デフォルト値 必須
ApplicationPassword ログイン・パスワード
いいえ
ApplicationUserID ログイン・ユーザー ID
いいえ
ArchiveQueue 正常に処理されたメッセージのコピーが送信されるキュー queue://CrossWorlds. QueueManager/MQCONN.
ARCHIVE
いいえ
Channel MQ サーバー・コネクター・チャネル
はい
ConfigurationMetaObject 構成メタオブジェクトの名前
はい
DataHandlerClassName データ・ハンドラー・クラス名 com.crossworlds. DataHandlers.swift. SwiftDataHandler いいえ
DataHandlerConfigMO データ・ハンドラー・メタオブジェクト MO_DataHandler_Default はい
DataHandlerMimeType ファイルの MIME タイプ swift いいえ
DefaultVerb コネクターによってサポートされる動詞 Create
ErrorQueue 未処理のメッセージのキュー queue://crossworlds. Queue.manager/
MQCONN.ERROR
いいえ
FeedbackCodeMappingMO フィードバック・コード・メタオブジェクト
いいえ
HostName WebSphere MQ サーバー
いいえ
InDoubtEvents FailOnStartup Reprocess Ignore LogError Reprocess いいえ
InputQueue ポーリング・キュー queue://CrossWorlds. QueueManager/MQCONN.IN はい
InProgressQueue 進行中イベント・キュー queue://CrossWorlds. QueueManager/ MQCONN.IN_PROGRESS いいえ
PollQuantity InputQueue プロパティーで指定された各キューから検索するメッセージの数 1 いいえ
Port WebSphere MQ リスナーのために確立するポート
いいえ
ReplyToQueue コネクターからの要求発行時に応答メッセージが配信されるキュー queue://CrossWorlds. QueueManager/MQCONN.REPLYTO いいえ
UnsubscribedQueue アンサブスクライブされたメッセージが送信されるキュー queue://CrossWorlds. QueueManager/MQCONN. UNSUBSCRIBE いいえ
UseDefaults true または false false

ApplicationPassword

WebSphere MQ へのログイン時に ApplicationUserID とともに使用されるパスワード。

デフォルト = なし。

ApplicationPassword がブランクの場合または除去された場合、コネクターは、WebSphere MQ が提供するデフォルトのパスワードを使用します。

ApplicationUserID

WebSphere MQ へのログイン時に ApplicationPassword とともに使用されるユーザー ID。

デフォルト = なし。

ApplicationUserIDがブランクの場合または除去された場合、コネクターは、WebSphere MQ が提供するデフォルトのユーザー ID を使用します。

ArchiveQueue

正常に処理されたメッセージのコピーが送信されるキューです。

デフォルト = queue://crossworlds.Queue.manager/MQCONN.ARCHIVE

Channel

コネクターが WebSphere MQ と通信するために経由する MQ サーバー・コネクター・チャネルです。

デフォルト = なし。

Channel の値が空白のままか、あるいはこのプロパティーが除去された場合、コネクターは WebSphere MQ から提供されるデフォルト・サーバー・チャネルを使用します。

ConfigurationMetaObject

コネクターの構成情報を含む静的なメタオブジェクトの名前です。

デフォルト = なし。

DataHandlerClassName

ビジネス・オブジェクトとの間でのメッセージ変換に使用するデータ・ハンドラー・クラスです。

デフォルト = com.crossworlds.DataHandlers.swift.SwiftDataHandler

DataHandlerConfigMO

構成情報を提供するためにデータ・ハンドラーに渡されるメタオブジェクトです。

デフォルト = MO_DataHandler_Default

DataHandlerMimeType

使用すると、特定の MIME タイプに基づいたデータ・ハンドラーを要求できます。

デフォルト = swift

DefaultVerb

ポーリング中にデータ・ハンドラーが動詞を設定しなかった場合に、着信ビジネス・オブジェクト内に設定される動詞を指定します。

デフォルト = Create

ErrorQueue

処理されなかったメッセージが送信されるキューです。

デフォルト = queue://crossworlds.Queue.manager/MQCONN.ERROR

FeedbackCodeMappingMO

メッセージの受信を WebSphere InterChange Server Express に同期的に知らせるのに使用される、デフォルトのフィードバック・コードをオーバーライドして再割り当てすることができます。このプロパティーを使用すると、それぞれの属性名がフィードバック・コードを表すと解釈されるメタオブジェクトを指定できます。フィードバック・コードに対応する値は、InterChange Server Express に渡される戻り状況値です。デフォルトのフィードバック・コードのリストについては、同期確認通知を参照してください。コネクターは、WebSphere MQ 固有のフィードバック・コードを表す、次の属性値を受け入れます。

コネクターは、次の WebSphere Business Integration Server Express システム固有の状況コードを、メタオブジェクトの属性値として受け入れます。

表 12 に、メタオブジェクトのサンプルを示します。

表 12. フィードバック・コードのメタオブジェクト属性の例
属性名 デフォルト値
MQFB_APPL_FIRST SUCCESS
MQFB_APPL_FIRST + 1 FAIL
MQFB_APPL_FIRST + 2 UNABLE_TO_LOGIN

デフォルト = なし。

HostName

WebSphere MQ のホストであるサーバーの名前です。

デフォルト = なし。

HostName が空白のままか、あるいは除去された場合、コネクターは WebSphere MQ にホストを決定させます。

InDoubtEvents

コネクターの予期しないシャットダウンのために、処理が完了していない進行中イベントの処理方法を指定します。初期化中に進行中キューにイベントが見つかった場合に実行するアクションを、以下の 4 つから選択してください。

デフォルト = Reprocess

InputQueue

コネクターが新規メッセージをポーリングするメッセージ・キューを指定します。 SWIFTAlliance Gateway へのルーティング用に WebSphere MQ キューを設定する方法については、MQSA の資料を参照してください。

コネクターは、セミコロンで区切られた複数のキュー名を受け入れます。例えば、キュー MyQueueAMyQueueB、および MyQueueC をポーリングするには、コネクター構成プロパティー InputQueue の値を MyQueueA;MyQueueB;MyQueueC とします。

コネクターは、ラウンドロビン方式でキューをポーリングして、各キューから最大 pollQuantity 個のメッセージを検索します。例えば、pollQuantity が 2 であり、MyQueueA に 2 件のメッセージがあり、MyQueueB に 1 件のメッセージがあり、MyQueueC に 5 件のメッセージがある場合は、コネクターは以下のようにメッセージを取得します。

pollQuanity が 2 に設定されていると、コネクターは、pollForEvents を呼び出すごとに各キューから最大で 2 つのメッセージを検索します。最初のサイクル (2 回のうちの 1 回目) では、コネクターは、MyQueueAMyQueueB、および MyQueueC の各キューの 1 番目のメッセージを検索します。これで最初のポーリング巡回は完了です。コネクターは 2 回目のポーリング巡回 (2/2 回目) を開始し、MyQueueA および MyQueueC からメッセージを 1 つずつ検索します。MqQueueB は空になっているので、このキューはスキップされます。すべてのキューを 2 回ポーリングしたら、メソッド pollForEvents への呼び出しは完了します。このメッセージ検索の順序は以下のとおりです。

  1. MyQueueA から 1 件のメッセージ
  2. MyQueueB から 1 件のメッセージ
  3. MyQueueC から 1 件のメッセージ
  4. MyQueueA から 1 件のメッセージ
  5. 空になったため、MyQueueB をスキップ
  6. MyQueueC から 1 件のメッセージ

デフォルト = queue://crossworlds.Queue.manager/MQCONN.IN

InProgressQueue

処理中にメッセージを保持するメッセージ・キュー。System Manager を使用してコネクター固有のプロパティーから デフォルトの InProgressQueue 名を削除することによって、このキューなしで動作するようコネクターを構成できます。そのように設定すると、イベントの保留中にコネクターがシャットダウンされたときにイベント・デリバリーが影響を受ける場合があるという警告のプロンプトが、始動時に出されます。

デフォルト = queue://crossworlds.Queue.manager/MQCONN.IN_PROGRESS

PollQuantity

pollForEvents スキャン中に InputQueue プロパティーで指定された各キューから検索するメッセージの数。

デフォルト =1

Port

WebSphere MQ リスナーのために確立するポート。

デフォルト = なし。

Port の値が空白のままか、あるいはこのプロパティーが除去された場合、コネクターは WebSphere MQ に適切なポートを決定させます。

ReplyToQueue

コネクターからの要求発行時に応答メッセージが配信されるキューです。

デフォルト = queue://crossworlds.Queue.manager/MQCONN.REPLYTO

UnsubscribedQueue

サブスクライブされていないビジネス・オブジェクトについてのメッセージが送信されるキューです。

デフォルト = queue://crossworlds.Queue.manager/MQCONN.UNSUBSCRIBED

UseDefaults

Create 操作では、UseDefaults を true に設定した場合に、各 isRequired ビジネス・オブジェクト属性に対して有効な値またはデフォルト値が指定されているかどうかをコネクターがチェックします。値が指定されている場合、Create 操作は成功します。この パラメーターを false に設定すると、コネクターは有効値の有無だけをチェックし、有効値が指定されていない場合、Create 操作は失敗します。デフォルト値は false です。

Copyright IBM Corp. 2004