環境のセットアップ
このセクションでは、チュートリアルを使用して作業できる環境の準備の仕方について説明します。後出の sample_folder は、サンプルがあるフォルダーを指します。
- キューの作成 このチュートリアルでは、JMS サービス・プロバイダーに 6 つのキューが定義されていることが必要です。これらのキューを定義する前に、JMS プロバイダーの資料を参照してください。次のキューを定義してください
(あるいは JNDI ルックアップを介して使用可能にしてください)。
- CWLD_Input
- CWLD_InProgress
- CWLD_Error
- CWLD_Archive
- CWLD_Unsubscribed
- CWLD_Output
- WebSphere MQ キュー・マネージャーの作成および開始
チャネル・イニシエーターとリスナーも実行します。
- キューの定義 WMQI ブローカーを構成するために WebSphere
MQ アダプターおよびポート・コネクターが必要とするキューを以下のように定義します。
- DEFINE QL('JMSConnector/ADMININQUEUE')
- DEFINE QL('JMSConnector/ADMINOUTQUEUE')
- DEFINE QL('JMSConnector/DELIVERYQUEUE')
- DEFINE QL('JMSConnector/FAULTQUEUE')
- DEFINE QL('JMSConnector/REQUESTQUEUE')
- DEFINE QL('JMSConnector/RESPONSEQUEUE')
- DEFINE QL('JMSConnector/SYNCHRONOUSREQUESTQUEUE')
- DEFINE QL('JMSConnector/SYNCHRONOUSRESPONSEQUEUE')
- DEFINE QL('PortConnector/ADMININQUEUE')
- DEFINE QL('PortConnector/ADMINOUTQUEUE')
- DEFINE QL('PortConnector/DELIVERYQUEUE')
- DEFINE QL('PortConnector/FAULTQUEUE')
- DEFINE QL('PortConnector/REQUESTQUEUE')
- DEFINE QL('PortConnector/RESPONSEQUEUE')
- DEFINE QL('PortConnector/SYNCHRONOUSREQUESTQUEUE')
- DEFINE QL('PortConnector/SYNCHRONOUSRESPONSEQUEUE')
- アダプターの構成 Connector Configurator Express を使用して、sample_folder¥JMSConnector.cfg を開きます。Connector Configurator Express の使用法に関する詳細情報は、付録B. Connector Configurator Expressを参照してください。コネクター固有プロパティーの詳細については、コネクター固有プロパティーの構成を参照してください。
以下の標準プロパティーを設定します。
- Broker Type このプロパティーを WMQI に設定します。
- Repository Directory このプロパティーを sample_folder ディレクトリーに設定します。
以下のコネクター固有プロパティーを設定します。
- DuplicateEventElimination このプロパティーを true に設定します。
- MonitorQueue このプロパティーを JMSConnector/MONITORQUEUE に設定します。
- ConfigurationMetaObject このプロパティーを Sample_JMS_MO_Config に設定します。
- DataHandlerConfigMO このプロパティーを Sample_JMS_MO_DataHandler に設定します。
- DataHandlerMimeType このプロパティーを text/delimited に設定します。
- ErrorQueue このプロパティーを CWLD_Error に設定します。
- InputQueue このプロパティーを CWLD_Input に設定します。
- UnsubscribedQueue このプロパティーを CWLD_Unsubscribed に設定します。
- ポート・コネクターの構成 Connector Configurator Express を使用して、以下の標準プロパティーを設定します。
- Broker Type このプロパティーを WMQI に設定します。
- Repository Directory このプロパティーを sample_folder ディレクトリーに設定します。
- RequestQueue このプロパティーを JMSConnector/DELIVERYQUEUE に設定します (JMS アダプターの DeliveryQueue プロパティー値)。
- DeliveryQueue このプロパティーを JMSConnector/REQUESTQUEUE に設定します (JMS アダプターの RequestQueue プロパティー値)。
- ビジネス・オブジェクトのサポート ビジネス・オブジェクトを使用するには、まずアダプターがビジネス・オブジェクトをサポートする必要があります。Connector Configurator Express を使用して、JMS アダプターの「サポートされているビジネス・オブジェクト」タブをクリックして、表 20 に記載されているビジネス・オブジェクトを追加します。「メッセージ・セット ID」をサポートされているそれぞれのビジネス・オブジェクトごとに固有な値に設定します。
表 20. JMS アダプターについてサポートされるサンプル・ビジネス・オブジェクト
ビジネス・オブジェクト名 |
メッセージ・セット ID |
Sample_JMS_MO_Config |
1 |
Sample_JMS_MO_DataHandler |
2 |
Sample_JMS_Contact |
3 |
Connector Configurator Express を使用して、sample_folder 内にあるポート・コネクター定義 PortConnector.cfg を開きます。次に、表 21 に記載されたサポートされるビジネス・オブジェクトとメッセージ・セット ID を追加します。
表 21. ポート・コネクターについてサポートされるサンプル・ビジネス・オブジェクト
ビジネス・オブジェクト名 |
メッセージ・セット ID |
Sample_JMS_Contact |
1 |
- コネクター開始スクリプトの作成または更新
Windows の場合
- Adapter for JMS のショートカットのプロパティーを開きます。
- ターゲットの最後の引数として、-c の後ろに <JMSConnector.cfg ファイルの絶対パスおよびファイル名> を続けたものを追加します。例:
-cProduct_Dir¥connectors¥JMS¥samples¥JMSConnector.cfg
Linux:
- ファイル Product_Dir/bin/connector_manager_JMS を開きます。
- AGENTCONFIG_FILE プロパティーを -c の後ろに <JMSConnector.cfg ファイルの絶対パスおよびファイル名> を続けた値に設定します。例:
AGENTCONFIG_FILE=-cProduct_Dir/connectors/JMS/samples/JMSConnector.cfg
