bea ホーム | 製品 | dev2dev | support | askBEA |
![]() |
![]() |
|
![]() |
e-docs > Tuxedo > Tuxedo のファイル形式とデータ記述方法 > セクション 5 ―ファイル形式、データ記述方法、MIB、およびシステム・プロセスのリファレンス |
Tuxedo のファイル形式とデータ記述方法
|
制限事項
なし
診断
コンポーネント MIB への接続時には、2 つの一般的なタイプのエラーがユーザに返される場合があります。1 つは、管理要求に対する応答を検索する 3 つの ATMI 関数 (tpcall()、tpgetrply()、および tpdequeue()) が返すエラーです。これらのエラーは、それぞれの関数のリファレンス・ページに定義されています。
2 つ目は、要求がその内容に対応できるシステム・サービスに正常にルーティングされても、システム・サービス側でその要求を処理できないと判断されると、アプリケーション・レベルのサービス障害として返されるエラーです。このような場合、tpcall() と tpgetrply() は、tperrno() を TPESVCFAIL に設定してエラーを返し、以下のようにエラーの詳細を示す TA_ERROR、TA_STATUS、および TA_BADFLD フィールドと一緒に、元の要求を含む応答メッセージを返します。TMQFORWARD(5) サーバ経由でシステムに転送された要求に対してサービス障害が発生すると、元の要求で識別される異常終了キューに障害応答メッセージが追加されます (TMQFORWARD に対して -d オプションが指定されたと見なされる)。
管理要求の処理中にサービス・エラーが発生すると、TA_STATUS という FML32 フィールドにエラーの内容を説明したテキストが設定され、TA_ERROR というFML32 フィールドにはエラーの原因 (下記参照) を示す値が設定されます。TA_BADFLD に設定される値は、下記の各エラーに関する説明のなかで示します。以下のエラー・コードは、いずれもマイナスであることが保証されています。
以下の診断コードは TA_ERROR で戻されるもので、管理要求が正常に完了したことを示します。これらのコードはマイナスでないことが保証されています。
相互運用性
FML32 インターフェイスへのアクセス、および BEA Tuxedo システムのアプリケーション管理に使用できるコンポーネント MIB へのアクセスは、BEA Tuxedo システム・リリース 4.2.2 以降のバージョンで可能です。汎用 MIB 属性を定義するヘッダ・ファイルおよびフィールド・テーブルは、BEA Tuxedo リリース 5.0 以降で利用できます。各コンポーネント MIB に固有の相互運用性の問題については、それぞれのリファレンス・ページで説明しています。
移植性
BEA Tuxedo システムの MIB を使用した管理作業をサポートするために必要な既存の FML32 および ATMI 関数、さらにこのリファレンス・ページに定義するヘッダ・ファイルとフィールド・テーブルは、すべてのサポート対象ネイティブ・プラットフォームとワークステーション・プラットフォームで使用可能です。
使用例
汎用 MIB 処理とのインターフェイスにおいて既存の API を使用する例については、前述の使用方法のセクションを参照してください。詳しい使用例については、各コンポーネント MIB のリファレンス・ページで実際のコンポーネント MIB のクラスや属性を使用して説明しています。
ファイル
${TUXDIR}/include/tpadm.h,
${TUXDIR}/udataobj/tpadm
関連項目
tpacall(3c), tpalloc(3c), tpcall(3c), tpdequeue(3c), tpenqueue(3c), tpgetrply(3c), tprealloc(3c), FML 関数の紹介, Fadd、Fadd32(3fml), Fchg、Fchg32(3fml), Ffind、Ffind32(3fml), AUTHSVR(5), TM_MIB(5), TMQFORWARD(5)
『BEA Tuxedo アプリケーションの設定』
『BEA Tuxedo アプリケーション実行時の管理』
『C 言語を使用した BEA Tuxedo アプリケーションのプログラミング』
『FML を使用した BEA Tuxedo アプリケーションのプログラミング』
nl_types(5)
名前
nl_types-ネイティブ言語データ型
形式
#include <nl_types.h>
機能説明
nl_types.h ヘッダ・ファイルには、以下の定義が含まれています。
関連項目
gencat(1)、catgets(3c)、catopen、catclose(3c)、nl_langinfo(3c)、langinfo(5)
servopts(5)
名前
servopts-サーバ・プロセスの実行時オプション
形式
AOUT CLOPT= [-A][-s{@filename|service[,service...][:func]}]
[-e stderr_file][-p [L][low_water][,[terminate_time]]
[:[high_water][,create_time]][-h][-l locktype][-n prio]
[-o stdout_file][-r][-t][ -- uargs][-v]
機能説明
servopts はコマンドではなく、BEA Tuxedo システムのサーバが認識する実行時オプションのリストです。
これらのオプションを使用するのは BEA Tuxedo システム提供のサーバ、または buildserver(1) コマンドによって作成されたアプリケーション提供のサーバです。
BEA Tuxedo システムでサーバを実行するには、アプリケーションのコンフィギュレーション・ファイルで指定したサーバ (およびその他のリソース) で機能するtmboot(1) コマンドと tmadmin(1) コマンドを使用します。servopts リストで選択したオプションは、コンフィギュレーション・ファイルのサーバに対して指定されます。認識されるオプションは以下のとおりです。
注記 UNIX プラットフォームのみ―alarm() システム・コールは、サーバ・プール管理下で実行しているサーバではうまく機能しません。アイドル状態のサーバを終了するコードでは alarm() 呼び出しを使用するため、Usignal() への呼び出しがエラーでない場合でも、ユーザが独自のシグナル・ハンドラを確立するために作成したコードは異常終了します。
注記 BEA Tuxedo 以降では、マルチスレッドまたは非 MSSQ の会話型サーバの自動生成に制限はありません。ただし、これらのサーバには自動廃棄機能は実装されません。
# サーバに組み込まれるサービスおよび対応ハンドラ関数のリスト
#
<servicename>:<functionname><NEWLINE>
<servicename>:<functionname><NEWLINE>
<servicename>:<functionname><NEWLINE>
.. . .
. . . .
# で始まる最初の 3 行はコメントです。その後の各行は、実行可能ファイルに組み込まれるサービス名とそれに対応する関数名を示しています。buildserver コマンド行に -s: functionname が指定されている場合、その行の servicename フィールドは空文字列にできます。functionname フィールドは必ず指定します。
注記 BEA Tuxedo システムの実行時には、各サーバのそれぞれのコマンド行に次のオプションが自動的に追加されます。
-c dom=domainid
-c オプションを使用すると、指定したドメイン ID を示すコメント行を、そのドメインに関連付けられたプロセスで通知されるすべてのコマンド出力 (たとえば ps コマンドの出力) に追加できます。複数のドメインを管理する管理者は、このコメントによって、複数のドメインを参照する単一の出力ストリームを理解しやすくなります。
使用例
UBBCONFIG(5) の使用例を参照してください。
関連項目
buildserver(1)、tmadmin(1)、tmboot(1)、txrpt(1)、tpsvrinit(3c)、UBBCONFIG(5)
『BEA Tuxedo アプリケーションの設定』
『BEA Tuxedo アプリケーション実行時の管理』
UNIX システム・リファレンス・マニュアルの nice(2)、plock(2)、getopt(3)
TM_MIB(5)
名前
TM_MIB-BEA Tuxedo システムの管理情報ベース
形式
#include <fml32.h>
#include <tpadm.h>
機能説明
BEA Tuxedo システムの MIB は、アプリケーションの基本的な側面を設定および管理するための一連のクラスを定義します。MIB を使用することで、マシン、サーバ、ネットワークなどを管理できます。
管理要求のフォーマットと管理応答の解釈を行うには、TM_MIB(5) を共通 MIB リファレンス・ページ MIB(5) と一緒に使用します。このリファレンス・ページで説明するクラスや属性を使用し、MIB(5) の説明に従ってフォーマットした要求を使用すると、アクティブなアプリケーションの既存の ATMI インターフェイスの 1 つを使用して管理サービスを要求できます。非アクティブなアプリケーションは、tpadmcall() 関数インターフェイスを使用して管理することもできます。TM_MIB(5) のすべてのクラス定義の追加情報については、TM_MIB(5) に関する追加情報を参照してください。
TM_MIB(5) は、次のクラスで構成されています。
各クラスの説明は、以下の 4 つのセクションで構成されています。
属性表の形式
以降のセクションでは、この MIB に含まれる各クラスが 4 つの部分に分けて定義されています。その 1 つが属性表です。属性表はクラス内の属性のリファレンス・ガイドであり、管理者、オペレータ、一般ユーザがそれらの属性を使用してアプリケーションと対話するための方法を説明しています。
属性表の各属性の説明には、5 つの列 (名前、タイプ、パーミッション、値、デフォルト) があります。各要素については、MIB(5) を参照してください。
TA_FLAGS 値
MIB(5) は、共通 TA_FLAGS 属性を定義します。この属性は long 型で、共通 MIB フラグ値とコンポーネント MIB 固有フラグ値の両方を持ちます。以下は、サポートされる TM_MIB(5) 固有フラグ値です。これらのフラグ値は、共通 MIB フラグと一緒に使用する必要があります。
FML32 フィールド・テーブル
このリファレンス・ページで説明する属性のフィールド・テーブルは、システムにインストールした BEA Tuxedo システム・ソフトウェアのルート・ディレクトリからの相対パスで指定される udataobj/tpadm ファイルにあります。${TUXDIR}/udataobj ディレクトリは、FLDTBLDIR 環境変数で指定されるコロン区切りのリストにアプリケーションによって追加される必要があり、フィールド・テーブル名 tpadm は、FIELDTBLS 環境変数で指定されるカンマ区切りのリストに追加される必要があります。
制限事項
この MIB のヘッダ・ファイルとフィールド・テーブルには、BEA Tuxedo リリース 6.1 以降のサイト (ネイティブとワークステーションの両方) からのみアクセスできます。
ワークステーションによるこのMIB へのアクセスは、実行時のみのアクセスに制限されており、関数 tpadmcall(3c) はワークステーションではサポートされません。
プレイメージ処理 (MIB_PREIMAGE フラグ・ビットのセット) を目的として、グローバル属性を持つクラスのローカル属性が考慮されることはありません。また、インデックス付きのフィールド、およびそれらのフィールドとともに送出されるインデックスも考慮されません (たとえば、T_TLOG クラス、TA_TLOGCOUNT、TA_TLOGINDEX、TA_GRPNO、TA_TLOGDATA など)。
![]() |
![]() |
![]() |
![]() |
||
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |