참조서

Net.Data 언어 환경 변수

언어 환경에서 FUNCTION 블록을 처리하는 방법을 조정할 수 있도록 하려면 이 변수를 함수에 사용하십시오. 각 변수에는 기본값이 있습니다. 변수에 새로운 값을 할당하여 기본값을 겹쳐쓸 수 있습니다.

• DATABASE
• DB_CASE
• DB2PLAN
• DB2SSID
• DTW_APPLET_ALTTEXT
• DTW_EDIT_CODES
• DTW_PAD_PGM_PARMS
• DTW_SAVE_TABLE_IN
• DTW_SET_TOTAL_ROWS
• LOCATION
• LOGIN
• NULL_RPT_FIELD
• PASSWORD
• SHOWSQL
• SQL_STATE
• TRANSACTION_SCOPE

DATABASE

목적

데이타베이스 함수를 호출할 때 액세스할 데이타베이스나 ODBC 자료 소스를 지정합니다. 여러 데이타베이스 또는 ODBC 자료 소스에 액세스하기 위해 한 매크로내에서 이 변수를 여러 차례 변경할 수 있습니다.

OS/400 운영 체제: 이 변수는 생략가능합니다. Net.Data는 기본적으로 DATABASE="*LOCAL"을 지정합니다. DTW_SQL 언어 환경은 국지 관계형 데이타베이스 디렉토리 항목을 사용합니다.

Windows NT, OS/2 및 UNIX 운영 체제: DTW_ORA(Oracle) 언어 환경을 사용하는 경우를 제외하고, 데이타베이스 함수를 호출하기 전에 이 변수를 정의하십시오. 또한, 동일한 HTML 블록에서 동일한 언어 환경을 통해 여러 데이타베이스에 액세스하는 경우 라이브 연결을 사용해야 합니다.

DEFINE문을 사용하거나 @DTW_ASSIGN() 함수를 사용하여 이 변수의 값을 지정하십시오.

값

DATABASE="dbname"

표 7. DATABASE 값

예

예 1: 임의의 SQL 조작에 대해 CELDIAL 데이타베이스에 연결하도록 지정합니다.

%DEFINE DATABASE="CELDIAL"
 
%FUNCTION (DTW_SQL) getRpt() {
SELECT * FROM customer
%}
 
%HTML(report){
%INCLUDE "rpthead.htm"
@getRpt()
%INCLUDE "rptfoot.htm"
%}

함수 getRpt가 호출되면 데이타베이스 CELDIAL에 액세스됩니다.

예 2: 이전의 DATABASE 정의를 DTW_ASSIGN로 대체합니다.

%DEFINE DATABASE="DB2C1"
...
%HTML(monthRpt){
@DTW_ASSIGN(DATABASE, "DB2D1")
%INCLUDE "rpthead.htm"
@getRpt()
%INCLUDE "rptfoot.htm"
%}

HTML 블록은 DATABASE에 대한 이전 값에 관계없이 데이타베이스 DB2D1을 조회합니다.

DB_CASE

목적

SQL 명령에 사용할 문자(대문자 또는 소문자)를 지정하고 모든 문자를 대문자 또는 소문자로 변환합니다. 이 변수가 정의되지 않은 경우, 생략시 조치는 SQL 명령 문자를 변환하지 않는 것입니다.

DEFINE문을 사용하거나 @DTW_ASSIGN() 함수를 사용하여 이 변수의 값을 지정하십시오.

값

DB_CASE="UPPER"|"LOWER"

표 8. DB_CASE 값

예

예 1: 모든 SQL 명령에 대해 소문자를 지정합니다.

%DEFINE DB_CASE="UPPER"

DB2PLAN

목적

국지 DB2 부속시스템에 연결하기 위한 플랜을 할당합니다. 변수는 Net.Data가 액세스할 국지 DB2 부속시스템에서 Net.Data SQL 언어 환경에 대한 플랜의 이름을 지정합니다.

DEFINE문을 사용하거나 @DTW_ASSIGN() 함수를 사용하여 이 변수의 값을 지정하십시오.

요구사항: 매크로에서 이 변수의 값이 적용되려면, SQL 언어 환경에 대한 ENVIRONMENT 명령문에 나열되어야 합니다.

값

 DB2PLAN="plan_name"

