Transfer From Archive Data Set の節とオプション
TRANSFER from
Endevor
TO ARCHIVE DATA SET ステートメントの節とオプションについて説明します。以下では、Transfer From Achrive data set の節とオプションについて説明します。
- TRANSFER ELEMENTelement-name
- 転送するエレメントを示します。必要な構文をコーディングし、適切なエレメント名を入力します。エレメント名に名前マスクを使用することもできます。
- VERSION
- 転送するエレメントのバージョン (1 〜 99) を指定します。この節を使用する場合は、完全なエレメント名を指定する必要があります。
- LEVEL
- 転送するエレメントのレベル (00 〜 99) を指定します。LEVEL 節を使用する場合、以下のようになります。
- THROUGH 節は使用できません。
- 完全なエレメント名を指定する必要があります。
- LEVEL 節を指定しない場合、Transfer アクションは、すべてのレベルをターゲット ロケーションに転送します。この節を指定すると、Endevorは指定したレベルのみを転送します。
- 指定されたレベルが現在のレベルではない場合、プロセッサ グループ定義で指定された設定に関係なく、ターゲット ロケーションで generate プロセッサの実行が強制されます。
- THROUGH (THRU)element-name
- TRANSFER ELEMENT ステートメントにコーディングされているエレメントから始まり、このステートメントで指定されているエレメントまでの範囲のエレメントを転送する必要があることを示します。エレメント名には名前マスクを使用できます。
- FROM ENVIRONMENTenv-nameSYSTEMsystem-nameSUBSYSTEMsubsys-nameTYPEtype-nameSTAGEstage-idSTAGE NUMBERstage-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 OFccid
- 指定された 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 節を使用すると、アクション要求をさらに指定できます。
- CCIDccid/COMMENTcomment
- 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 は注意して使用してください。