function
Library: Database access (OMDB)
Import : omdb.xmd |
Returns: A boolean value which is TRUE if there is another parameter to be streamed in and FALSE otherwise. |
define external switch function db.prepare modifiable db.field insert-handle
Argument definitions
Use db.prepare to fetch the next parameter to be inserted. It returns FALSE if all parameters have been inserted, otherwise it returns TRUE.
insert-handle must be the db.field passed as the "using" parameter to the previous db.streaming-execute call.
This function is to be called repeatedly after db.streaming-execute until it returns FALSE. Each time it returns TRUE, it sets the key of insert-handle to the name of the parameter being requested, where the first parameter from the left is "1", the second is "2", and so on.
Be sure to keep calling this function until it returns FALSE since the parameters can be requested out of order by the database driver. In addition, this function performs final processing after the final parameter has been streamed in.
See the usage notes for db.streaming-execute
for further details and examples.