READS

モニター・プログラムは READS 機能を呼び出して、計測機能インターフェースから同期データを要求することができます。

許可

プログラム固有のプログラミング・インターフェース情報の開始
アプリケーション・プログラムを実行する処理 の 1 次許可 ID、または いずれかの 2 次許可 ID は、MONITOR1 または MONITOR2 特権を 持っていなければなりません。 1 次許可 ID も、またどの 2 次許可 ID もこの特権を持っていないと、 要求は拒否されます。

READS 要求は、スレッドのユーザー (所有権トークン) ごとに一度ずつ許可検査が実行されます。(複数のユーザーが同一のスレッドを使用することはできますが、 スレッドのユーザーが変わるたびに許可検査が実行されます。)

READS を使用してユーザー自身のデータを獲得する場合 (修飾なしの IFCID 0124、0147、0148、 または 0150) 許可検査は 実行されません。

構文とオプション

計測機能インターフェースの READS 呼び出し構文は以下のとおりです。

CALL DSNWLI,('READS   ',ifca,return-area,ifcid-area,qual-area),VL
ifca
READS 呼び出しの状況に関する情報が入っています。
return-area
計測機能により戻される可変長レコードが入ります。指定された戻り域が小さすぎるために戻されるレコードのすべてを入れることができない場合は、保管できるだけ多くのレコードが含まれます。 モニター・プログラムは、READS 要求の戻り域を専用アドレス・スペースに確保します。
ifcid-area
要求される情報の IFCID が入ります。 IFCID の数は可変です。 IFCID 域の長さ指定を超過するか、または X'FFFF' の IFCID が検出されると、 リストは終了します。 無効な IFCID が指定された場合は、データは検索されません。
qual-area
モニター・プログラムが戻されるデータに関する制約を指定できる修飾域のアドレス。このパラメーターはオプションで、READS 要求でのみ使用されます。