표 9. DB2PLAN 값

예

예 1: DEFINE 명령문에 플랜을 지정합니다.

%DEFINE DB2PLAN="DTWGAV22"

DB2SSID

목적

국지 DB2 부속시스템에 대한 연결을 설정합니다. 변수는 Net.Data가 액세스할 국지 DB2 서브시스템의 서브시스템 ID를 지정합니다. 각 매크로당 하나의 국지 데이타베이스 연결만이 허용됩니다.

요구사항: 매크로에서 이 변수의 값이 적용되려면, SQL 언어 환경에 대한 ENVIRONMENT 명령문에 나열되어야 합니다.

값

 DB2PLAN="subsytem_id"

표 10. DB2SSID 값

예

예 1: DEFINE 명령문에 부속시스템 ID를 지정합니다.

%DEFINE DB2SSID="DBNC"

DTW_APPLET_ALTTEXT

목적

APPLET 태그를 인식하지 않는 브라우저에 대한 텍스트와 HTML 태그를 표시하고 애플릿 언어 환경에 사용됩니다.

DEFINE문을 사용하거나 @DTW_ASSIGN() 함수를 사용하여 이 변수의 값을 지정하십시오.

값

DTW_APPLET_ALTTEXT="HTML_text_and_tags"

표 11. DTW_APPLET_ALTTEXT 값

예

예 1: 웹 브라우저의 제한사항을 나타내는 대체 텍스트

%DEFINE DTW_APPLET_ALTTEXT = "<P>Sorry, your browser is not java-enabled."

DTW_EDIT_CODES

목적

DTW_SQL 언어 환경에 대한 SQL 조작의 결과 리턴된 NUMERIC, DECIMAL, INTEGER 및 SMALLINT 자료 유형을 변환합니다. 변수 DTW_EDIT_CODES는 DTW_SQL LE가 구축하는 테이블의 결과 컬럼에 해당하는 문자열입니다. 예를 들어, DTW_EDIT_CODES의 다섯번째 문자는 결과 세트의 다섯번째 컬럼에 적용됩니다(단, 이 컬럼이 지원되는 유형 중 하나인 경우). 이 단일 문자는 Data Description Specification Reference에 정의된 지원 시스템 제공 편집 코드 중 하나일 수 있습니다.

예를 들어 DECIMAL(6,0) 필드는 보통 문자열 '112698'로 표시됩니다. 변수 DTW_EDIT_CODES의 해당 컬럼에 대해 편집 코드 'Y'를 지정하면, 결과 테이블의 해당 컬럼은 '11/26/98'의 날짜를 나타내는 문자열로 표시됩니다.

참고: 숫자가 아닌 문자로 된(예: 콤마 또는 통화 기호) 문자열을 만들어 내는 컬럼에 사용자 제공 편집 코드를 적용하면 그 문자열이 Net.Data 매크로내의 후속 처리시 서버에 다시 전송되는 경우 구문 오류를 초래할 수 있습니다. 예를 들어, 숫자가 아닌 컬럼 값이 후속되는 DTW_SQL 함수 호출에서 숫자 비교에 사용될 수도 있는데, 이 경우 구문 오류가 초래됩니다.

DEFINE문을 사용하거나 @DTW_ASSIGN() 함수를 사용하여 이 변수의 값을 지정하십시오.

값

DTW_EDIT_CODES="edit_code"

표 12. DTW_EDIT_CODES 값

예

예 1:

@DTW_ASSIGN(DTW_EDIT_CODES "JJLJJ*******Y")

DTW_PAD_PGM_PARMS

목적

프로그램 또는 저장 프로시듀어에 전달할 때 문자 매개변수(자료 유형이 CHAR 또는 CHARACTER인)를 공백으로 채울 것인지 언어 환경에 표시합니다.

IN 또는 INOUT 매개변수의 경우, 매개변수 값의 길이가 지정된 정밀도보다 작으면, 매개변수 값의 길이가 정밀도와 같을 때까지 공백을 매개변수 값 오른쪽에 삽입합니다.

OUT 매개변수의 경우, 매개변수 값을 precision개의 공백으로 설정합니다.

프로그램 또는 저장 프로시듀어에 대한 호출 다음에 있는, 모든 후미 공백이 OUT 및 INOUT 매개변수 값에서 제거됩니다.

