名称

jsna3270_write_field − 3270画面イメージにフィールドを書き込む

形式

#include <sna/jsna3270.h>

jsna3270_write_field (session_id, buf, length, status_vec)

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

引数

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

buf 指定されたフィールドに書き込まれるデータが入って いるバッファへのポインタ。

length データの長さ。

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

機能説明

jsna3270_write_field プロシージャは，3270 画面イメージにフィールドを書き込みます。 jsna3270_read_field と同様に，呼び出し側が FDB データ構造の中でフィールドを指定します。

戻り値

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

[SNA3270_S_OK] 成功。

[SNA3270_S_OK_TRUNC] 成功。データが切り捨てられている。

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

[SNA3270_S_NOSUCHSOCK]
無効なセッション ID 。

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

[SNA3270_S_NOINPUT] WRITE_FIELD の入力データがない。

[SNA3270_S_BADOFFSET] FDB の中のバッファ・オフセットがフィールドの先頭になっていない。

[SNA3270_S_BADLEN] 読取り／書込みフィールド要求で間違ったバッファの長さが指定された。

[SNA3270_S_PROTECTED] フィールドが保護されており，変更できない。

[SNA3270_S_NUMERIC] データは数値でなければならない。

[SNA3270_S_WTFLDFAI] フィールドの書き込みに失敗した。ステータス・ベクタを参照。

診断項目

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

[SNA3270_S_INSRES] 資源が不十分。

上記以外のステータス・コードを受信した場合は， 『日本語 DEC SNA 3270 DSPI for DEC OSF/1 インストレーション/プログラミング ・ガイド』を参照してください。

制限事項

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

関連項目

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