Scrolling Through a Database File 

Use

You request output of the rest of the content of an opened database file. Use the <file_handle> output by the system when you were opening the database file.

Prerequisites

You have opened a database file. Keyword CONTINUE in the reply shows that you have not yet read the whole file.

You have the DBM operator authorization DBFileRead.

Syntax

file_getnext <file_id> <file_handle>

Options for <file_id>

see: Database Files

Reply

Output in ASCII Mode

OK<NL>
[CONTINUE|END]<NL>
<file_length>:20<data_length>:20<NL>
<data><NL>
<data><NL>
...

Output in Binary Mode

OK<NL>
[CONTINUE|END]<NL>
<file_length><data_length><NL>
<data><NL>

Values for the individual fields of the reply

END

Contents of the file have been completely transferred, file is automatically closed

CONTINUE

File has additional entries that have not been transferred due to the limited size of the reply memory. Call these by entering the command used above again

<file_length>

File length

<data_length>

Data length

<data>

Data value

The total length of file is not determined again and is therefore set to 0.