Language Environment Interface Reference

dtw_getNextRow()

The dtw_getNextRow() interface function retrieves input for row-at-a-time processing of Net.Data tables. It is called each time the DTW_LE_CONTINUE flag is set, indicating that another row of data needs to be processed for the table. Use dtw_getNextRow() for database language environments.

Restriction: This interface function is only called if Net.Data is running on the OS/400 or OS/390 operating systems.

Net.Data calls dtw_getNextRow() when the following conditions are met:

• The call to the language environment's dtw_execute() call completes successfully (return value of zero)
• The dtw_execute() interface function has set the DTW_LE_CONTINUE flag in the dtw_lei_t structure.

When the dtw_execute() function sets the DTW_LE_CONTINUE flag to on, Net.Data performs the following steps:

1. Processes the message block for the return value of the dtw_execute() interface function.
2. Calls language environment's dtw_getNextRow() interface function and begins row-at-a-time processing.
3. Processes the report block.
4. Processes the message block for the return value of the dtw_getNextRow() interface function.
5. Determines whether dtw_getNextRow() has turned on the DTW_LE_CONTINUE flag:
   • If yes, processing continues with the dtw_getNextRow() interface function in step 2.
   • If no, row-at-a-time processing ends and Net.Data continues processing the Net.Data macro.

When dtw_getNextRow() is called, the row field in the dtw_lei_t structure is set to point to a row object. To manipulate the row object, use the Net.Data utility functions, dtw_row_SetCols() and dtw_row_SetV(). Net.Data assumes that after the first call to the dtw_getNextRow() interface function the row object contains the column headings for the table. Subsequent calls contain the actual table data.

The dtw_getNextRow() function continues to get called (unless message block processing indicates otherwise) as long as the DTW_LE_CONTINUE flag is set.