Versions Compared

Key

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

...

RETURN_RRN

TO_FILE

VAL_ERROR


Anchor
FIELDS
FIELDS
FIELDS

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

または、このパラメータに拡張可能なグループ式を入力することもできます。詳細については、「拡張可能グループ」を参照してください。以下の特別な値を指定できます。

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

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

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

Anchor
TO_FILE
TO_FILE
TO_FILE

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

Anchor
IO_STATUS
IO_STATUS
IO_STATUS

I/O操作の結果の「戻りコード」を受け取るフィールドの名前を指定します。 

...

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

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

Anchor
IO_ERROR
IO_ERROR
IO_ERROR

このコマンドの実行時にI/Oエラーが発生した場合に実行するアクションを指定します。 

...

上記の値をどれも使用しない場合は、制御を渡す先の有効なコマンド・ラベルを指定してください。 

Anchor
VAL_ERROR
VAL_ERROR
VAL_ERROR

このコマンドで妥当性検査エラーが検出された場合に実行するアクションを指定します。 

...

上記の値をどれも使用しない場合は、制御を渡す先の有効なコマンド・ラベルを指定してください。 

Info

*LASTDISは、「直前の表示画面」がない場合(バッチ・ファンクション内など)でも有効です。この場合、ファンクションが異常終了し、該当するエラー・メッセージが発行されます。

*LASTDISを使用する場合、「直前の表示画面」は、データベース・コマンド(INSERT、UPDATE、DELETE、FETCH、およびSELECT)と同じレベルでなければなりません。データベース・コマンドがSUBROUTINE内で指定され、「直前の表示画面」が呼び出し元ルーチンまたはメインラインの場合など、レベルが異なるとこのファンクションは異常終了し、該当するエラー・メッセージが発行されます。

これは、Visual LANSAでイベント・ルーチンとメソッド・ルーチンを使用する場合には当てはまりません。これらの場合、制御は呼び出しルーチンに戻されます。フィールドには、エラーがあることと、フォームの親階層で見つかった最初のステータス・パーに返されたメッセージが表示されます。または、メッセージがない場合は、実行スタック内で見つかったステータス・バーを持つ最初のフォーム(PRIM_OBJTから継承した再利用可能パーツなど)が表示されます。 

Anchor
ISSUE_MSG
ISSUE_MSG
ISSUE_MSG

このパラメータは他のパラメータと機能が重複しています。値を指定しても何の効果もありません。

デフォルト値は*NOです。 

*NO以外に指定できる値は*YESのみです。 

Anchor
RETURN_RRN
RETURN_RRN
RETURN_RRN

挿入されたレコードの相対レコード番号を返す先のフィールドの名前を指定します。 

...

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

Anchor
CHECK_ONLY
CHECK_ONLY
CHECK_ONLY

I/O操作を実際に実行するか、実際に実行したときにファイルおよびデータ・ディクショナリ・レベルの妥当性検査の条件をすべて満たすことができるかを検査するために「シミュレーション」のみを行うかを指定します。

...

*YESを指定した場合、ファイルおよびデータ・ディクショナリ・レベルの検査の条件をすべて満たすことができるかどうかを確認するために、I/O操作がシミュレートされます。このオプションを使用した場合、この検査に関与するデータベース・ファイルがいかなる形でも変更されることはありません。 

Anchor
AUTOCOMMIT
AUTOCOMMIT
AUTOCOMMIT

LANSAリリース4.0プログラム変更レベルE5により、このパラメータは、他のパラメータと機能が重複しています。

...

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

移植性に関する考慮事項

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