[z/OS]

キュー・マネージャーを前のバージョンに戻す ( z/OS )

IBM® MQ for z/OS® 9.4.0 LTS または IBM MQ for z/OS 9.4.0 CD に移行した後、 IBM MQ for z/OS 9.3.0 または IBM MQ for z/OS 9.2.0 のいずれかから、 START QMGR コマンドの BACKMIG オプションを使用して、移行前のバージョンに後方移行(フォールバック)することができます。 CD リリース( IBM MQ for z/OS 9.2.5 など)では、逆方向のマイグレーションはサポートされていません。

始める前に

IBM MQ for z/OS 9.4 で使用可能な特定の機能は、後方移行に影響を与える可能性があります。 これらの機能はデフォルトでは有効になっていませんが、これらの機能を有効にした場合は、逆方向マイグレーションを実行する前に無効にする必要があります。

後方移行を実行する必要がないことを確認するまでは、新しい IBM MQ for z/OS 9.4 機能を活用しないでください。

IBM MQ for z/OS 9.3.0へのマイグレーション

[MQ 9.4.0 2024 年 6 月][MQ 9.4.0 2024 年 6 月] IBM MQ for z/OS 9.3.0 または に移行する際に、 の最優先属性は、オブジェクト定義に適用されなくなり、後方移行の時点で削除されます。 IBM MQ for z/OS 9.2.0 CAPEXPRY CAPEXPRY これらの値を維持したい場合は、 CAPEXPRY 属性が設定されたオブジェクトを特定し、移行前に CUSTOM 属性を使用するように戻してください。

[MQ 9.4.0 2024 年 6 月][MQ 9.4.0 2024 年 6 月]例えば、 MY.QUEUECAPEXPRY の値が5000の場合:
ALTER QL(MY.QUEUE) CAPEXPRY(NOLIMIT) CUSTOM('CAPEXPRY(5000)') 
注意: キュー共有グループ内のキューマネージャが後方互換モードで動作している場合、共有オブジェクトの CAPEXPRY の第一級属性をセットしたままにしておくことはサポートされていない構成です。 この構成により、1等級の CAPEXPRYCUSTOM のCAPEXPRY属性が同時に設定される可能性があります。

この場合、ファーストクラスの属性は、それをサポートするキューマネージャーによって常に使用され、CUSTOM属性はサポートしないキューマネージャーによって使用されます。 したがって、キューマネージャが後方互換モードで移行されている場合は、混乱を避けるために、 CUSTOM CAPEXPRY の値のみを設定してください。

IBM MQ for z/OS 9.2.0へのマイグレーション

前述の IBM MQ for z/OS 9.3.0 へのマイグレーション」セクション で説明されている情報が適用されます。

IBM MQ 9.3.0 で導入された STATQSTREAMQ、および STRMQOS パラメーターは適用されなくなりました。プライベート・オブジェクト定義およびコピー・オブジェクト定義の場合、新しいオプションは逆方向マイグレーションの時点で削除されます。

本タスクについて

キュー・マネージャーを逆方向にマイグレーションできるのは、始動時に CSQY039I メッセージが出力される場合のみです。 この場合、このトピックの情報を使用して、後方移行を実行できます。

通常、後方移行は何らかの理由でマイグレーションが失敗した直後にのみ実行されます。 ただし、 CSQY039I メッセージがキュー・マネージャーの始動時に出力される場合は、いつでも逆方向マイグレーションを実行することができます。
注:
  • START QMGR BACKMIG(vrm)を実行すると、キュー・マネージャーは指定されたレベルで開始できるようになります。

    代わりに、 BACKMIG 操作で指定されたバージョン・レベルより高いレベルでキュー・マネージャーを開始すると、キュー・マネージャーはキュー・マネージャーを上位バージョンに順方向にマイグレーションし、 START QMGR BACKMIG 操作を繰り返さない限り、後方移行を行うことはできなくなります。

  • BACKMIG 操作は、 IBM MQ のページ・セットとそれらのページ・セットに保管されているオブジェクトを直接変更します。 これは、キュー・マネージャーの再始動前に IPL が実行された場合、またはキュー・マネージャーが別の LPAR で開始された場合でも、指定された BACKMIG バージョンでキュー・マネージャーを再始動できることを意味します。

