mqsimigratecomponents コマンド

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

  • Windows
  • Linux および UNIX システム
  • z/OS

目的

mqsimigratecomponents コマンドは、以前にインストールされた製品のバージョン (バージョン 2.1 またはバージョン 5 のみ) から別のバージョンに 1 つ以上のコンポーネントを移動します。 このコマンドは、ソースであっても宛先であっても、インストールされている製品のバージョンが遅いほうから実行される必要があります
注:
  1. バージョン 2.1 の製品の場合、バージョン 2.1.0.8 がサポートされる最も初期の製品リリースです。
  2. バージョン 5 の製品の場合、バージョン 5.0.0.4 がサポートされる最も初期の製品リリースです。
  3. -t および -s パラメーターは、Version.Release.Modification.Fixpack という形式のバージョン番号 (たとえば、5.0.0.4) を受け入れます。また、サポートされる旧バージョンについては、"5" および "2.1" を短縮形として受け入れることもできます。

必要なコンポーネント・コードがインストールされている (つまり、必要とされる場合にはブローカー・コンポーネントがインストールされている、など) 製品の バージョン 6.0 インストールを持っていなければなりません

マイグレーションを開始する前に、コントロール・センターのデバッグ・セッションを停止してください。 デバッグ中のメッセージ・フローをマイグレーションすることはできません。

さまざまなオプションを指定してコマンドを呼び出し、以下のアクションの 1 つを実行することができます。
  • 1 つ以上のコンポーネントを、変更を加えずに検査して、コンポーネントが必要なマイグレーションに適合していることを確認する
  • 1 つ以上のコンポーネントを完全にまたは部分的に、別のバージョンに移動する
  • あるバージョンから別のバージョンに正常に行われた完全なまたは部分的な移動を取り消す、つまり元に戻す
  • 移動が正常に行われたことを検証する

構文

パラメーター

-c
(オプション) 以下の事柄を確認するために、指定されたコンポーネントの事前マイグレーション検査を行います。
  • 複数のブローカー・コンポーネントが指定されている場合、ブローカーはデータベース・スキーマを共有する。
  • すべての場合に、マイグレーションしているブローカーのデータベース・スキーマは、同時にマイグレーションされていないブローカーとは共有できません。
  • ブローカーの自動検出バージョンが、コマンド行で指定されたバージョンと一致する。
  • バージョン 6.0 から前のリリースにマイグレーションする場合は、64 ビットの実行グループがない。
  • 前のリリースからコピーされるデータベース表に、バージョン 6.0 の索引要件に違反する行が含まれない。
    • すべての行をスキャンすることが最も簡単な方法である。
    • ブローカーがバージョン 2.1 の場合は、グローバル・ロックがとられる。

マイグレーション検査は、実行中のコンポーネントまたはコンポーネントのセットに対して実行できます。 これは、パフォーマンスに多少の不利益が生じることを除けば、コンポーネントに影響を与えません。 UNIX システムでは、検査を実行する前に odbc.ini ファイルをマイグレーションする必要があります (つまり、以前のものと同じデータ・ソース・セットを持つ新規フォーマットの odbc.ini ファイルを作成する必要があります)。なぜなら、検査コマンドはブローカー・データベースにアクセスできなければならないからです。

検査コマンドは、成功するか失敗するかのどちらかで、マイグレーションが成功するかどうかについてのメッセージを印刷します。しかし、プロセス中に変更は行われません。

-v
(オプション) 以下の事柄を確認するために、指定されたコンポーネントの事後マイグレーション検査を行います。
  • 指定したバージョンについて、正しいデータベース表とキューが存在する。
  • 指定したバージョンについて、レジストリーが正しいフォーマットになっている。
