名称

jsna3270_read_field − 表示ベクタから指定フィールドを読み取る

形式

#include <sna/jsna3270.h>

jsna3270_read_field (session_id, buf, length, status_vec)

SESSION_ID_DEF session_id;
char ∗buf;
unsigned int length;
STATUS_RTN status_vec[];

引数

session_id 接続時に割り当てられたセッション識別子。

buf フィールド・ディスクリプタ・ブロックに指定された フィールドを受け取るバッファのアドレス。nullの場合には，データは バッファにコピーされず，日本語 3270 DSPI は FDB の中のフィールド・オフセット とサイズだけをそのフィールドに返す。

length read_field に渡されるデータ・バッファの長さ。

status_vec OSF/1 アプリケーションがメモリを割り当てて，日本語 3270 DSPI がユーザに 完全なステータス情報を提供するために使用する，データ・タイプ STATUS_RTN で， 長さ SNA3270_C_SV_SIZE のベクタ。最初のエントリ（status_vec[0]）には， ベクタの中で返されるステータス・コード数が入っている。

機能説明

jsna3270_read_field プロシージャは，表示ベクタからフィールドを読み取ります。 OSF/1 アプリケーションは，フィールドの特徴を FDB の中で指定します。

戻り値

jsna3270_read_field プロシージャは，次のステータス・メッセージを返します。

[SNA3270_S_OK] 成功。

[SNA3270_S_OK_TRUNC] データの切り捨てを行って成功した。

[SNA3270_S_SVOMIT] ステータス・ベクタが割り当てられていない。

[SNA3270_S_NOSUCHSOCK]
無効なセッション識別子。

[SNA3270_S_BADLEN] FDB 中のバッファ・レングスが間違っている。

[SNA3270_S_BADOFFSET] FDB 中のバッファ・オフセットが間違っている。

[SNA3270_S_NOTINFMOD] フィールド・モードになっていない。

[SNA3270_S_RDFLDFAL] フィールドの読み取りに失敗。詳細は，ステータス・ベクタを参照。

診断項目

呼び出しに失敗したときには，プロシージャは，ステータス・ベクタの中に関 連コード（1 つまたは複数）を返します。

[SNA3270_S_INSRES] 資源が不十分。

[SNA3270_S_NOFIELD] 文字ベクタ内にフィールドがみつからない。

制限事項

フィールド・モードでのみ使用可能。

関連項目

jsna3270_receive_screen(3) と jsna3270_write_screen(3) プロシージャも参照してください。