3.18.6　bjexu_pcopy（ファイルの複写）

■ 形式

■ オペランド

OUTDD=DD名　〜＜環境変数名＞((1〜31文字))

出力ディレクトリのパス名を定義したDD名を指定する。このオペランドは必須である。

INDD=({DD名｜(DD名,R)}[,{DD名｜(DD名,R)}]…)

• DD名　〜＜環境変数名＞((1〜31文字))

  入力ディレクトリのパス名を定義したDD名を指定する。このオペランドの指定は任意であり，後続のINDD文でも指定できる。

  このオペランドを省略する場合，COPY文の直後にINDD文の指定が必要である。INDD文の指定がなければ，エラーメッセージを出力して，このコピーオペレーションを無効とし，次のコピーオペレーションを処理する。

• R

  出力ディレクトリ中に，複写するファイルのファイル名またはSELECT文（MEMBERオペランド指定）で名前を変更して複写する場合は，新しいファイル名と同じ名称のファイルがすでに存在するとき，ファイルの置き換えを指定する。ファイルの置き換えを指定するには，DD名とキーワードRを括弧で囲むこと。

LIST=NO

処理したファイルのファイル名などの詳細なメッセージを出力する必要がないときに指定する。出力しないメッセージは，KAKD1100-I〜KAKD1105-Iメッセージである。このオペランドを省略すると，すべてのメッセージを出力する。

■ 注意事項

• COPY文はコピーオペレーションの開始を示す制御文であるため，コピーオペレーションの先頭にあること。

• INDDオペランドでファイルの置き換えを指定する場合，（DD名,R）の指定の途中で行を変えないこと。

• INDDオペランドとOUTDDオペランドで同じディレクトリのパス名を指定した場合，SELECT文やEXCLUDE文の指定があるとエラーになり，そのコピーオペレーションを終了する。

■ 形式

■ オペランド

MEMBER=({ファイル名｜(ファイル名,,R)｜(ファイル名,新ファイル名[,R])}[,{ファイル名｜(ファイル名,,R)｜(ファイル名,新ファイル名[,R])}]…)

• ファイル名　〜＜引用文字列または特殊文字列＞

  複写するファイル名を指定する。

• 新ファイル名　〜＜引用文字列または特殊文字列＞

  名前を変更して複写するとき，新しいファイル名を指定する。

• R

  複写先の出力ディレクトリに，複写するファイルのファイル名または名前を変更して複写する場合は，新しいファイル名と同じ名称のファイルがすでに存在するとき，ファイルの置き換えを指定する。

GROUP=({ファイル総称名｜(ファイル総称名,R)}[,{ファイル総称名｜(ファイル総称名,R)}]…)

• ファイル総称名　〜＜引用文字列または特殊文字列＞

  複写するファイルをファイル群の総称名（ファイル名の頭文字）で指定する。例えば，ABCと指定した場合，ファイル名がABCで始まるすべてのファイルが対象となる。

• R

  複写先の出力ディレクトリに，複写するファイルと同じ名称のファイルがすでに存在するとき，ファイルの置き換えを指定する。

■ 注意事項

• 同一コピーステップ内でEXCLUDE文と同時に指定できない。

• 新ファイル名の指定やファイルの置き換えを指定する場合，（ファイル名,,R），（ファイル名,新ファイル名,R），および（ファイル総称名,R）の指定の途中で行を変えないこと。

• 同一コピーステップ内で同一のファイル名（新ファイル名も含む），およびファイル総称名を指定しないこと。

• 同一コピーステップ内でSELECT文は複数指定できる。

• 同一コピーステップ内でMEMBERとGROUPを同時に指定できない。

• COPY文およびINDD文よりあとに記述すること。

• ファイル名およびファイル総称名には，パス名の区切りを示す文字（/：スラント）を指定できない。

• MEMBERオペランド指定とその他の指定では，複写するファイルの選択方法が異なる。

  次にSELECT文のMEMBERオペランド指定以外の場合とSELECT文のMEMBERオペランド指定の場合の複写するファイルの選択方法を示す。

SELECT文のMEMBERオペランド指定以外の場合

SELECT文のGROUPオペランド指定，EXCLUDE文指定，またはSELECT文およびEXCLUDE文を指定しない全ファイルの複写指定のときは，入力ディレクトリの指定順に，入力ディレクトリごとに複写処理する。

＜例＞入力ディレクトリIN1→IN2→IN3の順に，ファイル総称名がAとBのファイルを複写する。ただし，入力ディレクトリIN1配下の対象ファイルは置き換えを行わない。

• 制御文

  

• 処理の流れ

  1.　IN1を参照する。指定に該当するファイルAは，出力ディレクトリに同じ名称のファイルが存在し，置き換え指定がないため複写しない。

  2.　IN2を参照する。指定に該当するファイルBは，置き換え指定があるため複写する。

  3.　IN3を参照する。指定に該当するファイルAとBは，置き換え指定があるため複写する。

  図3‒35　複写処理の流れ（SELECT文のMEMBERオペランド指定以外の場合）

SELECT文のMEMBERオペランド指定の場合

SELECT文のMEMBERオペランド指定は，指定されたファイル名単位に，入力ディレクトリの指定順を検索し，最初に見つかったファイルだけ複写する。

ファイルを置き換える指定がないため，複写しなかった場合も，ファイルは見つかったものとする。

＜例＞入力ディレクトリIN1→IN2→IN3の順に，ファイル名がAとBのファイルを検索し複写する。ただし，ファイルAは置き換えを行わない。

• 制御文

  

• 処理の流れ

  1.　ファイルAをIN1から検索する。IN1でファイルAが見つかったが，出力ディレクトリに同じ名称のファイルAが存在し，置き換え指定がないため複写しない。この時点でファイルAの処理は終了する。

  2.　ファイルBをIN1から検索する。IN2でファイルBが見つかったため，これを複写する。この時点でファイルBの処理は終了する。

  図3‒36　複写処理の流れ(SELECT文のMEMBERオペランド指定の場合)

■ 形式

■ オペランド

MEMBER=(ファイル名[,ファイル名]…)　〜＜引用文字列または特殊文字列＞

出力したくないファイル名を指定する。

■ 注意事項

• 同一コピーステップ内で同一のファイル名を指定できない。

• 同一コピーステップ内でSELECT文と同時に指定できない。

• EXCLUDE文は複数指定できる。

• 同一コピーステップ内はCOPY文およびINDD文よりあとに記述すること。

■ 形式

■ オペランド

INDD=({DD名｜(DD名,R)}[,{DD名｜(DD名,R)}]…)

• DD名　〜＜環境変数名＞((1〜31文字))

  入力ディレクトリのパス名が設定されたDD名を指定する。

• R

  出力ディレクトリ中に，複写するファイルのファイル名またはSELECT文（MEMBERオペランド指定）で名前を変更して複写する場合は，新しいファイル名と同じ名称のファイルがすでに存在するとき，ファイルの置き換えを指定する。ファイルの置き換えを指定するには，DD名と"R"を括弧で囲む。

■ 注意事項

• COPY文と組み合わせて指定する。

• SELECT文やEXCLUDE文の直後に指定した場合は，コピーステップの開始と先行するコピーステップの終了を示す。出力ディレクトリは，先行するコピーステップのCOPY文から引き継がれる。