|
|
|
|
|
|
中央イベント・ログ
中央イベント・ログには、BEA Tuxedo アプリケーションで発生する重要なイベントが記録されます。これらのイベントに関するメッセージは、アプリケーション・クライアントとサービスが USERLOG(3cbl) ルーチンを介してログに出力されます。
中央イベント・ログの分析は、アプリケーションで行う必要があります。USERLOG(3cbl) に記録するイベントに関しては、厳密なガイドラインを定義しておきます。ほとんど問題にならないようなメッセージを記録しないようにすると、アプリケーションのデバッグが簡単になります。
Windows 2000 プラットフォームの中央イベント・ログの設定の詳細については、『Windows での BEA Tuxedo の使用』を参照してください。
ログの名前
アプリケーション管理者は、コンフィギュレーション・ファイルに、各マシン上のエラー・メッセージ・ファイル名の接頭辞として使用する絶対パス名を定義します。USERLOG(3cbl) ルーチンは、月、日、年を表す mmddyy の形式で日付を生成し、この日付をパス名の接頭辞に付加して中央イベント・ログの完全なファイル名を構成します。毎日、新しいファイルが作成されます。そのため、中央イベント・ログに数日間にわたってメッセージが送信された場合、メッセージはそれぞれ異なるファイルに書き込まれます。
ログ・エントリの形式
ログ・エントリは、次の要素から構成されます。
各メッセージの本文の前には、そのメッセージのカタログ名と番号が付きます。
たとえば、mach1 (uname コマンドから返される名前) という UNIX マシン上で、セキュリティ・プログラムが午後 4:22:14 に次のような呼び出しを行ったとします。
01 LOG-REC PIC X(15) VALUE "UNKNOWN USER ".
01 LOGREC-LEN PIC S9(9) VALUES IS 13.
CALL "USERLOG" USING LOG-REC LOGREC-LEN TPSTATUS-REC.
このログ・エントリは、次のようになります。
162214.mach1!security.23451:UNKNOWN USER
この例では、セキュリティのプロセス ID は 23451 です。
前述のメッセージが、アプリケーションではなく BEA Tuxedo システムによって生成された場合は、次のようになります。
162214.mach1!security.23451:COBAPI_CAT:999: UNKNOWN USER
この例では、メッセージのカタログ名は COBAPI_CAT 、メッセージ番号は 999 です。
プロセスがトランザクション・モードのときにメッセージが中央イベント・ログに送られると、ユーザ・ログ・エントリのタグにはそのほかの要素が付加されます。これらの要素は、リテラル文字列の gtrid と、それに続く 3 桁の long 型の 16 進数で構成されます。これらの整数はグローバル・トランザクションを一意に識別するもので、グローバル・トランザクション識別子、つまり gtrid と呼ばれます。この識別子は主に管理上の目的で使用されます。また、中央イベント・ログでメッセージの前に付加されるタグの中に挿入されます。システムがトランザクション・モードで中央イベント・ログにメッセージを書き込むと、ログ・エントリは次のようになります。
162214.mach1!security.23451:gtrid x2 x24e1b803 x239:
UNKNOWN USER
イベント・ログへの書き込み
イベント・ログにメッセージを書き込むには、次の手順に従います。
01 TPSTATUS-REC.
COPY TPSTATUS.
01 LOGMSG PIC X(50).
01 LOGMSG-LEN PIC S9(9) COMP-5.
. . .
CALL "TPOPEN" USING TPSTSTUS-REC.
IF NOT TPOK
MOVE "TPSVRINIT:Cannot Open Data Base" TO LOGMSG
MOVE 43 LOGMSG-LEN
CALL "USERLOG" USING LOGMSG
LOGMSG-LEN
TPSTATUS-REC.
. . .
この例では、TPOPEN(3cbl) が -1 を返した場合、メッセージが中央イベント・ログに送られます。
|
|
|
|
|
|
Copyright © 2001 BEA Systems, Inc. All rights reserved.
|