cp - ファイルをコピーする

説明

cp は、ファイル (複数でもよい) をそのコマンド行の最後の引数で指定された ターゲットへコピーします。 ターゲットが既存のファイルの場合は、cp はそれを上書きします。ターゲットが存在しない場合は、cp はそれを作成します。ターゲット・ファイルが存在し ていて、書き込み許可がない場合は、cp はアクセスを拒否し、次のコピーを続行します。

3 つ以上のパス名を指定する場合は、最後のパス名 (すなわち、ターゲット) はディレクトリーでなければ なりません。ターゲットがディレクトリーの場合は、cp はソースをそのディレクトリーに コピーし、ソース・パス名の最後のコンポーネントによって与えられた名前を付けます。

cp を使用して、MVS™ データ・セットとの間でファイルをコピーす ることもできます。コピーするファイルを複数指定する場合には、ターゲット (コマンド行の最 後のパス名) はディレクトリーまたは区分データ・セットのいずれかでなけ ればなりません。ターゲットが MVS 区分データ・セットの場合、ソースを UNIX ディレクトリ ーにすることはできません。

cp は世代別データ・グループ (GDG) 間のコピーをサポートしていません。 これらの MVS データ・セットを使用するには、 実際のデータ・セット名を指定する必要があります。また、cp は一時 PDSE へのコピーもサポートしていません。

レコードをコピーするとき、ストリング " ¥n" はストリング "¥n" と同様にコピーさ れます。すなわち、両方とも "¥n" として読み戻されます。ここで、"¥n" は 、z/OS XL C++ が単一ブランクを含むレコードをファイルに書き込むことを示 します (z/OS XL C/C++ のデフォルトの動作です)。 出力内の他のブランクはすべてブランクとして読み戻され、空の (長さがゼ ロの) レコードは入力では無視されます。ただし、cp の呼び出し前に 環境変数 _EDC_ZERO_RECLEN が Y に 設定されていれば、空のレコードは単一改行文字として扱われ、無視されません。また、_EDC_ZERO_RECLEN が Y に設定されていれば、 単一改行文字は空のレコードしてファイルに書き込まれ、単一ブランクは "¥n" で表されます。

オプション

–A

すべての接尾部 (最初のピリオドからターゲットの終わりまで) を切 り捨てることを指定します。–A は、–M および –C オプションに優先しま す。–A が最後に指定されたオプションであると、–S は オフになります。

–B

コピーするデータにバイナリー・データが含まれていることを指定し ます。–B を指定すると、cp の操作で <改行> 文字または DBCS データの特性が考慮されません。(このタイプの動作は UNIX システム間でコピーする際に一般的に見られるものです。)–B は、–F、–X、および –T と互いに排他的であるため、これらのオプションを複数指定すると、エラーになります。

–C

MVS データ・セット・メンバーの制約に合わせてファイル名を 8 文字 で切り捨てることを指定します。

–c (UNIX 間のみ)

コピー操作を完了するための十分な空きがディスケットにないとき、その交換をうながします。このオプションは、ディスケット・ドライブのないシステムには影響ありません。

規則: 親ディレクトリーが新しいターゲット・ディスケットに存在する必要があります。

–F format

コピーするときにファイルをバイナリー、テキスト、またはレコード・ファイル・フォーマットのどちらで扱うかを指定します。 テキスト・ファイルの場合は行の終わり区切り文字を指定します。さらに、ターゲットが UNIX ファイルであれば、ファイル・フォーマットを format に設定します。テキスト・ファイルの場合、UNIX から MVS へのコピーでは、行の終わり区切り文字は取り除かれます。 MVS から UNIX へのコピーでは、 行の終わり区切り文字が追加されます。 (コード・ページ IBM-1047 は、行の終わり区切り文字の有無を調べるために使用されます。) レコード・ファイル・フォーマットのファイルは、バイナリー・ファイルのように扱われます。

UNIX 間のコピーの際に -F が使用された場合、cp はターゲット・ファイルのフォーマットだけを設定し、行末区切り文字を置換しません。

format の設定が失敗した場合は警告が表示されますが、cp は、 コピーするよう指定された残りのファイルのコピーを続けます。

–F は、–B、–X、–p、 および –T と互いに排他的です。–F と共にこれらのオプション の 1 つを指定すると、エラーになります。–F を 2 回以上指定すると、最後に指定された –F が使 用されます。

