Entering content frame

 Scrolling Through a Database File 

Use

You are requesting the rest of the content of an opened database file. Use the <file_handle> displayed by the system when you open the database file.

Prerequisites

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

You have the DBM operator authorization DBFileRead.

You have determined the file ID of the file (Creating a List of the Database Files).

Syntax

file_getnext <file_id> <file_handle>

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.

 

Leaving content frame