AUTOGEN SPAN オプションの動作

AUTOGEN アクションオプション › AUTOGEN アクションオプション › AUTOGEN SPAN オプションの動作

AUTOGEN SPAN オプションの動作

AUTOGEN は、ターゲットコンポーネントと同じ論理マップにある using エレメントのみを生成します。また、AUTOGEN SPAN オプションも、論理マップにある環境とステージ内のさまざまなシステムとサブシステムにある using エレメントを生成します。 using エレメントは、AUTOGEN リクエストで指定されたターゲット環境およびステージで生成されますが、using エレメントのシステムとサブシステム内になります。 SPAN 拡張機能により、システムまたはサブシステムにわたって using エレメントを容易に配置および生成できます。

すべての AUTOGEN および AUTOGEN SPAN の結果について、ターゲットロケーションに現在存在しない生成されたエレメントが、ソースなしエレメントとして戻されます。ただし、管理者は、オプション機能テーブル（ENCOPTBL）で AUTOGEN_SOURCE をアクティブにすることにより、AUTOGEN 機能の動作を変更できます。このオプションがアクティブな場合、using エレメントの GENERATE アクションは、NoSource オプションではなく Copyback オプションで作成されます。

また、すべての AUTOGEN および AUTOGEN SPAN の結果について、using エレメントがマップされていない環境にあるか、それらがコンポーネントのターゲットロケーションの下位にある場合、using エレメントは生成されません。

AUTOGEN SPAN オプションをシミュレーションモードで実行して、AUTOGEN リクエストの影響を確認することができます。

AUTOGEN オプションで有効な値は、以下のとおりです。

AUTOGEN または AUTOGEN SPAN NONE：指定したコンポーネントと同じ論理マップにある using エレメントのみを生成します。「AUTOGEN」または「AUTOGEN SPAN NONE」を指定した場合、SCL は「AUTOGEN SPAN NONE」として記述されます。
AUTOGEN SPAN ALL：すべてのシステムおよびサブシステムから using エレメントを生成します。
AUTOGEN SPAN SYSTEMS：指定されたコンポーネントの同じ名前のサブシステムを持つすべてのシステムから using エレメントを生成します。
AUTOGEN SPAN SUBSYSTEMS：指定されたコンポーネントの同じ名前のシステムを持つすべてのサブシステムから using エレメントを生成します。

SPAN オプションには、以下の制限があります。

共通ライブラリは、using エレメントのシステムおよびサブシステムの GENERATE プロセッサ連結に含まれている必要があります。ライブラリが含まれていない場合、GENERATE アクションには、システムまたはサブシステムにわたって検索する際にコンポーネントに対して行われた変更が含まれます。
同じシステムおよびサブシステムは、それぞれの環境およびステージの場所に存在する必要があります。たとえば、ELEMENTA が PROD 環境のシステム Aの using エレメントである場合は、システム A が DEV 環境にも存在する必要があります。
SPAN には、ターゲット環境およびマップの上部にあるシステムまたはサブシステムの using エレメントのみが含まれます。
SPAN には、環境マップの外部の using エレメントは含まれません。

影響分析用のシミュレーションモードでの AUTOGEN の実行

AUTOGEN をアクティブにして実際にアクションを実行しなくても、AUTOGEN オプションをシミュレーションモードで実行して、結果を確認することができます。シミュレーションモードでは、バッチジョブ内のすべてのアクションの実行がバイパスされます。更新は行われません。この手順では、AUTOGEN で処理するアクションに対して、すでに AUTOGEN がコード化されていることを前提にしています。

次の手順に従ってください：

AUTOGEN オプションが含まれるバッチジョブに EN$AUSIM DD ステートメントを追加します。前景バッチリクエスト（または CA Endevor Quick Edit リクエスト）に対して、Include Additional JCL オプションを使用して DD ステートメントを追加します。以下に、DD ステートメントの例を示します。
```
//EN$AUSIM DD SYSOUT=*
```
処理するジョブをサブミットします。
C1MSGS1 および C1MSGS2 レポートは、アクションが実行された場合の構文リクエストレポートおよびアクションサマリレポートを表示します。シミュレーションモードでジョブが実行されたことを示す「*** AUTOGEN シミュレーション ***」というタイトルの見出しが表示されます。
これらのレポートを影響分析に使用して、アクションが実行された場合の結果を確認します。

