Compaq OpenVMS
DCL ディクショナリ


前へ 次へ 目次 索引


/BEFORE[=時刻]

指定された時刻より前の日付のファイルだけを選択するように指定します。絶対時刻,または絶対時刻とデルタ時間の組み合わせを指定できます。また,BOOT, LOGIN, TODAY(省略時の設定),TOMORROW,YESTERDAY というキーワードのいずれか 1 つを指定することもできます。選択基準となる時刻属性を指定するために,/CREATED または /MODIFIED 修飾子を使用します。/CREATED 修飾子が省略時の設定です。

時刻の指定方法についての詳細は,『Compaq OpenVMS ユーザーズ・マニュアル』またはオンライン・ヘルプの DCL_Tips トピック (Date_Time サブトピック) を参照してください。

/BY_OWNER[=uic]

ファイルの所有者の利用者識別コード (UIC) が,指定された所有者と一致するファイルだけを選択することを指定します。省略時の UIC は,現在のプロセスの UIC です。

『OpenVMS Guide to System Security』に説明されている標準的な UIC 形式を使用して指定します。

/CACHING_ATTRIBUTE=キーワード

この修飾子は,拡張ファイル・キャッシュによってキャッシングされるファイルを制御するために使用します。この修飾子は,Files-11 ODS-2 または ODS-5 ボリュームの中のファイルまたはディレクトリのキャッシング属性を設定します。

ファイルのキャッシング属性は,アプリケーションが使用したいキャッシング・オプションを指定せずにファイルにアクセスしたときに,拡張ファイル・キャッシュが使用する省略時のキャッシング・オプションです。

キーワードは WRITETHROUGH または NO_CACHING です。キャッシングしたいファイルに対しては WRITETHROUGH を使用します。キャッシングしたくないファイルに対しては NO_CACHING を使用します。

拡張ファイル・キャッシュはディレクトリのキャッシングは行いません。ディレクトリのキャッシング属性は,そのディレクトリ内に作成された新しいファイルとサブディレクトリによってキャッシング属性がどのように継承されるかのみを制御します。

INITIALIZE コマンドを使って新しい Files-11 ボリュームを作成した場合,そのルート・ディレクトリ (000000.DIR;1) のキャッシング属性はライトスルーに設定されます。つまり,省略時の設定では,SET FILE /CACHING_ATTRIBUTE を使用しない限り,そのボリューム内に作成するすべてのファイルとディレクトリがライトスルーのキャッシング属性を継承します。

ボリューム内のどのファイルもキャッシングしたくない場合は,ボリューム内のすべてのファイルのキャッシング属性を NO_CACHING に設定するのではなく, MOUNT /NOCACHE を使って,キャッシングを無効にした状態でボリュームをマウントするようにします。MOUNT /NOCACHE の方が性能が高く,キャッシングのオーバヘッドが最小限に抑えられます。

ディレクトリのキャッシング属性を変更しても,そのディレクトリの中の既存のファイルとサブディレクトリのキャッシング属性に影響は及びません。

ファイルのキャッシング属性を変更しても,現在そのファイルにアクセスしているアプリケーションが使用するキャッシングのタイプに影響は及びません。

/CONFIRM

/NOCONFIRM (省略時の設定)

各ファイルの属性を変更する前に,そのファイルに対する操作の実行を確認するために,プロンプトを表示するかどうかを指定します。次の応答のいずれかを入力します。

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 はエラー・メッセージを出力し,同じプロンプトが再度表示されます。

/CREATED (省略時の設定)

/BEFORE または /SINCE 修飾子に指定した時刻値を変更します。 /CREATED 修飾子は,作成日をもとにファイルを選択します。この修飾子は,同様に時刻属性によりファイルを選択する, /MODIFIED 修飾子と同時に指定することはできません。 /CREATED 修飾子が省略時の設定です。

/DATA_CHECK[=([NO]READ,[NO]WRITE)]