Net.Data 초기화 파일에서 이 변수를 설정하여 매크로 전체에 대해 값을 지정하십시오. 매크로에 이 값을 정의하여 값을 겹쳐쓸 수 있습니다. DTW_PAD_PGM_PARMS가 매크로에 정의되지 않는 경우, Net.Data 초기화 파일의 값을 사용합니다.

DTW_PAD_PGM_PARMS는 직접 호출 및 SQL 언어 환경에서 지원합니다.

값

DTW_PAD_PGM_PARMS="YES"|"NO"

표 13. DTW_PAD_PGM_PARMS 값

예

예 1: 공백으로 매개변수 채움

DTW_PAD_PGM_PARMS="YES"

DTW_SAVE_TABLE_IN

목적

SQL 언어 환경이 조회로부터 리턴된 테이블 자료를 저장하는 데 사용하는 테이블 변수를 식별합니다. 이 테이블은 나중에 테이블 자료를 분석하는 REXX 프로그램에서 사용될 수 있습니다.

DEFINE문을 사용하거나 @DTW_ASSIGN() 함수를 사용하여 이 변수의 값을 지정하십시오.

값

DTW_SAVE_TABLE_IN="table_name_var"

표 14. DTW_SAVE_TABLE_IN 값

예

예 1: REXX 호출에 사용된 사전 정의된 테이블 변수

%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)
%}

REXX FUNCTION 블록은 테이블의 자료 분석시 테이블 변수 theTable을 사용하는 REXX 프로그램 anzTbl.cmd를 호출합니다. 변수 theTable은 이전의 SQL 함수 호출로부터 리턴되었습니다.

DTW_SET_TOTAL_ROWS

목적

조회에 대한 결과 세트의 행 수가 TOTAL_ROWS에 지정되어야 함을 데이타베이스 언어 환경에 지정합니다.

DEFINE문을 사용하거나 @DTW_ASSIGN() 함수를 사용하여 이 변수의 값을 지정하십시오.

OS/400, OS/2, Windows NT 및 UNIX 사용자: 이 변수를 언어 환경으로 전달하려면, Net.Data 초기화 파일에 있는 데이타베이스 언어 환경의 ENVIRONMENT 명령문에 IN 변수로 포함시키십시오. 데이타베이스 언어 환경 명령문에 대한 자세한 내용은 Net.Data Administration and Programming Guide의 구성 장을 참조하십시오.

OS/390 사용자: DTW_SET_TOTAL_ROWS는 매크로에 정의될 때 데이타베이스 언어 환경에 내재적으로 전달됩니다.

성능 향상: DTW_SET_TOTAL_ROWS를 YES로 설정하면, 총 행 수 및 데이타베이스 언어 환경을 판별하기 위해 모든 행을 검색해야 하기 때문에 성능에 영향을 줄 수 있습니다.

값

DTW_SET_TOTAL_ROWS="YES"|"NO"

표 15. DTW_SET_TOTAL_ROWS 값

예

예 1: TOTAL_ROWS를 사용하도록 DTW_SET_TOTAL_ROWS를 정의합니다.

%DEFINE DTW_SET_TOTAL_ROWS="YES"
 
...
 
%FUNCTION (DTW_SQL) myfunc() {
select * from MyTable
%report {
...
%row
...
%}
<P>Your query is limited to $(TOTAL_ROWS) rows.  The query returned too many rows.
%}
%}

LOCATION

목적

원격 데이타베이스 서버에 대한 연결을 설정합니다. 이 변수는 국지 DB2 서브시스템이 원격 서버를 인식하는 데 사용하는 이름을 지정합니다. LOCATION의 값은 통신 데이타베이스(CDB)의 SYSIBM.SYSLOCATIONS 테이블내에 정의되어 있어야 합니다. 이 변수가 매크로내에 정의되지 않은 경우, 매크로에 의해 이루어지는 모든 SQL 요청은 국지 DB2 부속시스템에서 실행됩니다.

요구사항: 매크로에서 이 변수의 값이 적용되려면, SQL 언어 환경에 대한 ENVIRONMENT 명령문에 나열되어야 합니다.

DEFINE문을 사용하거나 @DTW_ASSIGN() 함수를 사용하여 이 변수의 값을 지정하십시오.

값

LOCATION="remote_dbase_name"