AUTOGEN および AUTOGEN SPAN 処理の例

以下の例では、同じエレメントに対するさまざまな AUTOGEN アクションオプションの影響を示します。それぞれの例では、いずれかのオプションでのインベントリの元の状態に対する影響を示します。

すべての例において、システム SYSTEMC のサブシステム SUB1 および SUBC には、アプリケーションシステム SYSTEM1、SYSTEM2、SYSTEM3 でプログラムのコンパイルに使用されるエレメントが含まれています。図には、コンポーネントエレメント COPYC1 と using プログラム PGMC1 および PGMC2 が強調表示で示されています。

DEV は QAS にマッピングされ、QAS は PRD にマッピングされます。 EMER 環境は PRD にマッピングされます。 ADMIN は独立しており、その他のすべての環境が使用するプロセッサを保持しています。

すべての例は、以下の条件を前提としています。

共通 SYSTEMC ライブラリは、全環境のすべてのアプリケーションシステムのすべての GENERATE プロセッサで連結されます。
したがって、DEV の共通システムで行われたすべての変更は、PRD へのパッケージまたはプロモーションが実行される前に、すべてのステージでアプリケーションシステムによって自動的に適用されます。
これらのユースケースでは、COPYC1 はすべての PGMC、PGMC1、および PGMC2 プログラムのコンポーネントです。
各ユースケースでは、エレメントとロケーションが元の図に示すとおりであることを前提にしています。ユースケースは、前のユースケースによる影響を受けません。

すべての例の処理前のイメージ

AUTOGEN を指定した GENERATE の前 — 以下の図は、AUTOGEN を指定した GENERATE リクエストを実行する前の元の状態のエレメントを示しています。

Autogen_2_Before Autogen

例 1： AUTOGEN または AUTOGEN SPAN NONE

この例では、開発者は、DEV の共通 SYSTEMC のサブシステム SUB1 内の COPYC1 を変更し、同じ論理マップ内ですべての using エレメントを自動的に生成します。これを実行するため、開発者は、AUTOGEN または AUTOGEN SPAN NONE を指定した以下の GENERATE リクエストを実行します。

GENERATE ELEMENT 'COPYC1' 
FROM ENVIRONMENT 'DEV' 
SYSTEM 'SYSTEMC' 
SUBSYSTEM 'SUB1' 
TYPE COPYBOOK 
STAGE NUMBER 1 
OPTIONS CCID REQ#43023 
COMMENT 'EDIT COMMON COPY BOOKS' 
COPYBACK
AUTOGEN SPAN NONE .

以下に、この GENERATE リクエストの影響を示します。

コピーブック COPYC1 は、コピーバックされ、DEV/SYSTEMC/SUB1/1 で生成されます。
マップの上部の PRD/SYSTEMC/SUB1/2 にある PGMC1 は、NOSOURCE エレメントとして DEV/SYSTEMC/SUB1/1 で生成されます。
コンポーネントの論理マップの外部の、その他の using プログラムは影響を受けません。

これで、開発者はテストを完了して、影響を受けるすべてのエレメントが含まれるパッケージを MOVE アクションを使用して作成できます。

AUTOGEN を指定した GENERATE の後 — 以下の図は、AUTOGEN または AUTOGEN SPAN NONE を指定した GENERATE リクエストが、ターゲットロケーションの環境「DEV」、ステージ 1、システム「SYSTEMC」、サブシステム「SUB1」の COPYC1 に対して実行された後の結果を示しています。

Autogen_3_After Autogen または Autogen Spans None

例 2： AUTOGEN SPAN ALL

