ANSI C, C++

#include <dctam.h>
int  dc_tam_write (DCLONG tblid, struct DC_TAMKEY *keyadr,
                   int keyno, char *datadr, int datsize,
                   DCLONG flags)

K&R C

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

The function dc_tam_write() updates/adds a record indicated with a key value in/to a TAM table.

If a TAM table is open under lock in records, the following lock is enabled:

• When the access type is "update" (DCTAM_WRITE specified for flags):
  Lock in tables is enabled with lock for reference processing, and lock in records is enabled with lock for update processing.
  However, table lock is not enabled for tables whose access type is "reference" or "update without permission of addition or deletion" if "table nonlock mode" is specified as the "table lock mode for access" in the TAM service definition.
  
• When the access type is "update or addition" or "addition" (DCTAM_WRTADD or DCTAM_ADD specified for flags):
  Lock in tables is enabled with lock for update processing.
  

If the function dc_tam_write() returns with an error, all the resources specified within this function are released, and the status before this function was called is regained. However, if a TAM table which was acquired under lock for reference processing before this function was called is updated/added, lock for update processing is enabled. (Lock for reference processing is not regained.)

When a request is made to update/add multiple specified records, even if one of the records causes an error, the processing of all the records specified in this function results in an error.

The key value storage location in the data to be updated/added and the key area length are as specified in the tamcre command used for creation of a TAM table file.

The data part has a key value if the key value is assigned to the data part (the -s option not specified in the tamcre command) when a TAM table file is created. Therefore, an error is returned if the key value specified in the function dc_tam_write() is not found in the data to be updated/added. The data part has no key value if no key value is assigned to the data part (the -s option specified in the tamcre command). In this case, no check is made on the contents of the data to be updated/added.

tblid

Specify the table descriptor of the TAM table whose record is to be updated/added. 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 to be updated/added. 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 to be updated/added.
  

keyno

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

datadr

Specify the address of the data to be updated/added.

datsize

Specify the length of the data to be updated/added. The length of the data to be updated/added must be equal to or greater than (record length x number of request records).

flags

Specify in the format shown below the record access type and the lock release wait type when competition for a resource occurs:

{DCTAM_WRITE|DCTAM_WRTADD|DCTAM_ADD}[|{DCTAM_WAIT|DCTAM_NOWAIT}]

• Flag 1
  The specification of record access type cannot be omitted. More than one record access type cannot be specified at a time.
  DCTAM_WRITE: Update
  DCTAM_WRTADD: Update or addition
  DCTAM_ADD: Addition
  
• Flag 2
  More than one lock release wait type cannot be specified at a time. The default is DCTAM_NOWAIT.
  DCTAM_WAIT: The function waits for the resource to be released from lock.
  DCTAM_NOWAIT: The function does not wait for the resource to be released from lock, and returns with an error.