DLVALUE

DLVALUE 関数は、データ・リンク値を戻します。この関数を UPDATE ステートメントの SET 文節の右側または INSERT ステートメントの VALUES 文節で使用した場合は、通常はファイルに対するリンクも作成されます。ただし、コメントだけを指定すると (この場合は、データ・ロケーション は長さゼロのストリング)、データ・リンク値は空のリンク属性を使用して作成され、したがってファイル・リンクにはなりません。


>>-DLVALUE--(--data-location--+-------------------------------------------+--)-><
                              '-,--linktype-string--+-------------------+-'      
                                                    '-,--comment-string-'

data-location: リンク・タイプが URL の場合は、これは完全な URL 値を含む文字ストリング式です。式が空ストリングではない場合は、この中に URL スキームと URL サーバーを入れる必要があります。文字ストリング式の実際の長さは、32718 文字以下でなければなりません。
linktype-string: データ・リンク値のリンク・タイプを指定するオプションの文字ストリング式。有効な値は「URL」だけです。
comment-string: コメント、または追加のロケーション情報を提供するオプションの文字ストリング式。この文字ストリング式の実際の長さは、254 文字以下でなければなりません。
コメント・ストリング は、NULL 値であってはなりません。 コメント・ストリング が指定されない場合は、コメント・ストリング は空ストリングになります。

最初の引数がヌルである可能性がある場合は、結果もヌルになる可能性があります。最初の引数がヌルの場合は、結果は NULL 値になります。

この関数の結果は、データ・リンク値になります。

データ・リンクの CCSID は、次の場合を除き、データ・ロケーション のものと同じになります。

コメント・ストリング が混合データで、データ・ロケーション が混合データでない場合、結果の CCSID は コメント・ストリング の CCSID になります。 ¹

データ・ロケーション が CCSID としてビット・データ (65535)、 UTF-16 グラフィック・データ (1200)、UCS-2 グラフィック・データ (13488)、トルコ語データ (905 または 1026)、あるいは日本語データ (290、930、または 5026) を持っている場合は、結果の CCSID は次の表のようになります。

データ・ロケーションの CCSID	コメント・ストリングの CCSID	結果の CCSID
65535	65535	ジョブ・デフォルト CCSID
65535	65535 以外	コメント・ストリング CCSID (CCSID が 290、930、 5026、905、1026 または 13488 の場合を除く。これらの場合は、CCSID は以下に示すように修正される。)
290	任意	4396
930 または 5026	任意	939
905 または 1026	任意	500
1200	任意	500
13488	任意	500

この関数を使用してデータ・リンク値を定義するときは、値のターゲットの最大長を考慮してください。例えば、DataLink(200) と定義されている列では、データ・ロケーション の最大長にコメントを加えたものが 200 バイトになります。

例

表に 1 行を挿入するとします。最初の 2 つのリンクの URL 値は、url_article と url_snapshot という名前の変数に入っています。また、url_snapshot_comment という名前の変数には、スナップショット・リンクに付随するコメントが入っています。ただし、movie のためのリンクはまだありません。url_movie_comment という名前の変数にコメントが入っているだけです。
```
  INSERT INTO HOCKEY_GOALS
    VALUES('Maurice Richard',
           'Montreal canadian',
           '?',
           'Boston Bruins,
           '1952-04-24',
           'Winning goal in game 7 of Stanley Cup final',
           DLVALUE(:url_article),
           DLVALUE(:url_snapshot, 'URL', :url_snapshot_comment),
           DLVALUE('', 'URL', :url_movie_comment) )
```

¹ コメント・ストリング の CCSID が 5026 または 930 の場合、結果の CCSID は 939 になります。