この例では、開発者は、DEV の共通 SYSTEMC のサブシステム SUB1 内の COPYC1 を変更し、すべてのシステムおよびサブシステムでコピーブックを使用するすべての using エレメントを自動的に生成します。これを実行するため、開発者は、AUTOGEN SPAN ALL を指定した以下の GENERATE リクエストを実行します。

GENERATE ELEMENT 'COPYC1' 
FROM ENVIRONMENT 'DEV' 
SYSTEM 'SYSTEMC' 
SUBSYSTEM 'SUB1' 
TYPE COPYBOOK 
STAGE NUMBER 1 
OPTIONS CCID REQ#43023 
COMMENT 'EDIT COMMON COPY BOOKS' 
COPYBACK
AUTOGEN SPAN ALL .

以下に、この GENERATE リクエストの影響を示します。

コピーブック COPYC1 は、コピーバックされ、DEV/SYSTEMC/SUB1/1 で生成されます。
マップの上部の PRD/SYSTEMC/SUB1/2 にあるエレメント PGMC1 は、NOSOURCE エレメントとして DEV/SYSTEMC/SUB1/1 で生成されます。
マップの外部の PRD/SYSTEMC/SUBC/2 にあるエレメント PGMC2 は、NOSOURCE エレメントとして DEV/SYSTEMC/SUBC/1 で生成されます。
マップの外部の PRD/SYSTEM1/SUB1/2 にあるエレメント PGMC1 は、NOSOURCE エレメントとして DEV/SYSTEM1/SUB1/1 で生成されます。
マップの外部の PRD/SYSTEM1/SUB2/2 にあるエレメント PGMC2 は、NOSOURCE エレメントとして DEV/SYSTEM1/SUB2/1 で生成されます。
マップの外部の DEV/SYSTEM2/SUB1/1 にあるエレメント PGMC は、その場所で生成されます。
AUTOGEN SPAN はターゲット環境の PGMC のシステムおよびサブシステムで GENERATE リクエストを作成しようとしますが、DEV/SYSTEM2/SUBA/1 が存在しないため、マップの外部の PRD/SYSTEM2/SUBA/2 にあるエレメント PGMC はバイパスされます。
マップの外部の PRD/SYSTEM3/SUB1/2 にあるエレメント PGMC1 は、NOSOURCE エレメントとして DEV/SYSTEM3/SUB1/1 で生成されます。
マップの外部の PRD/SYSTEM3/SUB2/2 にあるエレメント PGMC2 は、NOSOURCE エレメントとして DEV/SYSTEM3/SUB2/1 で生成されます。
マップの外部の EMER/SYSTEM2/SUB1/2 にあるエレメント PGMC は、EMER がコンポーネント COPYC1 の環境マップ内に存在しないため、影響を受けません。

これで、開発者はテストを完了して、影響を受けるすべてのエレメントが含まれるパッケージを MOVE アクションを使用して作成できます。

AUTOGEN SPAN ALL の後 — 以下の図は、AUTOGEN SPAN ALL を指定した GENERATE リクエストが、ターゲットロケーションの環境「DEV」、ステージ 1、システム「SYSTEMC」、サブシステム「SUB1」の COPYC1 に対して実行された後の結果を示しています。

Autogen_4_After Autogen Spans All

例 3： AUTOGEN SPAN SYSTEMS

この例では、開発者は、DEV の共通 SYSTEMC のサブシステム SUB1 内の COPYC1 を変更し、サブシステムを除くすべてのシステムでコピーブックを使用するすべての using エレメントを自動的に生成します。これを実行するため、開発者は、AUTOGEN SPAN SYSTEMS を指定した以下の GENERATE リクエストを実行します。

GENERATE ELEMENT 'COPYC1' 
FROM ENVIRONMENT 'DEV' 
SYSTEM 'SYSTEMC' 
SUBSYSTEM 'SUB1' 
TYPE COPYBOOK 
STAGE NUMBER 1 
OPTIONS CCID REQ#43023 
COMMENT 'EDIT COMMON COPY BOOKS' 
COPYBACK
AUTOGEN SPAN SYSTEMS .

