mqsicvp コマンド

mqsicvp コマンドは、ブローカーで検証テストを実行するために使用します。

サポートされるプラットフォーム

  • Windows
  • Linux および UNIX システム

mqsistart コマンドを使用してブローカーを開始する場合、このコマンドは自動的に実行してコンポーネントを検査します。

z/OS® 上では、ブローカーを開始すると、同じ検証手順が自動的に実行されます。

このコマンドは、ブローカーが実行しているかどうかに関係なく実行できます。ブローカーが実行中でない場合、検証テストは実行されますが、ブローカーは開始されません。

目的

mqsicvp コマンドの場合、

  • ブローカー環境が正しくセットアップされていることを検査します (例えば、インストールされているレベルの Java がサポートされていることなど)。
  • WebSphere® MQ のキューが定義済みでありアクセス可能であることを検証します。

mqsicvp コマンドはこれらすべての検査を実行し、 1 つ以上の検査が失敗した場合にはこのコマンドが失敗します。 すべてのエラーは、システム・ログ、コマンド行、またはその両方に報告されます。

ユーザー・データ・ソースに関する情報を提供するためのコマンドの使用

mqsicvp コマンドの追加の呼び出しが、以下の ODBC Test Tool 機能を提供するために追加されています。
  • ユーザー・データ・ソースに関する役立つ情報および診断の提供、または
  • 2 つのユーザー・データ・ソースが等価かどうかの比較。
これらの呼び出しは mqsicvp コマンドによる既存の呼び出しからは分離されていて、ブローカーの開始時には実行しないことに注意してください。

ただし、既存の呼び出しおよびブローカーの開始も Linux および UNIX システムで拡張されていて、データベース接続に対して WebSphere Message Broker Database Extender サポートパックを mqsisetdbparms コマンドと共に使用するとき、この ODBC テスト関数をブローカーに関連付けられた新しいユーザー・データ・ソース用に取り込みます。

mqsicvp コマンドを ODBC Test Tool として使用すると、コマンドは接続が成功したときに通知メッセージを発行して、データ・ソースの名前、データベース・タイプ、およびバージョンを示します。 2 次データ・ソースが提供された場合、mqsicvp コマンドはそのデータ・ソースへの接続が成功したときに 2 番目の通知メッセージを発行して、2 次データ・ソースに関する同じ情報を示し、比較が実行されることを伝えます。

データ・ソースに対して実行するとき、ツールは ODBC インターフェースに対して複数の検査を行い、どのデータ・タイプおよび機能がサポートされるか、およびそれらのデータ・タイプの名前およびサイズの情報を確認します。 いずれかのデータ・タイプまたは機能がサポートされていない場合、それらは最後の通知メッセージで要約されます。

2 つのデータ・ソースに対して実行すると、それらの同じテストは両方のデータ・ソースに対して実行され、両方の結果が画面に出力されます。 最後の通知メッセージは、2 つのデータ・ソースが等価かどうか、および同じメッセージ処理ノードで使用可能かどうかを知らせます。 詳しくは、ESQL からデータベースへのアクセスを参照してください。

構文

既存の呼び出し

構文図を読む構文図をスキップする
>>-mqsicvp--brokername-----------------------------------------><

構文

完全に指定されたデータ・ソース名を使用する新規の呼び出し

各データ・ソース名 (DSN) は、ユーザー名およびパスワードと共に完全に指定されます。

この呼び出しは、ブローカーとデータ・ソースの間の関連には依存せず、ブローカーとの間に関連のないデータ・ソースに関しても情報を返します。

構文図を読む構文図をスキップする
>>-mqsicvp-- -n--primaryDatasourceName-------------------------->

>-- -u--primaryDatasourceUserId--------------------------------->

>-- -p--primaryDatasourcePassword------------------------------->

>--+------------------------------------------------------------------------------------------------+-->
   '- -c--secondaryDatasourceName-- -i--secondaryDatasourceUserId-- -a--secondaryDatasourcePassword-'   

>--+-----+-----------------------------------------------------><
   '- -v-'   

構文

データ・ソース名がブローカーに関連付けられている新しい呼び出し

この呼び出しでは、ブローカーとデータ・ソース名 (DSN) の間の関連が必要です。 この呼び出しを正常に実行するためには、最初に mqsisetdbparms コマンドを実行して、ブローカーがデータ・ソースに接続するときに使用する特定のユーザー ID とパスワードを識別しておく必要があります。 この呼び出しの出力は、完全に指定されたデータ・ソース名を使用する呼び出しの出力と同じです。

構文図を読む構文図をスキップする
>>-mqsicvp--brokername-- -n--primaryDatasource------------------>

>--+--------------------------+--+-----+-----------------------><
   '- -c--secondaryDatasource-'  '- -v-'   

パラメーター

brokername
(必須 - brokername を含む呼び出しを使用している場合) 検査のためのブローカー名、または primaryDatasource が関連付けられているブローカー名を指定します。

Linux platformUNIX platform Linux および UNIX システム上では、すべての名前は大/小文字の区別があります。

-n primaryDatasource
(primaryDatasource を含む呼び出しを使用している場合に必要) 検査する ODBC 接続の名前。
-u primaryDatasourceUserId
(事前にデータ・ソース名をブローカーに関連付けていない場合に必要) primaryDatasource に接続するためのユーザー名。
-p primaryDatasourcePassword
(事前にデータ・ソース名をブローカーに関連付けていない場合に必要) primaryDatasourceUserId で使用されるパスワード。
-c secondaryDatasource
(オプション) 2 つのデータ・ソースが等価であるかどうか比較される場合、これは 2 番目の ODBC 接続名です。
-i secondaryDatasourceUserId
(オプション) secondaryDatasource に接続するためのユーザー名。
-a secondaryDatasourcePassword
(オプション) secondaryDatasourceUserId と共に使用されるパスワード。
-v
(オプション) サポートされる CASTS に関連した追加の未翻訳の診断がコマンドによって出力されるようにします。

