検出

DISCOVER アクションは、LPAR 上の CICS® 領域、 Db2® サブシステム、 IMS 制御領域、 MQ サブシステム、TCP/IP スタック、およびシステム・シンボルをディスカバーしてから、対応するメンバーをランタイム環境定義ライブラリーに作成します。

準備

本書では、 サブシステム を、 CICS 領域、 Db2 サブシステム、 IMS 制御領域、 MQ サブシステム、および TCP/IP スタックの非公式の総称として使用しています。

ディスカバリーは、CONFIGURE_* パラメーターを使用して構成した製品に限定されません。 DISCOVER アクションは、ディスカバー可能なすべてのサブシステムを常にディスカバーします。

DISCOVER アクションの結果について説明している以下のトピックを確認することをお勧めします。
ヒント: DISCOVER アクションを実行する前に、モニターする予定のすべてのサブシステムを起動してください。 初期ディスカバリーの実行後に LPAR でサブシステムが追加または開始された場合は、 DISCOVER アクションを再実行できます。 この場合は、それぞれのディスカバリー出力を RTEDEF データ・セットに統合する必要があります (つまり、 生成されたメンバーをマージ します)。

このタスクについて

DISCOVER アクションは、LPAR 上のサブシステムおよびシステム・シンボルをディスカバーしてから、ランタイム環境定義ライブラリー ( rte_plib_hilev.RTEDEF) 内に対応するメンバーを作成し、ディスカバーされたデータをメンバーに取り込みます。

以下のリストに、 DISCOVER アクションに関する詳細を示します。
  • サブシステムをディスカバーする LPAR に対して DISCOVER アクションを実行します。 例えば、 JOB ステートメントの後に JES2 SYSAFF ジョブ・パラメーターを挿入して、ジョブが正しい LPAR で実行されるようにします。
    /*JOBPARM SYSAFF=<lpar>
  • 詳細を確認するには、 KCIALPHA プログラムを使用します。 オプションで、DISCOVER アクションの場合のみ、JCL EXEC ステートメント内のプログラム名を KCIOMEGA から KCIALPHA に変更します。 KCIALPHA は、KCIOMEGA の APF 許可バージョンです。 APF 許可により、 KCIALPHA は、手動で入力する必要があるサブシステムの詳細をさらにディスカバーすることができます。 KCIALPHA が APF 許可されていないロード・ライブラリーから実行された場合、部分的なディスカバリーは引き続き完了しますが、ジョブは戻りコード 8 で終了します。

  • DISCOVER アクションはスタンドアロンで実行できます。つまり、 RTE_PLIB_HILEV パラメーターが指す既存の RTEDEF データ・セットを必要としません。 結果の RTEDEF には、ディスカバリーによって生成されたメンバーのみが含まれ、VTAM アプリケーション ID および開始タスク定義のデフォルト接頭部が使用されます。 このユース・ケースについて詳しくは、 デフォルトを使用したスタンドアロン・ディスカバリーの例を参照してください。

  • 一部のサブシステム・データ・セットでは、データ・セットに別名が定義されている場合、 DISCOVER アクションは、元のデータ・セット名の代わりに別名を使用します。 パラメーター KD2_DBnn_DB2_LOADLIB、 KI2_I1nn_CLASSIC_IMS_RESLIB、 KN3_TCPXnn_TCPIP_PROFILES_DSNが存在する場合、それらのパラメーターに別名が取り込まれます。
  • DISCOVER アクションを実行した後に、KCIPRINT sysout データ・セット内のディスカバリーに関するメッセージを確認します。
  • DISCOVER アクションの出力は、サブシステムによって異なります。 詳しくは、次のトピックを参照してください。
  • 最初の実行時に、 DISCOVER アクションは、ディスカバーしたサブシステムのタイプごとにメンバーを作成します。 後続の実行で、サブシステムのディスカバリー・メンバーが存在する場合、そのメンバーは上書きされず、代わりにコメント・メンバー (Kpp#lpar) が作成されます。 その後、メンバーを確認し、保持する更新を手動で適用する必要があります。 詳しくは、 初回ディスカバリーと再ディスカバリーを参照してください。

DISCOVER アクションを使用してディスカバリーを実行するには、以下の手順を使用します。

手順

  1. TKANSAM の KFJJMCM サンプル・ジョブを変更して (以下の例を参照)、 DISCOVER アクションを選択します。
  2. 必須パラメーター RTE_NAME および RTE_PLIB_HILEVの値を指定します。
  3. KFJJMCM ジョブを実行して、使用可能なサブシステムを検出します。
    DISCOVER アクションは、 RTEDEF データ・セット内にディスカバリー・メンバーを作成し、ディスカバーされた値をパラメーターに取り込みます。 DISCOVER アクションのジョブ・メッセージは、 KCIPRINT SYSOUT データ・セットに書き込まれます。
  4. ディスカバリー・メンバーの内容を確認し、必要に応じて更新します。

例

サブシステムのディスカバー

以下の JCL は、LPAR ZOS1 上のサブシステムをディスカバーし、 TSOUID.MONSUITE.RTEDEF内に対応するメンバーを作成します。 例えば、 DISCOVER アクションで Db2 サブシステムが検出されると、メンバー KD5@ZOS1が作成されます。そのメンバーが既に存在する場合は、 KD5#ZOS1が作成されます。

図1： DISCOVER アクションを実行する 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            DISCOVER
RTE_NAME          RTE1
RTE_PLIB_HILEV    TSOUID.MONSUITE
/*

JES2 SYSAFF ジョブ・パラメーターにより、LPAR ZOS1 でジョブが実行され、DISCOVER アクションによってサブシステムがディスカバーされるようになります。

デフォルトを使用したスタンドアロン・ディスカバリー

以下の JCL は、デフォルト値を使用するスタンドアロン・ディスカバリーを実行するために使用されます。

DISCOVER アクションのスタンドアロン実行を使用して IMS システムをディスカバーし、開始タスクと VTAM アプリケーション ID に異なる接頭部を指定する場合は、 RTE_VTAM_APPLID_PREFIX パラメーターと RTE_STC_PREFIX パラメーターに任意の接頭部を指定します。 このようにすると、VTAM および開始タスクの接頭部がメンバー RTEDEF(KI5@lpar)でそれに応じて受け入れられます。

図2： DISCOVER アクションを使用してスタンドアロン・ディスカバリーを実行する 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                     DISCOVER
RTE_NAME                   RTE1
RTE_PLIB_HILEV             TSOUID.MONSUITE

RTE_STC_PREFIX             OMEG
RTE_VTAM_APPLID_PREFIX     OM&SYSCLONE.
/*

スタンドアロンで DISCOVER アクションを実行したいシステム上に SMP/E ターゲット・ライブラリがない場合は、ユーティリティ TKANSAM(KFJMAINT) とアクション BLDREMDS を使用して、アクションの実行に必要な最小限のデータセット（TKANSAM、TKANMOD、TKANCUS ライブラリ）を構築できます。 作成されたデータ・セットを、スタンドアロン DISCOVER を実行するリモート・システムに転送し、TKANMOD ライブラリーの必要な APF 許可が行われていることを確認してください。