以下に、この GENERATE リクエストの影響を示します。

コピーブック COPYC1 は、コピーバックされ、DEV/SYSTEMC/SUB1/1 で生成されます。
マップの上部の PRD/SYSTEMC/SUB1/2 にあるエレメント PGMC1 は、NOSOURCE エレメントとして DEV/SYSTEMC/SUB1/1 で生成されます。
マップの外部の PRD/SYSTEM1/SUB1/2 にあるエレメント PGMC1 は、NOSOURCE エレメントとして DEV/SYSTEM1/SUB1/1 で生成されます。
マップの外部の DEV/SYSTEM2/SUB1/1 にあるエレメント PGMC は、その場所で生成されます。
マップの外部の PRD/SYSTEM3/SUB1/2 にあるエレメント PGMC1 は、NOSOURCE エレメントとして DEV/SYSTEM3/SUB1/1 で生成されます。
マップの外部の EMER/SYSTEM2/SUB1/2 にあるエレメント PGMC は、EMER がコンポーネント COPYC1 の環境マップ内に存在しないため、影響を受けません。
サブシステム SUB1 を除くその他のサブシステムは、AUTOGEN SPAN SYSTEMS リクエストによる影響を受けないため、サブシステム SUBA、SUBC、SUB2 の using エレメントは生成されません。

これで、開発者はテストを完了して、影響を受けるすべてのエレメントが含まれるパッケージを MOVE アクションを使用して作成できます。

AUTOGEN SPAN SYSTEMS の後 — 以下の図は、AUTOGEN SPAN SYSTEMS を指定した GENERATE リクエストが、ターゲットロケーションの環境「DEV」、ステージ 1、システム「SYSTEMC」、サブシステム「SUB1」の COPYC1 に対して実行された後の結果を示しています。

Autogen_5_After Autogen Spans Systems

例 4：AUTOGEN SPAN SUBSYSTEMS

この例では、開発者は、DEV の共通 SYSTEMC のサブシステム SUB1 内の COPYC1 を変更し、現在のシステム内のすべてのサブシステムでコピーブックを使用するすべての using エレメントを自動的に生成します。これを実行するため、開発者は、AUTOGEN SPAN SUBSYSTEMS を指定した以下の GENERATE リクエストを実行します。

GENERATE ELEMENT 'COPYC1' 
FROM ENVIRONMENT 'DEV' 
SYSTEM 'SYSTEMC' 
SUBSYSTEM 'SUB1' 
TYPE COPYBOOK 
STAGE NUMBER 1 
OPTIONS CCID REQ#43023 
COMMENT 'EDIT COMMON COPY BOOKS' 
COPYBACK
AUTOGEN SPAN SUBSYSTEMS .

以下に、この GENERATE リクエストの影響を示します。

コピーブック COPYC1 は、コピーバックされ、DEV/SYSTEMC/SUB1/1 で生成されます。
マップの上部の PRD/SYSTEMC/SUB1/2 にあるエレメント PGMC1 は、NOSOURCE エレメントとして DEV/SYSTEMC/SUB1/1 で生成されます。
マップの外部の PRD/SYSTEMC/SUBC/2 にあるエレメント PGMC2 は、NOSOURCE エレメントとして DEV/SYSTEMC/SUBC/1 で生成されます。
その他のサブシステムは AUTOGEN SPAN SUBSYSTEMS リクエストによる影響を受けないため、システム SYSTEM1、SYSTEM2、SYSTEM3 の using エレメントは生成されません。

これで、開発者はテストを完了して、影響を受けるすべてのエレメントが含まれるパッケージを MOVE アクションを使用して作成できます。

AUTOGEN SPAN SUBSYSTEMS の後 — 以下の図は、AUTOGEN SPAN SUBSYSTEMS を指定した GENERATE リクエストが、ターゲットロケーションの環境「DEV」、ステージ 1、システム「SYSTEMC」、サブシステム「SUB1」の COPYC1 に対して実行された後の結果を示しています。

Autogen_6_After Autogen Spans Subsystems