転送中のファイルに対して,読み込み(READ)データ・チェック(2 度読み),書き込み(WRITE)データ・チェック(書込み後に再読込み),またはこれらの 2 つのチェックの組み合わせを実行するかどうかを指定します。省略時の設定では,ファイルに対して書き込みデータ・チェックが実行されます。

/END_OF_FILE

割り当てられた最も大きなブロック番号のブロックに, EOF 指示子を再設定します。

/ENTER=別名ファイル指定

十分に注意して使用してください。

指定したファイルの別名を作成します。もとの名前も別名も同じファイルを参照します。別名を削除する場合は,SET FILE/REMOVE コマンドを使用します。

注意

別名ともとのファイル名が,異なるディレクトリにあることを確認してください。同一ディレクトリにあると,削除またはパージ操作を行った時にデータを失う可能性があります。もとのファイル名と別名が同一ディレクトリにあると, DELETE コマンド,PURGE コマンドの結果,およびファイルのバージョン制限機能は予期しない結果になります。

別名を使用する場合は,十分注意して DELETE コマンド,および SET FILE/REMOVE コマンドを使用してください。正しく使用しないと,名前がなくアクセスできないファイルができてしまったり,ファイルを参照しない名前になってしまいます。このような問題を回避するために,次のガイドラインに従ってください。

  • SET FILE/REMOVE コマンドを使用して別名を削除する。別名を削除する時は,DELETE コマンドは使用しない。

  • もとのファイル名を削除する時は,SET FILE/REMOVE コマンドは使用しない。

これらのガイドラインに従わず問題が発生した場合は, ANALYZE/DISK/REPAIR コマンドを使用して,アクセスできないファイルを SYSLOST ディレクトリに移動させます。また,ファイルを参照しない名前は削除します。

/ERASE_ON_DELETE

DELETE コマンドや PURGE コマンドなどを,ファイルに対して実行するときに,指定したファイルをディスクから削除することを指定します (単に領域を解放するだけではなく,物理的にデータが消去されます)。詳細は,DELETE/ERASE コマンドの説明を参照してください。

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

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

/EXPIRATION_DATE=日付

/NOEXPIRATION_DATE

読み込み(R),書き込み(W)および制御アクセス権が必要です。ファイルの所有者であれば,制御アクセス権を持っています。

指定したファイルに満了日を割り当てるかどうかを制御します。

『Compaq OpenVMS ユーザーズ・マニュアル』またはオンライン・ヘルプの DCL_Tips トピック (Date_Time サブトピック) に説明されている規則に従って日付を指定します。絶対日付を示すキーワードを使用できます。日付として 0 を指定すると,今日の日付が使用されます。

/EXTENSION[=n]

ファイルの省略時の拡張サイズを設定します。指定できる値は,0 〜 65535の範囲です。値を指定しなかった場合や,0 という値を指定した場合には, OpenVMS レコード管理サービス (OpenVMS RMS) は独自の方法で /EXTENSION修飾子の値を計算します。

詳細は,SET RMS_DEFAULT コマンドの /EXTEND_QUANTITY 修飾子の説明を参照してください。

/GLOBAL_BUFFER=n

/NOGLOBAL_BUFFER

指定したファイルに対する,OpenVMS レコード管理サービス ( OpenVMS RMS ) のグローバル・バッファ数を指定します。これは,ファイルをアクセスするプロセス間で共用できるバッファの数を示します。指定できる n の値は, 0 〜 32767 の範囲内の整数であり,0 を指定すると,バッファは共用できなくなります。

/SHARE 修飾子を使用すると,現在アクセスされているファイルのグローバル・バッファを有効または無効にすることができます。ただし,グローバル・バッファの新しい設定は,そのファイルの新しいアクセサに対してのみ適用されます。そのファイルがすでにグローバル・バッファでオープンされている場合,グローバル・バッファの数を変更しても,そのファイルのすべてのアクセサがそのファイルをクローズするまで,新しい値は有効になりません。

/LOG

/NOLOG (省略時の設定)

各ファイルを変更したあとに,そのファイルのファイル指定を表示するかどうかを指定します。

