ENVIRONMENT 陳述式的格式如下:
ENVIRONMENT(type) library-name ([specification parameterN, ...)
每一個 ENVIRONMENT 陳述式必須由一行構成。
下列為您必須指定給每一個語言環境的參數:
使這個語言環境與 Net.Data 巨集中的 FUNCTION 區塊定義產生關聯的名稱。 您使用 FUNCTION 區塊上定義的名稱,以結合此函數與語言環境。FUNCTION 區塊的相關資訊,請參閱 Net.Data 參考手冊 中的 「函數區塊」部份。
重要事項:名稱開頭不可以是字首 DTW。 這個字首已被 Net.Data 附隨的語言環境預定使用。 若使用 DTW 字首,Net.Data 無法載入語言環境 DLL。
物件的名稱,這個物件含有由 Net.Data 呼叫的語言環境介面。 就每一個作業系統而言副檔名各不相同:
在 SUN、PTX 和 Linux 中,使用 .so 副檔名指定共用程式庫名稱。
請查看您作業系統之 Net.Data 附隨的起始設定檔, 來取得如何指定這個名稱的資訊。 請考慮使用完整的路徑名稱,來確定 Net.Data 可以找到 DLL 或共用程式庫。
參數傳送規格指示 Net.Data 是否使用輸入、輸出或輸入及輸出的參數。 可能值:
除了在 FUNCTION 區塊定義及在 FUNCTION 區塊 RETURNS 子句指定參數之外,也可以在每次函數呼叫時指定傳遞給語言環境的參數。它們都傳到 dtw_lei_t 結構的 parm_data_array 欄位, 位於在 FUNCTION 區塊定義中指定的參數後面。 您必須先在 Net.Data 巨集中將這些參數定義為變數, 之後才可以進行函數呼叫。如果函數修改了輸出與輸入 / 輸出參數的值, 在函數完成處理程序後,參數會保留已修改的值。
下列範例顯示稱為 MY_LE 之語言環境的 ENVIRONMENT 陳述式。
ENVIRONMENT (MY_LE) lelib.dll ( IN INPUT1, OUT OUTPUT1 )
每一個作業系統的 ENVIRONMENT 陳述式稍微不同; 例如,OS/390 中用於 SQL 語言環境的參數即與 UNIX 中的 SQL 語言環境稍有不同。
ENVIRONMENT (DTW_SQL) DTWSQL ( IN LOCATION, DB2SSID, DB2PLAN ) ENVIRONMENT (DTW_SQL) /db2www/lib/dtwsqlshr.so ( IN DATABASE, LOGIN, PASSWORD )