データストアの URL

データベースでホストされているデータファイルおよびフォルダーを操作できるユーティリティやライブラリルーチンがいくつかあります。データストア内のこれらのファイルおよびフォルダーを参照するには、次に示すように、特定の URL を使用する必要があります。

sql://<server-name>/<datastore-name>/<file-name>[?<file-attributes>]     *> file url
sql://<server-name>/<datastore-name>?type=folder;[folder=/<folder-name>] *> folder url

詳細は次のとおりです。

server-name

データベース構成ファイル内のサーバーエントリの名前。サーバー名として「(local)」または「localhost」を指定すると、実行時に、そのサーバーを使用するプロセスを実行しているマシンの名前に置き換えられます。

datastore-name

データストアの名前。

file-name

データファイルの名前。

file-attributes

データファイルの属性 (そのタイプやデータストア内の場所など)。

属性	値	例	説明
type	blob folder lseq rrds seq	type=blob type=folder type=lseq type=rrds type=seq	ファイルタイプ。これは、ファイルヘッダーのないファイルをデータベースにディプロイする場合にのみ指定する必要があります。
reclen	<min[,max]>	type=lseq;reclen=0,80 type=seq;reclen=0,80 type=rrds;reclen=80 type=seq;reclen=80	可変長の順編成ファイルの最小レコード長および最大レコード長、あるいは固定長の順編成ファイルまたは RRDS ファイルのレコード長。これは、ファイルヘッダーのないファイルをデータベースにディプロイする場合にのみ指定する必要があります。
recterm	windows linux unix	recterm=windows recterm=linux recterm=unix	ファイルで使用されているレコード終了記号のタイプ。主に RRDS ファイルに使用され、現在ディプロイされているプラットフォームとは異なるプラットフォームで作成されたファイルにのみ必要です。
folder	<folder-name>	folder=/MyFolder folder=/MyFolder/SubFolder	フォルダー名。フォルダー名を明示的に指定しない場合は、ルートフォルダーが想定されます (つまり、folder=/)。

注: コマンドラインで dbfhdeploy.exe -urlhelp を実行して、構文ヘルプを表示することもできます。

MSSQL users: 大文字と小文字を区別する照合順序を使用してデータベースインスタンスが構成されている場合は、それに応じて dbfhdeploy コマンドでファイルおよびフォルダーを指定する必要があります。

URL での環境変数の使用

SQL URL 内で環境変数を使用できます。次の 2 つの形式のいずれかで指定できます。

$name - 変数名は、次の句読文字または文字列の末尾で終了します。
例：sql://$MYSERVER/$MYDATASTORE/myfile.dat
${name} - 変数名を中かっこで囲みます。
例：sql://${MYSERVER}/${MYDATASTORE}/myfile.dat

制約事項: JES カタログの場所やファイル割り当てフォルダーを定義する場合など、Enterprise Server 環境内で SQL URL を指定する場合、2 番目の形式はサポートされません。

例

次の例では、swt-bto ホストのデータベースインスタンスに格納されている JCLTEST データストアに保持されているファイル (my.dat) を参照します。
```
sql://swt-bto/JCLTEST/my.dat
```
次の例では、JCLDATASTORE 環境変数で指定されたデータストアの MyData フォルダーに保持されている別のファイル (another.dat) を参照します。
```
sql://swt-bto/$JCLDATASTORE/another.dat?folder=/MyData
```
次の例では、${MYSVR} 環境変数で指定されたマシン上のデータベースインスタンスにある SEQDATA データストアの MySeqData フォルダーに保持されている順編成ファイル (newseq.dat) を参照します。
```
sql://${MYSVR}/SEQDATA/newseq.dat?folder=/MySeqData;type=seq;reclen=0,80
```