Transfer From Endevor To Endevor ステートメント節
TRANSFER FROM
Endevor
TO Endevor
ステートメント節について説明します。TRANSFER FROM
Endevor
TO Endevor
ステートメント節について、以下で説明します。TRANSFER ELEMENT
element-name
転送するエレメントを識別します。必要な構文をコーディングし、適切なエレメント名を入力します。エレメント名に名前マスクを使用することもできます。
- VERSIONversionLEVELlevel
転送するバージョンとレベル番号を示します。バージョンとレベルを指定する場合は、完全なエレメント名をコーディングします。THROUGH 節を使用する場合、この節を入力することはできません。指定可能なバージョン番号は 1 〜 99 です。指定可能なレベル番号は、00 ~ 99 です。VERSION および LEVEL を同時に指定する必要があります。
VERSION LEVEL 節を指定しない場合、TRANSFER アクションは、すべてのレベルをターゲット ロケーションに転送します。この節を指定すると、指定した VERSION LEVEL のみが転送されます。
指定された VERSION LEVEL が現在のレベルではない場合、プロセッサ グループ定義の設定に関係なく、ターゲット ロケーションで generate プロセッサが実行されます。
THROUGH (THRU)
element-name
転送するエレメントの範囲を示します。範囲は TRANSFER ELEMENT ステートメントにコーディングされているエレメントから始まり、このステートメントで指定されているエレメントまでです。エレメント名には名前マスクを使用できます。
FROM ENVIRONMENT
env-name
SYSTEM
system-name
SUBSYSTEM
subsys-name
TYPE
type-name
STAGE
stage-id
STAGE NUMBER
stage-no
FROM 節は、転送されるエレメントのロケーションを示します。
Endevor
は、アクション内の FROM 節と先行する SET FROM 節の両方を使用して、そのアクションの「from」条件を決定します。- アクション内の FROM 節は、そのアクションに先行する SET FROM 節の値を上書きします。
- SET FROM 節に FROM 節に含まれていない値が含まれている場合、Endevorはそれらの値を使用します。
環境、システム、サブシステム、タイプ、およびステージを指定します。環境名は明示的に指定する必要があります。名前マスクは、システム、サブシステム、タイプ、およびステージで使用できます。ステージの指定には、以下のいずれかを使用できます。
- STAGE ID - 英数字のステージ識別子を 1 つ入力します。
- STAGE NUMBER -1または2を入力します。
TO ENVIRONMENTenv-nameSYSTEMsystem-nameSUBSYSTEMsubsys-nameTYPEtype-nameSTAGEstage-idSTAGE NUMBERstage-noELEMENTelement-name
TO 節は、エレメントが転送される場所を示します。
Endevor
は、アクション内の TO 節と先行する SET TO 節の両方を使用して、そのアクションの「to」条件を決定します。- アクション内の TO 節は、そのアクションに先行する SET TO 節の値を上書きします。
- SET TO 節に TO 節に含まれていない値が含まれている場合、Endevorはそれらの値を使用します。
- SET TO 節がコーディングされていないか、完全にワイルドカードで指定されており、TO 節のシステム、サブシステム、タイプ、またはエレメント フィールドがコーディングされていないか、完全にワイルドカードで指定されている場合、これらのフィールドはデフォルトで FROM 節でコーディングされた対応する値になります。
- ターゲット環境値は、TO 節または SET TO 節で明示的にコーディングする必要があります。部分的なワイルドカードおよび名前マスクは、環境フィールドでは使用できません。
ステージの指定には、以下のいずれかを使用できます。
- STAGE ID -- 英数字のステージ識別子を 1 つ入力します。
- STAGE NUMBER --1または2を入力します。
TRANSFER ELEMENT 節で指定したエレメント名を変更する場合、別のエレメント名を入力します。ここにエレメント名を入力しない場合、
Endevor
は FROM ロケーションのエレメント名を割り当てます。- 新しいエレメント名を入力できるのは、完全なエレメント名が TRANSFER ELEMENT 節にコーディングされている場合 (つまり、名前マスクを使用していない場合) のみです。
- 異なるエレメント名をコーディングする場合は、TRANSFER ステートメントでコーディングする必要があります。SET TO MEMBER 節はこのアクションには適用されません。
WHERE
WHERE 節を使用して、エレメントの選択条件をさらに限定します。
Endevor
は、アクション内の WHERE 節と先行する SET WHERE 節の両方を使用して、そのアクションの「where」条件を決定します。- アクション内の WHERE 節は、そのアクションに先行する SET WHERE 節の値を上書きします。
- SET WHERE 節に WHERE 節に含まれていない値が含まれている場合、Endevorはそれらの値を使用します。
WHERE CCID OF
- 指定された CCID のいずれかに一致するエレメントに処理を制限します。このフィールドでは名前マスクを使用できます。ccid
- CURRENT-
- MCF (マスタ制御ファイル) の CCID フィールドを検索して、指定された CCID を見つけるようにEndevorに指示します。これがデフォルトです。
- ALL-
- マスタ制御ファイルと SOURCE DELTA レベルの両方を検索して、指定された CCID を見つけるようにEndevorに指示します。ACM がある場合、Endevorは COMPONENT LIST DELTA レベルも検索して、指定された CCID を見つけます。
- RETRIEVE-
- マスタ制御ファイルの RETRIEVE CCID フィールド内の CCID を使用するようにEndevorに指示します。
複数の CCID で識別されるエレメントを選択する必要がある場合、CCID をかっこで囲み、カンマで区切って複数の CCID を指定できます。CCID は、必要に応じて複数行に拡張できます。
以下の例は、この節の使用方法を示しています。
Example 1: WHERE CCID OF CURRENT (PROJ__1, PROJ__2, PROJ__4) Example 2: WHERE CCID OF ALL (PROJ___)
WHERE PROCESSOR GROUP
グループ名
-
この節を使用すると、指定されたプロセッサ グループに従ってエレメントを選択できます。プロセッサ グループ名を指定している場合は、名前マスクを使用できます。複数のプロセッサ グループで識別されるエレメントを選択する必要がある場合、プロセッサ グループをかっこで囲み、カンマで区切ることで、複数の異なるプロセッサ グループ セレクタを指定します。プロセッサ グループは、必要に応じて複数行に拡張できます。
以下の例は、この節の使用方法を示しています。
Example 1: WHERE PROCESSOR GROUP (COBVS, COBII) Example 2: WHERE PROCESSOR GROUP (COB_)
OPTIONS
OPTIONS 節を使用すると、アクション要求をさらに指定できます。
CCID
- 1 ~ 12 文字の CCID および (または) 1 ~ 40 文字のコメントを入力できます。ccid
/COMMENT comment
CCID および(または)コメントが必要な場合があります。必要な CCID および(または)コメントを指定しない場合、TRANSFER アクションが失敗します。
TRANSFER アクションで CCID および(または)コメントを指定する場合、TRANSFER 要求を履歴なし、履歴あり、または同期ありのいずれかで指定したかに応じて、
Endevor
での CCID フィールドおよび(または) COMMENT フィールドの更新処理は異なります。履歴なしの TRANSFER アクションで CCID および(または)コメントを指定すると、
Endevor
は、この CCID および(または)コメントを使用して、以下の処理を行います。- generate プロセッサを実行している場合、generate および component list delta CCID フィールドと(または) COMMENT フィールドを設定します。
- last action CCID フィールドおよび(または) COMMENT フィールドを設定します。
Endevor
は以下も実行します。- retrieve CCID フィールドおよび(または) COMMENT フィールドをクリアします。
- 前のステージの値から、現在のソース CCID フィールドと (または) COMMENT フィールドを設定します。
- 前のステージの最後のデルタ値から、source delta CCID フィールドと (または) COMMENT フィールドを設定します。
WITH HISTORY オプションを使用して TRANSFER アクションで CCID および(または)コメントを指定すると、
Endevor
は、CCID および(または)コメントを使用して、以下の処理を行います。- generate プロセッサを実行している場合、generate および component list delta CCID フィールドと(または) COMMENT フィールドを設定します。
- last action CCID フィールドおよび(または) COMMENT フィールドを設定します。
Endevor
は以下も実行します。- retrieve CCID フィールドおよび(または) COMMENT フィールドをクリアします。
- 前のステージの値から、現在のソース CCID フィールドと (または) COMMENT フィールドを設定します。
- source delta CCID と COMMENT をそれぞれのデルタ レベルで移動します。
SYNCHRONIZE オプションを使用して TRANSFER アクションで CCID および(または)コメントを指定すると、
Endevor
は、この CCID および(または)コメントを使用して、以下の処理を行います。- retrieve CCID フィールドおよび(または) COMMENT フィールドをクリアします。
- 前のステージの値から、現在のソース CCID フィールドと (または) COMMENT フィールドを設定します。
- 同期フラグを使用して、転送のターゲットの値から source delta CCID フィールドと (または) COMMENT フィールドを設定します。
BYPASS GENERATE PROCESSOR を使用すると、TRANSFER アクションによって、generate または component list delta CCID フィールドと(または) COMMENT フィールドが設定
されません
。NEW VERSION version-
デフォルトでは、FROM ロケーション エレメントのバージョン番号(転送時)が、TO ロケーション エレメントに割り当てられます。TO ロケーション エレメントに異なるバージョン番号を割り当てるには、このオプションを使用します。使用する番号(1 ~ 99
。下限値と上限値を含み、先頭のゼロはオプション)を入力するだけです。Endevor
は、各ロケーションでエレメントの 1 つのバージョンのみを許可します。そのため、ターゲット ロケーションに現在、エレメントが存在する場合は、別のバージョンで更新できません。たとえば、エレメントのバージョン 2 を、既存のバージョン 1 がすでに存在するターゲット ロケーションに転送しようとする場合、バージョン 2 を転送する前に、現在のバージョン 1 をアーカイブまたは削除する必要があります。エレメントがターゲット ロケーションまたはマップ ルート上の場所に存在する場合は、TRANSFER アクションが失敗します。IGNORE GENERATE FAILED-
このオプションは、エレメントに以前に設定された *FAILED* フラグに適用されます。TRANSFER アクションが失敗した場合は、「the generate failed. (生成に失敗しました。)」というメッセージが表示されます。アクションの処理は通常、この時点で終了します。ただし、このオプションを入力すると、エレメントが以前に生成されたか、または正常に移動されたかどうかにかかわらず、アクションを実行できます。
BYPASS GENERATE PROCESSOR-
generate/move プロセッサ(選択したプロセッサ グループ オプションによって異なる)をエレメントで実行しない場合は、このオプションを選択します。PROCESSOR GROUP EQ/= group name-
プロセッサの事前定義済みのグループを指定するには、このオプションを選択します。プロセッサ グループを指定しない場合、Endevor
によってデフォルトはこのエレメントで最後に使用されたプロセッサ グループに設定されます。ただし、キーワード PROCESSOR GROUP EQ と BYPASS GENERATE PROCESSOR は、相互に排他的です (どちらか一方をコーディングできます)。両方をコーディングした場合、デフォルトの BYPASS GENERATE PROCESSOR が使用されます。FROM エレメントが BYPASS GENERATE PROCESSOR が指定されていないプロセッサ グループに関連付けられている場合、プロセッサ グループは Processor グループ節で上書きされる可能性があります。それ以外の場合は、プロセッサ グループを上書きできないことを示すメッセージが発行されます。
OVERRIDE SIGNOUT-
エレメントが自分以外のユーザにサインアウトされている場合、このアクションを実行するには、このオプションをコーディングする必要があります。別のユーザが行った変更のリグレッションを避けるため、OVERRIDE SIGNOUT は注意して使用してください。BYPASS ELEMENT DELETE-
このオプションは、エレメントを転送後に FROM ロケーションに保持するようにEndevor
に指示します。このオプションを選択すると、Delete プロセッサもバイパスされます。BYPASS DELETE PROCESSOR-
このオプションを選択する場合、Endevor
は Delete プロセッサを実行しません。BYPASS DUPLICATE OUTPUT CHECK–
このオプションを有効にすると、システム定義で [重複プロセッサ出力タイプ] のチェックがオンになっている場合でも、この転送アクションでの重複プロセッサ出力のチェックがバイパスされます。メッセージ「IMGR255E REG. ERROR: ELM EXISTS W/SAME PROC GRP O/P TYPE (COPY) AT」は生成されません。 WITH HISTORY-
WITH HISTORY オプションは、ソース エレメントの変更履歴を保持します。TRANSFER WITH HISTORY を要求すると、Endevor
は最初にターゲット エレメントの現在のレベルがソース エレメントのベース レベルと同じであることを確認します。その後、エレメントのすべてのレベルをソースからターゲットに転送し、ソース変更履歴をターゲット変更履歴に追加します。このオプションをコーディングしない場合、
Endevor
は履歴なしでエレメントを転送します。履歴なしでエレメントを転送すると、Endevor
はソース ロケーションのエレメント レベルを確認し、ターゲット ロケーションで一致するレベルを検索します。その後、Endevor
は 2 つのレベルを比較し、その違いを反映する新しいレベルをターゲット ロケーションに作成します。ソース エレメントのベース レベルがターゲットの現在のレベルと異なる場合、SYNCHRONIZE オプションをコーディングしない限り、TRANSFER は失敗します。
WITH HISTORY オプションは、エレメント変更レベルに「H」フラグを付け、どのエレメント変更レベルが [履歴] オプションを指定して作成されたかを示します。H インジケータは、Endevor の前景インターフェースと Quick Edit の [エレメント参照]、[履歴]、[変更]、および [レベルサマリ] パネルの [レベル サマリ] セクションに表示される [同期] 列に表示されます。
SYNCHRONIZE オプションは、ソース エレメントのベース レベルとターゲット エレメントの現在のレベルとの相違点を補正します。
Endevor
は、ソースおよびターゲット エレメント間の同期レベルを、ソースの第 1 レベルから開始して、デルタを順方向に検索しようとします。Endevor
は、同期レベルを検出すると 2 つのレベルを比較し、その違いを反映する新しいレベルをターゲットに作成します。Endevor
が同期レベルを検出できず、SYNC を指定していた場合、Endevor
は非同期メッセージを発行します。Endevor
は、ソースの最終レベルとターゲットの最終レベルを比較し、その違いを反映する新しいレベルをターゲットに作成します。履歴付きで移動する場合、同期ポイントが検出されると、Endevor
はエレメントを FROM ロケーションから TO ロケーションに移動し、同期ポイント エレメントの後に FROM ロケーション デルタ レベルを追加します。2 つのレベルが異なっており、SYNC が指定されている場合、Endevor
は最初に FROM エレメントのベース レベルとターゲットの間の違いを反映する同期レベルをターゲットに作成し、その後、エレメントを TO ロケーションに移動し、FROM ロケーション デルタ レベルをターゲットに追加します。SIGNIN-
このオプションは、移動が正常に完了した後、ターゲット ステージですべてのエレメントをサインインするように Endevor
に指示します。このオプションを使用すると、SET OPTION RETAIN SIGNOUT 節または SET OPTION SIGNOUT TO 節が上書きされます。RETAIN SIGNOUT-
このオプションは、すべてのエレメントのソース ロケーションでのサインアウトをターゲット ロケーションで保持するように Endevor
に指示します。このオプションは、エレメントが TRANSFER 前にソースでサインアウトされていた場合にのみ適用されます。- エレメントが TRANSFER の前にソースでサインアウトされていた場合、TRANSFER の後に、ターゲットで同じ ID にサインアウトされます。
- エレメントが TRANSFER の前にソースでサインアウトされていない場合、TRANSFER 後にターゲットでサインアウトされません。
- このオプションを使用しない場合、ターゲット ロケーションのエレメントは、TRANSFER が発生する前にターゲットでサインアウトされたかどうかにかかわらず、サインアウトされません。
SIGNOUT TO userid
- このオプションは、ターゲット ステージで、すべてのエレメントを指定されたユーザ ID にサインアウトするように Endevor
に指示します。