/MODIFIED

/BEFORE または /SINCE 修飾子で指定した時刻値を変更します。/MODIFIED 修飾子は,最後に更新された日付をもとにファイルを選択します。この修飾子は,同様に時刻属性によりファイルを選択する,/CREATED 修飾子と同時に指定することはできません。/CREATED 修飾子が省略時の設定です。

/MOVE

/NOMOVE

ファイルの移動を許可するかどうか指定します。

ファイル作成時には,ファイルの移動は許可されています。XQP を介さずに ( 直接論理I/O等を使って ) アクセスするファイルに対しては移動を禁止にしてください。

重要なシステム・ファイルに対しては,最初からファイルの移動は禁止されています。これらのファイルには移動を許可しないでください。

/NODIRECTORY

十分に注意して使用してください。SYSPRV 特権が必要です。

ファイルのディレクトリ属性を削除します。この修飾子を使用すると,不正なディレクトリ・ファイルを削除することができます。この場合,削除するディレクトリ・ファイルに登録されていたファイルは,ロスト・ファイルとなります。

ロスト・ファイルを [SYSLOST] に登録するには,ANALYZE/DISK_STRUCTURE/REPAIR を使用します。このあと,ロスト・ファイルを新しいディレクトリにコピーできます。この修飾子は,Files-11 ODS-2 (Files-11 On-Disk Structure Level 2) のファイルに対してだけ有効です。ANALYZE/DISK_STRUCTURE ユーティリティについての詳細は,『Compaq OpenVMS システム管理ユーティリティ・リファレンス・マニュアル』を参照してください。

/OWNER_UIC[=uic]

この修飾子は,SET SECURITY/OWNER コマンドに置き換えられました。

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

この修飾子は,SET SECURITY/PROTECTION コマンドに置き換えられました。

/REMOVE

注意して使用してください。

複数の名前を持つファイルに関して,ファイルは削除せずに,1 つの名前だけを削除するように指定します。SET FILE コマンドで /ENTER 修飾子を使用してファイルに別名をつけた場合には,/REMOVE 修飾子を使用すると,もとの名前または別名を削除できます。名前を削除しても,ファイルはそのまま残ります。このファイルは,まだ削除されていない方の名前によってアクセスできます。

しかし,名前を 1 つだけしか持たないファイルの名前を誤って削除すると,ほとんどの DCL コマンドでは,そのファイルをアクセスできなくなります。このようなファイルを検索するには, ANALYZE/DISK_STRUCTURE ユーティリティを使用します。

/SEMANTICS=セマンティクス・タグ

/NOSEMANTICS

ファイルにタグを作成します。また,タグを変更することもできます。ファイルからセマンティクス・タグを削除する場合は, /NOSEMANTICS 修飾子を指定します。詳細は,『Guide to OpenVMS File Applications』を参照してください。

/SEMANTICS=semantics-tag

/NOSEMANTICS

/SEMANTICS 修飾子は,セマンティクス・タグの作成または変更に使用します。 /NOSEMANTICS 修飾子は,ファイルからセマンティクス・タグを削除するために使用します。詳細は,『Guide to OpenVMS File Applications』を参照してください。

/SHARE

現在他のユーザによってアクセスされているファイルのグローバル・バッファまたは統計情報を有効または無効にします。

SYSPRV 特権が必要です。

新しい設定を使用するのは,ファイルの新しいアクセサだけです。たとえば,ファイルがグローバル・バッファを指定せずにオープンされているときに, SET FILE/GLOBAL=n/SHARE コマンドが発行された場合,そのファイルの新しいアクセサのみがグローバル・バッファを使用します。アクティブ・ファイル上で /STATISTICS が有効になっている場合には,そのファイルの新しいアクセサによって実行される操作だけが測定されます。

そのファイルがすでにグローバル・バッファでオープンされている場合,グローバル・バッファの数を変更しても,そのファイルのすべてのアクセサがそのファイルをクローズするまで,新しい値は有効になりません。

