新しいファイルを作成し、バイトストリーム操作用に開いたままにします。
構文:
call "CBL_CREATE_FILE" using filename
access-mode
deny-mode
device
file-handle
パラメーター:
|
呼び出しプロトタイプ使用時 (「説明の読み方」を参照)
|
PIC |
filename |
pic x(n)
|
pic x(n)
|
access-mode |
cblt-x1-compx |
pic x comp-x |
deny-mode |
cblt-x1-compx |
pic x comp-x |
device |
cblt-x1-compx |
pic x comp-x |
file-handle |
cblt-bytestream-handle |
pic x(4) comp-5 |
入力パラメーター:
- filename
- 作成するファイルの空白文字または null で終了する名前, or a specific MFDBFH datastore URL(see
The Datastore URL for specific SQL URL syntax)。filename には組み込み環境変数およびライブラリ名を使用できます。
- access-mode
- アクセス モードを定義します。
1 |
読み取り専用 |
2 |
書き込みのみ (deny-mode は 0 にする必要があります)
|
3 |
読み取りおよび書き込み |
64 |
4 GB を超えるファイルを使用できます。この値を必要なアクセスの値と組み合わせます。たとえば、4 GB を超えるファイルに対する読み取りおよび書き込みアクセスの場合は、67 を設定します。 |
- deny-mode
- 拒否モードを定義します。
0 |
読み取りと書き込みの両方を拒否する (排他) |
1 |
書き込みを拒否する |
2 |
読み取りを拒否する |
3 |
読み取りも書き込みも拒否しない |
- device
- 予備 (値は常に 0)。
出力パラメーター:
- file-handle
- ファイルが正常に開かれた場合にファイル ハンドルを返します。
説明:
呼び出しが成功したかどうかは、RETURN-CODE 特殊レジスタを確認してチェックできます。
filename には組み込み環境変数およびライブラリ名を使用できます。
不明なリモート ファイル システムに対する 64 ビット ファイル アクセスを要求する場合は、remote_64bit_access チューナーを設定してください。