許可

すべての Windows システムで、このコマンドは、ブローカーのサービス・ユーザー ID として定義されているユーザー ID として実行する必要があります。mqsicreatebroker コマンドを使用してブローカーを作成したときに、サービス・ユーザー ID を -i パラメーターに指定しました。

そのため、Windows Vista および Windows Server 2008 では、このコマンドを実行する場合、サービス・ユーザー ID は Administrators グループのメンバーでなければなりません。

Linux および UNIX システム上では、mqsistart コマンドを使用してブローカーを開始した (または開始する) 際のユーザー ID としてこのコマンドを実行します。

応答

  • BIP8040W: データベース・アクセスがありません (接続できません)。
  • BIP8267W: 警告、このデータ・ソースの使用については問題が存在する可能性があります。 詳しくは、前のメッセージを参照してください。
  • BIP8268I: 提供された 2 つのデータ・ソースには互換性があるので、同じ Compute ノードで使用できます。
  • BIP8269W: 提供された 2 つのデータ・ソースには互換性がないので、同じ Compute ノードで使用することはできません。
  • BIP8270I: データ・ソース <..複数の挿入..> に接続しました。
  • BIP8271I: 比較のための 2 番目のデータ・ソース <..複数の挿入..> に接続しました。
  • BIP8272W: 指定されたデータ・ソースはブローカーに関連付けられていません。
  • BIP8273I: 以下のデータ・タイプおよび関数は、データ・ソース '&1' によってネイティブにサポートされていません: <..複数の挿入..>
  • BIP8274W: 以下のデータ・タイプおよび関数は、データ・ソース '&1' を WebSphere Message Broker と共に使用すると問題を生じる可能性があります: <..複数の挿入..>
  • BIP8873I: ブローカー 'broker_name' のコンポーネント検査を開始します。
  • BIP8874I: 'broker_name' のコンポーネントの検査が正常に終了しました。
  • BIP8875W: 'broker_name' のコンポーネント検査が終了しましたが、1 つ以上の検査が失敗しました。
  • BIP8876I: ブローカー 'broker_name' の環境検査を開始します。
  • BIP8877W: ブローカー 'broker_name' の環境検査が終了しましたが、1 つ以上の検査が失敗しました。
  • BIP8878I: ブローカー 'broker_name' の環境検査が正常に終了しました。
  • BIP8882I: ブローカー 'broker_name' の WebSphere MQ 検査を開始します。
  • BIP8883W: ブローカー 'broker_name' の WebSphere MQ 検査が終了しましたが、1 つ以上の検査が失敗しました。
  • BIP8884I: ブローカー 'broker_name' の WebSphere MQ 検査が正常に終了しました。
  • BIP8885E: 検査が失敗しました。キュー・マネージャー 'queue_manager_name' への接続に失敗しました。 MQRC: return_code MQCC: completion_code
  • BIP8886I: キュー・マネージャー 'queue_manager_name' のキュー 'queue_name' は検査にパスしました。
  • BIP8887E: 'operation' の発行中にキュー・マネージャー 'queue_manager_name' のキュー 'queue_name' の検査が失敗しました。 MQRC: return_code MQCC: completion_code
  • BIP8888E: 検査が失敗しました。キュー・マネージャー 'queue_manager_name' からの切断に失敗しました。 MQRC: return_code MQCC: completion_code
  • BIP8892E: 検査が失敗しました。インストールされている Java レベル 'level_installed' が必要な Java レベル 'level_supported' と一致しません。
  • BIP8893E: Verification failed for environment variable 'variable_name'. Unable to access file 'file_name' with user ID 'user_ID'. Additional information for IBM® support: data1 data2.
  • BIP8894I: 'broker_name' は検査にパスしました。
  • BIP8895E: 検査が失敗しました。環境変数 'variable_name' が無効か欠落しています。
  • BIP8896E: 検査が失敗しました。ユーザー ID 'user_ID' でレジストリーにアクセスできません。 IBM サポートの追加情報: data1 data2
  • BIP8897E: 検査が失敗しました。環境変数 'variable_name' がブローカー名 'broker_name' と一致しません。
  • BIP8900I: APF Authorization check successful for file 'file_name'.
  • BIP8903E: 検査が失敗しました。ファイル 'file_name' の APF 許可の検査は失敗しました。
  • BIP8904E: Verification failed. Failed to start file 'file_name1' with return code 'return_code' and errno 'error_number'.

例

MB8BROKER というブローカーに対して検証検査を実行します。
mqsicvp MB8BROKER
データ・ソース名 (DSN) MyDB は、mqsisetdbparms コマンドを使用して、ブローカー MB8BROKER に関連付けられます。
mqsicvp MB8BROKER -n MyDB
DSN MyDB は、mqsisetdbparms コマンドを使用して、ブローカー MB8BROKER に関連付けられた 2 番目の DSN MyDB2 と比較されます。
mqsicvp MB8BROKER -n MyDB -c MyDB2
完全修飾 DSNMyDB は、1 次および 2 次ユーザー ID およびパスワードを使用して、2 番目の完全修飾 DSN MyDB2 と比較されます。
mqsicvp -n MyDB -u username -p password -c MyDB2 -i username2 -a password2
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

Copyright IBM Corporation 1999, 2012Copyright IBM Corporation 1999, 2012.

        
最終更新

        最終更新 : 2012-07-13 15:43:21


参照トピック参照トピック | バージョン 8.0.0.1 | an07235_