이들 변수는 Net.Data 정의 변수로, Net.Data 처리에 영향을 주고 함수 호출의 상태를 알아내며 데이타베이스 조회의 결과 세트에 대한 정보를 얻고 파일 위치와 날짜에 대한 정보를 판별하는 데 이를 사용할 수 있습니다. Net.Data 매크로를 테스트할 때 함수에 이 변수를 쓰거나 사용할 경우에 이 변수가 유용하다는 사실을 느낄 수 있습니다.
| AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X | X | X | X | X | X | X |
목적
현재의 입력 파일에 대한 이름 및 확장자. 입력 파일은 INCLUDE문에 지정된 파일이거나 Net.Data 매크로입니다.
이 변수는 사전 정의된 변수이며, 이의 값은 변경할 수 없습니다. 변수를 변수 참조로 사용하십시오.
예
<P>This file is <I>$(DTW_CURRENT_FILENAME)</I>, and was updated on $(DTW_CURRENT_LAST_MODIFIED).
| AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X | X | X | X | X | X | X |
목적
현재 파일이 마지막으로 수정된 날짜 및 시간. 현재 파일은 Net.Data 매크로이거나 INCLUDE 명령문에 지정된 파일입니다. 출력 형식은 Net.Data가 수행되는 시스템에 따라 다릅니다.
이 변수는 사전 정의된 변수이며, 이의 값은 변경할 수 없습니다. 변수를 변수 참조로 사용하십시오.
예
<P>This file is <I>$(DTW_CURRENT_FILENAME)</I>, and was updated on $(DTW_CURRENT_LAST_MODIFIED).
| AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X | X |
| X | X | X | X |
목적
오류 발생시, 호출에서 내장 함수나 언어 환경으로 리턴된 메세지 텍스트가 들어 있습니다.
Net.Data 매크로의 어느 부분에서나 DTW_DEFAULT_MESSAGE 변수를 사용할 수 있습니다.
이 변수는 사전정의된 변수로, 이의 값은 수정하지 마십시오. 변수를 변수 참조로 사용하십시오.
예
예 1: 함수가 성공적으로 완료되었는지의 여부를 알려주는 메세지
@function1()
%IF ("$(RETURN_CODE)" == "0")
The function completed successfully.
%ELSE
The function failed with the return code $(RETURN_CODE). The error message
returned is "$(DTW_DEFAULT_MESSAGE)".
%ENDIF
예 2: 함수가 0이 아닌 리턴 코드를 리턴하는 경우의 생략시 텍스트
%MESSAGE{
default: {<h2>Net.Data received return code: $(RETURN_CODE).
Error message is $(DTW_DEFAULT_MESSAGE)</h2> %} : continue
%}
함수가 0이 아닌 리턴 코드를 리턴하는 경우 생략시 오류 메세지가 표시됩니다.
| AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X | X |
|
| X | X | X |
목적
Net.Data가 로그 파일에 기록하는 메세지 레벨.
DEFINE 명령문이나 @DTW_ASSIGN() 함수를 사용하여 이 변수의 값을 지정할 수 있습니다.
요구사항: 기록을 시작하도록 Net.Data 초기화 파일에 DTW_LOG_DIR을 정의하십시오. 그렇지 않으면, Net.Data는 매크로에 DTW_LOG_LEVEL 변수를 지정해도 메세지를 기록하지 않습니다.
값
DTW_LOG_LEVEL="OFF|ERROR|WARNING"
| 값 | 설명 |
|---|---|
| OFF | Net.Data가 오류를 기록하지 않습니다. OFF가 생략시 값입니다. |
| ERROR | Net.Data가 오류 메세지를 기록합니다. |
| WARNING | Net.Data가 오류 메세지뿐 아니라 경고도 기록합니다. |
예
%DEFINE DTW_LOG_LEVEL="ERROR"
| AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X | X | X | X | X | X | X |
목적
현재의 Net.Data 매크로 파일에 대한 이름 및 확장자.
이 변수는 사전 정의된 변수이며, 이의 값은 변경할 수 없습니다. 변수를 변수 참조로 사용하십시오.
예
<P>This Net.Data macro is <I>$(DTW_MACRO_FILENAME)</I>, and was updated on $(DTW_MACRO_LAST_MODIFIED).
| AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X | X | X | X | X | X | X |
목적
Net.Data 매크로가 마지막으로 수정된 날짜 및 시간. 출력 형식은 Net.Data가 수행되는 시스템에 따라 다릅니다.
이 변수는 사전 정의된 변수이며, 이의 값은 변경할 수 없습니다. 변수를 변수 참조로 사용하십시오.
예
<P>This Net.Data macro is <I>$(DTW_MACRO_FILENAME)</I>, and was updated on $(DTW_MACRO_LAST_MODIFIED).
| AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X | X | X |
| X | X | X |
목적
생략시 언어 환경에 사용되는 문자열과 단어 함수에 다중 바이트 문자 세트(MBCS) 지원을 제공합니다. Net.Data 초기화 파일에 이 변수를 설정할 수 있지만 매크로에서 이를 사용하여 현재의 설정을 설정하거나 겹쳐쓸 수 있습니다.
DEFINE문을 사용하거나 @DTW_ASSIGN() 함수를 사용하여 이 변수의 값을 지정하십시오.
Net.Data 초기화 파일에 이 변수를 설정할 수 있지만 매크로에서 이를 사용하여 현재의 설정을 설정하거나 겹쳐쓸 수 있습니다.
OS/400을 사용하는 경우: OS/400용 Net.Data는 MBCS 지원을 위한 함수를 자동으로 작동시키며 이 변수를 필요로 하지 않습니다. OS/400용 Net.Data는 OS/400 운영 체제로 이주된 매크로에서 이 변수를 무시합니다.
이 구성 변수는 DTW_UNICODE 구성 변수와 함께 작동합니다.
DTW_UNICODE가 생략시 값이 NO를 사용하는 경우, DTW_MBMODE의 값이
사용됩니다. DTW_UNICODE가 NO가 아닌 값으로 설정된 경우, 이 값이
사용됩니다. 표 23에서는
이들 두 변수의 설정값이 내장 함수가 문자열을 처리하는 방법을
어떻게 결정하는가를 보여줍니다.
표 23. DTW_UNICODE 및 DTW_MBMODE 설정값간의 관계
| DTW_UNICODE가 다음과 같이 설정된 경우 ... | DTW_MBMODE=YES | DTW_MBMODE=NO |
|---|---|---|
| NO | SBCS와 혼합된 DBCS 지원 | SBCS만 지원 |
| UTF8 | UTF-8 지원 | UTF-8 지원 |
값
DTW_MBMODE="YES"|"NO"
| 값 | 설명 |
|---|---|
| YES | 문자열 및 단어 함수에 대해 MBCS 지원을 지정합니다. |
| NO | 문자열 및 단어 함수에 MBCS 지원이 되지 않도록 지정합니다. NO가 생략시 값입니다. |
예
예 1: INI 파일의 값을 대체합니다.
INI 파일:
DTW_MBMODE NO
매크로:
%DEFINE DTW_MBMODE = "YES"
| AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X | X | X | X | X | X | X |
목적
Net.Data 실행 가능 파일의 경로와 이름. 사용중인 시스템에 따라 다르지만, 출력은 다음과 같은 샘플 경로 및 이름과 유사합니다.
/usr/lpp/internet/server_root/cgi-bin/db2www
이 변수는 사전 정의된 변수이며, 이의 값은 변경할 수 없습니다. 변수를 변수 참조로 사용하십시오.
예
The Net.Data executable file is $(DTW_MP_PATH).
| AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X | X | X | X | X | X | X |
목적
서버에서 수행중인 Net.Data의 버전 및 릴리스 번호.
이 변수는 사전 정의된 변수이며, 이의 값은 변경할 수 없습니다. 변수를 변수 참조로 사용하십시오.
예
This Web application uses $(DTW_MP_VERSION).
| AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X | X | X | X | X | X | X |
목적
HTTP 머리말에 대한 텍스트를 지정합니다.
Net.Data는 텍스트를 출력하기 전에 이 변수를 한번 읽고 다시는 읽지 않기 때문에, Net.Data가 웹 브라우저로 전송된 텍스트를 처리하기 전에 이 변수를 설정해야 합니다. DTW_PRINT_HEADER 변수에 변경이 생겨도 Net.Data가 브라우저로 송신된 후에는 무시됩니다.
DTW_PRINT_HEADER를 사용하여 사용자 머리말을 생성하는 경우(DTW_PRINT_HEADER = "NO"), DTW_REMOVE_WS를 "NO"로 설정해야 합니다.
DEFINE문을 사용하거나 @DTW_ASSIGN() 함수를 사용하여 이 변수의 값을 지정하십시오.
값
DTW_PRINT_HEADER="YES"|"NO"
| 값 | 설명 |
|---|---|
| YES | Net.Data는 HTTP 머리말로 텍스트 Content-type: text/html을 출력합니다. YES가 생략시 값입니다. |
| NO | Net.Data는 HTTP 머리말을 인쇄하지 않습니다. 사용자가 원하는 HTTP 머리말 정보를 생성할 수 있습니다. |
예
이 변수를 사용하는 가장 일반적인 방법 중의 하나는 Net.Data 매크로가 쿠키(cookies)를 보낼 수 있도록 하는 것입니다. 쿠키를 설정하려면, DTW_PRINT_HEADER 변수가 NO로 설정되고, 처음 세 행은 Content-type 머리말, Set-Cookie 명령문 및 공백 행이 되어야 합니다.
예 1: Net.Data가 쿠키를 전송하도록 허용
%DEFINE DTW_PRINT_HEADER="NO"
%HTML(cookie1) {
Content-type: text/html
Set-Cookie: UsrId=56, expires=Friday, 12-Dec-99, 12:00:00 GMT; path=/
<P>
Any text
%}
| AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X | X | X | X | X | X | X |
목적
도표 작성기, 공백 및 개행 문자 등으로 인한 잉여 공간을 압축하여 동적으로 생성된 웹 페이지의 크기를 줄입니다.
DEFINE 블록에 이 변수의 값을 지정하십시오.
<PRE></PRE> 태그 사용: 이 변수를 YES로 정의하면 인쇄되는 공간의 양과 유형이 영향을 받습니다. 이 변수가 YES로 설정되면, <PRE></PRE> 태그를 사용하는 HTML 페이지의 부분은 표시되지 않습니다.
DTW_PRINT_HEADER를 사용하여 사용자 머리말을 생성하는 경우(DTW_PRINT_HEADER = "NO"), DTW_REMOVE_WS를 "NO"로 설정해야 합니다.
OS/390을 사용하는 경우: 매크로 전체에 대해 값을 지정하려면 Net.Data 초기화 파일에 이 변수를 설정하십시오. 매크로에 이 값을 정의하여 값을 겹쳐쓸 수 있습니다. 매크로에 DTW_REMOVE_WS가 정의되어 있지 않으면, 초기화 파일의 값을 사용합니다.
값
DTW_REMOVE_WS="YES"|"NO"
| 값 | 설명 |
|---|---|
| YES | Net.Data는 연속된 두 개 이상의 공백을 하나의 개행 문자로 압축하여 좀 더 짧은 HTML 결과 페이지를 생성합니다. |
| NO | Net.Data가 공백을 압축하지 않습니다. NO가 생략시 값입니다. |
예
예 1: 공백 압축
DTW_REMOVE_WS="YES"
| AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X | X | X | X | X | X | X |
목적
함수에 의해 내장 함수나 언어 환경에 리턴된 리턴 코드. Net.Data는 이 값을 사용하여 MESSAGE 블록을 처리합니다. 이 변수를 사용하여 함수 호출이 성공했는지 실패했는지를 판별할 수 있습니다. 값이 0이면, 함수 호출이 성공적으로 완료되었음을 나타냅니다.
RETURN_CODE 변수는 Net.Data 매크로의 어느 부분에서나 참조할 수 있습니다.
이 값은 사전정의된 것입니다. 값을 수정하지 마십시오. 이를 변수 참조로 사용하십시오.
예
예 1: 함수가 성공적으로 완료되었는지의 여부를 알려주는 메세지
@function1()
%IF ("$(RETURN_CODE)" == "0")
The function completed successfully.
%ELSE
The function failed with the return code $(RETURN_CODE).
%ENDIF
예 2: 리턴 코드가 0이 아닌 경우의 생략시 메세지
%MESSAGE{
default: "<h2>Net.Data received return code: $(RETURN_CODE)</h2>" : continue
%}
함수가 0이 아닌 리턴 코드를 리턴하는 경우 생략시 메세지가 표시됩니다.