Net.Data는 새 언어 및 데이타베이스 인터페이스가 '플러그 가능' 방식으로 추가될 수 있도록 설계되었습니다. 이들 언어 환경은 서비스 프로그램으로서 액세스됩니다. 서비스 프로그램명은 Net.Data 초기설정 파일에 구성되고, 언어 환경명과 연결됩니다. 각 언어 환경은 Net.Data에 의해 정의되는 표준 인터페이스 집합을 지원해야 합니다.
OS/400용 Net.Data는 다음과 같은 언어 환경을 지원합니다.
다음 절에서는 앞에서 언급한 언어 환경에 대해 설명합니다.
REXX 언어 환경은 Net.Data 매크로의 FUNCTION 블록에 지정된 내부 REXX 프로그램을 해석할 수 있습니다. 또는, 별도 파일에 저장된 외부 REXX 프로그램을 실행할 수 있습니다. REXX 언어 환경의 특징은 다음과 같습니다.
REXX 프로그램은 rEXX 스템 변수로서 Net.Data 매크로 테이블 매개변수 값에 액세스하게 됩니다. REXX 프로그램에게, T 테이블에 대한 컬럼 표제는 T_N.i이고, 필드 값은 T_V.i.j입니다.
외부 REXX 프로그램 호출은, 다음과 같은 형식의 명령문에 의해 FUNCTION 블록에서 식별됩니다.
%EXEC{ REXX-file-name Yoptional parameters" %}
다음은 내부 REXX 프로그램과 외부 REXX 프로그램에 대한 참조 모두가 있는 매크로(REXXM)의 간단한 예입니다.
%define a = "3"
%define b = "0"
%function(DTW_REXX) func1(IN inp1, OUT outp1){
%EXEC{ /QSYS.LIB/REXX.LIB/REXXSRC.FILE/TREXX.MBR %}
%}
%function(DTW_REXX) func2(IN inp1, OUT outp1){
outp1 = 2*inp1
%}
%HTML(REPORT){
@func1(a, b)
b=$(b)
@func2(a, b)
b=$(b)
%}
이 예에서, @func1의 결과는 REXX 프로그램 TREXX.MBR이 REXX 해석기에 의해 해석되고, @func2 결과는 REXX 해석기에서 "outp1 = 2*inp1" 명령문을 해석합니다. 두 경우 모두, REXX 변수 풀이 설정되어 REXX 해석기는 "a" 및 "b" 변수에 액세스할 수 있습니다. @func2가 완료된 후 "b"는 "6"으로 설정됩니다(REXX 프로그램 TREXX.MBR이 "a"를 수정하지 않았다고 전제).
이것은 다음을 전제로 하는, 매크로를 참조하는 예제 URL입니다.
http://hostname/cgi-bin/db2www/WWW/macro/REXXM/report
Net.Data 초기설정 파일을 작성하지 않기로 한 경우, 생략시 값으로 REXX 언어 환경이 작동 가능합니다. 그러나, 초기설정 파일을 작성했고 REXX 언어 환경을 사용하려는 경우, 다음과 같은 구성 명령문이 초기설정 파일에 있어야 합니다.
ENVIRONMENT(DTW_REXX) /QSYS.LIB/QTCP.LIB/QTMHREXX.SRVPGM ( )
SQL 언어 환경은 DB2를 사용하여 SQL문을 실행하는 데 사용됩니다. SQL 언어 환경의 특징은 다음과 같습니다.
DTW_SQL_NAMING_MODE = SYSTEM_NAMING
또한,DTW_SQL_NAMING_MODE를 SQL_NAMING으로 설정할 수도 있습니다. 이는 SQL 명명 모드의 생략시 값과 같습니다.
원격 AS/400에 연결을 하는 경우, SQL Call Level Interface는 QSQCLIPKG라는 이름으로 QGPL 라이브러리에서 *SQLPKG 오브젝트를 찾습니다. 있으면 사용되지만 없으면 작성됩니다. 이 SQL 패키지에는 기본 SQL가 액세스되는 모든 규칙이 들어 있습니다. 따라서, 첫번째 연결 속성은 모든 후속 연결이 따라야 하는 규칙을 설정합니다. 이들 속성중의 하나가 명명 모드입니다. 원격 AS/400의 기존의 QGPL/QSQCLIPKG에서 명명 모드와 충돌하도록 DTW_SQL_NAMING_MODE를 설정하면, Net.Data 매크로에 있는 SQL문 결과는 -5016이라는 SQLCODE가 됩니다. 이러한 상황을 피하려면, 명명 모드를 선택하고 이를 고수하십시오. QGPL/QSQCLIPKG 오브젝트가 사용자가 선택한 명명 모드와 충돌하는 경우, 이를 삭제하고 다시 Net.Data 요청을 발행하십시오. 새로운 QGPL/QSQCLIPKG가 필요한 명명 모드 옵션으로 작성됩니다.
SQL 언어 환경이 원격 시스템으로 연결을 하는 경우, 사용자 ID와 연결을 연결시킵니다. 후속 Net.Data 조회에서 사용자 ID가 연결과 관련된 사용자 ID와 일치하지 않는 경우, 연결이 종료되고 데이타베이스에 대한 새로운 연결이 이루어집니다(이는 트랜잭션 범위가 SINGLE인 경우에만 발생합니다). 성능이 문제인 경우, 웹 매크로 작성자는 원격 데이타베이스로 SQL문을 발행할 때 동일한 사용자 ID를 사용하거나 하드 코드화해야 합니다. 국지 데이타베이스 액세스의 경우, 사용자 ID 및 암호는 무시됩니다.
다음은 단일 SQL 명령을 발행하는 간단한 매크로의 예(SQLM)입니다.
%define DATABASE="HOSTNAME"
%FUNCTION(DTW_SQL) sql1 (){
select * from custinfo.customer
%}
%HTML(REPORT){
@sql1()
%}
매크로를 참조하는 URL은, 매크로 파일명 REXXM이 SQLM으로 교체되는 것만 빼고, REXX 언어 환경에 대해 제공된 예제 URL과 유사합니다.
Net.Data 초기설정 파일을 작성하지 않기로 선택한 경우, 생략시 값으로 SQL 언어 환경이 작동가능하게 됩니다. 그러나, 초기설정 파일을 작성했고 SQL 언어 환경을 사용하고자 하는 경우, 다음과 같은 구성 명령문이 초기설정 파일에 있어야 합니다.
ENVIRONMENT(DTW_SQL) /QSYS.LIB/QTCP.LIB/QTMHSQL.SRVPGM
( IN DATABASE, LOGIN, PASSWORD, TRANSACTION_SCOPE, SHOWSQL, DTW_SET_TOTAL_ROWS,
DB_CASE, OUT DTWTABLE, SQL_CODE, TOTAL_ROWS )
초기설정 파일에서 이 환경 명령문의 텍스트는 모두 한 행에 있어야 합니다. 여기에서는 읽기 편하도록 여러 행으로 나누어 표시했습니다.
위 구성 명령문의 SQL 언어 환경 매개변수들은 언어 호나경으로 전달되고 아래와 같이 설명됩니다.
%DEFINE DATABASE="HOSTNAME"
%DEFINE{ LOGIN="MYUSERID"
PASSWORD="DB2WWW"
%}
%DEFINE TRANSACTION_SCOPE="SINGLE"
%DEFINE SHOWSQL="YES"
%DEFINE DB_CASE="UPPER"
Query completed with SQL code $(SQL_CODE).
SYSTEM 언어 환경은 FUNCTION 블록의 EXEC 명령문에서 식별되는 외부 프로그램으로의 호출을 지원합니다.
SYSTEM 언어 환경은 C 언어 시스템() 함수 호출을 사용하여 실행을 위해 지정된 프로그램명 및 매개변수를 운용 시스템으로 전달함으로써 EXEC 명령문을 해석합니다. 이 방법은 Net.Data 변수가 REXX 언어 환경이 하는 것처럼 실행가능 명령문으로 직접 전달되거나 검색되지 못하도록 합니다. 따라서, SYSTEM 언어 환경은 다음과 같은 방식으로 변수를 전달 및 검색합니다.
SYSTEM 언어 환경 프로그램은 Net.Data명에 의해 Net.Data 매크로 테이블 매개변수 값에 액세스합니다. 테이블 T에 대한 컬럼 표제는 T_N_i이고, 필드값은 T_V_i_j입니다.
SYSTEM 언어 환경은 실행 가능한 명령어나 프로그램이기를 기대합니다. QTMHHTP1 사용자 프로파일에는 실행 가능하게 사용하는 자원 외에도, 실행 가능을 수행할 권한이 있어야 합니다.
다음은, 한 Net.Data 매개변수로 전달하여 실행 가능하게 프로그램을 지정하는 간단한 매크로의 예(SYSM)입니다.
%define var1 = "OriginalValue"
%FUNCTION(DTW_SYSTEM) test(INOUT parm1){
%EXEC{ /QSYS.LIB/PGM.LIB/TSYS0001.PGM %}
%}
%HTML(REPORT){
<PRE>
Value of var1 before function call: $(var1)
@test(var1)
Value of var1 after function call: $(var1)
</PRE>
%}
매크로를 참조하는 URL은, 매크로 파일명 REXXM이 SYSM으로 교체되는 것을 제외하고는, REXX 언어 환경에 주어진 URL 예제와 유사합니다.
Net.Data 초기설정 파일을 작성하지 않기로 선택한 경우, 생략시 값으로 SYSTEM 언어 환경이 작동가능하게 됩니다. 그러나, 초기설정 파일을 작성했고 SYSTEM 언어 환경을 사용하고자 하는 경우, 다음과 같은 구성 명령문이 초기설정 파일에 있어야 합니다.
ENVIRONMENT(DTW_SYSTEM) /QSYS.LIB/QTCP.LIB/QTMHSYS.SRVPGM ( )