アプリケーションへの参加

クライアントがサービスを要求する場合、BEA Tuxedo アプリケーションに明示的または暗黙的に参加している必要があります。アプリケーションに参加すると、クライアントは要求を送り、その応答を受け取ることができるようになります。

01 TPINFDEF-REC
   COPY TPINFDEF.
01 USER-DATA-REC      PIC X(any-length).
01 TPSTATUS-REC.
   COPY TPSTATUS.
CALL "TPINITIALIZE" USING TPINFDEF-REC USER-DATA-REC TPSTATUS-REC.

クライアントが TPINITIALIZE を呼び出す前にサービス要求 (または ATMI 呼び出し) を行うと、暗黙的にアプリケーションに参加したことになります。その場合、SPACES パラメータを使用して、TPINITIALIZE がクライアントではなく BEA Tuxedo システムによって呼び出されます。TPINFDEF-REC レコードは BEA Tuxedo システムの特別な型付きレコードであり、クライアントがアプリケーションに参加するときに、クライアントの ID と認証の情報をシステムに渡すためにクライアント・プログラムによって使用されます。このレコードは、次のように COBOL の COPY ファイルに定義されています。

05 USRNAME           PIC X(30).
05 CLTNAME           PIC X(30).
05 PASSWD            PIC X(30).
05 GRPNAME           PIC X(30).
05 NOTIFICATION-FLAG PIC S9(9) COMP-5.
  88 TPU-SIG           VALUE 1.
  88 TPU-DIP           VALUE 2.
  88 TPU-IGN           VALUE 3.
05 ACCESS-FLAG       PIC S9(9) COMP-5.
  88 TPSA-FASTPATH     VALUE 1.
  88 TPSA-PROTECTED    VALUE 2.
05 DATALEN           PIC S9(9) COMP-5.

次の表は、COBOL の COPY ファイルに定義されているフィールドを示しています。

COBOL の COPY ファイルのフィールド

フィールド	説明
USRNAME	呼び出し元を表す名前。このフィールドには、UNIX コマンドの getuid(2) の戻り値を指定することもできます。USRNAME には、MAXTIDENT で指定された文字数 (30 文字) までの値を指定できます。
CLTNAME	アプリケーション定義のセマンティクスに従ったクライアント名。CLTNAME には、MAXTIDENT で指定された文字数 (30 文字) までの値を指定できます。
PASSWD	非暗号化形式のアプリケーション・パスワード。TUXCONFIG ファイルに格納されたアプリケーション・パスワードとの認証で、TPINITIALIZE によって使用されます。PASSWD には、MAXTIDENT の値までの文字列を指定します。
GRPNAME	クライアントを対応付けるリソース・マネージャ・グループの名前。クライアントは、グローバル・トランザクションの一部として、XA 準拠のリソース・マネージャにアクセスできるようになります。GRPNAME には、MAXTIDENT で指定された文字数 (30 文字) までの値を指定できます。ただし、現在のところ、GRPNAME は SPACES として渡す必要があります。その場合、クライアントはリソース・マネージャ・グループに対応付けられず、デフォルトのクライアント・グループに属することを指定します。
NOTIFICATION-FLAG	使用する通知メカニズム、およびシステム・アクセス・モード。有効な値については、「任意通知型通知の処理」 を参照してください。
ACCESS-FLAG	使用するシステム・アクセス・モード。使用できる値については、「システム・アクセス・モード」 を参照してください。
DATALEN	認証サービスに送信されるアプリケーション固有データの長さ。ネイティブ・クライアントの場合、このデータはシステムによって符号化されずに、クライアントによって提供される認証サービスに渡されます。ワークステーション・クライアントの場合、クライアント認証はシステムによって行われ、暗号化形式でネットワークを介して渡されます。

関連項目