dc_tam_read_cancel

名称

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

UAPで値を設定する引数

●tblid

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

●keyadr

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

struct DC_TAMKEY {
                 char *keyname;
                 };

●keyno

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

●flag

DCNOFLAGSを設定します。

リターン値

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