日本-日本語

製品  >  ソフトウェア  >  OpenVMS  >  マニュアル

OpenVMS マニュアル


HP OpenVMS
DCL ディクショナリ


目次 索引



指定された出力ファイルに, 1 つまたは複数の指定された入力ファイルの内容を追加します。

形式

APPEND 入力ファイル[,...] 出力ファイル


パラメータ



入力ファイル[,...]

追加する1つ,または複数の入力ファイルの名前を指定します。入力ファイルは,すべて指定された順に,出力ファイルの最後に追加されます。複数の入力ファイルを指定する場合には,コンマ (,) またはプラス記号 (+) で区切ります(コンマとプラス記号は,同じ意味に解釈されます)。

入力ファイルには,ワイルドカード文字 (* と %) を使用することができます。

出力ファイル

入力ファイルが追加されるファイルの名前を指定します。

少なくとも1つの出力ファイルを指定しなければなりません。デバイスやディレクトリを指定しなかった場合には,APPEND コマンドは,現在の省略時のデバイスおよびディレクトリを使用します。省略したファイル指定要素に対しては,APPEND コマンドは,入力ファイルの対応する要素を使用します。

出力ファイルの指定時にアスタリスク・ワイルドカード文字 (*) を使用すると, APPEND コマンドは,指定した入力ファイルの対応する要素を使用します。複数の入力ファイルを追加している場合には,最初の入力ファイルの対応する要素を使用します。


説明

APPEND コマンドの構文と機能は,COPY コマンドの構文と機能に似ています。通常,APPEND コマンドは, 1つまたは複数のファイルの内容を既存のファイルの最後に追加します。この時,バージョン番号は増えません。 /NEW_VERSION 修飾子を指定すると,その名前を持つファイルが存在しない場合は,新しい出力ファイルが作成されます。

DECwindows 複合ドキュメントに APPEND コマンドを使用する場合には,特に注意してください。詳細は『Guide to OpenVMS File Applications』を参照してください。


修飾子



/ALLOCATION=ブロック数

出力ファイルの初期占有サイズを,1ブロック 512 バイトのブロック数で設定します。 /ALLOCATION 修飾子が指定されていない場合や, /ALLOCATION修飾子にブロック数を指定しない場合には,出力ファイルの初期占有サイズは,入力ファイルのサイズによって決定されます。

占有サイズは,/NEW_VERSION 修飾子が指定され,新しいファイルが実際に作成される場合にだけ適用されます。

/BACKUP

/BEFORE または /SINCE 修飾子を適用する時刻属性を指定します。この修飾子を指定すると,最新のバックアップの日時をもとにファイルを選択します。この修飾子は他の時刻属性を指定する修飾子,/CREATED,/EXPIRED,および /MODIFIED 修飾子とは同時に指定できません。これら 4 つの修飾子のいずれも指定しない場合には,省略時の設定として /CREATED 修飾子が使用されます。

/BEFORE[=時刻]

指定された時刻以前の時刻属性を持つファイルを選択します。絶対時刻,または絶対時刻とデルタ時間の組み合わせを指定します。また,BOOT,LOGIN,TODAY (省略時の設定),TOMORROW,および YESTERDAY というキーワードも指定できます。適用する時刻属性は,/BACKUP,/CREATED (省略時の設定),/EXPIRED,または /MODIFIED 修飾子のいずれかで指定します。

時刻指定の詳細は,『OpenVMS ユーザーズ・マニュアル』,またはオンライン・ヘルプのトピック Date を参照してください。

/BLOCK_SIZE=n

COPY が使用する省略時のブロック・サイズ (124) を指定変更します。 1 〜 127 の範囲の値を指定することができます。

/BY_OWNER[=利用者識別コード]

ファイル所有者の利用者識別コード (UIC) が,指定された所有者 UIC と一致する場合にだけ,そのファイルを選択します。 /BY_OWNER 修飾子だけを指定し,UIC を省略した場合には,現在のプロセスの UIC が使用されます。

UIC を指定する場合には,『OpenVMS ユーザーズ・マニュアル』に説明されている標準的な UIC 形式を使用します。

/CONFIRM

/NOCONFIRM (省略時の設定)

ファイルに対する各 APPEND 操作の実行を確認するために,操作の前に確認を要求します。システムがプロンプトを表示したら,次のいずれかの応答を入力します。

YES NO QUIT
TRUE FALSE [Ctrl/Z]
1 0 ALL
  [Return]  

