TAMテーブルのレコードの入力取り消し

ANSI C ，C++の形式

 
#include <dctam.h>
int  dc_tam_read_cancel(DCLONG tblid,struct DC_TAMKEY *keyadr,
                        int keyno,DCLONG flags)
 

K&R版 C の形式

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

トランザクション内で，dc_tam_read関数を使って排他を掛けた参照目的の入力，および更新目的の入力を取り消し，レコード排他を解除します。

更新，または追加済みのレコードには，排他を掛けた参照目的の入力を取り消すことはできません。また，dc_tam_rewrite関数で更新したレコードの，更新目的の入力の取り消しはできません。

更新，または追加済みのレコード，およびテーブル排他でオープンした，TAMテーブル上のレコードに対する更新目的の入力の取り消しでは，排他を解除しません。

dc_tam_read_cancel関数で入力を取り消したあとも，トランザクションが終了するまでは，入力したTAMテーブルに対して，ほかのトランザクションからレコードの追加，削除はできません。

dc_tam_read_cancel関数がエラーリターンした場合，この関数で解放した資源は再確保しないで，関数を呼び出す前の状態には戻しません。また，複数のレコードを設定してアクセスを要求した場合，それらのレコードのうち，一つでもエラーが発生したら処理を中断して，エラーリターンします。

●tblid

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

●keyadr

入力を取り消すレコードの，キー値のアドレスを持つ構造体のアドレスを設定します。構造体の形式は次のとおりです。

 
struct DC_TAMKEY {
                  char *keyname;
                  };
 

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

●keyno

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

●flag

DCNOFLAGSを設定します。

リターン値	リターン値（数値）	意味
DC_OK	0	TAMテーブルのレコードの検索を取り消して，レコード排他を正常に解除しました。
DCTAMER_PARAM_TID	-1700	tblidに設定したテーブル記述子が間違っています。
DCTAMER_PARAM_KEY	-1702	keyadrに設定したキー値が間違っています。
DCTAMER_PARAM_KNO	-1703	keynoに設定した値が間違っています。
DCTAMER_PARAM_FLG	-1708	flagsに設定した値が間違っています。
DCTAMER_NOTTAM	-1709	tblidに設定したテーブルはTAMテーブルではありません。
DCTAMER_TAMEND	-1720	TAMサービスが終了中です。
DCTAMER_PROTO	-1721	TAMテーブルへアクセスする順序が間違っています。
		UAPにリンケージしているトランザクション制御用オブジェクトファイルのリソースマネジャ登録が間違っています。 または，UAPにトランザクション制御用オブジェクトファイルをリンケージしていません。
		関数を呼び出したUAPのユーザサービス定義に，トランザクション属性なし（atomic_update=N）を指定しています。
DCTAMER_RMTBL	-1723	TAMテーブルが削除されています。
DCTAMER_NOLOAD	-1724	TAMテーブルがロードされていません。
DCTAMER_NOOPEN	-1726	TAMテーブルがオープン状態ではありません。
DCTAMER_LOGHLD	-1727	TAMテーブルが論理閉塞状態です。
DCTAMER_OBSHLD	-1728	TAMテーブルが障害閉塞状態です。
DCTAMER_NOREC	-1731	指定されたレコードは存在しません。
DCTAMER_SEQENCE	-1732	dc_tam_read関数を呼び出していません。
DCTAMER_EXWRITE	-1733	tblidに設定したテーブル記述子はdc_tam_write関数で更新または追加したレコードです。
DCTAMER_EXREWRT	-1734	tblidに設定したテーブル記述子は，すでにdc_tam_rewrite関数で更新済みです。
DCTAMER_TBLVR	-1760	UAPが，現在稼働しているTAMテーブルでは動作できないバージョンのTAMライブラリと結合されています。
DCTAMER_FLSVR	-1761	UAPが，現在稼働しているOpenTP1ファイルサービスでは動作できないバージョンのTAMライブラリと結合されています。
DCTAMER_TRNNUM	-1765	TAMサービスで管理できるトランザクション数を超えました。
DCTAMER_OPENNUM	-1766	キャラクタ型スペシャルファイルのオープン数の制限値を超えました。
DCTAMER_ACCESSS	-1767	スペシャルファイルに対するアクセス権がありません。
DCTAMER_ACCESSF	-1768	TAMテーブルファイルに対するアクセス権がありません。
DCTAMER_MEMORY	-1769	メモリが不足しました。
DCTAMER_IO	-1770	入出力エラーが起こりました。
DCTAMER_TMERR	-1771	トランザクションサービスでエラーが起こりました。