-q
(オプション) 操作時に状況メッセージをわずかしか印刷しません。
-1
(オプション) レジストリーおよびファイル・システムの作業のみ行います。 -2 または -3 パラメーターの前に、-1 パラメーターを使用します。
-2
(オプション) WebSphere MQ の作業のみ行います。
-3
(オプション) データベースの作業のみ行います。
-u
(オプション) 失敗したマイグレーション・ステップを取り消します。また、-1-2-3 のうちの少なくとも 1 つを指定する必要があります。 このオプションを使用するのは、マイグレーションが失敗し、さらに自動回復も失敗した場合に限ります (一例として、分割マイグレーション時の障害)。
-sSource Version
(オプション) コンポーネントの前のバージョン。 この値が指定されていない場合は、自動的に検出されます。 サポートされている製品のバージョン番号の制約事項については、目的を参照してください。
-tTarget Version
(オプション) コンポーネントの宛先のバージョン。 この値が指定されていない場合は、現行バージョンであることが想定されます。 サポートされている製品のバージョン番号の制約事項については、目的を参照してください。
Component Name
(必須) マイグレーションするコンポーネントの名前。少なくとも 1 つの名前が指定されている必要があります。

許可

単一ステップのマイグレーションを実行する際に、このコマンドを呼び出すのに使用するユーザー ID は以下の機能を持っている必要があります。
  • 製品のレジストリーに書き込む。
  • コンポーネントに関連したデータベースを変更する。
  • キュー定義を変更する。
分割マイグレーションの場合、このコマンドを呼び出すのに使用するユーザー ID は製品のレジストリーから読み取る機能を常に持っている必要があります。また、各ステップが成功するために特定の許可も持っている必要があります。
  • -1 は、キュー定義を変更する機能を必要とします。
  • -2 は、製品のレジストリーに書き込む機能を必要とします。
  • -3 は、コンポーネントに関連したデータベースを変更する機能を必要とします。

応答

このコマンドは、さまざまな操作の結果に応じて、考えられる大量の応答を生成することがあります。 このコマンドは、メッセージを生成する方法の点で他のコマンドと異なることに注意してください。メッセージは、プログラムの最後にバッチで生成されるというよりも、必要に応じて表示されます。

次の例は、V2.1 からバージョン 6.0への BROKER1 のマイグレーションを検査します。

mqsimigratecomponents –c BROKER1
BIP 0001I: コンポーネント‘BROKER1’のマイグレーション検査を FAD レベル‘3’まで開始中です。
BIP 0002I: ‘BROKER1’はバージョン 2.1 です (自動検出)。
BIP 0003I: ブローカー・データベース‘BKRDB’とスキーマ‘WMQIUSER’は他のコンポーネントと共有されません。
BIP 0004I: ブローカー・データベースに無効な行が見つかりません。
BIP 0005I: マイグレーション検査をパスしました。
BIP 8071I: コマンドが正常に完了しました。

次の例は、V2.1 からバージョン 6.0 への BROKER1 の自動マイグレーションを行います。

mqsimigratecomponents BROKER1
BIP 0001I: コンポーネント‘BROKER1’のマイグレーション検査を FAD レベル‘3’まで開始中です。
BIP 0002I: ‘BROKER1’はバージョン 2.1 です (自動検出)。
BIP 0003I: ブローカー・データベース‘BKRDB’とスキーマ‘WMQIUSER’は他のコンポーネントと共有されません。
BIP 0004I: ブローカー・データベースに無効な行が見つかりません。
BIP 0005I: マイグレーション検査をパスしました。
BIP 0020I: コンポーネント‘BROKER1’のレジストリー・マイグレーションを開始中です。
BIP 0021I: 最上位 'CurrentVersion' キーが作成されました。
BIP 0021I: ‘DSN’サブキーが作成されました。
BIP 0022I: ‘HTTPListener’サブキーが作成されました。
BIP 0023I: ‘HTTPListener.HTTPConnector’サブキーが作成されました。
BIP 0024I: ‘FADLevel’値が作成されました。‘3’に設定されます。
BIP 0025I: ‘converters’値が作成されました。‘’に設定されます。
BIP 0028I: レジストリー・データを‘CurrentVersion’に移動中です。
BIP 0029I: 値‘AdminAgentPID’を移動しました。
[値ごとに繰り返し]
BIP 0030I: レジストリー・データの‘CurrentVersion’への移動が完了しました。
BIP 0025I: コンポーネント‘BROKER1’のレジストリー・マイグレーションが完了しました。
BIP 0011I: ‘BKRDB’のデータベース表のマイグレーションが開始中です。’WMQIUSER’。
BIP 0012I: 表 ’BROKERRESOURCES’を ’somethingBROKERRESOURCES’に移動中です。
BIP 0013I: 新規表 ’BROKERRESOURCES’を作成中です。
BIP 0014I: データを‘somethingBROKERRESOURCES’から ’BROKERRESOURCES’にコピー中です。
BIP 0015I: すべてのデータ (322 行) を正常にコピーしました。
 [表ごとに繰り返し]