표 16. LOCATION 값

예

예 1: DEFINE 명령문에 원격 데이타베이스 위치를 정의합니다.

%DEFINE LOCATION="QMFDJ00"

LOGIN

목적

사용자 ID를 데이타베이스 언어 환경에 전달하여 보호되는 자료에 대한 액세스를 제공합니다. DB2의 보안 알고리즘을 합치려면 이 변수를 PASSWORD와 함께 사용하십시오.

OS/400을 사용하는 경우: OS/400은 DATABASE 변수가 정의되지 않았거나 이의 값이 "*LOCAL"로 설정된 경우 LOGIN 및 PASSWORD를 무시합니다. 데이타베이스 액세스는 Net.Data가 수행되는 사용자 프로파일을 통해 경로지정됩니다.

보안 관련사항: 이 값을 Net.Data 매크로에 코드화할 수도 있지만, 응용프로그램 사용자가 HTML 양식에 사용자 ID를 입력하는 것이 좋습니다. 또한, 생략시 값인 웹 서버 ID를 사용하면 사용자의 보안 요구에 부합되지 않는 액세스 레벨이 제공됩니다.

DEFINE문을 사용하거나 @DTW_ASSIGN() 함수를 사용하여 이 변수의 값을 지정하십시오.

값

LOGIN="database_user_id"

표 17. LOGIN 값

예

예 1: 사용자 ID, DB2USER로 액세스 제한

%DEFINE LOGIN="DB2USER"

예 2: HTML 양식 입력 행 사용

USERID&#58;  <INPUT TYPE="text" NAME="LOGIN" SIZE=6>

이 예는 응용프로그램 사용자가 자신들의 사용자 ID를 입력하도록 HTML 양식의 일부로 포함시킬 수 있는 행을 보여줍니다.

NULL_RPT_FIELD

목적

SQL 결과 세트에 리턴된 NULL 값을 나타내기 위해 사용자가 DTW_SQL 언어 환경에 제공할 수 있는 문자열을 지정합니다.

DEFINE문을 사용하거나 @DTW_ASSIGN() 함수를 사용하여 이 변수의 값을 지정하십시오.

값

NULL_RPT_FIELD="null_char"

표 18. NULL_RPT_FIELD 값

예

예 1: NULL 값을 나타내는 문자열을 SQL 언어 환경에 지정합니다.

%DEFINE NULL_RPT_FIELD = "++++"

PASSWORD

목적

암호를 데이타베이스 언어 환경에 전달하여 보호되는 자료에 대한 액세스를 제공합니다. DB2의 보안 알고리즘을 합치려면 이 변수를 LOGIN과 함께 사용하십시오.

OS/400을 사용하는 경우: OS/400은 DATABASE 변수가 정의되지 않았거나 이의 값이 "*LOCAL"로 설정된 경우 LOGIN 및 PASSWORD를 무시합니다. 데이타베이스 액세스는 Net.Data가 수행되는 사용자 프로파일을 통해 경로지정됩니다.

보안 관련사항: 이 값을 Net.Data 매크로에 코드화할 수도 있지만, 응용프로그램 사용자가 HTML 양식에 암호를 입력하는 것이 좋습니다.

DEFINE문을 사용하거나 @DTW_ASSIGN() 함수를 사용하여 이 변수의 값을 지정하십시오.

값

PASSWORD="password"

표 19. PASSWORD 값

예

예 1: 암호 NETDATA를 갖는 응용프로그램 사용자로 액세스 제한

%DEFINE PASSWORD="NETDATA"

예 2: HTML 양식 입력 행

PASSWORD&#58; <INPUT TYPE="password" NAME="PASSWORD" SIZE=8>

이 예는 응용프로그램 사용자가 암호를 입력하도록 HTML 양식의 일부로 포함시킬 수 있는 행을 보여줍니다.

SHOWSQL

목적

웹 브라우저에서 사용된 조회의 SQL을 숨기거나 표시합니다. 테스트중에 SQL을 표시하면 Net.Data 매크로를 디버그할 때 특히 유용합니다. SHOWSQL은 Net.Data 구성 파일에서 DTW_SHOWSQL이 YES로 설정된 경우에만 사용할 수 있습니다. DTW_SHOWSQL 구성 변수에 대한 자세한 내용은 운영 체제에 대한 Net.Data 관리 및 프로그래밍 안내서에서 구성 장을 참조하십시오.

