名称

jsna_get_msg − jsna_get_msg ユーティリティは，所定のエラー・コードのエラー・メッセージまたは 情報メッセージを返します。

形式

#include <sna/jsna3270.h>

jsna_get_msg (facility, status_vec, buffer_return, buffer_length, locale)

char ∗facility;
STATUS_RTN status_vec[];
char ∗buffer_return;
unsigned int buffer_length;
const char ∗locale;

引数

facility SNA などのファシリティ名を指定する。

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

buffer_return エラー・メッセージを格納するバッファへのポインタ。

buffer_length.  リターン・バッファの長さを指定する。

locale 将来の拡張用に予約。

機能説明

jsna_get_msg ユーティリティは，所定のエラー・コード (1 つまたは複数) のエラー・ メッセージまたは情報メッセージを返します。

戻り値

jsna_get_msg ユーティリティは，次のステータス・メッセージを返します。

[SNA3270_S_OK] 成功。

[SNA3270_S_OK_MSGTRUNC]
成功。バッファーに入らない分のメッセージは切り捨てられた。

[SNA3270_S_OPENFAIL] メッセージ・ファイルのオープンに失敗した。

[SNA3270_S_MSGLEN] バッファの長さが無効。

制限事項

なし

関連項目

jsna_put_msg(3) ユーティリティも参照してください。