応答には,大文字と小文字を任意に組み合わせて使用することができます。単語による応答は,1 文字以上 ( たとえば,TRUE の場合は T,TR,またはTRU) に短縮することができます。肯定応答は,YES,TRUE,1 です。否定応答は,NO,FALSE,0,Return です。QUIT と Ctrl/Z は,その時点でコマンドの処理を停止する時に使用します。ALL を応答すると,コマンドは処理を継続しますが,プロンプトは表示されなくなります。上記に示されていない応答を入力すると,DCL はエラー・メッセージを出力し,同じプロンプトがもう一度表示されます。

/CONTIGUOUS

/NOCONTIGUOUS

出力ファイルが物理的に連続したディスク・ブロックを使用するかどうかを指定します。何も指定されていない場合には,APPEND コマンドは,対応する入力ファイルと同じ属性で出力ファイルを作成し,十分な連続領域が無くてもエラー・メッセージは表示しません。この修飾子は,/NEW_VERSION 修飾子とともに使用します。

入力ファイルが連続している場合には,連続した領域に出力ファイルを作成しようとしますが,連続した出力ファイルを作成するための十分な領域がない場合でもエラーは報告しません。属性の異なる複数の入力ファイルを追加する場合には,出力ファイルは,連続したファイルになることも非連続のファイルになることもあります。確実に連続した領域に出力ファイルを作成したい場合は, /CONTIGUOUS 修飾子を使用する必要があります。

/CREATED (省略時の設定)

/BEFORE または /SINCE 修飾子を適用する時刻属性を指定します。この修飾子を指定すると,作成日時をもとにファイルを選択します。この修飾子は他の時刻属性を指定する修飾子,/BACKUP,/EXPIRED,および /MODIFIED 修飾子とは同時に指定できません。これら 4 つの修飾子のいずれも指定しない場合には,省略時の設定として /CREATED 修飾子が使用されます。

/EXCLUDE=(ファイル指定[,...])

指定されているファイル(1つまたは複数)と一致するファイルを, APPEND操作から除外することを指定します。ファイル指定にはディレクトリを含むことはできますが,デバイスを含むことはできません。ファイル指定の中で,ワイルドカード文字 (* と %) を使用することができますが,相対バージョン番号を指定して特定のバージョンを除外することはできません。 1つのファイルだけを指定する場合には,括弧を省略できます。

/EXPIRED

/BEFORE または /SINCE 修飾子を適用する時刻属性を指定します。この修飾子を指定すると,満了日時をもとにファイルを選択します ( 満了日は,SET FILE/EXPIRATION_DATE コマンドで設定します )。この修飾子は他の時刻属性を指定する修飾子,/BACKUP,/CREATED,および /MODIFIED 修飾子とは同時に指定できません。これら 4 つの修飾子のいずれも指定しない場合には,省略時の設定として /CREATED 修飾子が使用されます。

/EXTENSION=ブロック数

ファイルを拡張するたびに,出力ファイルに追加されるブロック数を指定します。 /EXTENSION 修飾子を指定すると,/NEW_VERSION 修飾子も指定されていると解釈されるため,/NEW_VERSION 修飾子を指定する必要はありません。この修飾子は,/NEW_VERSION 修飾子と同時に指定します。

拡張サイズは,新しいファイルが実際に作成される場合にだけ使用されます。

/LOG

/NOLOG (省略時の設定)

APPEND コマンドが,追加される各ファイルのファイル指定を表示するかどうかを制御します。 /LOG 修飾子を使用した場合には,APPEND コマンドは,各追加操作を実行した後で,追加されたブロック数またはレコード数と,入力ファイルと出力ファイルのファイル名を表示します。

/MODIFIED

/BEFORE または /SINCE 修飾子を適用する時刻属性を指定します。この修飾子を指定すると,最新の変更日時をもとにファイルを選択します。この修飾子は他の時刻属性を指定する修飾子,/BACKUP,/CREATED,および /EXPIRED 修飾子とは同時に指定できません。これら 4 つの修飾子のいずれも指定しない場合には,省略時の設定として /CREATED 修飾子が使用されます。

/NEW_VERSION

/NONEW_VERSION (省略時の設定)

指定した出力ファイルが存在しない場合に,APPEND コマンドが,新しい出力ファイルを作成するかどうかを制御します。省略時の設定では,指定した出力ファイルは既存のファイルでなければなりません。指定した出力ファイルが存在しない場合には,新しい出力ファイルを作成するために /NEW_VERSION 修飾子を使用します。出力ファイルが存在する場合には,/NEW_VERSION 修飾子は無視され,入力ファイルはその出力ファイルに追加されます。

/PROTECTION=(所有区分[:アクセス][,...])

出力ファイルに対して適用される保護を定義します。

  • 所有区分は,システム (S),所有者 (O),グループ (G) またはワールド(W) から指定します。

  • アクセス・コードは,読み込み (R),書込み (W),実行 (E) または削除 (D) から指定します。

