FUNCTION 블록이 처리되는 방법을 조정하려면 SQL 함수와 함께 이 변수를 사용하십시오. 이 변수를 참조하기 전에 먼저 이를 정의해야 합니다. 임의의 Net.Data 매크로 블록에서 보고서 변수를 설정하거나 참조할 수 있습니다.
목적
| AIX | HP-UX | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X |
| X | X | X | X |
Net.Data는 이 변수를 사용하여 지정된 데이타베이스와의 연결을 설정합니다. OS/400을 제외한 모든 플랫폼에서, 지속적인 연결 설정에 라이브(Live) 연결을 사용하지 않았으면 각 매크로당 하나의 데이타베이스 연결만이 허용됩니다. 이 변수가 정의되지 않았으면, 데이타베이스에 액세스시 오류가 발생합니다.
OS/400 플랫폼에서는 복수의 데이타베이스 연결을 설정할 수 있습니다. 또한, DATABASE 변수는 선택적입니다. OS/400용 Net.Data는 생략시 값으로 DATABASE="*LOCAL"을 지정합니다. DTW_SQL 언어 환경은 국지 관계형 데이타베이스 디렉토리 항목을 사용합니다.
예제 2 및 예제 3에 있는 것처럼, 동일한 Net.Data 매크로내의 다른 HTML 블록에 대한 DATABASE를 변경할 수 있습니다.
예
예제 1: 이 Net.Data 매크로내의 모든 SQL 은 CELDIAL 데이타베이스에서 수행됩니다.
%DEFINE DATABASE="CELDIAL"
예제 2: HTML 블록은 DATABASE의 이전 값이 무엇이었는지에 관계없이 데이타베이스 DB2D1을 조회합니다.
%HTML(monthRpt){
@DTW_ASSIGN(DATABASE, "DB2D1")
%INCLUDE "rpthead.htm"
@getRpt()
%INCLUDE "rptfoot.htm"
%}
예제 3: 이 예제는 예제 2와 동일하지만, DTW_ASSIGN 대신 DEFINE을 사용하여 DATABASE 변수를 설정합니다. 이는 HTML 블록이 호출될 때마다 Net.Data가 Net.Data 매크로 전체를 맨 위에서부터 처리하기 때문에 작동합니다.
%DEFINE DATABASE="DB2D1"
%HTML(monthRpt){
%INCLUDE "rpthead.htm"
@getRpt()
%INCLUDE "rptfoot.htm"
%}
목적
| AIX | HP-UX | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X | X | X | X | X | X |
SQL 명령에 어떤 문자(대문자 또는 소문자)를 사용할 것인지를 지정합니다. 이 변수가 정의되어 있지 않을 경우, 생략시 조치는 SQL 명령을 변환하지 않는 것입니다. SQL 명령내의 모든 문자를 강제로 대문자 또는 소문자로 변경하려면, "UPPER" 또는 "LOWER"를 지정하십시오.
예
예제 1:
%DEFINE DB_CASE="UPPER"
목적
| AIX | HP-UX | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
|
|
|
| X |
|
|
|
|
OS/390용 Net.Data는 이 변수를 사용하여 국지 DB2 서브시스템으로의 연결에 필요한 계획을 할당합니다. 변수는 Net.Data가 액세스할 국지 DB2 서브시스템에 있는 Net.Data SQL 언어 환경에 대한 계획의 계획명을 지정합니다. 이 변수가 OS/390용 Net.Data 구성 파일에도 지정되어 있지 않고 매크로내에도 정의되어 있지 않은 경우에, 매크로가 SQL 함수를 실행하려 하면 오류가 발생합니다.
예
예제 1:
%DEFINE DB2PLAN="DTWGA105"
목적
| AIX | HP-UX | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
|
|
|
| X |
|
|
|
|
OS/390용 Net.Data는 이 변수를 사용하여 국지 DB2 서브시스템으로의 연결을 설정합니다. 변수는 Net.Data가 액세스할 국지 DB2 서브시스템의 서브시스템 ID를 지정합니다. 각 매크로당 하나의 국지 데이타베이스 연결만이 허용됩니다. 이 변수가 OS/390용 Net.Data 구성 파일에도 지정되어 있지 않고 매크로내에도 정의되어 있지 않은 경우에, 매크로가 SQL 함수를 실행하려 하면 오류가 발생합니다.
예
예제 1:
%DEFINE DB2SSID="DB2G"
목적
| AIX | HP-UX | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X | X | X | X | X | X |
이 변수는 SQL 언어 환경이 조회로부터 리턴된 테이블 자료를 저장하는데 사용하는 TABLE 변수를 식별합니다. 이 테이블은 나중에 테이블 자료를 분석하는 REXX 프로그램에서 사용될 수 있습니다.
예
이 예에서, REXX FUNCTION 블록은 테이블내의 자료 분석시 테이블 변수 theTable을 사용하는 REXX 프로그램 anzTbl.cmd을 호출합니다. 변수 theTable은 이전의 SQL 함수 호출로부터 리턴되었습니다.
%DEFINE theTable = %TABLE(2)
%DEFINE DTW_SAVE_TABLE_IN = "theTable"
%FUNCTION(DTW_SQL) doQuery() {
SELECT MODNO, COST, DESCRIP FROM EQPTABLE
WHERE TYPE='MONITOR'
%}
%FUNCTION(DTW_REXX) analyze_table(myTable) {
%EXEC{ anzTbl.cmd %}
%}
%HTML(doTable) {
@doQuery()
@analyze_table(theTable)
%}
목적
| AIX | HP-UX | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
|
|
|
| X |
|
|
|
|
OS/390용 Net.Data는 이 변수를 사용하여 원격 데이타베이스 서버로의 연결을 설정합니다. 이 변수는 국지 DB2 서브시스템이 원격 서버를 인식하는데 사용하는 이름을 지정합니다. LOCATION의 값은 통신 데이타베이스( CDB)의 SYSIBM.SYSLOCATIONS 테이블내에 정의되어 있어야 합니다. 이 변수가 매크로내에 정의되어 있으면, 매크로에 의해 이루어지는 모든 SQL 조회는 국지 DB2 서브시스템에서 실행됩니다.
예
예제 1:
%DEFINE LOCATION="QMFDJ00"
목적
| AIX | HP-UX | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X |
| X | X | X | X |
사용자 ID를 입력함으로써 보호되는 자료에 대한 액세스를 제공합니다. DB2의 보안 알고리즘을 합치려면 이 변수를 PASSWORD와 함께 사용하십시오. 생략시 값은 웹 서버를 시작한 사용자 ID를 사용하는 것입니다. Net.Data 매크로에 직접 이 값을 코딩하거나, 적용업무 사용자가 HTML 형식으로 ID를 입력하도록 할 수 있습니다.
예
예제 1: 이 예제는 액세스를 사용자 ID DB2USER로만 제한합니다.
%DEFINE LOGIN="DB2USER"
예제 2: 이 예는 적용업무 사용자가 그들의 사용자 ID를 입력할 때 HTML 형식의 일부분으로 포함시킬 수 있는 행을 보여줍니다.
USERID: <INPUT TYPE="text" NAME="LOGIN" SIZE=6>
목적
| AIX | HP-UX | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X |
| X | X | X | X |
암호를 입력함으로써 보호되는 자료에 대한 액세스를 제공합니다. DB2의 보안 알고리즘을 합치려면 이 변수를 LOGIN과 함께 사용하십시오. Net.Data 매크로에 직접 이 값을 코딩하거나, 적용업무 사용자가 HTML 형식으로 암호를 입력하도록 할 수 있습니다.
예
예제 1: 이 예제는 암호가 NETDATA 인 사용자에게만 액세스를 제한합니다.
%DEFINE PASSWORD="NETDATA"
예제 2: 이 예는 적용업무 사용자가 그들의 암호를 입력할 때 HTML 형식의 일부분으로 포함시킬 수 있는 행을 보여줍니다.
PASSWORD: <INPUT TYPE="password" NAME="PASSWORD" SIZE=8>
목적
| AIX | HP-UX | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X | X | X | X | X | X |
웹 브라우져에서 사용되는 SQL 조회를 숨기거나 표시합니다. 생략시 값은 SQL을 숨기는 것입니다. 데이타베이스로 송신된 SQL을 표시하려면 이 변수를 YES로 설정하십시오. SQL을 숨기려면 이 변수를 NO로 설정하십시오. 테스트중에 SQL을 표시하면 Net.Data 매크로를 디버그하는데 특히 유용합니다.
예
예제 1: 이 예제에는 매번 SQL을 표시하는 방법이 나와 있습니다.
%DEFINE SHOWSQL="YES"
예제 2: 이 예제에는 HTML 형식의 입력을 사용하여 SQL을 표시할지의 여부를 지정하는 방법이 나와 있습니다.
SHOWSQL: <INPUT TYPE="radio" NAME="SHOWSQL" VALUE="YES"> Yes
<INPUT TYPE="radio" NAME="SHOWSQL" VALUE="" CHECKED> No
목적
| AIX | HP-UX | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X | X | X | X | X | X |
SQL 명령에 대한 트랜잭션 범위를 지정합니다. 생략시 값은 "MULTIPLE"이며, 이는 Net.Data가 HTML 블록내의 모든 SQL 명령이 성공적으로 완료된 후에만 COMMIT 명령을 발행함을 의미합니다. 실패한 SQL 명령은 이전에 그 블록내의 동일한 데이타베이스에 대해 실행된 SQL 이 구간복원되도록 합니다. "SINGLE"을 지정하는 것은 Net.Data 가 HTML내의 각 SQL 명령이 성공적으로 완료된 후에야 COMMIT를 발행함을 의미합니다.
OS/400 및 OS/390 이외의 플랫폼에서, 다음 모든 조건에 해당되면 실패 응답을 수신한 데이타베이스에 대한 갱신은 동일한 HTML 블록에서 액세스된 기타 데이타베이스에 대한 갱신이 확약되는 동안에 구간복원될 수 있습니다.
DataJoiner 소프트웨어를 사용하여 Net.Data로부터 복수의 데이타베이스에 액세스할 경우, Net.Data로부터 갱신을 수행할 때 복수의 데이타베이스 갱신 조정 및 일치 내용을 아카이브할 수 있습니다.
OS/400 및 OS/390에서, TRANSACTION_SCOPE = "MULTIPLE"를 지정하면 모든 IBM 데이타베이스 갱신은 하나의 HTML 블록에서 발행되어 확약되거나 구간복원됩니다.
OS/400이외의 플랫폼에서, REXX, Perl 및 자바 언어 환경은 자신만의 별도의 운용 시스템 프로세스에서 수행됩니다. 따라서, 이러한 언어 환경에서 발행한 모든 데이타베이스 갱신은 Net.Data TRANSACTION_SCOPE 값에 관계없이 Net.Data 매크로 파일에서 발행된 데이타베이스 갱신으로부터 별도로 확약되거나 구간복원됩니다.
예
예제 1:
%DEFINE TRANSACTION_SCOPE="SINGLE"