名前

tpadmcall()−ブートされていないアプリケーションの管理

形式

#include <atmi.h> 
#include <fml32.h> 
#include <tpadm.h> 
 
int tpadmcall(FBFR32 *inbuf, FBFR32 **outbuf, long flags) 

機能説明

tpadmcall() は、ブートされていないアプリケーションの属性の検索と更新に使用します。また、アクティブなアプリケーションで、限られた属性の集合を直接検索することもできます。この場合、外部プロセスとの通信は必要ありません。この関数は、システム提供のインターフェイス・ルーチンを使用してシステムのコンフィギュレーションと管理が完全に行えるような十分な機能を提供します。

inbuf には、tpalloc() によって以前に割り当てた、希望する管理操作とそのパラメータが入っている FML32 バッファへのポインタを指定します。

outbuf には、結果を入れる FML32 バッファへのポインタのアドレスを指定します。outbuf は、元々 tpalloc() によって割り当てられた FML32 バッファを指していなければなりません。送信と受信に同じバッファを使用する場合は、outbuf には inbuf のアドレスを指定してください。

現在 tpadmcall() の最後の引数の flags は将来の使用のために予約されているため、0 に設定しなければなりません。

tpadmcall() は次の4つのモードで呼び出すことができます。

これらのインターフェイス・ルーチンを使用したバイナリの BEA Tuxedo ATMI システム・アプリケーション・コンフィギュレーション・ファイルに対するアクセスおよび更新は、ディレクトリ名やファイル名に関する UNIX システムのパーミッションによって制御されます。

マルチスレッドのアプリケーションの場合、TPINVALIDCONTEXT 状態のスレッドは tpadmcall() の呼び出しを発行できません。

環境変数

このルーチンを呼び出す前に、次の環境変数を設定する必要があります。

注意事項

tpadmcall() を使用する場合、GET 要求における TA_OCCURS 属性の使用はサポートされていません。tpadmcall() を使用する場合、GETNEXT 要求はサポートされていません。

戻り値

tpadmcall() は成功すると 0 を、失敗すると -1 を返します。

エラー

異常終了時には、tpadmcall() は tperrno を次のいずれかの値に設定します。

相互運用性

このインターフェイスは、ローカルなコンフィギュレーション・ファイルおよび掲示板に対するアクセスおよび更新しかサポートしていません。したがって、相互運用性の問題はありません。

移植性

このインターフェイスは、BEA Tuxedo ATMI リリース 5.0 またはそれ以降が稼動する UNIX System のサイトでしか利用できません。

ファイル

${TUXDIR}/lib/libtmib.a、 ${TUXDIR}/lib/libqm.a、${TUXDIR}/lib/libtmib.so.<rel>、${TUXDIR}/lib/libqm.so.<rel>、${TUXDIR}/lib/libtmib.lib、${TUXDIR}/lib/libqm.lib

buildclient を使用する場合は、ライブラリを手動でリンクする必要があります。この場合、-L${TUXDIR}/lib -ltmid -lqm を指定します。

関連項目