名称

jsna3270_receive_stream − IBM ホストからデータを受信する

形式

#include <sna/jsna3270.h>

jsna3270_receive_stream (session_id, sesidx, io_typ, buf,
length, status_vec)

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

引数

session_id jsna3270_request_connect によって返されたセッション識別子の値。

sesidx データを SSCP から受信した場合には SNA3270_C_SSCP に設定し，それ以外の場合には SNA3270_C_LULU に設定する。

io_typ 受信をブロック・モードにするか，非ブロック・ モードにするかを指定するフラグ。SNA3270_C_BLOCK または SNA3270_C_NON_BLOCK の いずれかを指定する。

buf バッファ・ポインタのアドレス。ポインタには， 日本語 3270 DSPI が IBM ホストから受信したデータ用に割り当てたバッフ ァ位置のアドレスが入っている。

length 受信したデータの長さ。

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

機能説明

jsna3270_receive_stream プロシージャは，IBM ホストから送信された 3270 データ・ストリームを受信します。

戻り値

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

[SNA3270_S_OK] 成功。

[SNA3270_S_OK_SELECT] 成功。受信されたデータはない。

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

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

[SNA3270_S_FUNNOTIMP] 指定されたパラメータは現在使用不可。

[SNA3270_S_EVT_BINDRCV]
BIND 要求を受信した。

[SNA3270_S_EVT_SDTRCV]
SDT コマンドを受信した。

[SNA3270_S_EVT_CLEAR] CLEAR コマンドを受信した。

[SNA3270_S_EVT_TURNGONE]
送信する番になっていない。

[SNA3270_S_EVT_UNBIND]
UNBIND 要求を受信した。

[SNA3270_S_EVT_SESSTERM]
セッションが終了された。

[SNA3270_S_RECVSTRFAI] 受信に失敗。

診断項目

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

[SNA3270_S_INSRES] 資源が不十分。

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

関連項目

jsna3270_acknowledge プロシージャを参照してください。