Versions Compared

Key

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

7.125.1 UPDATE のパラメータ

UPDATE_P#AUTOCOMMIT

AUTOCOMMIT

CHECKUPDATE_P#CHECK_ONLYUPDATE_P#FIELDS

FIELDS

UPDATEIN_P#IN_FILE

UPDATEIO_P#IO_ERROR

UPDATE_P#IOIO_STATUS

UPDATEISSUE_P#ISSUE_MSG

UPDATE_P#NOTNOT_FOUND

UPDATE_P#RETURNRETURN_RRN

UPDATE_P#VALVAL_ERROR

UPDATEWITH_P#WITH_KEY

UPDATE_P#WITHWITH_RRN


Anchor
FIELDS
FIELDS
FIELDS

...

拡張可能なグループ式を指定することもできます。詳細については、「フィールド・グループおよび拡張可能なグループ」を参照してください。以下の特別な値を指定できます。

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

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

パラメータFIELDSでは、特別な値*ALL、*ALL_REAL、または*ALL_VIRTを必要な場合にのみ慎重に使用することを強くお勧めします。必要のないフィールドを更新すると、クロスリファレンスの詳細(ファンクション内で使用されていないフィールドを示す)が無効になり、ファンクションのCRUDE項目の複雑度が無意味に高くなります。

移植性に関する考慮事項

IBM iで、コミット制御下にないファイルの1つ以上のLOBフィールドを更新する場合にI/Oエラーが発生すると、LOB以外のフィールドが更新され、1つ以上のLOBフィールドが更新されない可能性があります。

『LANSAアプリケーション設計ガイド』の「コミット制御」も参照してください。

Anchor
IN_FILE
IN_FILE
IN_FILE

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

Anchor
WITH_KEY
WITH_KEY
WITH_KEY

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

このパラメータによる自動「相互更新」検査への影響の詳細については、次のコメント/警告のセクションを参照してください。 

...

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

I/O操作の戻りコードについては、「I/Oコマンド戻りコード表」を参照してください。

Anchor
IO_ERROR
IO_ERROR
IO_ERROR

...

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

Note
title注意

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

このコマンドで指定するファイルが論理ファイルかどうかに関係なく、実際にアクセス対象になるデータベース・ファイルは物理ファイルです。そのため、WITH_RRNパラメータを使用して論理ファイルにアクセスする場合は、論理ファイルの選択/除外基準は使用されません。 

以下も参照してください。

Anchor
RETURN_RRN
RETURN_RRN
RETURN_RRN

...

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

Anchor
CHECK_ONLY
CHECK_ONLY
CHECK_ONLY

...

IBM iでのコミット制御の関連については、『LANSA /ADユーザーガイド』の「コミット制御を使用する」を参照してください。

移植性に関する考慮事項

Visual LANSAを使用している場合は、『LANSAアプリケーション設計ガイド』の「コミット制御」を参照してください。