名称

jsna3270_transmit_sna_cmd − out-of-band要求を送信する

形式

#include <sna/jsna3270.h>

jsna3270_transmit_sna_cmd (session_id, io_typ, cmd, status_vec)

SESSION_ID_DEF session_id;
unsigned long int io_typ;
unsigned int cmd;
STATUS-RTN status_vec[];

引数

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

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

cmd SNA コマンド。有効なコマンドには次のものがある。

・SNA3270_C_CMD_NOTIFY_ON

・SNA3270_C_CMD_NOTIFY_OFF

・SNA3270_C_CMD_LUSTAT

・SNA3270_C_CMD_SIGNAL

・SNA3270_C_CMD_UNBIND

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

機能説明

jsna3270_transmit_sna_cmd プロシージャは，OSF/1 アプリケーシ ョンに SNA 要求を IBM ホストに送信するメカニズムを提供します。アプリケーション が NOTIFY，LUSTAT，SIGNAL などのコマンドを送信する必要がある場合にこのプロシー ジャを使用します。

戻り値

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

[SNA3270_S_OK] 成功。

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

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

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

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

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

[SNA3270_S_XMITSNAFAI] コマンドの送信に失敗した。ステータス・ベクタを参照。

診断項目

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

[SNA3270_S_NO_SSCP] SSCP-LU セッションがない。

[SNA3270_S_INSRES] 資源が不十分。

制限事項

なし

関連項目

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