Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

7.59.1 FETCH のパラメータ

FETCH_P#FIELDSFIELDS

FETCHFROM_P#FROM_FILE

FETCHIO_P#IO_ERROR

FETCHIO_P#IO_STATUS

FETCH_P#ISSUEISSUE_MSG

FETCH_P#KEEPKEEP_LASTFETCH_P#LOCK

LOCK

FETCHNOT_P#NOT_FOUND

FETCHRETURN_P#RETURN_RRN

FETCH_P#VALVAL_ERRORFETCH_P#WHERE

WHERE

FETCHWITH_P#WITH_KEY

FETCHWITH_P#WITH_RRN

FETCH_P#RETRET_UPDID


Anchor
FIELDS
FIELDS
FIELDS

ファイルから取得するフィールド、または取得するフィールドを指定するグループの名前を指定します。または、このパラメータに拡張可能なグループ式を入力することもできます。詳細については、「拡張可能グループ」を参照してください。

以下の特別な値を指定できます。

  • *ALLを指定した場合、現在アクティブなファイルのすべてのフィールドが取得されます。
  • *ALL_REALを指定した場合、現在アクティブなファイルのすべての実フィールドが取得されます。
  • *ALL_VIRTを指定した場合、現在アクティブなファイルのすべての仮想フィールドが取得されます。
  • *EXCLUDINGを指定した場合、この特別な値に続けて指定するフィールドがフィールド・リストから除外されます。
  • *INCLUDINGを指定した場合、この特別な値に続けて指定するフィールドがフィールド・リストに含められます。この特殊な値は、*EXCLUDINGエントリーによって、フィールド・リストが除外モードに移行した後にのみ必要です。
Note
title注意

注意:OTHERによって保守されている論理ファイルからすべてのフィールドを取得すると、基になっている物理ファイルのすべてのフィールドがフィールド・リストに含められます。

...

BLOBまたはCLOBデータを取得すると、*SQLNULLまたはファイル名になることに注意してください。ファイル名の場合、データベース・ファイルのデータがそのファイルにコピーされています。

Warning
title警告

警告:ファイルからBLOBまたはCLOBフィールドを取得する操作には時間がかかります。

...

Anchor
FROM_FILE
FROM_FILE
FROM_FILE

I/Oコマンドでのファイル名の指定」を参照してください。

Anchor
WHERE
WHERE
WHERE

条件および式の指定」および「I/OコマンドでのWHEREパラメータの指定」を参照してください。

FETCHでWHERE条件を使用し、その条件によってレコードが見つからなかった場合、フィールドの内容は予測できません。

Anchor
WITH_KEY
WITH_KEY
WITH_KEY

I/Oコマンドでのファイル・キー・リストの指定」を参照してください。

Anchor
IO_STATUS
IO_STATUS
IO_STATUS

...

戻りコードを受け取るフィールドとしてユーザー・フィールドを指定する場合、このフィールドは、長さ2文字の英数字フィールドである必要があります。ユーザー・フィールドを指定した場合も、特別なフィールド#IO$STSは更新されます。

I/O操作の戻りコード値の詳細については、「RDML I/O戻りコード」を参照してください。

Anchor
IO_ERROR
IO_ERROR
IO_ERROR

...

*YESを指定した場合は、レコードがロックされます。ロックしたレコードは、後でユーザーの責任により解放してください。

Note
title注意

注意:LOCK(*YES)は、レコード・レベルのロックを実行します。これにより、オペレーティング・システム内およびオペレーティング・システム間の動作(コミット制御による複数レコードのロック、デフォルトの待機時間など)が変化する可能性があります。そのため、LOCK_OBJECT組み込み関数を使用して、適切かつ完全な「ユーザー・オブジェクト」のロック・プロトコルを開発することをお勧めします。

移植性に関する考慮事項

可搬性のあるアプリケーションではサポートされないため、使用しないでください。Visual LANSAで使用すると、ビルド警告が生成されます。

...

このパラメータで指定するフィールドは数値タイプで、このファンクションまたはLANSAデータ・ディクショナリで定義されていなければなりません。

Note
title注意

注意:FETCH、DELETEまたはUPDATEコマンドに対してWITH_RRNパラメータを使用すると、他の形式のデータベース・アクセスよりもレコードの取得、削除または更新を高速に行うことができます。

...

詳細については、『Visual LANSA 開発者ガイド』の「インポート・テーブル定義」も参照してください。

Anchor
RETURN_RRN
RETURN_RRN
RETURN_RRN

...

詳細については、『Visual LANSA 開発者ガイド』の「インポート・テーブル定義」を参照してください。

Anchor
KEEP_LAST
KEEP_LAST
KEEP_LAST

...