出力ファイルが存在する場合には,省略時の保護属性 ( 指定されていない保護属性を含む ) は,そのファイルの現在の保護設定から適用され,新しい出力ファイルが作成される場合には,現在の省略時の保護設定が使用されます。この修飾子は,/NEW_VERSION 修飾子と同時に指定します。

保護コード指定についての詳細は,『OpenVMS システム・セキュリティ・ガイド』を参照してください。

/READ_CHECK

/NOREAD_CHECK (省略時の設定)

すべてのレコードが正しく読み込まれたかどうか確認するために,入力ファイルの各レコードを 2 回ずつ読み込むことを, APPEND コマンドに指定します。

/SINCE[=時刻]

指定された時刻以降の時刻属性を持つファイルを選択します。絶対時刻,または絶対時刻とデルタ時間の組み合わせを指定します。また,BOOT,JOB_LOGIN,LOGIN,TODAY (省略時の設定),TOMORROW,および YESTERDAY というキーワードも指定できます。適用する時刻属性は,/BACKUP,/CREATED (省略時の設定),/EXPIRED,または /MODIFIED 修飾子のいずれかで指定します。

時刻指定の詳細は,『OpenVMS ユーザーズ・マニュアル』,またはオンライン・ヘルプのトピック Date を参照してください。

/WRITE_CHECK

/NOWRITE_CHECK (省略時の設定)

各レコードが正しく追加され,出力ファイルからそのレコードが正しく読み込めることを確認するために,レコードが書き出された後,そのレコードを読み込むことを APPEND コマンドに指定します。

#1
$ APPEND  TEST3.DAT TESTALL.DAT

この APPEND コマンドは,省略時のディスクおよびディレクトリにあるTEST3.DAT というファイルの内容を,同様に省略時のディスクおよびディレクトリにある TESTALL.DAT というファイルに追加します。

#2
$ APPEND/NEW_VERSION/LOG *.TXT   MEM.SUM
%APPEND-I-CREATED, USE$:[MAL]MEM.SUM;1 created
%APPEND-S-COPIED, USE$:[MAL]A.TXT;2 copied to USE$:[MAL]MEM.SUM;1 (1 block)
%APPEND-S-APPENDED, USE$:[MAL]B.TXT;3 appended to USE$:[MAL]MEM.SUM;1 (3 records)
%APPEND-S-APPENDED, USE$:[MAL]G.TXT;7 appended to USE$:[MAL]MEM.SUM;1 (51 records)

APPEND コマンドは,.TXT ファイル・タイプのすべてのファイルを, MEM.SUM という名前のファイルに追加します。 /LOG 修飾子は,追加された各入力ファイルの指定の表示を要求します。 MEM.SUM ファイルが存在しない場合は,APPEND コマンドは出力されるとおりに作成します。出力に示されるブロックまたはレコード数は,ターゲット・ファイルの合計ではなく,ソース・ファイルを参照します。

#3
$ APPEND/LOG A.DAT, B.MEM   C.*
%APPEND-S-APPENDED, USE$:[MAL]A.DAT;4 appended to USE$:[MAL]C.DAT;4 (2 records)
%APPEND-S-APPENDED, USE$:[MAL]B.MEM;5 appended to USE$:[MAL]C.DAT;4 (29 records)

APPEND コマンドは,ファイル A.DAT および B.MEM を,すでに存在している C.DAT ファイルに追加します。

#4
$ APPEND/LOG A.*   B.*
%APPEND-S-APPENDED, USE$:[MAL]A.DAT;5 appended to USE$:[MAL]B.DAT;1 (5 records)
%APPEND-S-APPENDED, USE$:[MAL]A.DOC;2 appended to USE$:[MAL]B.DAT;1 (1 record)

入力ファイル指定と出力ファイル指定は,ともにファイル・タイプ・フィールドにワイルドカードが使用されています。 APPEND コマンドは,ファイル名 A の各ファイルを,ファイル名として既存のファイルに追加します。最初の入力ファイルのファイル・タイプによって,出力ファイル・タイプが決まります。

#5
$ APPEND BOSTON"BILL_BESTON YANKEE"::DEMO1.DAT, DEMO2.DAT
$ _To:   DALLAS::DISK1:[MODEL.TEST]TEST.DAT

この APPEND コマンドは,リモート・ノード BOSTON 上のファイル DEMO1.DAT と DEMO2.DAT を,リモート・ノード DALLAS 上のファイル TEST.DAT に追加します。


目次 索引

プライバシー ご利用条件・免責事項