Row and field level functions

The basic theory of operation is that each table consists of a number of fields. The table structure holds within it one row of data. Each getdbtblrow() call will overwrite that data, and each putdbtblrow() call writes that data out. A call to dbnametofld() returns a pointer to a structure containing information about one field.

Each field has a certain amount of information associated with it. A call to getfld() returns a pointer to the data storage area of the field. Subsequent calls to getdbtblrow() or putfld() may overwrite this area, or create a new area. The previous data is lost, so if you want to keep the data around longer you need to make a copy of it.

Putfld() takes a pointer to the data to be written out. This data must remain valid until putdbtblrow() is called. It is the responsibility of the calling program to free the data if needed.

• getdbtblrow() - Reads the next row in from a table.
• putdbtblrow() - Writes the current row in the table.
• recidvalid() - determine if a RECID pointer is valid
• getfld() - get a value from a field
• putfld() - put a value into a field.
• putdd() - adds a new field to an existing DD.
• dbnametofld() - Get a field from a DBTBL.
• getcounter() - Get a valid counter value