dc_tam_status

名称

TAMテーブルの情報の取得

形式

ANSI C ,C++の形式

#include <dctam.h>
int  dc_tam_status(char *tblname,struct DC_TAMSTAT *stbuf,
                  DCLONG  flags)

K&R版 C の形式

#include <dctam.h>
int  dc_tam_status(tblname,stbuf,flags)
char       *tblname;
struct  DC_TAMSTAT  *stbuf;
DCLONG     flags;

機能

TAMテーブルの情報を,DC_TAMSTAT構造体に返します。リターンする値を次に示します。

UAPで値を設定する引数

●tblname

情報を取得するTAMテーブル名を設定します。TAMテーブル名は,32文字以内で設定します。文字列の最後にはヌル文字を付けてください。

●stbuf

TAMテーブルの情報を受け取る構造体 DC_TAMSTAT のアドレスを設定します。構造体には,dc_tam_status関数に設定したTAMテーブルの状態が返されます。

●flags

DCNOFLAGSを設定します。

OpenTP1から値が返される引数

●stbuf

TAMテーブルの情報が,構造体 DC_TAMSTAT で返されます。構造体の形式は次のとおりです。

struct  DC_TAMSTAT {
                   char    st_file_name[64];
                   DCLONG  st_tbl_stat;
                   DCLONG  st_rec_usenum;
                   DCLONG  st_rec_maxnum;
                   char    st_idx_type;
                   char    st_acs_type;
                   char    st_lod_type;
                   char    reserve1;
                   DCLONG  st_rec_len;
                   DCLONG  st_key_len;
                   DCLONG  st_key_pos;
                   DCLONG  st_tbl_sec;
                   DCLONG  reserve2[8];
                   };

リターン値

リターン値リターン値(数値)意味
DC_OK0TAMテーブルの情報を正常に取得しました。
DCTAMER_PARAM_TBL-1701tblnameに設定した値が間違っています。
DCTAMER_PARAM_FLG-1708flagsに設定した値が間違っています。
DCTAMER_NOTTAM-1709tblnameに設定した名称は,TAMテーブルではありません。
DCTAMER_UNDEF-1710TAMテーブルが定義されていません。
DCTAMER_TAMEND-1720TAMサービスが終了中です。
DCTAMER_PROTO-1721TAMテーブルへアクセスする順序が間違っています。
UAPにリンケージしているトランザクション制御用オブジェクトファイルのリソースマネジャ登録が間違っています。または,UAPにトランザクション制御用オブジェクトファイルをリンケージしていません。
関数を呼び出したUAPのユーザサービス定義に,トランザクション属性なし(atomic_update=N)を指定しています。
DCTAMER_TBLVR-1760UAPが,現在稼働しているTAMテーブルでは動作できないバージョンのTAMライブラリと結合されています。
DCTAMER_TAMVR-1762UAPが,現在稼働しているTAMサービスでは動作できないバージョンのTAMライブラリと結合されています。
DCTAMER_OPENNUM-1766キャラクタ型スペシャルファイルのオープン数の制限値を超えました。
DCTAMER_ACCESSS-1767スペシャルファイルに対するアクセス権がありません。
DCTAMER_MEMORY-1769メモリが不足しました。
DCTAMER_IO-1770入出力エラーが起こりました。
DCTAMER_NO_ACL-1772情報を取得しようとしたTAMテーブルは,セキュリティ機能で保護されています。該当するTAMテーブルに対するACLがありません。
DCTAMER_ACCESS-1773情報を取得しようとしたTAMテーブルは,セキュリティ機能で保護されています。dc_tam_status関数を呼び出したUAPには,アクセス権限がありません。