Transfer From Archive Data Set の節とオプション

TRANSFER from
Endevor
TO ARCHIVE DATA SET ステートメントの節とオプションについて説明します。
以下では、Transfer From Achrive data set の節とオプションについて説明します。
TRANSFER ELEMENT
element-name
転送するエレメントを示します。必要な構文をコーディングし、適切なエレメント名を入力します。エレメント名に名前マスクを使用することもできます。
VERSION
転送するエレメントのバージョン (1 〜 99) を指定します。この節を使用する場合は、完全なエレメント名を指定する必要があります。
LEVEL
転送するエレメントのレベル (00 〜 99) を指定します。LEVEL 節を使用する場合、以下のようになります。
  • THROUGH 節は使用できません。
  • 完全なエレメント名を指定する必要があります。
LEVEL 節を指定しない場合、Transfer アクションは、すべてのレベルをターゲット ロケーションに転送します。この節を指定すると、
Endevor
は指定したレベルのみを転送します。
指定されたレベルが現在のレベルではない場合、プロセッサ グループ定義で指定された設定に関係なく、ターゲット ロケーションで 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
    はそれらの値を使用します。
    詳細については、「SCL ステートメント」の SET FROM ステートメントの説明を参照してください。
  • 環境、システム、サブシステム、タイプ、ステージを指定する必要があります。環境名は明示的に指定する必要があります。名前マスクは、システム、サブシステム、タイプ、およびステージで使用できます。ステージの指定には、以下のいずれかを使用できます。
    STAGE ID
    英数字のステージ識別子を 1 つ入力します。
    STAGE NUMBER
    1 または 2。
    TO FILE (DDNAME) dd-name
    TO 節は、エレメントの転送先のファイルまたは DDname を示します。
    Endevor
    は、アクション内の TO 節と先行する SET TO 節の両方を使用して、そのアクションの「to」条件を決定します。
    • アクション内の TO 節は、そのアクションに先行する SET TO 節の値を上書きします。
    • SET TO 節に TO 節に含まれていない値が含まれている場合、
      Endevor
      はそれらの値を使用します。
    DCB には可変ブロック レコード (RECFM=VB) を指定する必要があり、DSORG は PS である必要があります。最小 LRECL は、2940、または TYPE-LENGTH に 14 を加えた値のいずれか大きい方である必要があります。ディスクにアーカイブする場合、上記のルールでより大きな LRECL/BLKSIZE が必要でない限り、推奨されるブロック サイズは 1/2 トラックで、推奨される LRECL は 1/2 トラックから 4 を引いた値です。テープにアーカイブする場合、32760 ブロック サイズと 32756 LRECL をお勧めします。
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 (PROJV)
WHERE PROCESSOR GROUP グループ名 -- この節を使用すると、指定されたプロセッサ グループに従ってエレメントを選択できます。プロセッサ グループ名を指定している場合は、名前マスクを使用できます。
複数のプロセッサ グループで識別されるエレメントを選択する必要がある場合、プロセッサ グループをかっこで囲み、カンマで区切ることで、複数の異なるプロセッサ グループ セレクタを指定します。プロセッサ グループは、必要に応じて複数行に拡張できます。
以下の例は、この節の使用方法を示しています
Example 1: WHERE PROCESSOR GROUP (COBVS, COBII) Example 2: WHERE PROCESSOR GROUP (COBV)
OPTIONS
OPTIONS 節を使用すると、アクション要求をさらに指定できます。
CCID
ccid
/COMMENT
comment
1 ~ 12 文字の CCID および(または) 1 ~ 40 文字のコメントを入力することができます。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 と COMMENTS をそれぞれのデルタ レベルで移動します。
    With History アクション オプションは、エレメント変更レベルに H フラグを付け、どのエレメント変更レベルが履歴オプションありで作成されたかを示します。H インジケータは、
    Endevor
    の前景インターフェースと Quick Edit の [エレメント参照]、[履歴]、[変更]、および [レベルサマリ] パネルの [レベル サマリ] セクションの [同期] 列に表示されます。また、H インジケータはバッチ プリント出力にも表示されます。
SYNCHRONIZE オプションを使用して TRANSFER アクションで CCID および(または)コメントを指定すると、
Endevor
は、この CCID および(または)コメントを使用して、以下の処理を行います。
  • retrieve CCID フィールドおよび(または) COMMENT フィールドを設定します。
  • 前のステージの値から、ソース CCID フィールドと (または) COMMENT フィールドを設定します。
  • 同期フラグを使用して、TRANSFER のターゲットの値から source delta CCID フィールドと (または) COMMENT フィールドを設定します。
BYPASS ELEMENT DELETE
エレメントを転送後に FROM ロケーションに保持するように
Endevor
に指示します。このオプションを選択すると、Delete プロセッサもバイパスされます。
BYPASS DELETE PROCESSOR
このオプションを選択する場合、
Endevor
は Delete プロセッサを実行しません。
IGNORE GENERATE FAILED
エレメントに以前に設定された *FAILED* フラグに適用されます。TRANSFER アクションが失敗した場合は、「the generate failed. (生成に失敗しました。)」というメッセージが表示されます。アクションの処理は通常、この時点で終了します。
ただし、このオプションを入力すると、エレメントが以前に生成されたか、または正常に移動されたかどうかにかかわらず、アクションを実行できます。
OVERRIDE SIGNOUT
エレメントが自分以外のユーザにサインアウトされている場合、このアクションを実行するには、このオプションをコーディングする必要があります。別のユーザが行った変更のリグレッションを避けるため、OVERRIDE SIGNOUT は注意して使用してください。