/SHARE 修飾子は以下の修飾子のみで有効です。

/SHELVABLE

/NOSHELVABLE

ファイルがシェルビングされるかどうかを指定します。

/SINCE[=時刻]

指定された時刻,またはそれ以降の時刻の日付のファイルだけを選択するように指定します。絶対時刻,または絶対時刻とデルタ時間の組み合わせを指定できます。また BOOT, LOGIN, TODAY(省略時の設定),TOMORROW,YESTERDAY というキーワードのいずれか 1 つを指定することもできます。選択基準となる時刻属性を指定するために, /CREATED または /MODIFIED 修飾子を使用します。 /CREATED 修飾子が省略時の設定です。

時刻の指定方法についての詳細は,『Compaq OpenVMS ユーザーズ・マニュアル』またはオンライン・ヘルプの DCL_Tips トピック (Date_Time サブトピック) を参照してください。

/STATISTICS

/NOSTATISTICS (省略時の設定)

指定ファイルに関する RMS の統計情報を収集できるようにします。これらの統計情報は後で,Monitor ユーティリティ ( DCL コマンド MONITOR で起動する ) を使用して見ることができます。SET FILE/STATISTICS コマンドは,指定したファイルに対してアプリケーション ACE を適用します。この ACEは,アクセス制御には影響せず,そのファイルに割り当てられたアプリケーションにのみ意味を持ちます。

/SHARE 修飾子は,現在アクセスされているファイルの統計情報を有効または無効にするために使用することができます。ただし,測定されるのは,そのファイルの新しいアクセサの統計情報に限られます。

/STYLE=キーワード

表示するファイル名の書式を指定します。

この修飾子のキーワードは CONDENSED および EXPANDED です。意味は次の表のとおりです。

キーワード 説明
CONDENSED
(省略時の設定)
ファイル名を 255 文字長の文字列に適合するように表示します。このファイル名の場合,ファイル指定に DID あるいは FID 短縮形を含むことが可能です。
EXPANDED ファイル名をディスクに格納されているとおりに表示します。このファイル名の場合,ファイル指定に DID あるいは FID 短縮形は含みません。

キーワード CONDENSED と EXPANDED を同時に指定することはできません。この修飾子は,確認が要求された場合に,出力メッセージに表示されるファイル名の書式を指定します。

EXPANDED キーワードが指定されていない場合,ファイル・エラーは CONDENSED ファイル指定で表示されます。

詳細は『 Compaq OpenVMS Extended File Specifications の手引き』を参照してください。

/TRUNCATE

EOF 指示子を含むブロックの最後で,ファイルが切り捨てられるように指定します。つまり,割り当てられてはいるが,使用されていないブロックを解放します。

/UNLOCK

非アクセス・ロックとしてマークされているファイルをクリアします。非アクセス・ロックは,独自のロックと一貫性を保持している少数のアプリケーションが必要とし,使用するものです。この種のアプリケーションは,一般に OpenVMS 分散ロック・マネージャを使用せず,また RMS も使用しないことがあります。非アクセス・ロックを使用するアプリケーションが (アプリケーションまたはシステムの障害のために) ファイルの非アクセスを正しく行わなかった場合,そのファイルはロック済みとしてマークされ,ファイルの内容の整合性が検証されて, SET FILE/UNLOCK コマンドが使用されるまではアクセスできなくなります。

このコマンドは,RMS または分散ロック・マネージャを使ってロックされているファイルの状態には影響を及ぼしません。

ファイルの非アクセス・ロックの詳細については,『OpenVMS I/O User's Reference Manual』と ACP-QIO インタフェースのマニュアル,特に IO$_CREATE および IO$_ACCESS 関数の FIB$V_DLOCK オプションの項を参照してください。

SET FILE/UNLOCK コマンドは,次のエラー・メッセージの原因をクリアすることができます。


%SYSTEM-W-FILELOCKED, file is deaccess locked 

ただし,このコマンドは次のエラー・メッセージの原因を解決することはできません。


%RMS-W-FLK, file currently locked by another user 

