クライアントのコーディング

フィールド	説明
usrname	クライアントを表す名前。ブロードキャスト通知と管理統計情報の検索に使用されます。クライアントは、tpinit() 関数を呼び出すときに usrname に値を設定します。この値には、最大文字数が MAXTIDENT で、最後が NULL で終わる文字列を指定します。最大文字数のデフォルト値は 30 ですが、管理者が変更できます。
cltname	アプリケーション定義のセマンティクスに従ったクライアント名。30 文字以内で最後が NULL で終わる文字列を指定します。ブロードキャスト通知と管理統計情報の検索に使用されます。クライアントは、tpinit() 関数を呼び出すときに cltname に値を設定します。この値には、最大文字数が MAXTIDENT で、最後が NULL で終わる文字列を指定します。最大文字数のデフォルト値は 30 ですが、管理者が変更できます。注記 sysclient の値は、cltname フィールド用に予約されています。
passwd	非暗号化形式のアプリケーション・パスワード。ユーザ認証に使用されます。30 文字以内の文字列を指定します。
grpname	クライアントをリソース・マネージャ・グループに対応付ける値。grpname が長さ 0 の文字列として設定されている場合、クライアントはリソース・マネージャに対応付けられず、デフォルトのクライアント・グループに属します。ワークステーション・クライアントの場合、grpname の値には NULL 文字列 (長さが 0 の文字列) を指定します。ワークステーション・クライアントの詳細については、『BEA Tuxedo Workstation コンポーネント』を参照してください。
flags	クライアント固有の通知メカニズム、およびシステム・アクセスのモード。この値により、マルチコンテキスト・モードとシングルコンテキスト・モードが制御されます。フラグの詳細については、任意通知型通知の処理、または『BEA Tuxedo C リファレンス』の tpinit() を参照してください。
datalen	アプリケーション固有データの長さ。TPINIT 型バッファのバッファ・タイプ・スイッチ・エントリは、そのバッファに渡される合計サイズに基づいてこのフィールドを設定します。アプリケーション・データのサイズは、合計サイズから TPINIT 構造体自体のサイズを差し引き、その値に構造体に定義されているデータ・プレースホルダのサイズを加算したものです。
data	アプリケーション定義の認証サービスに転送される可変長データ用のプレース・ホルダ。

フラグ	説明
TPU_SIG	シグナルによる任意通知を選択します。このフラグは、シングル・スレッドでシングル・コンテキストのアプリケーションのみで使用します。このモードの利点は、直ちに通知できることです。このモードには、次のような不都合があります。ネイティブ・クライアントを実行している場合、呼び出し元プロセスで送信元プロセスと同じ UID を使用する必要があります。ワークステーション・クライアントには、この制約はありません。すべてのプラットフォーム上で TPU_SIG が使用できるわけではありません。特に、MS-DOS ワークステーションでは使用できません。システムや環境の要件を満たしていない場合にこのフラグを指定すると、フラグに TPU_DIP が設定され、ログにイベントが記録されます。
TPU_DIP (デフォルト)	ディップ・インを使用した任意通知型メッセージを指定します。クライアントは tpchkunsol() 関数を使用してメッセージ処理関数の名前を指定し、tpsetunsol() 関数を使用して待機中の任意通知型メッセージを確認できます。
TPU_THREAD	別のスレッド内の THREAD 通知を指定します。このフラグは、マルチスレッドをサポートするプラットフォーム専用です。マルチスレッドがサポートされていないプラットフォームで TPU_THREAD を指定すると、無効な引数として処理されます。その結果、tperrno(5) エラーが返されて TPEINVAL が設定されます。
TPU_IGN	任意通知を無視します。

フラグ

説明

TPU_SIG

シグナルによる任意通知を選択します。このフラグは、シングル・スレッドでシングル・コンテキストのアプリケーションのみで使用します。このモードの利点は、直ちに通知できることです。このモードには、次のような不都合があります。

