VIEWPOSN 呼び出し (IMS セグメントへの位置設定)

この IEB 呼び出しでは、IMS セグメントに位置設定し、次の GETIMS (USING_VIEW を指定) でこのポイントからセグメントを取り出すようにします。

図 1. Syntax

key details

注:

¹ field_ref または field_name を使用するには、この関数呼び出しの前の VIEWIMS の呼び出しによって、ビューがすでにロードされている必要があります。
² layout_ref の修飾がない field_ref を指定した場合、field_ref は segname セグメントの最初のレイアウトに関連付けられます。
³ field_name を完全修飾するには、指定する最初の qualifier をレイアウト名にする必要があります。レイアウト名が指定されていない場合、FM/IMS は、グループ修飾子と field_name が見つかるまで、相対順序ですべてのレイアウトから segname セグメントを検索します。見つからない場合、エラー・メッセージが表示され、処理が終了します。

field_name: フィールド名。
field_ref: レイアウト内のフィールドのフィールド参照番号。VIEWIMS DESCRIBE 文節を使用してビューまたはテンプレートを印刷するか、ビューまたはテンプレートをオンラインでブラウズすることで取得できます。
field_value: field_ref または field_name に指定したフィールドの値。
layout_ref: セグメント内のレイアウトの相対番号。VIEWIMS DESCRIBE 文節を使用してビューまたはテンプレートを印刷することで取得できます。
posseg: 位置設定先のセグメントの名前。
qualifier: フィールド名 (field_name) を特定する 1 つ以上の修飾子。最初の修飾子はセグメント・レイアウト名です。後続の修飾子 (ある場合) は、指定したフィールド名を特定するために使われるグループ・フィールドです。レイアウト名またはグループ・フィールドを省略すると、FM/IMS は指定された修飾子とフィールド名をセグメント・レイアウトから検索します。
注: レイアウト名とグループ・フィールドは、VIEWIMS DESCRIBE 文節を使用してビューまたはテンプレートを印刷するか、ビューまたはテンプレートをオンラインでブラウズすることで取得できます。
segname: 位置設定するセグメントの階層パス内のセグメントの名前。

正常に行われればゼロを戻し、そうでなければゼロ以外を戻します。

FM/IMS で使用不可の HALDB 区画または DEDB 領域が検出された場合、DELIMS 関数は戻りコード 8 を受け取り、ISPF 変数 FMSTATUS は、以下の IMS 状況コードを示します。

FH: 使用不可の DEDB 領域
BA: 使用不可の HALDB 区画

セグメントの現在の内容を OUTREC 変数の内容で置き換えるには、SET 文節を省略します。可変長セグメントを挿入する場合には、OUTREC の最初の 2 バイトでセグメントの長さを指定する必要があります。