カスタマイズ検証プログラム (CVP) の実行

これは、z/OS 上でユーザー・ネーム・サーバーを作成する大きなタスクの一部です。

始める前に

このタスクを実行するには、以下のタスクを完了している必要があります。

PDSE から、BIP$JCVP ジョブを実行依頼します。 ジョブ・ログで、メッセージと戻りコードを検査します。 エラー・メッセージを何も受け取らなかった場合、ジョブのすべてのステップの戻りコードは 00 で、BAD ステップはフラッシュされ、CVP は正常に実行されたということです。次のステップに進みます。

カスタマイズ検証プログラム (CVP) は 2 つのステップで構成されます。

CVP ステップ 1: セットアップの検査

シェル・スクリプト mqsichecksetup は、以下を検査します。
  1. コンポーネント・ディレクトリーのルート・ディレクトリーが存在するかどうかを検査します。
  2. カスタマイズ・ログ・ファイル <ComponentDirectory>/output/Customizelog でエラーを検査します。 カスタマイズ・プロセスは、その進行状況と、このファイルの戻りコードをログ記録します。
  3. コンポーネント・ディレクトリー・ツリーの構造を検査します。
  4. mqsicompcif の値に対するレジストリー項目を検査します。
  5. mqsicompcif の値に対する環境ファイル ENVFILE の内容を検査します。
すべての検査の結果は、<ComponentDirectory>/output/cvpslog にログ記録されます。 エラー・メッセージは <ComponentDirectory>/output/cvpserr に書き込まれます。

CVP ステップ 2: WebSphere MQ の検査

このステップでは、WebSphere MQ リソースが正しくセットアップされているかどうか、およびこれらのリソースがすべてのコンポーネント・キュートとの間で格納または取得するメッセージの検査に、コンポーネントの環境ファイル ENVFILE (コンポーネント・ディレクトリーのルート・ディレクトリーにある) を使用するかどうかを確認します。

この検査の結果は、<ComponentDirectory>/output/cvpplog にログ記録されます。 エラー・メッセージは <ComponentDirectory>/output/cvpperr に書き込まれます。

CVP の実行後

コンソール、ジョブ・リスト、およびブローカーの /output サブディレクトリーの cvpslogcvpserr ファイルを検査します。 たとえば、TSO から次のコマンドを発行します。
obrowse /var/wmqi/MQP1UNS/output/cvpslog

CVP が正常に終了すると、BIPJCVP のすべてのジョブ・ステップで rc=0 を受け取ります。

CVP 実行時の問題

次のエラーについては、さらに調査してください。
CVP ジョブ・ステップ 戻りコード 説明 アクション
1 4 すべてのカスタマイズ・ステップが実行されたわけではないことを示します。 カスタマイズはまだ完了していないので、これはエラーとは見なされません。 カスタマイズ・ステップを完了します。
1 8 カスタマイズ・ステップのうち、最低 1 つでエラーが報告されたことを示します。 次のログ・ファイルを検査します。
  • <ComponentDirectory>/output/Customizelog
  • <ComponentDirectory>/output/cvpslog
  • <ComponentDirectory>/output/cvpserr
  • <ComponentDirectory>/output/cvpplog
  • <ComponentDirectory>/output/cvpperr

適切な処置を取ります。再カスタマイズが必要になることもあります。
2 8 ブローカー・データベースへのアクセスか、または WebSphere MQ キューへのアクセスが失敗したことを示します。 次のログ・ファイルを検査します。
  • <ComponentDirectory>/output/Customizelog
  • <ComponentDirectory>/output/cvpslog
  • <ComponentDirectory>/output/cvpserr
  • <ComponentDirectory>/output/cvpplog
  • <ComponentDirectory>/output/cvpperr

適切な処置を取ります。再カスタマイズが必要になることもあります。

関連概念
ユーザー・ネーム・サーバー

関連タスク
z/OS でのユーザー・ネーム・サーバーの作成
ユーザー・ネーム・サーバーが開始するタスク・プロシージャーのコピー
ユーザー・ネーム・サーバーが開始するタスクのユーザー ID の定義