名称

jsna3270_acknowledge − 受信データの確認応答

形式

#include <sna/jsna3270.h>

jsna3270_acknowledge (session_id, sense, status_vec)

SESSION_ID_DEF session_id;
SENSE_CODE ∗sense;
STATUS_RTN status_vec[];

引数

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

sense PLU に送信されるセンス・コード応答が入っている SENSE_CODE 型変数へのポインタ。

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

機能説明

jsna3270_acknowledge プロシージャは， jsna3270_receive_stream から受信したデータが受け入れ可能かどうかを IBM アプリケシーョン・サブシステム に知らせます。 OSF/1 アプリケーションは，日本語 3270 DSPI がデータを IBM ホストに 返信する事を許可する前に受信したデータを確認応答しなければなりません。

アプリケーションがフィールド・モードを使用して （つまり， jsna3270_receive_screen プロシージャを使用して） ， IBM ホストからデータを受信する場合には，プロシージャは受信した画面を 自動的に確認応答します。したがって，ほとんどの場合， OSF/1 アプリケーションは jsna3270_acknowledge を 特に呼び出す必要がありません。

戻り値

jsna3270_acknowledge プロシージャは，次のステータスを返します。

[SNA3270_S_OK] 成功。保留されている応答がないときにもこのステータス・メッ セージが返される。

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

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

[SNA3270_S_ACKFAI] 呼び出しが失敗した。

診断項目

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

[SNA3270_S_INSRES] 資源が不十分。

制限事項

なし

関連項目

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