Guida di riferimento per l'interfaccia per l'ambiente di linguaggio

dtw_getNextRow()

La funzione di interfaccia dtw_getNextRow() richiama l'immissione per una elaborazione una riga per volta delle tabelle di Net.Data. Essa viene richiamata ogni volta che viene impostato l'indicatore DTW_LE_CONTINUE, che indica che è necessario elaborare un'altra riga di dati per la tabella. Utilizzare dtw_getNextRow() per gli ambienti di linguaggio del database.

Limitazione: Questa interfaccia viene richiamata solo se Net.Data è in esecuzione sui sistemi operativi OS/400 o OS/390.

Net.Data chiama dtw_getNextRow() quando si verificano le seguenti condizioni:

Quando la funzione dtw_execute() imposta su on l'indicatore DTW_LE_CONTINUE, Net.Data segue questa procedura:

  1. Elabora il blocco dei messaggi per il valore di ritorno della funzione di interfaccia dtw_execute().

  2. Chiama la funzione di interfaccia dtw_getNextRow() dell'ambiente di linguaggio ed avvia l'elaborazione di una riga per volta.

  3. Elabora il blocco del prospetto.

  4. Elabora il blocco dei messaggi per il valore di ritorno della funzione di interfaccia dtw_getNextRow().

  5. Stabilisce se dtw_getNextRow() ha attivato l'indicatore DTW_LE_CONTINUE:

Quando viene chiamato dtw_getNextRow(), il campo della riga nella struttura dtw_lei_t structure viene impostato per indicare un oggetto riga. Per gestire l'oggetto riga, utilizzare i programmi di utilità di Net.Data, dtw_row_SetCols() e dtw_row_SetV(). Dopo la prima chiamata alla funzione di interfaccia dtw_getNextRow() l'oggetto riga contiene le intestazioni della colonna per la tabella. Le chiamate successive contengono i dati della tabella.

La funzione dtw_getNextRow() continua ad esser chiamata (a meno che l'elaborazione del blocco dei messaggi non indichi il contrario) fino a che rimane impostato l'indicatore DTW_LE_CONTINUE.


[ Inizio pagina | Pagina precedente | Pagina successiva | Indice | Indice analitico ]