デプロイ
DEPLOY アクションは、パッケージ化されたランタイム環境をリモート・システムにデプロイします。
準備
DEPLOYアクションを使用する前に、以下の情報を確認してください：
- アクションを使用して実行環境のパッケージ化に成功した後にのみ、 DEPLOY アクションを実行できます。 PACKAGE アクションを使って実行環境のパッケージ化に成功した後にのみ実行できます。
- DEPLOYアクションはz/OSDFSMSdssコマンドを使用する。 DFSMSdssを使用する際に呼び出されるプログラムである'ADRDSSUを実行する権限が必要な場合があります。 認証が必要な場合、DFSMSdss はエラーメッセージを発行します。 ADR707E. 詳細については、 z/OS DFSMSdss Storage Administration Guideを参照してください： RACF FACILITY クラスプロファイルによる DFSMSdss 機能の保護 を参照してください。
- DEPLOY アクションを実行したいシステム上に SMP/E ターゲット・ライブラリがない場合、 BLDREMDS アクションとともにユーティリティ
TKANSAM(KFJMAINT)を使用して、アクションの実行に必要な最小限のデータセット（TKANSAM、 TKANMOD、 TKANCUS ライブラリ）を構築することができます。 作成されたデータセットを、'DEPLOY実行されるべきリモートシステムに転送し、'TKANMODライブラリの必要なAPF認証を行うことを確認する。 これらの SMP/E ターゲット・ライブラリは、 Configuration Managerを完全なランタイム環境で実行するために最低限必要なものである。 ただし、 SMP/E と共有するランタイム環境の場合は、 SMP/E ターゲット・ライブラリのセット全体を、 DEPLOY アクションを実行するシステムにコピーする必要がある。
重要：'DEPLOYアクションを使用すると、対象の実行環境データセットが更新される。 DEPLOYアクションを使用する前に、これらのデータセットが使用されていないことを確認する。
重要：のPACKAGEアクションは、次の名前のメタデータファイルを作成します。package_hlq.rte_name.PACKMD 。 KFJ_LOCAL_* パラメータ（ KCIVARS DD および PCK$PARM メンバ内）がパッケージ作成時に使用されている場合に発生する可能性があります。データセットの名前が変更された場合、 DEPLOY アクションは PACKMD メタデータファイルを必要とします。 PACKMD ファイルが利用できない場合、 DEPLOY アクションはパッケージをそのままリストアし、すべての高レベル修飾子と SMS プロパティを保持します。 DEPLOY アクションを使用する際は、 PACKMD メタデータファイルを使用することをお勧めします。
このタスクについて
以下のリストは「DEPLOYアクションの詳細である：
- DEPLOY アクションは、 PACKAGE アクションによって生成されたパッケージデータセットをターゲットシステム上にリストアすることによって、ランタイム環境をデプロイする。 DEPLOY 、DFSMSdssを使ってデータセットをリストアする。
- DEPLOY アクションでは、 KCIALPHA プログラムを使用する必要があります。 KCIALPHA は、APF 許可バージョンの KCIOMEGAです。
- 既存のデータセットを検索するために使用される高レベルの修飾値を指定する必要があります。 高レベルの修飾子を指定するには、以下のパラメータを使用する：
- RTE_PLIB_HILEV
- (必須） 実行時環境定義 （RTEDEF ） ラ イ ブ ラ リ を検索す る ための上位レベルの修飾子を指定 し ます。 DEPLOY 、このパラメータと値を指定する必要がある。
- KFJ_PAC_HERV
- (オプション）パッケージ・データ・セットの上位レベルの修飾子値を指定します。 このパラメータが指定されない場合、パラメータ RTE_PLIB_HILEV の値が使用される。重要： RTE_PLIB_HILEV とは異なる高レベル修飾子でパッケージ・データセットを転送した場合は、 DEPLOY アクションでパラメータ KFJ_PACK_HILEV を使用する必要があります。注： ランタイム環境をデプロイする際には、 KFJ_PACK_HILEV パラメータを指定することを推奨する。
注： パラメータ KFJ_LOCAL_PLIB_HILEV は、 DEPLOY アクションではサポートされていない。 - オプションで、 z/OS® UNIX System Servicesに関連するパーツをデプロイする DEPLOY ワークフロー・ステージを実行するタイミングを制御できます。 デフォルトでは、 DEPLOY 。 z/OS UNIX に関連するファイルとディレクトリが、パッケージ化された実行環境データセットに存在する場合、自動的に配置されます。 しかし、（認証の問題などの理由で）このステップをスキップして、後でこのステップを実行したい場合もあるでしょう。 以下のように、 OPTION パラメーターを使用して、この処理を制御する NOUSS 値または USS 値を指定できます。
- ノUSS
OPTION NOUSS が指定された場合、 DEPLOY アクションは、.NET Framework に関連するパーツを展開するステージを実行しない。 z/OS UNIX.
このオプションでは、 z/OS データセットのみが配備される。 z/OS UNIX に関連するファイルやディレクトリはバイパスされる。
- USS
OPTION USS が指定された場合、 DEPLOY アクションは、 に関連するパーツを配置するステージのみを実行する。 z/OS UNIX 他の処理は実行されません。
このオプションは、ファイルやディレクトリを z/OS UNIX に関連するファイルやディレクトリだけを更新したい場合に便利です。
- DEPLOYアクションは、メイン VSAM および非 VSAM パッケージに対して無条件リストア (データセットの完全な置き換え) を実行し、履歴パッケージに対して条件付きリストア (既存のデータセットの置き換えは行わない) を実行する。 以下の動作に注意してください。
- 履歴ダンプ・データセット（
**.PACKHNまたは**.PACKHV）が見つからないか、復元に失敗した場合、リターンコード4が生成される。 - メイン・ダンプ・データ・セット (
**.PACKMNまたは**.PACKMV) が見つからないか、復元に失敗した場合は、戻りコード 8 が生成される。
注意: DEPLOY アクションは、メインパッケージのVSAMファイルと非VSAMファイルを置き換えるが、履歴関連ファイルは置き換えない。 したがって、 PACKHN および PACKHV のデプロイ・フローがRC=8で終了するのは正常です。 これを回避したい場合 (例えば、保守をロールアウトする場合) は、これらのパッケージをターゲット・システムに転送しないでください。 通常、戻りコード 8 は 構成マネージャー を停止させますが、この特定の状況 (ヒストリー・ファイル) では、戻りコード 8 は受け入れ可能と見なされ、 構成マネージャー が機能し続けるのを妨げることはありません。 - 履歴ダンプ・データセット（
- パッケージ化されたランタイム環境をリストアする（そしてアンタストする可能性がある）とき、 DEPLOY アクションは、 PACKAGE アクションで使用された以下のパラメータを再利用する：
- KFJ_PACK_HILEV
- KFJ_ADRDSSU_ADMIN
- KFJ_PACK_TERSE
- KFJ_PACK_DATACLAS
- KFJ_PACK_UNIT
- KFJ_PACK_VOLUME
- KFJ_PACK_TERSEが'
Yに設定されている場合、まず'DEPLOYアクションがパッケージをアンターゼする。 未変換のDMPファイル上位修飾子およびSMSパラメータは、以下のパラメータで指定されたとおりに使用される：- RTE_PLIB_HILEV
- RTE_SMS_MGMTCLAS
- RTE_SMS_STORCLAS
- RTE_SMS_UNIT
- RTE_SMS_VOLUME
- 大規模なパッケージが作成されていない場合は、 KFJ_PACK_DATACLAS を適宜使用して、抽出されたパッケージ・ファイルに対してマルチボリューム・データ・セットを割り振る必要があります。
- KFJ_PACK_UNIT または KFJ_PACK_VOLUME が指定されている場合は、未処理のすべてのパッケージに適用されます。
- RTE_SMS_VOLUME が指定され、 RTE_SMS_MGMTCLAS が指定されていない場合、 RTE_SMS_MGMTCLAS のデフォルトは
NULLMGMTCLASとなる。 同様に、 RTE_SMS_STORCLAS のデフォルトはNULLSTORCLAS。
DEPLOYアクションを実行するには、以下のステップを完了する。
手順
例
- パラメータ RTE_PLIB_HILEV でデフォルトの上位修飾子を使用する
この例では、パッケージ・データ・セットは、ランタイム定義ライブラリのデフォルトの高レベル修飾子を使って命名され、同じファイル名を使ってリモート・システムに転送された。
パッケージ化されたデータセットには、 RTE1 という実行環境と、実行環境定義ライブラリ TSOUID.MONSUITE.RTEDEF が含まれている。
パッケージ化されたデータセットの名前は TSOUID.MONSUITE.RTE1.PACK*。
以下の DEPLOY アクションジョブは、リモートシステム上で実行され、ターゲット LPAR 上のパッケージデータセットを、高レベル修飾子 TSOUID.MONSUITE を持つデータセットにデプロイ（リストア）します。
図1： デフォルトの高レベル修飾子を使用してDEPLOYアクションを実行するJCLの例 //UID#ZMCM JOB ,CLASS=A,MSGCLASS=X,NOTIFY=&SYSUID /*JOBPARM SYSAFF=ZOS1 //S1 EXEC PGM=KCIALPHA,REGION=0M,DYNAMNBR=256 //STEPLIB DD DISP=SHR,DSN=MONSUITE.TKANMOD //KCIFLOW DD DISP=SHR,DSN=MONSUITE.TKANCUS(KFJOMEGA) //KCIVARS DD * ACTION DEPLOY RTE_NAME RTE1 RTE_PLIB_HILEV TSOUID.MONSUITE /*- カスタム高級修飾子をパラメータで使用する KFJ_PACK_HILEV
RTE_PLIB_HILEV パラメータ値とは異なる高レベル修飾子でパッケージ・データ・セットをリモート・システムに転送した場合は、 DEPLOY アクションでパラメータ KFJ_PACK_HILEV を使用する必要があります。
この例では、パッケージデータセットには、 RTE1 というランタイム環境と、 TSOUID.MONSUITE.RTEDEF というランタイム環境定義ライブラリが含まれている。 しかし、ファイルは高レベル修飾子 TESTSYS を使ってリモート・システムに転送された。
その結果、リモートシステム上のパッケージデータセットの名前は TESTSYS.MONSUITE.RTE1.PACK* となり、パラメータ KFJ_PACK_HILEV を使用する必要がある。
図2： カスタム・ハイレベル修飾子を使用してDEPLOYアクションを実行するJCLの例 //UID#ZMCM JOB ,CLASS=A,MSGCLASS=X,NOTIFY=&SYSUID /*JOBPARM SYSAFF=ZOS1 //S1 EXEC PGM=KCIALPHA,REGION=0M,DYNAMNBR=256 //STEPLIB DD DISP=SHR,DSN=MONSUITE.TKANMOD //KCIFLOW DD DISP=SHR,DSN=MONSUITE.TKANCUS(KFJOMEGA) //KCIVARS DD * ACTION DEPLOY RTE_NAME RTE1 RTE_PLIB_HILEV TSOUID.MONSUITE KFJ_PACK_HILEV TESTSYS.MONSUITE /*