3.3.1　サービス要求データファイル

(a)　ファイルの構造

(b)　ファイルの内容

(c)　注意事項

• サービス関数の引数との関係を次に示します。

  

  1. データ

  2. データ長

  3. 応答領域長

• RPC要求データファイルは，オフラインテスタのファイルも使用できます。

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

(a)　ファイルの構造

(b)　ファイルの内容

(c)　注意事項

• サービス関数の引数との関係を次に示します。

  void tpservice(svcinf)
       TPSVCINFO *svcinf;
   
       struct TPSVCINFO {
                 char name[32];
                 char *data;       →1.
                 long len;         →2.
                 long flags;
                 int cd;
              }

  1. タイプ，サブタイプにマッピングされたデータが格納されているアドレス

  2. dataで示すデータの長さ

• utoxsppsvcコマンドで発行するXATMI関数との関係を次に示します。

  idata=tpalloc (type, subtype, ilen);
                  2.      3.      4.
  tpcall (svc, idata, ilen, odata, olen, flags);
    1.                  4.                 5.
  tpacall (svc, idata, ilen, flags);
    1.                   4.    5.
  tpconnect (svc, idata, ilen, flags);
      1.                   4.     5.

  1. 呼び出し種別に対応したXATMI関数

  2. タイプ名

  3. サブタイプ名

  4. データ長

  5. フラグ（指定したフラグを実際のフラグの値に変換して指定）

• XATMI要求データファイルは，オフラインテスタのファイルも使用できます。

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

• サブタイプ名が16文字に満たない場合，サブタイプ名の後ろにヌル文字を付けて指定してください。

• タイプがX_OCTET以外の場合，ファイル内で指定したサブタイプのデータ長と，utoxsppsvcコマンドで指定するサブタイプのデータ長が異なると，XATMI要求データファイルのデータ不正になります。

• フラグにはTPNOCHANGEのコードを指定できますが，無視されます。

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

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

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