PutDODA

Store information from a record schema as a resource.

Short Name

PUTDODA()

Type

Low-level data file resource function

Declaration

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

Description

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 Plus 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 Plus 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
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 Plus Error Codes for a complete listing of valid c-tree Plus error values.

Limitations

The file must be opened in ctEXCLUSIVE mode.

Resources must be enabled for the data file.