format には、以下を指定できます。

not

指定されていません

bin

バイナリー・データ

rec

レコード。(ファイル・データは、接頭部の付いたレコードから成ります。レコードの接頭部には、後に続くレコードの長さが含まれます。シェル・コマンドの観点からは、このフォーマットのファイルはバイナリー・ファイルのように扱われます。)

あるいは、以下のテキスト・データ区切り文字。

nl

改行文字

cr

キャリッジ・リターン

lf

改行 (LF)

crlf

キャリッジ・リターン改行

lfcr

改行キャリッジ・リターン

crnl

キャリッジ・リターン改行

–f

開くことができない UNIX 宛先ファイルの除去と置換を試みます。

-H

コマンド行でソース・オペランドとして指定されたシンボリック・リンクに従います。 ツリー横断中に検出されるシンボリック・リンクには従いません。これは、-R または -r オプションが指定され、-H、-L、または -P オプションのいずれも指定されない場合のデフォルトの動作です。

制約事項: このオプションを使用できるのは、-R または -r オプションが指定される場合のみです。

–i

UNIX ターゲットにコピーするとき、–i は、ファ イルが読み取り専用かどうかにかかわらず、既存のファイルを上書きしたい かどうかを尋ねます。

-L

コマンド行でソース・オペランドとして指定されたシンボリック・リンクおよびツリー横断中に検出されたシンボリック・リンクに従います。

制約事項: このオプションを使用できるのは、-R または -r オプションが指定される場合のみです。

–M

UNIX ファイルと MVS データ・セット・メンバーの間でコピーすると きに、ファイル名の特定の文字を変換するように指定します。文字は次のように変換されます。

• UNIX での _ (下線) は、MVS データ・セット・メンバーでは @ に変換されます。また 、その逆も同様です。
• . UNIX の . (ピリオド) は、 MVS データ・セット・メンバーでは # に変換されます。また、その逆も同様です。
• UNIX の – (ダッシュ) は、 MVS データ・セット・メンバーの $ に変換されます。 また、その逆も同様です。

–m (UNIX 間のみ)

各宛先ファイルの変更時刻およびアクセス時刻を、対応するソース・ファイルのものに設定します。 通常は、cp は宛先ファイルの変更時刻を現在の時刻に設定します。

–O u | c=codeset

ソースおよびターゲット・ファイルに関する自動変換を可能にします。

–O u

ターゲットが存在していて、空でもすでにタグ付きでもない場合、cp は ターゲットが自動変換の候補になるためにターゲットのタグを変更しません。

新規のターゲットと既存のタグ付けされていない空ファイルに対しては、このオプションは有効ではなく、cp はデフォルトと同様に機能します。 デフォルトの動作については、cp での自動変換とファイル・タグの動作を参照してください。

cp を使用して UNIX ファイルから MVS データ・セットにコピーする場合、ソースがタグ付きテキスト・ファイルであれば、そのファイルは自動変換の候補となります。

MVS からまたは MVS への実行可能ファイルのコピーの場合、ソースとターゲットの両方に対して自動変換が使用不可になります。

–O c=codeset

cp にこのオプションを指定したときの動作については、cp での自動変換とファイル・タグの動作を参照してください。

codeset は、システムに認識されているコード・セット名かコード化数字セット ID (CCSID) のいずれかです。コード・セット名が存在する場合、その名前に関連付けられている数値 CCSID が使用されます。コマンド iconv -l は、既存の CCSID とそれらに対応するコード・セット名をリストすることに留意してください。

cp はタグをテキストまたはコード・セットに設定できない場合、テキスト・ファイルの破壊を防止するために失敗します。

重要: 自動変換が 正しく設定されていないか、またはソースが正しくタグ付けされていない場合、ターゲットは そのファイルの内容に一致しないタグのコード・セットで終わる可能性があります。

-P

_UNIX03 が YES である場合、コマンド行でソース・オペランドとして指定されたシンボリック・リンクにも、ツリー横断中に検出されたシンボリック・リンクにも従いません。

制約事項: このオプションを使用できるのは、-R または -r オプションが指定される場合のみです。

–P params

_UNIX03 が設定されていないか、YES でない場合、-P オプションは、新規順次データ・セット (存在しない場合) を作成するために必要なパラメーターの指定として扱われます。RECFM、LRECL、BLKSIZE、および SPACE を、CRTL fopen() 関数が 使用する形式で指定することができます。

