FairCom ISAM for C

PutDODA

Store information from a record schema as a resource.

Short Name

PUTDODA()

Type

Low-Level data file resource function

Declaration

COUNT PUTDODA(FILNO datno, pDATOBJ doda, UCOUNT numfld)

Description

In V12 the file number typedef was formally changed from COUNT, a two-byte value to FILNO, a four-byte value. Refer to this link for compatibility details. Four Byte File Numbering

PutDODA() assigns the contents of a data object definition array (DODA) to data file. The DODA is converted into a schema map and schema names as described in Record Schemas of the c-tree Programmer’s Reference Guide.

datno is the data file number to assign the DODA to.
doda points to the beginning of the DODA (i.e., the array of DATOBJ’s). The DATOBJ is discussed in Record Schemas of the c-tree Programmer’s Reference Guide.
The numfld parameter indicates how many data fields (number of elements) are contained in the DODA.

Return

Value	Symbolic Constant	Explanation
0	NO_ERROR	Success
48	FMOD_ERR	Only valid for data files.
62	LERR_ERR	The file must be opened exclusively.
401	RNON_ERR	Resources not enabled.
448	DEFP_ERR	File definition permission denied.

See c-tree Error Codes for a complete listing of valid c-tree error values.

Limitations

The file must be opened in ctEXCLUSIVE mode.

Resources must be enabled for the data file.