キュー・マネージャーが始動時に CSQY040I メッセージを発行した場合、逆方向マイグレーションはサポートされず、以下のテキストで説明されている手順は適用されません。 マイグレーションの前に、キュー・マネージャー・データをバックアップしてある場合、そのデータを使用して以前のリリースのキュー・マネージャーを開始できます。

手順

  1. キュー・マネージャーにオフラインのページ・セットがないことを確認します。
    存在する場合は、コマンド CSQUTIL FORMAT を使用して、ページ・セットをオンラインに戻します。
  2. キュー・マネージャーをクリーン・シャットダウンします。
  3. コマンド START QMGR BACKMIG(vrm) を実行します。ここで、 vrm は、以前にマイグレーションされたリリースのバージョン、リリース、および修飾子の値です (例: 920)。
    この値は、キュー・マネージャーの始動時に CSQY039I メッセージで出力されます。
    重要: メッセージ出力からピリオド文字を除去する必要があります。
    通常 START QMGR コマンドで使用する場合は、 PARM パラメーターを含める必要があります。
    キュー・マネージャーが始動し、後方移行に適したフォーマットでデータを再書き込みし、その後シャットダウンします。 コマンドが正常に処理されると、 CSQY045I メッセージが出力されます。
    CSQY043E メッセージが出力された場合は、表示されたメッセージを調べて問題を解決し、コマンドを再試行する。
  4. 必要に応じて、 IBM MQ for z/OS 9.3.0 または IBM MQ for z/OS 9.2.0 ライブラリーで MSTR および CHINIT 開始プロシージャー JCL を使用するように切り替えます。

    データ・セット別名がロード・ライブラリーに使用されている場合は、 IBM MQ for z/OS 9.3.0 または IBM MQ for z/OS 9.2.0 ライブラリーを参照するように別名を切り替えます。

    例えば、MQM.MQV940.SCSQLOAD を参照する MQM.MQP1.SCSQLOAD というエイリアスは、必要に応じて MQM.MQV930.SCSQLOAD、または MQM.MQV920.SCSQLOAD を参照するように変更する必要があります。

  5. QMINI データ・セットを定義するために、CSQMINI DD を MSTR 始動プロシージャーに追加した場合は、その CSQMINI DD カードを削除します。
  6. 移行前に、システム・パラメータ・モジュール(CSQZPARM)を IBM MQ for z/OS 9.3.0 または IBM MQ for z/OS 9.2.0 で使用するように戻し、必要に応じて IBM MQ for z/OS 9.3.0 または IBM MQ for z/OS 9.2.0 のコードにリンクします。
  7. キュー・マネージャー、チャネル・イニシエーター、またはリスナーを個別に開始することにより、後方移行を検証します。
  8. 始動時に発生したエラーがないか確認し、あれば解決します。
    3 つのコンポーネントがすべて正常に始動した後に、必要に応じて 3 つのコンポーネントの始動を組み合わせることができます。
  9. 既存のアプリケーションが正しく機能していることを確認します。

結果

これでキュー・マネージャーは、マイグレーション元のコードのバージョンで実行されるようになります。
注: キュー・マネージャーを前のバージョンに戻す場合、このインストールでは、早期コードを前のバージョンにフォールバックする必要はありません。

早期コードとは、 IBM MQz/OS サブシステムとして機能するためにリンク・パック域 (LPA) にロードする必要がある IBM MQ ロード・モジュールのことです。 キュー・マネージャーに対してコマンドを発行する場合、またはアプリケーションがキュー・マネージャーに接続する場合、 IBM MQ システムによって最初に実行されるアクションは、早期コードをロードすることです。

LPA には、システム上で実行されている最新バージョンの IBM MQ からの IBM MQ 早期コード・モジュールが含まれている必要があります。 例えば、 IBM MQ for z/OS 9.4.0IBM MQ for z/OS 9.3.0 のキューマネージャが同じシステム上で動作している場合、 IBM MQ for z/OS 9.4.0 の初期コードはLPAにロードされなければなりません。

詳しくは、 早期コードを参照してください。