3.3.3　XATMI受信データファイル

(1)　ファイルの構造

ページの先頭へ

(2)　ファイルの内容

ページの先頭へ

(3)　注意事項

• メッセージ受信関数（tprecv関数）の引数との関係を次に示します。

  tprecv (……, data, len, ……, revent)
                 1.    2.          3.

  1. タイプ，サブタイプで確保されたバッファに格納したデータ

  2. データ長

  3. イベントフラグ

• サーバUAPシミュレート機能で使用する場合にtprecv関数に渡すデータと，XATMI受信データファイル，XATMI応答データファイルとの関係を，次の図に示します。

  図3‒1　受信データとテスタファイルの関係

  サーバUAPシミュレート機能で使用する場合，受信データは実行単位に作成します。一つのサービスが複数回tprecv関数を発行する場合は，発行回数分のデータを作成しておく必要があります。ただし，最後のtprecv関数に渡すデータは，XATMI応答データファイル内にデータを格納できます。

  データの数よりtprecv関数の発行回数が多い場合は，tpreturn関数のデータが受信されたものとし，それ以降は，エラーとなります。

  XATMI受信データファイルは，サービス単位にオープン，クローズします。

• XATMI受信データファイルは，オフラインテスタのファイルは使用できません。ただし，複数のオフラインテスタ用XATMI受信データファイルを，catコマンドで一つのファイルに編集すると，オンラインテスタでも使用できます。

• サーバUAPシミュレート機能使用時に出力された送信データを格納したXATMI送信データファイルは，そのままXATMI受信データファイルとして使用できます。

• データ長に満たないデータを指定した場合は，エラーとなります。また，データ長を超えた部分のデータは無視されます。

• サーバUAPシミュレート機能で使用する場合，イベントフラグにTPEV_SENDONLY以外を指定すると，クライアントUAPで発行したtprecv関数は，それ以上会話を続行できないイベントを受け取ります。そのため，それ以降のデータは使用されません。また，イベント発生時のグローバル変数tpurcodeには，0が設定されます。

• クライアントUAPシミュレート機能で使用する場合，イベントフラグの指定は，0とTPEV_SENDONLYだけが有効です。それ以外の指定は無効になります。

• タイプ，サブタイプを指定した場合のデータ長とデータは，スタブで定義したデータ構造（構造体）と同じでなければなりません。

  また，スタブで定義したデータ構造は，バウンダリ調整が行われます（合計長は4の整数倍となります）。そのため，ファイルで指定するデータはその調整部分を考慮して作成する必要があります。

  バウンダリ調整の内容は，stbmakeコマンドで作成したスタブソース，およびstbmakeコマンドに-pオプションを指定した場合の出力結果を参照して，確認できます。

ページの先頭へ