ネイティブ・クライアントを実行している場合、呼び出し元プロセスで送信元プロセスと同じ UID を使用する必要があります。ワークステーション・クライアントには、この制約はありません。

すべてのプラットフォーム上で TPU_SIG が使用できるわけではありません。特に、MS-DOS ワークステーションでは使用できません。

システムや環境の要件を満たしていない場合にこのフラグを指定すると、フラグに TPU_DIP が設定され、ログにイベントが記録されます。

TPU_DIP (デフォルト)

ディップ・インを使用した任意通知型メッセージを指定します。クライアントは tpchkunsol() 関数を使用してメッセージ処理関数の名前を指定し、tpsetunsol() 関数を使用して待機中の任意通知型メッセージを確認できます。

TPU_THREAD

別のスレッド内の THREAD 通知を指定します。このフラグは、マルチスレッドをサポートするプラットフォーム専用です。マルチスレッドがサポートされていないプラットフォームで TPU_THREAD を指定すると、無効な引数として処理されます。その結果、tperrno(5) エラーが返されて TPEINVAL が設定されます。

TPU_IGN

任意通知を無視します。

モード	説明
PROTECTED	アプリケーション内で ATMI 関数を呼び出し、共用メモリを使用して BEA Tuxedo システムの内部テーブルにアクセスします。BEA Tuxedo システム・ライブラリ外のアプリケーション・コードからのアクセスに対して、共用メモリを保護します。この値は、NO_OVERRIDE が指定されている場合を除き、UBBCONFIG の値に優先します。UBBCONFIG の詳細については、『BEA Tuxedo アプリケーションの設定』を参照してください。
FASTPATH (デフォルト)	アプリケーション・コード内で ATMI 関数を呼び出し、共用メモリを使用して BEA Tuxedo システム内部にアクセスします。BEA Tuxedo システム・ライブラリ外のアプリケーション・コードからのアクセスに対して、共用メモリを保護しません。この値は、NO_OVERRIDE が指定されている場合を除き、UBBCONFIG の値に優先します。UBBCONFIG の詳細については、『BEA Tuxedo アプリケーションの設定』を参照してください。

モード

説明

PROTECTED

アプリケーション内で ATMI 関数を呼び出し、共用メモリを使用して BEA Tuxedo システムの内部テーブルにアクセスします。BEA Tuxedo システム・ライブラリ外のアプリケーション・コードからのアクセスに対して、共用メモリを保護します。この値は、NO_OVERRIDE が指定されている場合を除き、UBBCONFIG の値に優先します。UBBCONFIG の詳細については、『BEA Tuxedo アプリケーションの設定』を参照してください。

FASTPATH (デフォルト)

アプリケーション・コード内で ATMI 関数を呼び出し、共用メモリを使用して BEA Tuxedo システム内部にアクセスします。BEA Tuxedo システム・ライブラリ外のアプリケーション・コードからのアクセスに対して、共用メモリを保護しません。この値は、NO_OVERRIDE が指定されている場合を除き、UBBCONFIG の値に優先します。UBBCONFIG の詳細については、『BEA Tuxedo アプリケーションの設定』を参照してください。

オプションまたは引数 . .	説明 . .
filename.c	コンパイルする C 言語のアプリケーション。
-o filename	実行可能な出力ファイル。出力ファイルのデフォルト名は a.out です。
-f filenames	BEA Tuxedo システムのライブラリより先にリンクされるファイルのリスト。-f オプションは、コマンド行で複数回指定できます。また、各 -f に複数のファイル名を指定できます。C プログラム・ファイル (file.c) を指定すると、リンクされる前にコンパイルが行われます。ほかのオブジェクト・ファイル (file.o) を個別に、またはアーカイブ・ファイル (file.a) にまとめて指定することもできます。
-l filenames	BEA Tuxedo システム・ライブラリの後にリンクされるファイルのリスト。-l オプションは、コマンド行で複数回指定できます。また、各 -l に複数のファイル名を指定できます。C プログラム・ファイル (file.c) を指定すると、リンクされる前にコンパイルが行われます。ほかのオブジェクト・ファイル (file.o) を個別に、またはアーカイブ・ファイル (file.a) にまとめて指定することもできます。
-r	実行可能サーバにリンクされるリソース・マネージャのアクセス・ライブラリ。アプリケーション管理者は、buildtms(1) コマンドを使用して、すべての有効なリソース・マネージャ情報を $TUXDIR/updataobj/RM ファイルに事前に定義しておく必要があります。指定できるリソース・マネージャは 1 つだけです。詳細については、『BEA Tuxedo アプリケーションの設定』を参照してください。

