IBM Books

Net.Data: riferimenti all'ambiente di linguaggio


Funzioni di interfaccia dell'ambiente di linguaggio

Net.Data utilizza quattro funzioni di interfaccia con un ambiente di linguaggio: fornire una o più di queste funzioni. Tre di queste funzioni sono facoltative, ma ogni ambiente di linguaggio deve avere una funzione di interfaccia dtw_execute(). Se una macro di Net.Data fa riferimento ad un ambiente di linguaggio che non possiede una funzione di interfaccia dtw_execute(), Net.Data restituisce un messaggio di errore e chiude l'elaborazione della macro di Net.Data.

Per richiamare un ambiente di linguaggio, fare riferimento ad esso sul blocco FUNCTION della macro di Net.Data. Le funzioni di interfaccia dell'ambiente di linguaggio devono essere richiamate nel seguente ordine:

  1. dtw_initialize()
  2. dtw_execute()
  3. dtw_getNextRow()
  4. dtw_cleanup()

La funzione dtw_execute() è la sola funzione di interfaccia che deve essere fornita in un ambiente di linguaggio.

Quando Net.Data rileva una chiamata ad una funzione che utilizza l'ambiente di linguaggio, esegue questa procedura per richiamare l'ambiente di linguaggio:

  1. Net.Data chiama dtw_initialize() se è stato definito per questo ambiente di linguaggio. La funzione esegue tutte le attività di inizializzazione richieste dall'ambiente di linguaggio, come il collegamento ai database o l'assegnazione di variabili.

  2. Net.Data chiama dtw_execute() per elaborare il blocco FUNCTION del file della macro contenente le istruzioni che l'ambiente di linguaggio deve elaborare.

  3. Net.Data chiama dtw_getNextRow() se, alla successiva restituzione, dtw_execute() ha indicato che deve essere chiamato dtw_getNextRow().

  4. Quando l'elaborazione della macro di Net.Data è completata, Net.Data chiama dtw_cleanup() per aggiornare l'ambiente (ad esempio, scollegandosi dal database o liberando le variabili) se questa funzione è stata definita per l'ambiente di linguaggio e ritorna poi al server Web.

Le seguenti sezioni descrivono le funzioni di interfaccia:


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