名称

jsna3270_transmit_screen − 画面を作成し送信する

形式

#include <sna/jsna3270.h>

jsna3270_transmit_screen (session_id, sesidx, io_typ, aid, status_vec,
                          wsf_cb)

SESSION_ID_DEF session_id;
unsigned int sesidx;
unsigned long int io_typ;
unsigned char aid;
STATUS_RTN status_vec[];
SENSE_CODE (∗wsf_cb)();

引数

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

sesidx データを SSCP に送信するときには SNA3270_SSCP に 設定し，それ以外のときには SNA3270_LULU に設定する。

io_typ 接続要求をブロック・モードにするか，非ブロック・モードにするかを指定する フラグ。SNA3270_C_BLOCK のみ指定可能。

aid アテンション識別（AID）は，アプリケーションがホストに送信して， データ・ストリームを送信した処置や機能に注意を向けさせるコード。

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

wsf_cb 画面送信コールバック・ルーチン。 write structured field を IBM ホストに送信する前に，このプロシージャ が呼び出されて，インバウンド write structured field データを作成する。 アプリケーションがコールバック・ルーチンを必要としないときには NULL を 使用する。

機能説明

jsna3270_transmit_screen プロシージャは，文字ベクタと属性ベクタを解析して，3270 データ・ストリーム を生成し，完全なストリームを IBM ホストに送信します。データを IBM ホスト に送信する前に，日本語 3270 DSPI は，送信するインバウンド構造化フィールド ・データがあるかどうかをチェックします。そして write structured field デ ータを受けるコールバック・ルーチンが呼び出されます。この時，インバウンド 構造化フィールド・データを送信するコールバック・ルーチンがアプリケーション になければなりません。

戻り値

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

[SNA3270_S_OK] 成功。

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

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

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

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

[SNA3270_S_PARERR] パラメータが間違っている。

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

[SNA3270_S_XMITSCRFAI] 画面送信に失敗した。ステータス・ベクタを参照。

[SNA3270_S_NOT_OWNER]
セッションの所有者でない。

診断項目

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

[SNA3270_S_INSRES] 資源が不十分。

[SNA3270_S_NO_SSCP] SSCP セッションが使用できない。

制限事項

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

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

関連項目

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