オプションまたは引数 . .

説明 . .

filename.c

コンパイルする C 言語のアプリケーション。

-o filename

実行可能な出力ファイル。出力ファイルのデフォルト名は a.out です。

-f filenames

BEA Tuxedo システムのライブラリより先にリンクされるファイルのリスト。-f オプションは、コマンド行で複数回指定できます。また、各 -f に複数のファイル名を指定できます。C プログラム・ファイル (file.c) を指定すると、リンクされる前にコンパイルが行われます。ほかのオブジェクト・ファイル (file.o) を個別に、またはアーカイブ・ファイル (file.a) にまとめて指定することもできます。

-l filenames

BEA Tuxedo システム・ライブラリの後にリンクされるファイルのリスト。-l オプションは、コマンド行で複数回指定できます。また、各 -l に複数のファイル名を指定できます。C プログラム・ファイル (file.c) を指定すると、リンクされる前にコンパイルが行われます。ほかのオブジェクト・ファイル (file.o) を個別に、またはアーカイブ・ファイル (file.a) にまとめて指定することもできます。

-r

実行可能サーバにリンクされるリソース・マネージャのアクセス・ライブラリ。アプリケーション管理者は、buildtms(1) コマンドを使用して、すべての有効なリソース・マネージャ情報を $TUXDIR/updataobj/RM ファイルに事前に定義しておく必要があります。指定できるリソース・マネージャは 1 つだけです。詳細については、『BEA Tuxedo アプリケーションの設定』を参照してください。

main()
{
セキュリティ・レベルをチェック
tpsetunsol() を呼び出して、TPU_DIP 用にハンドラを命名
usrname、cltname を取得
アプリケーション・パスワードの入力を要求
TPINIT バッファを割り当て
TPINIT バッファ構造体メンバに値を格納

if (tpinit((TPINIT *) tpinfo) == -1){
エラー・ルーチン;
}

ユーザ入力が存在する間に
メッセージ・バッファを割り当て {
ユーザ入力をバッファに格納
サービス呼び出しを行う
応答を受信
任意通知型メッセージを確認
}
バッファを解放
.. .
if (tpterm() == -1){
エラー・ルーチン;
}
}

#include <stdio.h> /* UNIX */
#include <string.h> /* UNIX */
#include <fml.h> /* BEA Tuxedo システム */
#include <atmi.h> /* BEA Tuxedo システム */
#include <Uunix.h> /* BEA Tuxedo システム */
#include <userlog.h> /* BEA Tuxedo システム */
#include "bank.h" /* 銀行業務アプリケーションのマクロ定義 */
#include "aud.h" /* 銀行業務アプリケーションの VIEW 定義 */

...

main(argc, argv)
int argc;
char *argv[];

{
...
if (strrchr(argv[0],'/') != NULL)
proc_name = strrchr(argv[0],'/')+1;
else
proc_name = argv[0];
...
/* アプリケーションへの参加 */
if (tpinit((TPINIT *) NULL) == -1) {
(void)userlog("%s:failed to join application¥n", proc_name);
exit(1);
}
...
/* アプリケーションからの分離 */
if (tpterm() == -1) {
(void)userlog("%s:failed to leave application¥n", proc_name);
exit(1);
}
}