DEFINE문을 사용하거나 @DTW_ASSIGN() 함수를 사용하여 이 변수의 값을 지정하십시오.

값

SHOWSQL="YES"|"NO"

표 20. SHOW_SQL 값

예

예 1: 모든 SQL 조회를 표시합니다.

구성 파일에서:

DTW_SHOWSQL YES

매크로에서:

%DEFINE SHOWSQL="YES"

예 2: HTML 형식 입력을 사용한 SQL 표시 여부 지정

구성 파일에서:

DTW_SHOWSQL YES

매크로에서:

SHOWSQL: <INPUT TYPE="radio" NAME="SHOWSQL" VALUE="YES"> Yes
         <INPUT TYPE="radio" NAME="SHOWSQL" VALUE="" CHECKED> No

SQL_STATE

목적

데이타베이스에서 리턴된 SQL 상태 값에 액세스하거나 이를 표시합니다.

이 변수는 사전 정의된 변수이며, 이의 값은 변경할 수 없습니다. 변수를 변수 참조로 사용하십시오.

예

예 1: REPORT 블록에 SQL 상태를 표시합니다.

%FUNCTION (DTW_SQL) val1() {
 select * from customer
%REPORT {
 ...
  %ROW {
 ...
%}
 SQLSTATE=$(SQL_STATE)
%}
 

TRANSACTION_SCOPE

목적

SQL 명령에 대한 트랜잭션 범위를 지정하여, 각각의 SQL 명령이 실행된 후 또는 HTML 블록의 모든 SQL 명령이 성공적으로 완료된 후 Net.Data가 COMMIT를 발행할지의 여부를 결정합니다. 확약 전에 모든 SQL 명령이 성공적으로 완료되어야 함을 지정하면, 성공적으로 실행되지 않은 SQL 명령이 있을 경우 그 블록의 동일한 데이타베이스에 대해 이전에 실행된 SQL이 구간 복원됩니다.

TRANSACTION_SCOPE 변수가 적용되려면, Net.Data 구성 파일의 ENVIRONMENT 명령문에 포함시켜야 합니다. 그런 다음, DEFINE 명령문이나 @DTW_ASSIGN() 함수를 사용하여 이 변수의 값을 지정할 수 있습니다.

일관성 관련사항: OS/400 및 OS/390 이외의 플랫폼에서 다음 모든 조건이 참이면, 실패 응답을 수신한 데이타베이스에 대한 갱신은 동일한 HTML 블록에서 액세스된 기타 데이타베이스에 대한 갱신이 확약되는 동안에 구간 복원될 수 있습니다.

• TRANSACTION_SCOPE = "MULTIPLE"가 지정되었습니다.

• 복수의 데이타베이스가 한 HTML 블록내에서 액세스됩니다(이는 라이브 연결을 사용할 경우에 가능합니다).

• SQL 요청으로부터 실패한 응답이 수신되었습니다.

IBM의 DataJoiner 소프트웨어를 사용하거나 OS/400에 설치된 Net.Data로부터 여러 개의 데이타베이스에 액세스할 경우, Net.Data로부터 갱신할 때 여러 데이타베이스 갱신의 조정 및 일관성을 달성할 수 있습니다.

OS/400 및 OS/390에서, TRANSACTION_SCOPE = "MULTIPLE"는 하나의 HTML 블록에서 발행된 모든 IBM 데이타베이스 갱신이 함께 확약 또는 구간 복원되도록 합니다.

OS/400이외의 플랫폼에서, REXX, Perl 및 자바 언어 환경은 자체의 개별 운용 체제 프로세스에 따라 수행됩니다. 따라서, 이러한 언어 환경에서 발행한 데이타베이스 갱신은 Net.Data TRANSACTION_SCOPE 값과 상관없이 Net.Data 매크로에서 발행된 데이타베이스 갱신과는 별도로 확약되거나 구간 복원됩니다.

값

TRANSACTION_SCOPE="SINGLE"|"MULTIPLE"

표 21. TRANSACTION_SCOPE 값

예

예 1: 각 트랜잭션 후 COMMIT을 발행하도록 지정합니다.

%DEFINE TRANSACTION_SCOPE="SINGLE"