TAMテーブルからレコードの入力

ANSI C，C++の形式

 
#include <dctam.h>
int  dc_tam_read(DCLONG tblid,struct DC_TAMKEY *keyadr,
                 int keyno,
                 char *bufadr,int bufsize,DCLONG flags)
 

K&R版 C の形式

 
#include <dctam.h>
int dc_tam_read(tblid,keyadr,keyno,bufadr,bufsize,flags)
DCLONG           tblid;
struct DC_TAMKEY *keyadr;
int              keyno;
char             *bufadr;
int              bufsize;
DCLONG           flags;
 

flagsに設定した検索種別に従って，TAMテーブル上のレコードを参照または更新の目的で入力します。検索種別とインデクス種別の関係を次の表に示します。

表2-3　検索種別とインデクス種別の関係

注※

インデクス種別がハッシュで，TAMテーブルファイルの初期作成時に，データ部にキー値を付けている（tamcreコマンドに-sオプションを設定していない）場合，先頭検索とNEXT検索を使って，TAMテーブル上の全レコードを検索できます。

参照目的の入力で排他を掛ける場合，参照排他でテーブル排他とレコード排他を確保します。レコード排他でオープンしたTAMテーブルを更新目的で入力する場合は，参照排他でテーブル排他を確保し，更新排他でレコード排他を確保します。

dc_tam_read関数がエラーリターンした場合は，この関数内で設定した資源はすべて解放して，関数を呼び出す前の状態に戻ります。ただし，関数を呼び出す前に参照排他で確保されていたレコードを更新目的で入力した場合は，更新排他となり参照排他には戻りません。また，エラーリターンした場合には，バッファの内容は保証できません。

複数のレコードを設定して入力する場合，それらのレコードのうち一つでもエラーが発生したときは，この関数で設定した全レコードの処理をエラーとします。

●tblid

レコードを入力するTAMテーブルの，テーブル記述子を設定します。テーブル記述子はdc_tam_open関数で返された値です。

●keyadr

レコードを検索するための，キー値のアドレスを持つ構造体のアドレスを設定します。構造体の形式は次のとおりです。

 
struct DC_TAMKEY {
                  char  *keyname;
                  };
 

• keyname
  キー値のアドレスを設定します。キー値は入力するレコードのキー領域の長さで設定します。
  

●keyno

要求レコード数（keyadrで設定する構造体の数）を設定します。

●bufadr

レコードを入力するバッファのアドレスを設定します。

●bufsize

レコードを入力するバッファの長さを設定します。バッファ長は（レコード長×要求レコード数）以上にします。

●flags

レコードの検索種別，アクセス種別，参照目的の排他のときの排他要否種別を設定します。また，排他を掛ける場合に，資源の競合が起こったときの排他解除待ち種別を設定します。

 
{フラグ1}|{DCTAM_REFERENCE〔|{DCTAM_EXCLUSIVE|DCTAM_NOEXCLUSIVE}〕|DCTAM_MODIFY}〔|{DCTAM_WAIT|DCTAM_NOWAIT}〕
 

• フラグ1
  フラグ1には，次のレコードの検索種別のうちどれか一つを指定してください。
  レコードの検索種別の設定は省略できません。また，検索種別は重複して設定できません。
  

  DCTAM_EQLSRC…'キー値＝'を検索する（ハッシュ，ツリー）。

  DCTAM_GRTEQLSRC…'キー値＜＝'を検索する（ツリー）。

  DCTAM_GRTSRC…'キー値＜'を検索する（ツリー）。

  DCTAM_LSSEQLSRC…'キー値＞＝'を検索する（ツリー）。

  DCTAM_LSSSRC…'キー値＞'を検索する（ツリー）。

  DCTAM_FIRSTSRC…先頭から検索する（ハッシュ）。

  DCTAM_NEXTSRC…設定したキー値の，次のレコードから検索する（ハッシュ）。

• フラグ2
  レコードのアクセス種別の設定も省略できません。また，アクセス種別も重複して設定できません。
  DCTAM_REFERENCE…参照目的の排他
  DCTAM_MODIFY…更新目的の排他
  
• フラグ3
  参照目的の排他の場合は，排他するかどうかを設定します。排他要否種別は重複して設定できません。このフラグの設定を省略した場合は，DCTAM_NOEXCLUSIVEが仮定されます。
  DCTAM_EXCLUSIVE…排他します。
  DCTAM_NOEXCLUSIVE…排他をしません。
  
• フラグ4
  排他解除待ち種別も重複して設定できません。このフラグの設定を省略した場合は，DCTAM_NOWAITが仮定されます。
  DCTAM_WAIT…排他解除待ちをします。
  DCTAM_NOWAIT…待たないで，エラーリターンします。
  

flagsに設定する値と，設定内容について次に示します。

EQLSRC
GRTEQLSRC
GRTSRC
LSSEQLSRC
LSSSRC
FIRSTSRC
NEXTSRC

REFERENCE

EXCLUSIVE

WAIT

NOWAIT

NOEXCLUSIVE

MODIFY

WAIT

NOWAIT

（凡例）

×：設定できません。

−：常にEXCLUSIVEを設定します。NOEXCLUSIVEは設定できません。

注※1

省略した場合は，NOEXCLUSIVEが仮定されます。

注※2

省略した場合は，NOWAITが仮定されます。