TAMテーブルの状態の取得

ANSI C ，C++の形式

 
#include <dctam.h>
int  dc_tam_get_inf(char *tblname,DCLONG flags)
 

K&R版 C の形式

 
#include <dctam.h>
int dc_tam_get_inf(tblname,flags)
char      *tblname;
DCLONG    flags;
 

TAMテーブルの状態を取得します。取得するTAMテーブルの状態を次に示します。

• オープン状態
• クローズ状態
• 論理閉塞状態
• 障害閉塞状態

dc_tam_get_inf関数は，トランザクション内でもトランザクション外でも呼び出せます。

dc_tam_get_inf関数を呼び出したプロセスでdc_tam_open関数を呼び出していなくても，設定したTAMテーブルにほかのプロセスでdc_tam_open関数を呼び出している場合は，TAMテーブルはオープン状態としてリターンします。

●tblname

状態を取得するTAMテーブル名のアドレスを設定します。TAMテーブル名は32文字以内で設定して，文字列の最後にはヌル文字を付けてください。

●flags

DCNOFLAGSを設定します。

リターン値が正の値のとき（TAMテーブルの状態を示します）

リターン値	リターン値（数値）	意味
DCTAM_STS_OPN	1	オープン状態であることを示します。
DCTAM_STS_CLS	2	クローズ状態であることを示します。
DCTAM_STS_LHLD	3	論理閉塞状態であることを示します。
DCTAM_STS_OHLD	4	障害閉塞状態であることを示します。

リターン値が負の値のとき（エラーが起こったことを示します）

リターン値	リターン値（数値）	意味
DCTAMER_PARAM_TBL	-1701	tblnameに設定した値が間違っています。
DCTAMER_PARAM_FLG	-1708	flagsに設定した値が間違っています。
DCTAMER_UNDEF	-1710	TAMテーブルが定義されていません。
DCTAMER_TAMEND	-1720	TAMサービスが終了中です。
DCTAMER_PROTO	-1721	TAMテーブルへアクセスする順序が間違っています。
		UAPにリンケージしているトランザクション制御用オブジェクトファイルのリソースマネジャ登録が間違っています。 または，UAPにトランザクション制御用オブジェクトファイルをリンケージしていません。
		関数を呼び出したUAPのユーザサービス定義に，トランザクション属性なし（atomic_update=N）を指定しています。
DOTAMER_TAMVR	-1762	UAPが，現在稼働しているTAMサービスでは動作できないバージョンのTAMライブラリと結合されています。
DCTAMER_NO_ACL	-1772	アクセスしようとしたTAMファイルは，セキュリティ機能で保護されています。該当するファイルに対するACLがありません。
DCTAMER_ACCESS	-1773	アクセスしようとしたTAMファイルは，セキュリティ機能で保護されています。dc_tam_get_inf関数を呼び出したUAPには，アクセス権限がありません。