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;

The function dc_tam_read_cancel() cancels the input for reference or update processing with lock specified in the function dc_tam_read(), and resets lock in records.

For an updated or added record, the input for reference processing with lock specified cannot be canceled. For a record updated by the function dc_tam_rewrite(), the input for update processing cannot also be canceled.

If the input for update processing is canceled for updated/added records or for the records of a TAM table open under lock in tables, lock is not reset.

After the function dc_tam_read_cancel() cancels input, other transactions are not allowed to add/delete a record to/from the input TAM table until the transaction terminates.

If the function dc_tam_read_cancel() returns with an error, all the resources acquired within this function are released, and the status before this function was called is regained. When a request is made to access multiple specified records, even if one of the records causes an error, processing is stopped and an error is returned.

tblid

Specify the table descriptor of the TAM table whose record input is to be canceled. The table descriptor is the value returned with the function dc_tam_open().

keyadr

Specify the address of the structure having the address of the key value of the record whose input is to be canceled. The structure format is as follows:

struct DC_TAMKEY {
                  char *keyname;
                 };

• keyname
  Specify the address of the key value. The key value must be specified with the length of the key area of the record whose input is to be canceled.
  

keyno

Specify the number of request records (number of structures specified for keyadr).

flags

Specify DCNOFLAGS.