SPACE=(units,(primary,secondary) ここで、units には、次の値を使用できます。

• BLKSIZE を示す任意の正の整数
• CYL (大文字小文字混合)
• TRK (大文字小文字混合)

  例えば、次のとおりです。

  SPACE=(500,(100,500)) units, primary, secondary
  SPACE=(500,100) units and primary only

これらのパラメーターの指定方法については、 「z/OS XL C/C++ プログラミング・ガイド」を参照してください。

注: CRTL fopen() 引数: LRECL は、固定長 レコードの場合は長さを、可変長レコードの場合は最大長を、バイト単位で 指定します。BLKSIZE は、レコードの物理ブロックの最大長をバイト単位で指定します。 RECFM は、データ・セットのレコード・フォーマットを指し、SPACE は、MVS データ・ セットのスペース属性を示します。

–p (UNIX 間のみ)

変更およびアクセス時刻を保存します (–m オプションが行う のと同じです)。それに加えて、権限があれば、ファイル・モード、ファイル・フォーマット、所有者、およびグループ所有者を保存します。さらに、拡張属性も保存します。可能な場合は、ファイルとディレクトリーの ACL も保存します。ファイル・システムが ACL をサポートしない場合には、ACL は保存されません。

–p と –F は互いに排他的です。両方を指定すると、エラ ー・メッセージが表示されます。

–R (UNIX 間のみ)

ソース・ツリーの「クローン」を作成します。cp は、source… に よって指定されたすべてのファイルおよびサブディレクトリーを directory にコピーします。スペシャル・ファイル (FIFO、文字特殊) の複写には細心の配慮をします。cp は、コマンド行でソース・オペランドとして指定されたシンボリック・リンクのみに従います。

–r (UNIX 間のみ)

ソース・ツリーの「クローン」を作成しますが、スペシャル・ファイル (FIFO、文字特殊) については考慮しません。したがって、cp は スペシャル・ファイルをコピーするのではなく、デバイスから読み取ろうと試みます。これは、より望ましい –R に似ていますが、あまり有用ではありません。

–S d=suffix|a=suffix

• d=suffix

  指定された接尾部をファイルから除去します。

• a=suffix

  指定された接尾部をファイルに追加します。

–S は、–M および –C に優先します。 また、–A オプションをオフにします (–S が、指定された最後 のオプションである場合)。

–T

コピーするデータにテキスト・データが含まれていることを指定し ます。テキスト・データの取り扱いについては、使用上の注意を参照してください。このオプションは、IBM–1047 行の終わり区切り文字を探すもので、–F、–X、および –B と互いに排他的です。つまり、これらのオプションを複数指定すると、エラーになります。

注: –T は、UNIX ファイル・システム間でのコピーのときは無 視されます。

–U

MVS データ・セット・メンバーから UNIX ファイルへコピーするとき 、ファイル名を大文字のまま保持します。デフォルトでは、ファイル名は小文字にされます。

–v

詳細

-W seqparms=params

順次データ・セット (存在しない場合) を作成するために必要な パラメーターを指定します。RECFM、LRECL、BLKSIZE、および SPACE を、CRTL fopen() 関数が使用する形式で指定することができます。

SPACE=(units,(primary,secondary) ここで、units には、次の値を使用できます。

• BLKSIZE を示す任意の正の整数
• CYL (大文字小文字混合)
• TRK (大文字小文字混合)
  例えば、以下のとおりです。

  SPACE=(500,(100,500)) units, primary, secondary
  SPACE=(500,100) units and primary only

これらのパラメーターの指定方法については、 「z/OS XL C/C++ プログラミング・ガイド」を参照してください。

注: CRTL fopen() 引数: LRECL は、固定長 レコードの場合は長さを、可変長レコードの場合は最大長を、バイト単位で 指定します。BLKSIZE は、レコードの物理ブロックの最大長をバイト単位で指定します。 RECFM は、データ・セットのレコード・フォーマットを指し、SPACE は、MVS データ・ セットのスペース属性を示します。

このオプションは、_UNIX03 が設定されていないか、YES でない場合の -P params と同じです。複数の -P params および -W を指定すると、コマンドで最後に示される値が指定されます。

–X

コピーするデータが実行可能であることを指定します。–F、–T、 または –B オプションと一緒に使用することはできません。

-Z

ターゲット上での ACL 設定時に、エラー・メッセージを表示しないことを 指定します。戻りコードはゼロとなります。デフォルトの動作を使用してファイル・タグが設定された場合、失敗は抑止されます。デフォルトの動作については、cp での自動変換とファイル・タグの動作を参照してください。

–F|B|T または X のいずれも指定されないと、cp はまず、示された MVS データ・セットのフォーマットを検 査してから、ファイルのタイプを判別しようと試みます。

cp 上の –p オプションはファイル・タグに影響しません。

cp での自動変換とファイル・タグの動作

制約と要件

一般的には、以下のとおりです。

1. MVS データ・セット名を指定するには、名前の前にダブルスラッシュ (//) を付けます。例えば、完全修飾データ・セット名 'turbo.gammalib' および 'turbo.gammalib(pgm1)' を指定するには、次のように入力します。

   "//'turbo.gammalib'"
   "//'turbo.gammalib(pgm1)'"

   完全修飾でないデータ・セット名にも、同じ要件が適用されます。

   //turbo

2. PDS (区分データ・セット) または PDSE (拡張区分データ・セッ ト) の場合、シェルによって構文解析されないようにするためには、名前を引用符 で囲むか、または最小限、括弧をエスケープする必要があります。例えば、'turbo(pgm1)' を指定するには、次のように引用符で囲みます。

   "//turbo(pgm1)"  

   または、次のように括弧をエスケープすることができます。

   //turbo¥(pgm1¥)

   上記に示したように、完全修飾名は単一引用符で囲む必要があります (TSO 内で行われるのと同じです)。単一引用符がシェルによって解釈されないようにするためには、単一引用符 をエスケープするか、または名前を正規の引用符内に入れなければなりません。'turbo.gammalib' の例を参照してください。

3. UNIX ファイルをソースとして指定したときに、MVS データ・セット (タ ーゲット) が存在しないと、順次データ・セットが作成されます。区分データ・セットが存在する場合は、UNIX ファイルは区分データ・セット・メンバーにコピーされます。
4. ソースが MVS データ・セットで、ターゲットが UNIX ディレクトリーの 場合は、その UNIX ディレクトリーが存在していなければなりません。
5. ターゲットが区分データ・セットである場合は、ソースとして、UNIX デ ィレクトリー、区分データ・セット、または順次データ・セットを使用する ことはできません。
6. 区分データ・セットからすべてのメンバーをコピーするには、ソー スとしてその区分データ・セットを指定し、ターゲットとして UNIX ディレ クトリーを指定することができます。

表 5 は、cp でオプションを正しく使用するための早見表です。

次の表は、cp を使用して許可されるコピーの種類を示しています。

使用上の注意

ローカライズ

TZ 環境変数のフォーマットに、TZ 環境変数を使用してローカル・タイム・ゾーンを設定する方法が説明されています。

環境変数

終了値

0

正常終了

1

以下のいずれかによる失敗。

• 引数の末尾にスラッシュ (/) があるが、ディレクトリーではなかった
• ファイルが見つからない
• 入力ファイルを読み取るために開くことができない
• 出力ファイルを作成または開くことができない
• 入力ファイルで読み取りエラーが発生した
• 出力ファイルで書き込みエラーが発生した
• 入力ファイルと出力ファイルが同一である
• –r または –R を使用しているときに、 リカバリー不能エラーが発生した。以下のリカバリー不能な –r または –R エラーの可能性がある。
  • ファイルにアクセスできない
  • ターゲット・ファイルの許可を変更できない
  • ディレクトリーを読み取れない
  • ディレクトリーを作成できない
  • ターゲットがディレクトリーではない
  • ソースおよび宛先ディレクトリーが同一である

2

以下のいずれかによる失敗。

• コマンド行のオプションが正しくない
• コマンド行の引数が少なすぎる
• ターゲットはディレクトリーでなければならないが、そうでない
• ターゲット・デバイスにスペースがない
• コピーするデータを保持するためのメモリーが不足
• ターゲット・ファイルを保持するためのディレクトリーを作成できない

メッセージ

移植性

POSIX.2、X/Open 移植性ガイド、UNIX システム。

–f および –m オプションは、POSIX 標準の拡張です。

関連情報

cat、cpio、ln、mv、rm