dc_tam_read

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;

●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…排他をしません。

  排他しないでdc_tam_read 関数を呼び出した場合，dc_tam_read関数の処理中にほかのUAPから該当するTAMレコードが更新されることがあります。この場合，dc_tam_read関数で入力するレコードの内容は，ほかのUAPでの更新処理の状態（コミット処理が完了するタイミング）に依存します。したがって，UAP間でデータの整合性をとるためには，必ずDCTAM_EXCLUSIVEを指定してください。DCTAM_NOEXCLUSIVEは，参照型のTAMテーブルの場合や，同一のTAMレコードに対して業務処理全体として参照と更新が競合する可能性がない場合に使用します。

• フラグ4

  排他解除待ち種別も重複して設定できません。このフラグの設定を省略した場合は，DCTAM_NOWAITが仮定されます。

  DCTAM_WAIT…排他解除待ちをします。

  DCTAM_NOWAIT…待たないで，エラーリターンします。

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