ddlPutRec() - write record to database

ddlPutRec() - write record to database ddlPutRec() - write record to database

Prototype:

   void ddlPutRec(
      CONTROL *ctl,
      char *OptnStr,
      char *ArgList,
      char *Image);

Permitted values in OptnStr:

   /R - do not clear target collection before storing record number
   /S - write without structure

Form of ArgList:
[<cx>] <dgname> <rdname> [<piPathName>]

Form of Image:
Image must reflect exactly the record described by <rdname>.

Description:

Creates a new record in the open database. The contents of the record are contained in a record image whose form is described by the record description <rdname>.

The record image must be initialized to ASCII blanks for X() data types, to ASCII zeros for N() data types, and to binary zeros for binary data types. This can be done easily with the ddlInitRec() function.

Beginning with TB API 8.0.155, if an IDENTITY field is included in the RD, the generated value is returned to <Image>.

X() and N() data types should never contain binary zeros.

ddlPutRec() does not support data type TEXT.

When an external RD in specified [by (piPathName)], the RD is automatically cached for possible future use.

Values returned in Control Structure:

Control.Ans1	1 - record written successfully
Control.Ans2	record number of new record