BIP 0016I: ‘BKRDB’のデータベース表のマイグレーションが完了しました。’WMQIUSER’。
BIP 0017I: ‘BKRQM’キュー・マイグレーションを開始中です。
BIP 0018I: 新規キュー‘SYSTEM.BROKER.AGGR.CONTROL’を作成中です。
BIP 0018I: 新規キュー‘SYSTEM.BROKER.AGGR.REPLY’を作成中です。
BIP 0018I: 新規キュー‘SYSTEM.BROKER.AGGR.REQUEST’を作成中です。
BIP 0018I: 新規キュー‘SYSTEM.BROKER.AGGR.TIMEOUT’を作成中です。
BIP 0018I: 新規キュー‘SYSTEM.BROKER.AGGR.UNKNOWN’を作成中です。
BIP 0018I: 新規キュー‘SYSTEM.BROKER.INTERBROKER.MODEL.QUEUE’を作成中です。
BIP 0018I: 新規キュー‘SYSTEM.BROKER.TIMEOUT.QUEUE’を作成中です。
BIP 0018I: 新規キュー‘SYSTEM.BROKER.WS.ACK’を作成中です。
BIP 0018I: 新規キュー‘SYSTEM.BROKER.WS.INPUT’を作成中です。
BIP 0018I: 新規キュー‘SYSTEM.BROKER.WS.REPLY’を作成中です。
BIP 0026I: キュー‘SYSTEM.BROKER.ADMIN.QUEUE’をクリア中です。
BIP 0026I: キュー‘SYSTEM.BROKER.EXECUTIONGROUP.QUEUE’をクリア中です。
BIP 0026I: キュー‘SYSTEM.BROKER.EXECUTIONGROUP.REPLY’をクリア中です。
BIP 0026I: キュー‘SYSTEM.BROKER.IPC.QUEUE’をクリア中です。
BIP 0019I: ‘BKRQM’のキュー・マイグレーションが完了しました。
BIP 0005I: コンポーネント‘BROKER1’のマイグレーションが成功しました。
BIP 8071I: コマンドが正常に完了しました。

次の例は、前述の例の繰り返しですが、-q フラグが指定されています。

mqsimigratecomponents -q BROKER1
BIP 0001I: コンポーネント‘BROKER1’のマイグレーション検査を FAD レベル‘3’まで開始中です。
BIP 0002I: ‘BROKER1’はバージョン 2.1 です (自動検出)。
BIP 0005I: マイグレーション検査をパスしました。
BIP 0020I: コンポーネント‘BROKER1’のレジストリー・マイグレーションを開始中です。
BIP 0025I: コンポーネント‘BROKER1’のレジストリー・マイグレーションが完了しました。
BIP 0011I: ‘BKRDB’のデータベース表のマイグレーションが開始中です。’WMQIUSER’。
BIP 0016I: ‘BKRDB’のデータベース表のマイグレーションが完了しました。’WMQIUSER’。
BIP 0017I: ‘BKRQM’キュー・マイグレーションを開始中です。
BIP 0019I: ‘BKRQM’のキュー・マイグレーションが完了しました。
BIP 0005I: コンポーネント‘BROKER1’のマイグレーションが成功しました。
BIP 8071I: コマンドが正常に完了しました。
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック
Copyright IBM Corporation 1999, 2005 Last updated: 11/07/2005
an26150_