bea ホーム | 製品 | dev2dev | support | askBEA |
|
e-docs > Tuxedo > C 言語を使用した Tuxedo アプリケーションのプログラミング > 会話型クライアントおよびサーバのコーディング |
C 言語を使用した Tuxedo アプリケーションのプログラミング |
会話型クライアントおよびサーバのコーディング
ここでは、次の内容について説明します。
会話型通信の概要
会話型通信は BEA Tuxedo システムのメッセージ交換のパラダイムで、人の会話に似た通信がクライアントとサーバ間でインプリメントされています。この通信方法では、クライアント (イニシエータ) とサーバ (下位サーバ) 間で仮想接続が行われて、双方で会話の状態に関する情報が保持されます。この接続は、接続を終了するイベントが発生するまで継続します。
会話型通信では、クライアントとサーバ間に半二重接続が確立されます。半二重接続では、メッセージが 1 方向だけに送信されます。接続に関する制御は、イニシエータから下位サーバへ、またはその逆に移ります。制御を持つプロセスがメッセージを送信でき、持たないプロセスは受信しかできません。
以下に銀行業務のオンライン・アプリケーションを例に、BEA Tuxedo アプリケーションで行われる会話型通信について説明します。この例では、銀行の顧客が過去 2 か月間の当座預金の明細書を要求しています。
図 7-1 銀行業務オンライン・アプリケーションでの会話型通信
注記 口座レコード管理システムでは、状態情報を保持して、顧客が More プロンプトを選択した場合にどの明細書を送るのか認識できるようにする必要があります。
要求/応答型通信の場合と同じように、BEA Tuxedo システムでは型付きバッファを使用してデータが渡されます。アプリケーションがバッファ・タイプを認識できることが必要です。バッファ・タイプの詳細については、型付きバッファの概要を参照してください。
会話型のクライアントおよびサーバには、次の特徴があります。
会話型通信は、次の点で要求/応答型通信と異なります。
アプリケーションへの参加
会話型クライアントは、サービスへの接続を確立する前に、tpinit() を呼び出してアプリケーションに参加する必要があります。詳細については、クライアントのコーディングを参照してください。
接続の確立
tpconnect(3c) 関数は、会話を行うための接続を確立します。
tpconnect() 関数の呼び出しには、次の文法を使用します。
int
tpconnect(char *name, char *data, long len, long flags)
次の表は、tpconnect() 関数の引数を示しています。
表 7-1 tpconnect( ) 関数の引数
tpconnect() によって接続が確立されると、BEA Tuxedo システムから接続記述子 (cd) が返されます。この cd は、特定の会話で以降に送られるメッセージを識別するために使用されます。クライアントまたは会話型サービスは、複数の会話に同時に参加できます。最大 64 個の会話を同時に行うことができます。 tpconnect() 関数の呼び出しが失敗すると -1 が返され、対応するエラー・コードが tperrno に設定されます。エラー・コードについては、『BEA Tuxedo C リファレンス』の tpconnect(3c) を参照してください。 次のコード例は、tpconnect() 関数の使用方法を示しています。 コード リスト 7-1 会話型接続の確立#include atmi.h
#define FAIL -1
int cd1; /* 接続記述子 */
main()
{
if ((cd = tpconnect(“AUDITC”,NULL,0,TPSENDONLY)) == -1) {
error routine
}
}
メッセージの送受信
BEA Tuxedo システムで会話型接続が確立されると、イニシエータと下位サーバ間の通信は送信呼び出しと受信呼び出しによって行われます。接続の制御を持つプロセスは、tpsend(3c) 関数を使用してメッセージを送信できます。制御がないプロセスは、tprecv(3c) 関数を使用してメッセージを受信できます。
注記 発信元 (クライアント) は、最初に tpconnect() 呼び出しの TPSENDONLY または TPRECVONLY フラグを使用して、どのプロセスが制御を持っているのかを判別します。TPSENDONLY は、発信元が制御を持つことを示します。TPRECVONLY は、呼び出されたサービスに制御が渡されたことを示します。
メッセージの送信
メッセージを送信するには tpsend(3c) 関数を使用します。この関数には、次の文法を使用します。
int
tpsend(int cd, char *data, long len, long flags, long *revent)
次の表は、tpsend() 関数の引数を示しています。
表 7-2 tpsend( ) 関数の引数
tpsend() 関数の呼び出しが失敗すると -1 が返され、対応するエラー・コードが tperrno(5) に設定されます。エラー・コードについては、『BEA Tuxedo C リファレンス』の tpsend(3c) を参照してください。 tpsend() 関数を呼び出すたびに、制御を渡す必要はありません。一部のアプリケーションでは、tpsend() の呼び出しを認められているプロセスが、制御をほかのプロセスに渡すまで、現在のタスクで必要な回数だけ呼び出しを実行できます。ただし、プログラムのロジックによっては、会話が継続する間は常に 1 つのプロセスが接続の制御を持たなければならないアプリケーションもあります。 次のコード例は、tpsend() 関数の呼び出し方法を示しています。 コード リスト 7-2 会話モードでのデータ送信 メッセージの受信 オープン接続を介してデータを受信するには、tprecv(3c) 関数を使用します。この関数には、次の文法を使用します。 次の表は、tprecv() 関数の引数を示しています。if (tpsend(cd,line,0,TPRECVONLY,revent) == -1) {
(void)userlog(“%s: tpsend failed tperrno %d”,
argv[0],tperrno);
(void)tpabort(0);
(void)tpterm();
exit(1);
}int
tprecv(int cd, char **data, long *len, long flags, long *revent)
処理が成功すると、*data が受信データを指し、len にバッファのサイズが格納されます。len が tprecv() を呼び出す前のバッファの合計サイズより大きい場合、バッファのサイズは変更されていて、len はバッファの新しいサイズを示しています。len 引数が 0 の場合、受信データがないことを示します。
次のコード例は、tprecv() 関数の使用方法を示しています。
コード リスト 7-3 会話型でのデータ受信
if (tprecv(cd,line,len,TPNOCHANGE,revent) != -1) {
(void)userlog(“%s: tprecv failed tperrno %d revent %ld”,
argv[0],tperrno,revent);
(void)tpabort(0);
(void)tpterm();
exit(1);
}
会話の終了
次の場合、接続が切断されて会話が正常に終了します。
注記 tpreturn() 関数については、クライアントおよびサーバへの要求/応答のコーディングを参照してください。
以下の節では、会話を正常に終了する方法について、2 つの例を挙げて説明します。これらの会話には、tpreturn() 関数を使用するグローバル・トランザクションは含まれていません。
最初の例では、2 つのコンポーネント間の単純な会話を終了する方法を示します。2 番目の例では、会話が階層構造になっている複雑な会話を終了する方法を示します。
接続がオープンになっているときに会話を終了すると、エラーが返されます。その場合、tpcommit() または tpreturn() は失敗します。
例: 単純な会話の終了
次の図は、正常に終了する A と B 間の単純な会話を示しています。
図 7-2 正常に終了する単純な会話
注記 この例では、A はクライアントまたはサーバのどちらでもかまいませんが、B はサーバでなければなりません。
例: 階層構造の会話の終了
次の図は、正常に終了する階層構造の会話を示しています。
図 7-3 接続の階層構造
この例では、サービス B は会話のメンバで、2 番目のサービス C との接続を開始しています。つまり、A - B 間 と B - C 間という 2 つのアクティブな接続が存在しています。B がこの両方の接続を制御している場合に tpreturn() の呼び出しを行うと、呼び出しは失敗し、すべてのオープン接続に TPEV_SVCERR イベントが通知され、接続が切断されます。 両方の接続を正常に終了するには、次の処理を順に行います。
注記 会話型サービスは、別のサービスと通信するために要求/応答型の呼び出しを行うことができます。そのため、前述の例では、B から C への呼び出しに tpconnect() ではなく tpcall() または tpacall() を使用することもできます。ただし、会話型サービスが tpforward() を呼び出すことはできません。
会話の切断
エラーの発生により接続を終了する唯一の方法は、tpdiscon(3c) 関数を呼び出すことです。これは、「プラグを抜くこと」と同じです。この関数を呼び出すことができるのは、会話のイニシエータ (クライアント) だけです。
注記 この方法で会話を終了することはお勧めしません。アプリケーションを正常に終了するには、下位サーバで tpreturn() 関数を呼び出します。
tpdiscon() 関数の呼び出しには、次の文法を使用します。
int
tpdiscon(int cd)
cd 引数は、接続が確立したときに tpconnect() 関数によって返される接続記述子を指定します。
tpdiscon() 関数は、接続の相手側のサービスに対して TPEV_DISCONIMM イベントを生成し、cd を無効にします。トランザクションが実行中の場合、そのトランザクションはアボートし、データは失われます。
cd で接続の開始側と識別されていないサービスから tpdiscon() が呼び出されると、その呼び出しは失敗し、エラー・コード TPEBADDESC が生成されます。
イベントおよびエラー・コードの全リストとその説明については、『BEA Tuxedo C リファレンス』の tpdiscon(3c) を参照してください。
会話型のクライアントおよびサーバのビルド
次のコマンドを使用して、会話型のクライアントおよびサーバをビルドします。
会話型サービスと要求/応答型サービスでは、次の操作を行うことはできません。
会話型通信イベント
BEA Tuxedo システムの会話型通信では、5 つのイベントが認識されます。これらのイベントはすべて tprecv() に通知でき、そのうちの 3 つは tpsend() にも通知できます。
次の表は、イベント、そのイベントを受け取る関数、および各イベントの簡単な説明を示しています。