1.3.2　XATMIインタフェース用スタブの作成方法

(a)　通信で使う型付きバッファの定義

形式

タイプ名  サブタイプ名{
            データ型  データ名；
          〔データ型  データ名；〕
                     ：
                     ：
            }；

機能

サーバUAPで使う型付きバッファのタイプ名，サブタイプ名，および構造体を定義します。サーバUAPから ほかのサーバUAPプロセスのサービスを呼び出す場合，呼び出すプロセスで使える型付きバッファはすべて自プロセスでも使えます。そのため，ここでは自プロセス内のサービス関数が入出力として使う型付きバッファだけを定義します。

X_OCTETは定義しなくても常に認識されます。X_OCTETを定義した場合，スタブを生成するコマンド（stbmakeコマンドまたはtpstbmkコマンド）の実行時にエラーとなります。

パラメタ

• タイプ名

  サーバUAPで使う型付きバッファの，タイプ名を指定します。

• サブタイプ名

  サーバUAPで使う型付きバッファの，サブタイプ名を指定します。

• データ型

  サーバUAPで使う型付きバッファの構造体にあるデータの，データ型を指定します。

• データ名

  サーバUAPで使う型付きバッファの構造体にあるデータの，データ名を指定します。

タイプで使えるデータ型の一覧

タイプで使えるデータ型の一覧を次の表に示します。識別子とはXATMIインタフェース定義に記述するデータ型を示し，C言語のデータ型とは実際にスタブに定義される型付きバッファを示します。OpenTP1以外のシステムと通信するためにデータ型を変換する場合は，変換する識別子をXATMIインタフェース定義に指定します。

OpenTP1では，intを4バイトとしているので，定義ファイル内ではそれを明示するため「int4」と記述します。

表1‒6　タイプで使えるデータ型の一覧

タイプ	識別子	C言語のデータ型	通信プロトコル		備考
			TCP/IP	OSI TP
X_OCTET	−※1	−※1	○	○	なし
X_COMMON	short a	short a	○	○	なし
	short a[n]	short a[n]	○	○	なし
	long a	DCLONG a	○	○	なし
	long a[n]	DCLONG a[n]	○	○	なし
	char a※2	char a	○	○	無変換配列
	octet a	char a	○	○	無変換配列
	tchar a	char a	−	○	変換配列
	char a[n]※2	char a[n]	○	○	無変換配列
	octet a[n]	char a[n]	○	○	無変換配列
	tchar a[n]	char a[n]	−	○	変換配列
X_C_TYPE	short a	short a	○	×	なし
	short a[n]	short a[n]	○	×	なし
	long a	DCLONG a	○	×	なし
	long a[n]	DCLONG a[n]	○	×	なし
	int4 a	DCLONG a	○	×	なし
	int4 a[n]	DCLONG a[n]	○	×	なし
	char a※2	char a	○	×	なし
	octet a	char a	○	×	なし
	tchar a	char a	○	×	なし
	char a[n]※2	char a[n]	○	×	なし
	octet a[n]	char a[n]	○	×	なし
	tchar a[n]	char a[n]	○	×	なし
	float a	float a	○	×	なし
	float a[n]	float a[n]	○	×	なし
	double a	double a	○	×	なし
	double a[n]	double a[n]	○	×	なし
	octet a[n][n]	char a[n][n]	○	×	なし
	tchar a[n][n]	char a[n][n]	○	×	なし
	str a[n]	char a[n]	○	×	なし
	str a[n][n]	char a[n][n]	○	×	なし
	tstr a[n]	char a[n]	○	×	なし
	tstr a[n][n]	char a[n][n]	○	×	なし

（凡例）

○：該当する通信プロトコルで使えます。

×：該当する通信プロトコルでは使えません。

−：変換の識別子でも，無変換としてそのまま処理されます。

注※1

X_OCTETは，定義しなくても自動的に認識されます。XATMIインタフェース定義にX_OCTETを指定した場合は，スタブを生成するコマンドを実行したときにエラーになります。

注※2

この識別子も使えますが，新規で作成する場合は次に示す識別子を使うことをお勧めします。

X_COMMONの場合：octet または tchar

X_C_TYPEの場合：strまたは tstr

指定例

 X_C_TYPE subtype1 {
                   char  name[8];
                   int4  data[10];
                   int4  flags;
                   };

(b)　サービス関数名と引数情報の定義

形式

service  サービス関数名{(タイプ名 〔サブタイプ名〕) | (ALL) | (〔void〕)};

機能

サーバUAPのサービス関数の関数名と，引数として渡される型付きバッファのタイプ名とサブタイプ名を指定します。引数とは，サービス関数の実際の引数であるsvc_info構造体のdataメンバのことです。

X_OCTETの場合はサブタイプ名がないので，タイプ名だけを指定します。また，サービス関数内でsvc_info構造体のdataメンバを一度も参照しない処理の場合は，サービス関数名のあとに何も指定しないか，voidを指定します。

tpcall( )，tpacall( )，tpconnect( )は型付きバッファを送信しないで，サービス関数を呼び出せます。ただし，サービス関数でsvc_info構造体のメンバが指すデータを明示的に参照したくない場合は，引数に何も設定しないか，voidを設定します。このように指定したサービス関数を呼び出すには，クライアント側のtpcall( )，tpacall( )，tpconnect( )が送信する型付きバッファへのポインタにNULLを設定してください。ただし，X_OCTETの場合は，ポインタがNULLでなくても，送信データの長さが0の場合でも，サービスを要求できます。

引数として受け取る型付きバッファを限定しない指定をする場合は，引数に ALL を指定します。ALL を引数に指定して定義したサービス関数は，自プロセスで認識できる型付きバッファであれば，どの型でも受信できます。

パラメタ

• サービス関数名

  サーバUAPにある，関数名を指定します。

• タイプ名

  関数のデータ領域に指定した，タイプ名を指定します。

• サブタイプ名

  関数のデータ領域に指定した，サブタイプ名を指定します。

指定例

例1

service svc_func1(X_C_TYPE subtype1);

例2（引数のタイプ名がX_OCTETの場合）

service svc_func2(X_OCTET);

例3（引数を受信しないサービス関数の場合）

service svc_func3(void);  または  service svc_func3();

例4（引数を限定しないサービス関数の場合）

service svc_func4(ALL);

(c)　サーバUAPから，さらに別のサーバUAPを呼び出す場合

クライアントUAPのXATMIインタフェース定義（called_servers文）を指定します。