ヌル標識の照会または設定

概要

%NULLIND 組み込み関数は、ヌル値可能フィールドのヌル標識を照会または設定するために使用することができます。
この組み込み関数 は、ALWNULL(*USRCTL) キーワードが制御仕様書に指定されたか、またはコマンド・パラメーターとして指定された場合のみ使用 することができます。
フィールド名は、ヌル値可能配列要素、データ構造、独立フィールド、サブフィールド、または複数オカレンス・データ構造の場合があります。

使用条件

ALWNULL キーワードは、外部記述データベース・ファイルからの、ヌル値可能フィールドを含んでいるレコードを使用する方法を指定します。
ALWNULL(*NO)を指定した場合、ヌル値フィールドを持つレコードを外部記述ファイル から処理することはできません。ヌル値を含んでいるレコードの取り出しを試みると、レコード内のデータにアクセスできず、データ・マッピング・エラーが発生します。
ALWNULL(*INPUTONLY) を指定した場合、外部記述入力専用データベース・ファイルから、ヌル値を含むヌル値可能フィールドがあるレコードを正常に読み取ることができます。ヌル値を含むレコードが取り出された場合、データ・マッピング・エラーは発生しないで、ヌル値を含むすべてのフィールドに、データベースのデフォルト値が入ります。 ただし、 以下のいずれも実行することはできません。
― ヌル値可能キー・フィールドの使用
― ヌル値可能フィールドを含むレコードの作成または更新
― プログラムの実行中に、ヌル値可能フィールドが実際にヌルであるかどうかを 判別すること
― ヌル値可能フィールドをヌルに設定すること
ALWNULL(*USRCTL) を指定した場合、外部記述データベース・ファイルから、ヌル値を含むレコードの読み取り、書き出し、および更新を行うことができます。 ヌル・キーを含むレコードは、キー付き命令を使用して取り出すことができます。 ヌル値可能フィールドが実際にヌルであるかどうかを判別し、ヌル値可能フィールドを出力または更新のためにヌルに設定することができます。
ALWNULL キーワードを指定しない場合、コマンドに指定した値が使用されます。

組み込み関数（％NULLIND）

［一般形式］

%NULLIND は、拡張演算項目 2 の中の式でのみ使用することができます。
・この関数を式の右側で使用すると、ヌル値可能フィールドのヌル標識の設定値が戻されます。この設定値は *ON または *OFF です。
・この関数を式の左側で使用すると、ヌル値可能フィールドのヌル標識を *ON または *OFF に設定することができます。ヌル値可能フィールドの内容は変わりません。

              
_*. 1 ...+... 2 ...+... 3 ...+... 4 ...+... 5 ...+... 6 ...+... 7 ...+... 8
HL0N01FACTOR1+++++++OPCODE&EXTEXTENDED-FACTOR2+++++++++++++++++++++++++++++
H ALWNULL(*USRCTL)　　　　　　　　　　　　　　　　　　　　　　　　//制御仕様書
C*
C　　　　　　　　　 EVAL　　　%NULLIND(SW2H00001) = *OFF 
C　　　　　　　　　 IF　　　　%NULLIND (SW2H00001)