/VERSION_LIMIT[=n]

指定ファイルの最大バージョン数を指定します。バージョン・リミットを指定しなかった場合には 0 が使用され,ファイルのバージョンの数は, Files-11 の構造上の上限である 32767 に制限されます。新しいファイル・バージョンを作成したためにバージョン・リミットを超える場合には,ユーザへ通知せずに,そのもっとも古いバージョンのファイルがディレクトリから削除されます。たとえば,あるディレクトリ内に 5 バージョンのファイルを持っているときに,バージョン・リミットとして 3 を設定した場合でも,そのファイルが削除またはパージされるまでは,5 つのバージョンは残りますが, 1 度バージョン・リミット以下になるとその制限が適用されます。

#1

$ SET FILE/EXPIRATION_DATE=19-DEC-2001:11:00 BATCH.COM;3

この例では,BATCH.COM;3 というファイルの満了日を, 2001 年 12 月 19 日の午前 11:00 に設定するように指示しています。

#2

$ SET FILE/BEFORE=31-DEC/ERASE_ON_DELETE PERSONNEL*.SAL
 

この例では,PERSONNEL*.SAL というファイル指定に一致するファイルの中で, 12 月 31 日以前のすべてのファイルを対象としています。この場合,DELETE コマンドや PURGE コマンドなどによってそのファイルの 1 つが削除されたときには,そのファイルが使用していたディスク領域の内容も,消去されることを指示しています。

#3

$ SET FILE/OWNER_UIC=[360,020]/VERSION_LIMIT=100 MYFILE.DAT
 

この例では,MYFILE.DAT というファイルの属性を変更します。ここでは,所有者の利用者識別コード (UIC) を変更し,ファイル・バージョン・リミットを 100 に設定しています。所有者の UIC を変更するには,システム特権 (SYSPRV) が必要です。

#4

$ SET FILE/NOMOVE TEST.FDL
$DIRECTORY/FULL TEST.FDL
Directory SYS$SYSDEVICE:[BERGMANN]
TEST.FDL;1   File ID:  (10,8,0) 
   .
   .
   .
File attributes: Allocation: s, Extend: 0, Global buffer count: 0
   No version limit, MoveFile disabled
   .
   .
   .
 

ファイル TEST.FDL に対するファイル移動を禁止しています。ファイル TEST.FDL に対する DIRECTORY/FULL コマンドが,ファイル移動属性が禁止されていることを示しています。

#5

$  SET FILE/ATTRIBUTES=ORG:SEQ -
_$ TEST$:[DATA]SET_ATTRIBUTES.DATA_FILE/LOG
%SET-I-MODIFIED, TEST$:[DATA]SET_ATTRIBUTES.DATA_FILE;1 MODIFIED
 

SET FILE/ATTRIBUTES コマンドは,指定ファイルのファイル構造を変更しています。

#6

$  SET FILE/PROTECTION=(S:RWE,O=RWE,G:RE,W:RE) TEMP.DIR
$ DIRECTORY/PROTECTION TEMP.DIR
Directory DKB0:[FULGHUM]
TEMP.DIR;1           (RWE,RWE,RE,RE)
 

この例では,SET FILE コマンドで TEMP.DIR の保護コードを設定し,次にDIRECTORY コマンドを使用して,ファイルの保護コードを表示しています。

#7

$  SET FILE/SHARE/GLOBAL_BUFFER=5000/STATISTICS INVENTORY.IDX

この例は,INVENTORY.IDX ファイルに 5000 のグローバル・バッファを設定し,統計情報を有効にします。ファイルがオープンされているときに, SET FILE コマンドが /SHARE 修飾子なしで発行された場合は,次のエラーが返されます: SYSTEM-W-ACCONFLICT (file access conflict)。 /SHARE 修飾子を使用すると,オープンされているファイル上でグローバル・バッファと統計情報を有効にすることができます。ただし,これらの設定はそのファイルの新しいアクセサだけに適用されます。


前へ 次へ 目次 索引