IBM WebSphere Message Broker バージョン 8.0.0.0 のツールとランタイム・コンポーネントに関する README 資料。
README ファイル: IBM WebSphere Message Broker
製品/コンポーネント・リリース: 8.0
発行日: 2011 年 12 月 9 日
最終更新日: 2011 年 12 月 9 日
常に最新版の README ファイルを使用してください。最新版の README ファイルは以下から入手できます (英語のみ)。
http://www.ibm.com/support/docview.wss?uid=swg27006917
翻訳された README ファイルは以下から入手できます。
ftp://public.dhe.ibm.com/software/integration/wbibrokers/docs/
製品をインストールする前に実行する必要のあるタスクについては、以下に提供されている「WebSphere Message Broker V8.0 インフォメーション・センター」を参照してください。
http://publib.boulder.ibm.com/infocenter/wmbhelp/v8r0m0/index.jsp
WebSphere Message Broker システム要件で、ご使用のインストール・プラットフォームが、インストールしようとしている製品版でサポートされていることを確認してください。WebSphere Message Broker システム要件の Web ページは以下で参照できます。
http://www.ibm.com/software/integration/wbimessagebroker/requirements/
Windows では、WebSphere Message Broker V8.0 の以下の 2 つのエディションが提供されています。
WebSphere Message Broker 64 ビット版は、Windows オペレーティング・システムのすべての 64 ビット版でサポートされるわけではありません。詳しくは、WebSphere Message Broker のシステム要件の Web ページを参照してください。
z/OS へのサービスの適用
z/OS にサービスを適用している場合は、 以下のようにして、プログラム一時修正 (PTF) パッケージをバイナリー・ファイルとしてダウンロードしてから、z/OS に転送する必要があります。
Organization . . . : PS
Record format . . . : FB
Record length . . . : 1024
Block size . . . . : 6144
1st extent tracks . : 500
Secondary tracks . : 50
これらのデータ・セットは、以下のサンプル JCL (ジョブ制御言語) を使用して割り振ることができます。
/* INSERT A VALID JOBCARD HERE
//*
//ALLOCATE EXEC PGM=IEFBR14
//SYSMOD1 DD DSN=YOUR HIGH LEVEL QUALIFIER (HLQ).PTF NUMBER.TRS,
// DISP=(NEW,CATLG,DELETE),
// UNIT=SYSDA,
// SPACE=(TRK,(500,50),RLSE),
// DSORG=PS,
// DCB=(RECFM=FB,LRECL=1024,BLKSIZE=6144)
//*
put PTF NUMBER.TRS 'YOUR HLQ.PTF NUMBER.TRS' (replace
変更が完了し、適切なジョブ・カードが追加されたら、以下のサンプル JCL を使用して データ・セットを解凍できます。
//*****************************************************
//* UNTERSE APAR
//*****************************************************
/UNPACK EXEC PGM=TRSMAIN,PARM='UNPACK'
//STEPLIB DD DISP=SHR,DSN=TERSE.LOADLIB
//SYSPRINT DD SYSOUT=*
//INFILE DD DSN=YOUR HLQ.PTF NUMBER.TRS,
// DISP=SHR
//OUTFILE DD DSN=YOUR HLQ.PTF NUMBER,
// DISP=(NEW,CATLG),
// SPACE=(TRK,(1000,100,))
/*
WebSphere Message Broker バージョン 6.1 またはバージョン 7.0 からマイグレーションする場合は、オンラインのインフォメーション・センター (http://publib.boulder.ibm.com/infocenter/wmbhelp/v8r0m0/index.jsp) を参照してください。これには、マイグレーション方法の詳細が記載されています。
WebSphere Message Broker V8.0 のオンラインのインフォメーション・センターは、以下に提供されています。
http://publib.boulder.ibm.com/infocenter/wmbhelp/v8r0m0/index.jsp
最新情報に関しては、オンラインのインフォメーション・センターを必ず参照してください。オンラインのインフォメーション・センターには、Message Broker Toolkit 付属のインフォメーション・センターよりも新しい情報が記載されています。
WebSphere Message Broker V8.0 GA のインフォメーション・センターには、データの記録と表示については記載されていますが、データの再生については記載されていません。
データの記録、表示、および再生についての包括的な最新情報は、PDF 版に提供されています。PDF をダウンロードするには、以下に提供されている技術情報を参照してください。
www.ibm.com/support/docview.wss?uid=swg21573603
スタンドアロンのインフォメーション・センターは、以下のアドレスからダウンロード可能です。
ftp://public.dhe.ibm.com/software/integration/wbibrokers/docs/V8.0/wmb_help_linux.tgz (Linux 版)
ftp://public.dhe.ibm.com/software/integration/wbibrokers/docs/V8.0/wmb_help_win.zip (Windows 版)
using_the_infocenter.html をお読みください。このファイルは wmb_help_linux.tgz および wmb_help_win.zip ファイルの ibm_help フォルダーに入っています。
障害: この README ファイルには、障害番号の参照が記載されていることがあります。これらの障害番号は IBM 社内問題番号を参照しており、 問題について IBM 技術員と相談するときにこの問題番号が役立ちます。
技術情報: 既知の問題と使用可能なフィックスの最新情報については、WebSphere Message Broker の以下のサポート用 Web サイトを参照してください。
http://www.ibm.com/support/entry/portal/Software/WebSphere/WebSphere_Message_Broker
技術情報を検索するには、「トラブルシューティング」をクリックしてください。WebSphere Message Broker の技術情報が表示され、それらを並び替えたり検索したりできます。
WebSphere Message Broker バージョン V8.0 のインストール・イメージをパスポート・アドバンテージの Web サイトからダウンロードする方法については、以下のダウンロード資料「Download WebSphere Message Broker V8.0 from the
Passport Advantage website」を参照してください。
http://www.ibm.com/support/docview.wss?uid=swg24030968
バージョン: WebSphere Message Broker でサポートされているオペレーティング・システムとデータベースのバージョンの最新情報については、以下のシステム要件のページを参照してください。
http://www.ibm.com/software/integration/wbimessagebroker/requirements/index.html
WebSphere Message Broker Toolkit の更新 (英語版やその他の対応言語版の資料の更新も含む) は定期的に確認してください。WebSphere Message Broker の推奨フィックスについては、以下のサイトを参照してください。
http://www.ibm.com/support/docview.wss?uid=swg27006041
バージョン 8.0 の新機能の詳細は、以下に記載されています。
http://publib.boulder.ibm.com/infocenter/wmbhelp/v8r0m0/index.jsp?topic=/com.ibm.etools.mft.doc/bb23110_.htm
このセクションでは、WebSphere Message Broker の既知の問題、およびその対処方法 (存在する場合) の概要をコンポーネント別に示します。
症状:
Windows 7 または Windows Server 2008 R2 を使用している場合に WebSphere Message Broker アンインストール・プログラム uninstaller.exe を実行すると、アンインストール・ファイルが署名されていないことを警告するダイアログが表示される場合があります。
解決方法:
この警告は無視しても問題ありません。アンインストール・プロセスを続行してください。
症状:
IBM パスポート・アドバンテージから入手した電子イメージを使用して IBM 製品をインストールする場合に、Windows XP Service Pack 2 以上では、Windows のセキュリティーの設定によって添付ファイル マネージャがインストーラーの .zip ファイルの内容をブロックして、インストールが失敗する場合があります。
解決方法:
この問題を回避するには、以下の手順を実行します。
Windows 添付ファイル マネージャの詳細については、Microsoft のサポート・サイト (http://support.microsoft.com/kb/883260) を参照してください。
WebSphere Message Broker V8.0 GA ランタイム・コンポーネントのインストール・イメージは、物理 CD に推奨されている 700 MB の制限を超えます。そのため、HP-UX プラットフォームのインストール・イメージは、物理 CD ではなく物理 DVD で提供されます。WebSphere Message Broker V8.0 GA ランタイム・コンポーネントのインストール・イメージは、パスポート・アドバンテージの Web サイトからも入手することができます。
WebSphere Message Broker バージョン V8.0 のインストール・イメージをパスポート・アドバンテージの Web サイトからダウンロードする方法については、以下のダウンロード資料「Download WebSphere Message Broker V8.0 from the
Passport Advantage website」を参照してください。
http://www.ibm.com/support/docview.wss?uid=swg24030968
WebSphere Message Broker は Ubuntu でサポートされていますが、開発システムを使用する場合に限定されます。Ubuntu で、実動システムを使用して WebSphere Message Broker を実行することはできません。
詳しくは、WebSphere Message Broker のシステム要件のページを参照してください。WebSphere Message Broker システム要件の Web ページは以下で参照できます。
http://www.ibm.com/software/integration/wbimessagebroker/requirements/
症状:
複数の出力端末を持つノードを他のノードに接続しようとしても、接続を確立できません。
解決方法:
この問題に対処するには、以下のいずれかの手順を実行してください。
WebSphere Message Broker Explorer をキュー・マネージャーに接続して資料を取得するには、キュー・マネージャーの SVRCONN チャネルの SHARECNV プロパティーが 0 より大きい値である必要があります。この値は、WebSphere Message Broker Explorer で「ブローカー統計」または 「ブローカー統計グラフ」ビューを使用する場合に必要です。
症状:
WebSphere Message Broker Toolkit とそのリソースを V8.0 にマイグレーションした後、WebSphere Message Broker Toolkit V8.0 では削除された項目が表示される場合があります (例えば、メニュー内に以前のツールキットのオプションが表示されるなど)。また、原因不明のエラーが表示される場合があります。
解決方法:
この問題を解決するには、以下の手順を実行してください。
症状:
リソースを新規ワークスペースへインポートすると、自動ビルドの完了後にエラー・メッセージが表示されることがあります。
解決方法:
「ブローカー開発」ビューでプロジェクトを選択し、「プロジェクト」>「クリーン」を右クリックして、プロジェクトを再ビルドしてください。プロジェクトをクリーニングしたら、インポートに関連するエラー・メッセージが表示されなくなります。
mqsicreatebar
を使用して新規ワークスペースを指定するには、プロジェクト・クリーンが必要な場合がある症状:
mqsicreatebar
コマンドの実行時、新規ワークスペースを指定すると、エラー・メッセージが表示されることがあります。
解決方法:
mqsicreatebar
コマンドの実行時に -cleanBuild
オプションを使用して、プロジェクトをクリーニングしてください。
症状:
WebSphere Message Broker Toolkit V8.0.0.0 GA に含まれるインフォメーション・センターを使用すると、Data Format Description Language (DFDL) のトピックが米国英語でのみ表示されます。
これらのトピックの ID は「dfxxxxx_」 (「xxxxx」は 5 桁の数字) です。
解決方法:
これらのトピックを米国英語以外の言語で参照するには、オンラインのインフォメーション・センターを使用してください。WebSphere Message Broker V8.0 の以下のオンラインのインフォメーション・センターには、最新の翻訳済みの資料が提供されています。
http://publib.boulder.ibm.com/infocenter/wmbhelp/v8r0m0/index.jsp
症状:
WebSphere Adapter for SAP Software の Enterprise Metadata Discovery (EMD) の反復ディスカバリー の実行中に、アダプター接続ウィザードの「サービスの生成およびデプロイメントの構成 」パネルが表示され、編集が可能ですが、入力したアダプター・システム接続情報はアダプター・コンポーネントに保存されません。
解決方法:
WebSphere Adapters エディターを使用して、アダプター・システム接続情報を変更し、後続の EMD 反復ディスカバリーでアダプター・システム接続情報が保存されるようにしてください。
症状:
アダプター・ウィザードで「確実な送達」チェック・ボックスが選択されていると、JDE インバウンド・アダプターはデプロイに失敗します。以下のエラーが発行されます。
プロパティー「AssuredOnceDelivery」をアダプター・コンポーネント「AssuredDeliveryMSApp.IBM WebSphere Adapter for JD Edwards EnterpriseOne」上に設定しようとしましたが、そのプロパティーがサポートされていないので失敗しました。
解決方法:
この機能は現在サポートされていません。メッセージ・フローの開発には使用しないでください。
症状:
グラフィカル・データ・マップを使用してデータベースから取得した入力データをマップする場合、スキーマ名は、ご使用のデータベース・サーバーのデフォルトのスキーマ名の構成に依存します。ブローカーは、現在は、データベースに対して発行される SQL ステートメント内で使用されるデータベース・スキーマ名をオーバーライドする機能を提供していません。現在、マップによって発行される SQL ステートメントには、データベース名とテーブル名のみが含まれており、スキーマ名は含まれていません。結果として、データベース・サーバーは、ブローカーがマップの実行中にデータベース・サーバーに接続するために ID 用に使用した、デフォルトのデータベース・スキーマ名を使用します。ブローカーが使用する接続 ID は、ブローカーの JDBCProvider 構成可能サービスで構成されます。使用する JDBCProvider 構成可能サービスは、マップ内のデータ・ソース名によって選択されます。
必要なデータベース・テーブルがこのスキーマ内で使用可能でない場合、ご使用のデータベース・サーバー固有のエラー・コードを含むブローカー・エラーが表示され、マップの実行が失敗します。以下に例を示します。
BIP3947E: QName '{maps}:RDB_Mapping' のマップの処理が失敗しました。詳細は以下のとおりです:
'{データベース・スキーマ・テーブル・アクセスについての固有のエラー・メッセージとコード}'
解決方法:
グラフィカル・データ・マップから選択したテーブルが、JDBCProvider 構成可能サービスで構成されたデータベース接続 ID 用のデータベース・サーバーによって設定されたスキーマ内で使用可能であることを確認してください。これは、z/OS では特に制限されます。
症状:
Z シェル (zsh) をシェル環境として使用する UNIX システムでは、'source {install path}/mqsiprofile' を呼び出すとシェルが終了します。zsh のデフォルトの動作により、mqsiprofile コマンドは、正しくない引数番号を確認して、それがソースとして指定されているのか直接実行されているのかを判断します。その後、mqsiprofile スクリプトは警告メッセージを出力して終了を呼び出しますが、zsh はこの呼び出しを現在のシェルの終了指示であると解釈します。
解決方法:
この問題に対処するには、以下の手順を実行してください。
症状:
インフォメーション・センターのトピック an19545_ mqsiapplybaroverride では、アプリケーションおよびライブラリーでの -k および -y パラメーターの使用について説明しています。これらのパラメーターをコマンドで使用すると、以下のエラーが発生します。
BIP1033E: 無効なパラメーター (Invalid parameters)
解決方法:
これらのオプションは、コマンドでの使用はサポートされていないため、使用しないでください。
z/OS 上のユーザー・データベースを使用する場合は、DB2 APAR PK99362 が必要です。
グローバル座標指定 (XA) トランザクションはサポートされていません。
JDBC/XA グローバル座標指定 (XA) トランザクションは、HP-UX/Itanium および z/OS 以外のすべてのブローカー・プラットフォーム上の DB2 および Oracle (Oracle RAC を除く) でサポートされています。
ODBC XA および JDBC/XA を同一ブローカー上で混用することはできません。
Informix グローバル座標指定 (XA) トランザクションはサポートされていません。
Windows Server 2008 R2 および 64 ビット版の Windows 7 でサポートされるのは、DB2 および Microsoft SQL Server のみです。DB2 および Microsoft SQL Server のシステム要件のページを参照して、各製品のどのバージョンがご使用のシステムに適切かを判断してください。
DB2 のシステム要件の Web ページは、以下のとおりです。
http://www.ibm.com/software/data/db2/linux-unix-windows/sysreqs.html
http://www.ibm.com/legal/copytrade.shtml
本書は米国 IBM が提供する製品およびサービスについて作成したものです。
本書に記載の製品、サービス、または機能が日本においては提供されていない場合があります。 日本で利用可能な製品、サービス、および機能については、日本 IBM の営業担当員にお尋ねください。 本書で IBM 製品、プログラム、またはサービスに言及していても、その IBM 製品、プログラム、または サービスのみが使用可能であることを意味するものではありません。これらに代えて、IBM の知的所有権を侵害することのない、機能的に同等の 製品、プログラム、またはサービスを使用することができます。 ただし、IBM 以外の製品とプログラムの操作またはサービスの 評価および検証は、お客様の責任で行っていただきます。
IBM は、本書に記載されている内容に関して特許権 (特許出願中のものを含む) を保有している場合があります。本書の提供は、お客様にこれらの特許権について 実施権を許諾することを意味するものではありません。 実施権についてのお問い合わせは、書面にて下記宛先にお送りください。
以下の保証は、国または地域の法律に沿わない場合は、適用されません。
IBM およびその直接または間接の子会社は、本書を特定物として現存するままの状態で提供し、 商品性の保証、特定目的適合性の保証および法律上の瑕疵担保責任を含むすべての明示 もしくは黙示の保証責任を負わないものとします。国または地域によっては、法律の強行規定により、保証責任の制限が 禁じられる場合、強行規定の制限を受けるものとします。
この情報には、技術的に不適切な記述や誤植を含む場合があります。 本書は定期的に見直され、必要な変更は本書の次版に組み込まれます。 IBM は予告なしに、随時、この文書に記載されている製品またはプログラムに対して、 改良または変更を行うことがあります。
本書において IBM 以外の Web サイトに言及している場合がありますが、便宜のため記載しただけであり、決してそれらの Web サイトを推奨するものではありません。 それらの Web サイトにある資料は、この IBM 製品の資料の一部では ありません。それらの Web サイトは、お客様の責任でご使用ください。
IBM は、お客様が提供するいかなる情報も、お客様に対してなんら義務も負うことのない、 自ら適切と信ずる方法で、使用もしくは配布することができるものとします。
本プログラムのライセンス保持者で、(i) 独自に作成したプログラムと その他のプログラム (本プログラムを含む) との間での情報交換、 および (ii) 交換された情報の相互利用を可能にすることを目的として、 本プログラムに関する情報を必要とする方は、下記に連絡してください。
本プログラムに関する上記の情報は、適切な使用条件の下で使用すること ができますが、有償の場合もあります。
本書で説明されているライセンス・プログラムまたはその他の ライセンス資料は、IBM 所定のプログラム契約の契約条項、IBM プログラムのご使用条件、またはそれと同等の条項に基づいて、 IBM より提供されます。
IBM 以外の製品に関する情報は、その製品の供給者、出版物、 もしくはその他の公に利用可能なソースから入手したものです。IBM は、それらの製品のテストは行っておりません。したがって、 他社製品に関する実行性、互換性、またはその他の要求については確証できません。 IBM 以外の製品の性能に関する質問は、それらの製品の供給者にお願いします。
本書には、日常の業務処理で用いられるデータや報告書の例が含まれています。より具体性を与えるために、それらの例には、個人、企業、ブランド、 あるいは製品などの名前が含まれている場合があります。 これらの名称はすべて架空のものであり、 名称や住所が類似する企業が実在しているとしても、それは偶然にすぎません。
著作権使用許諾:
本書には、様々なオペレーティング・プラットフォームでのプログラミング手法を例示するサンプル・アプリケーション・プログラムがソース言語で掲載されています。お客様は、サンプル・プログラムが書かれているオペレーティング・ プラットフォームのアプリケーション・プログラミング・インターフェースに 準拠したアプリケーション・プログラムの開発、使用、販売、配布を目的として、 いかなる形式においても、IBM に対価を支払うことなくこれを複製し、改変し、 配布することができます。 このサンプル・プログラムは、あらゆる条件下における完全なテストを経ていません。 従って IBM は、これらのサンプル・プログラムについて信頼性、利便性もしくは機能性が あることをほのめかしたり、保証することはできません。 お客様は、IBM のアプリケーション・プログラミング・インターフェースに準拠した アプリケーション・プログラムの開発、使用、販売、配布を目的として、いかなる形式においても、 IBM に対価を支払うことなくこれを複製し、改変し、配布することができます。
以下は、International Business Machines Corporation の米国およびその他の国における商標です。
DB2、developerWorks、IBM、Informix、WebSphere、z/OS。
Java およびすべての Java 関連の商標およびロゴは Oracle やその関連会社の米国およびその他の国における商標または登録商標です。
Microsoft および Windows は、Microsoft Corporation の米国およびその他の国における商標です。
UNIX は、The Open Group の米国およびその他の国における登録商標です。
Linux は、Linus Torvalds の米国およびその他の国における商標です。
他の会社名、製品名およびサービス名等はそれぞれ各社の商標です。
WebSphere Message Broker 製品ページ
http://www.ibm.com/software/integration/wbimessagebroker/
DB2 フィックスパック
現行のサポート契約をお持ちの場合は、DB2 サポートに電話して DB2 フィックスパックの CD 版を注文することができます。DB2 フィックスパックは Web からダウンロードすることもできますが、一部のフィックスパックのファイルはサイズが大きいため、CD 版を注文するとダウンロードにかかる時間を回避できます。
DB2 サポートの連絡先の詳細と DB2 フィックス・パックのダウンロードは、以下から入手できます。
http://www.ibm.com/software/data/db2/udb/support.html
WebSphere MQ フィックスパック (英語)
http://www.ibm.com/support/entry/portal/Software/WebSphere/WebSphere_MQ
WebSphere Message Broker フィックスパック (英語)
http://www.ibm.com/support/docview.wss?uid=swg27006041
WebSphere Message Broker 要件 (英語)
http://www.ibm.com/software/integration/wbimessagebroker/requirements/
WebSphere Message Broker README ファイル (英語)
http://www.ibm.com/support/docview.wss?uid=swg27006917
WebSphere Message Broker V8.0 スタンドアロン版インフォメーション・センター
Linux の場合:
ftp://public.dhe.ibm.com/software/integration/wbibrokers/docs/V8.0/wmb_help_linux.tgz
Windows の場合:
ftp://public.dhe.ibm.com/software/integration/wbibrokers/docs/V8.0/wmb_help_win.zip
WebSphere Message Broker V8.0 オンライン・インフォメーション・センター
http://publib.boulder.ibm.com/infocenter/wmbhelp/v8r0m0/index.jsp
IBM Centre for Java™ Technology Development
ダウンロード (英語)
http://www.ibm.com/developerworks/java/jdk/
Web Services Description Language (WSDL) の仕様 (英語)
http://www.w3.org/TR/wsdl
WebSphere Message Broker developerWorks ゾーン (英語)
http://www.ibm.com/developerworks/websphere/zones/businessintegration/wmb.html