dc_tam_status

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;

●tblname

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

●stbuf

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

●flags

DCNOFLAGSを設定します。

●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];
                    };

• st_file_name

  TAMファイル名が返されます。

• st_tbl_stat

  TAMテーブルの状態が，次に示す値のどれかで返されます。

  DCTAM_STS_OPN…オープン状態であることを示します。

  DCTAM_STS_CLS…クローズ状態であることを示します。

  DCTAM_STS_LHLD…論理閉塞状態であることを示します。

  DCTAM_STS_OHLD…障害閉塞状態であることを示します。

• st_rec_usenum

  TAMテーブルで現在使っているレコードの数が返されます。ただし，dc_tam_status関数を呼び出したあとでレコードの追加や削除があった場合は，値を保証しません。

• st_rec_maxnum

  TAMテーブルの最大レコード数が返されます。

• st_idx_type

  TAMテーブルのインデクス種別が，次に示す値のどれかで返されます。

  DCTAM_STS_HASH…ハッシュ形式であることを示します。

  DCTAM_STS_TREE…ツリー形式であることを示します。

• st_acs_type

  TAMテーブルのアクセス形態が，次に示す値のどれかで返されます。

  DCTAM_STS_READ…参照型であることを示します。

  DCTAM_STS_REWRITE…追加・削除できない更新型であることを示します。

  DCTAM_STS_WRITE…追加・削除できる更新型であることを示します。

  DCTAM_STS_RECLCK…テーブル排他を確保しない，追加・削除できる更新型であることを示します。

• st_lod_type

  TAMテーブルのローディング契機が，次に示す値のどれかで返されます。

  DCTAM_STS_START…TAMサービスの開始時であることを示します。

  DCTAM_STS_LIB…dc_tam_open関数でTAMテーブルをオープンしたときであることを示します。

  DCTAM_STS_CMD…tamloadコマンドを実行したときであることを示します。

• reserve1

  予備の領域です。

• st_rec_len

  TAMテーブルのレコード長が返されます。

• st_key_len

  TAMテーブルのキー長が返されます。

• st_key_pos

  TAMテーブルのデータ内のキー開始位置が返されます。

• st_tbl_sec

  TAMサービス定義で指定したTAMテーブルのセキュリティ属性が，次に示す値のどれかで返されます。

  DCTAM_STS_NOSEC…セキュリティの指定がないことを示します。

  DCTAM_STS_SEC…セキュリティの指定があることを示します。

• reserve2

  予備の領域です。