Net.Data 참조서

일반 함수

다음과 같은 일반 함수를 사용할 수 있습니다.

DTW_ADDQUOTE
DTW_DATE
DTW_GETENV
DTW_GETINIDATA
DTW_HTMLENCODE
DTW_QHTMLENCODE
DTW_SETENV
DTW_TIME
DTW_URLESCSEQ

DTW_ADDQUOTE

목적

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

입력 문자열의 작은 따옴표 하나를 작은 따옴표 두 개로 교체합니다. 이는 문자열에 작은 따옴표가 하나 있는 경우, SQL문이 성공적으로 완료되기 위해 필요합니다.

구문

@DTW_ADDQUOTE(stringIn, stringOut)
@DTW_rADDQUOTE(stringIn)
@DTW_mADDQUOTE(stringMult, stringMult2, ..., stringMultn)

매개변수

표 1. DTW_ADDQUOTE 매개변수

자료 유형 매개변수 사용 설명
문자열 stringIn IN 변수 또는 리터럴 문자열. DTW_mADDQUOTE에는 여러 개의 입력 문자열이 있을 수 있습니다.
문자열 stringOut OUT 수정된 stringIn 형식이 들어 있는 변수.
문자열 stringMult INOUT

입력: 문자열이 들어 있는 변수.
출력: 각 작은 따옴표(')가 두 개의 작은 따옴표로 교체된 입력 문자열이 들어 있는 변수.

자료 유형	매개변수	사용	설명
문자열	`stringIn`	IN	변수 또는 리터럴 문자열. DTW_mADDQUOTE에는 여러 개의 입력 문자열이 있을 수 있습니다.
문자열	`stringOut`	OUT	수정된 stringIn 형식이 들어 있는 변수.
문자열	`stringMult`	INOUT	입력: 문자열이 들어 있는 변수. 출력: 각 작은 따옴표(')가 두 개의 작은 따옴표로 교체된 입력 문자열이 들어 있는 변수.

예

예1:

@DTW_ADDQUOTE(string1,string2)

입력: string1 = "John's Web page"
결과: string2 = "John''s Web page"

예2:

@DTW_rADDQUOTE("The article's title is 'Once upon a time'")

결과: The article''s title is ''Once upon a time''

예3:

@DTW_mADDQUOTE(string1,string2)

입력: string1="Joe's bag", string2="'to be or not to be'"
결과: string1="Joe''s bag", string2="''to be or not to be''"

DTW_DATE

목적

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

지정된 형식으로 현재 시스템 날짜를 리턴합니다.

구문

@DTW_DATE(format, stringOut)
@DTW_DATE(stringOut)
@DTW_rDATE(format)
@DTW_rDate()

매개변수

표 2. DTW_DATE 매개변수

자료 유형 매개변수 사용 설명
문자열 format IN 자료 형식을 지정하는 리터럴 문자열 또는 변수. 유효한 형식은 다음과 같습니다.

D--당해년도의 일 (001-366)
E--유럽의 날짜 형식 (dd/mm/yy)
N--일반 날짜 형식 (dd mon yyyy)
O--순서화된 날짜 형식 (yy/mm/dd)
S--표준 날짜 형식 (yyyymmdd)
U--미국 날짜 형식 (mm/dd/yy)

생략시 값은 N입니다.
문자열 stringOut OUT 지정된 형식으로 된 날짜가 들어있는 변수.

자료 유형	매개변수	사용	설명
문자열	`format`	IN	자료 형식을 지정하는 리터럴 문자열 또는 변수. 유효한 형식은 다음과 같습니다. D--당해년도의 일 (001-366) E--유럽의 날짜 형식 (dd/mm/yy) N--일반 날짜 형식 (dd mon yyyy) O--순서화된 날짜 형식 (yy/mm/dd) S--표준 날짜 형식 (yyyymmdd) U--미국 날짜 형식 (mm/dd/yy) 생략시 값은 N입니다.
문자열	`stringOut`	OUT	지정된 형식으로 된 날짜가 들어있는 변수.

예

예1:

@DTW_DATE(results)

결과: results = "25 Apr 1997"

예2:

@DTW_DATE("E", results)

결과: results="25/04/97"

예3:

%HTML(report){
<P>This report created on @DTW_rDATE("U").

결과: 04/25/97

DTW_GETENV

목적

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

지정된 환경 변수의 값을 리턴합니다. ENVVAR를 사용하여 환경 변수 값을 얻을 수도 있습니다. 보다 자세한 내용은 ENVVAR 명령문를 참조하십시오.

구문

@DTW_GETENV(envVarName, envVarValue)
@DTW_rGETENV(envVarName)

매개변수

표 3. DTW_GETENV 매개변수

자료 유형 매개변수 사용 설명
문자열 envVarName IN 변수 또는 리터럴 문자열.
문자열 envVarValue OUT envVarName에 지정된 환경 변수의 값. 이 값이 없으면 널(NULL) 문자열이 리턴됩니다.

자료 유형	매개변수	사용	설명
문자열	`envVarName`	IN	변수 또는 리터럴 문자열.
문자열	`envVarValue`	OUT	envVarName에 지정된 환경 변수의 값. 이 값이 없으면 널(NULL) 문자열이 리턴됩니다.

예

예1:

@DTW_GETENV(myEnvVarName, myEnvVarValue)

입력: myEnvVarName = "PATH"
결과: myEnvVarValue = "/usr/path"

예2:

@DTW_rGETENV(myPath)

입력: myPath = "PATH"
결과: "/usr/path"

예3:

The server is @DTW_rGETENV("SERVER_NAME").

결과: "www.software.ibm.com"

DTW_GETINIDATA

목적

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

지정된 구성 변수의 값을 리턴합니다. 값이 없으면 널(NULL) 문자열이 리턴됩니다.
주: ENVIRONMENT 명령문 뿐만 아니라 특수 구성 경로 변수인 MACRO_PATH, EXEC_PATH, INCLUDE_PATH 등도 이 호출로는 검색할 수 없습니다.

구문

@DTW_GETINIDATA(iniVarName, iniVarValue)
@DTW_rGETINIDATA(iniVarName)

매개변수

표 4. DTW_GETINIDATA 매개변수

자료 유형 매개변수 사용 설명
문자열 iniVarName IN 변수 또는 리터럴 문자열.
문자열 iniVarValue OUT iniVarName에 지정된 구성 변수의 값.

자료 유형	매개변수	사용	설명
문자열	`iniVarName`	IN	변수 또는 리터럴 문자열.
문자열	`iniVarValue`	OUT	iniVarName에 지정된 구성 변수의 값.

예

예1:

@DTW_GETINIDATA(myEnvVarName, myEnvVarValue)

입력: myEnvVarName = "FFI_PATH"
결과: myEnvVarValue = "D:\FFI"

예2:

@DTW_rGETINIDATA("HTTP_COOKIE")

결과: "cookie.txt"

DTW_HTMLENCODE

목적

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

표준 HTML 십진 escape 코드를 사용하여 문자를 코드화하는데, 모든 문자를 코드화하는 것은 아닙니다. 이 함수를 사용하여, 브라우저가 HTML로 해석하지 않기를 원하는 자료를 코드화할 수 있습니다. 예를 들어, 적절한 escape 문자를 사용하여 보다 작음(<) 및 보다 큼(>) 기호를 표시할 수 있습니다. 이들 기호는 일반적으로 HTML 태그로 사용됩니다.

두번째 예에서, HTML로 된 문자열

"1    2     3"

은 각 번호 사이에 빈 칸이 하나임을 표시합니다. 빈칸의 수를 맞게 표시하려면 DTW_HTMLENCODE를 사용하십시오.

다음 문자는 DTW_HTMLENCODE 함수에 의해 코드화됩니다.

표 5. HTML 십진 escape 문자

문자 이름 코드
SPACE 공간  
" 큰 따옴표 "
# 숫자 기호 #
% 퍼센트 %
& 앰퍼샌드 &
/ 역슬래쉬 \
: 콜론 :
; 세미콜론 ;
< 보다 작음 <
= 같음 &#61:
> 보다 큼 &#62:
? 물음표 &#63:
@ 위치 기호 @
[ 여는 대괄호 (
\ 슬래쉬 /
] 닫는 대괄호 )
^ 캐럿 ^
{ 여는 중괄호 {
| 직선 |
} 닫는 중괄호 }
~ 틸드 ~

구문

@DTW_HTMLENCODE(stringIn, stringOut)
@DTW_rHTMLENCODE(stringIn)

매개변수

표 6. DTW_HTMLENCODE 매개변수

자료 유형 매개변수 사용 설명
문자열 stringIn IN 변수 또는 리터럴 문자열.
문자열 stringOut OUT 일부 문자가 HTML escape 문자 코드화로 교체되어 수정된 입력 문자열이 들어 있는 변수.

자료 유형	매개변수	사용	설명
문자열	`stringIn`	IN	변수 또는 리터럴 문자열.
문자열	`stringOut`	OUT	일부 문자가 HTML escape 문자 코드화로 교체되어 수정된 입력 문자열이 들어 있는 변수.

예

예1:

@DTW_HTMLENCODE(string1,string2)

입력: string1 = "Jim's dog"
결과: string2 = "Jim's dog"

예2:

@DTW_rHTMLENCODE("X <= 10")

결과: "X <= 10"

DTW_QHTMLENCODE

목적

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

@DTW_HTMLENCODE와 같은 기능을 수행하고, 작은 따옴표(')를 로 코드화하기도 합니다. DTW_QHTMLENCODE가 사용하는 HTML 십진 escape 문자는 표 5에 있습니다.

모든 SQL INPUT 명령문에 대해 이 함수를 사용해 보십시오. 예를 들어, 다음 예에서와 같이 성을 O'Brien으로 입력하면 작은 따옴표로 인해 오류가 생길 수 있습니다.

INSERT INTO USER1.CUSTABLE (LNAME, FNAME)
VALUES ('O'Brien', 'Patrick')

DTW_QHTMLENCODE 함수를 사용하면 SQL문에 오류가 생기지 않습니다.

INSERT INTO USER1.CUSTABLE (LNAME, FNAME)
VALUES ('O&#39;Brien', 'Patrick')

자세한 내용은 예3을 참조하십시오.

구문

@DTW_QHTMLENCODE(stringIn, stringOut)
@DTW_rQHTMLENCODE(stringIn)

매개변수

표 7. DTW_QHTMLENCODE 매개변수

자료 유형 매개변수 사용 설명
문자열 stringIn IN 변수 또는 리터럴 문자열.
문자열 stringOut OUT HTML escape 문자 코드화로 일부 문자가 교체되어 수정된 형식의 stringIn이 들어 있는 변수.

자료 유형	매개변수	사용	설명
문자열	`stringIn`	IN	변수 또는 리터럴 문자열.
문자열	`stringOut`	OUT	HTML escape 문자 코드화로 일부 문자가 교체되어 수정된 형식의 stringIn이 들어 있는 변수.

예

예1:

@DTW_QHTMLENCODE(string1,string2)

입력: string1 = "Jim's dog"
결과: string2 = "Jim's dog"

예2:

@DTW_rQHTMLENCODE("John's & Jane's")

결과: "John's & Jane's"

예3:

%FUNCTION(DTW_SQL) insertName(){
INSERT INTO USER2A.SURVEY
(NAME) VALUES '@DTW_rQHTMLENCODE(fullname)'
%}

입력: fullname = "Patrick O'Brien"
결과: 'Patrick O'Brien'

DTW_SETENV

목적

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

지정된 값으로 환경 변수를 설정하고 이전 값을 리턴합니다. 이전 값이 없는 경우 널(NULL) 문자열이 리턴됩니다.

구문

@DTW_SETENV(envVarName, envVarValue, prevValue)
@DTW_rSETENV(envVarName, envVarValue)

매개변수

표 8. DTW_SETENV 매개변수

자료 유형 매개변수 사용 설명
문자열 envVarName IN 환경 변수를 나타내는 리터럴 문자열 또는 변수.
문자열 envVarValue OUT 환경 변수가 설정된 값이 있는 리터럴 문자열 또는 변수.
문자열 prevValue OUT 환경 변수의 이전 값이 들어 있는 변수. DTW_rSETENV는 함수 리턴 값으로서 값을 리턴합니다.

자료 유형	매개변수	사용	설명
문자열	`envVarName`	IN	환경 변수를 나타내는 리터럴 문자열 또는 변수.
문자열	`envVarValue`	OUT	환경 변수가 설정된 값이 있는 리터럴 문자열 또는 변수.
문자열	`prevValue`	OUT	환경 변수의 이전 값이 들어 있는 변수. DTW_rSETENV는 함수 리턴 값으로서 값을 리턴합니다.

예

예1:

@DTW_SETENV("PATH", "myPath", prevValue)

입력: myPath = "myPath"
결과: prevValue = "myPreviousPath"

예2:

@DTW_rSETENV("PATH", "myPath")

입력: myPath = "myPath"
결과: "myPreviousPath", PATH = "myPath"

DTW_TIME

목적

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

지정된 형식으로 현재 시스템 시간을 리턴합니다.

구문

@DTW_TIME(stringIn, stringOut)
@DTW_TIME(stringOut)
@DTW_rTIME(stringIn)
@DTW_rTIME()

매개변수

표 9. DTW_TIME 매개변수

자료 유형 매개변수 사용 설명
문자열 stringIn IN 시간 형식을 지정하는 리터럴 문자열 또는 변수. 유효한 형식은 다음과 같습니다:

C 상용 시간 (hh:mmAM/PM, 12시간 단위)
L 현지 시간 (hh:mm:ss)
N 일반 시간 (hh:mm:ss 24시간 단위)
H 자정 이후 시간
M 자정 이후 분
S 자정 이후 초
생략시 값은 N입니다.
문자열 stringOut OUT 지정된 형식으로 된 시간이 들어 있는 변수.

자료 유형	매개변수	사용	설명
문자열	`stringIn`	IN	시간 형식을 지정하는 리터럴 문자열 또는 변수. 유효한 형식은 다음과 같습니다: C 상용 시간 (hh:mmAM/PM, 12시간 단위) L 현지 시간 (hh:mm:ss) N 일반 시간 (hh:mm:ss 24시간 단위) H 자정 이후 시간 M 자정 이후 분 S 자정 이후 초 생략시 값은 N입니다.
문자열	`stringOut`	OUT	지정된 형식으로 된 시간이 들어 있는 변수.

예

예1:

@DTW_TIME(results)

결과: results = "10:30:53"

예2:

@DTW_TIME("C", results)

결과: results = "10:30AM"

예3:

@DTW_rTIME("M")

결과: "630"

예4:

%REPORT{
<P>This report was created at @DTW_rTIME(), @DTW_rDATE().
%}

결과: This report was created 15:04:39, 01 May 1997.

DTW_URLESCSEQ

목적

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

URL에서는 허용되지 않는 문자를 escape 값으로 교체합니다. 표 10에 표시된 문자를 다른 매크로 파일이나 HTML 블록으로 전달하려면 이 함수를 사용해야 합니다.

표 10. URL에서 허용되지 않는 문자

문자 이름 코드
SPACE 공간 &#20
" 큰 따옴표 &#22
# 숫자 기호 &#23
% 퍼센트 &#25
& 앰퍼샌드 &#26
/ 역슬래쉬 &#2F
: 콜론 &#3A
; 세미콜론 &#3B
< 보다 작음 &#3C
= 같음 &#3D
> 보다 큼 &#3E
? 물음표 &#3F
@ 위치 기호 &#40
[ 여는 대괄호 &#5B
\ 슬래쉬 &#5C
] 닫는 대괄호 &#5D
^ 캐럿 &#5E
{ 여는 중괄호 &#7B
| 직선 &#7C
} 닫는 중괄호 &#7D
~ 틸드 &#7E

구문

@DTW_URLESCSEQ(stringIn, stringOut)
@DTW_rURLESCSEQ(stringIn)

매개변수

표 11. DTW_URLESCSEQ 매개변수

자료 유형 매개변수 사용 설명
문자열 stringIn IN 변수 또는 리터럴 문자열.
문자열 stringOut OUT URL에서 허용되지 않는 16진 escape 값으로 교체된 문자가 있는 입력 문자열이 포함된 변수.

자료 유형	매개변수	사용	설명
문자열	`stringIn`	IN	변수 또는 리터럴 문자열.
문자열	`stringOut`	OUT	URL에서 허용되지 않는 16진 escape 값으로 교체된 문자가 있는 입력 문자열이 포함된 변수.

예

예1:

@DTW_URLESCSEQ(string1,string2)

입력: string1 = "Guys & Dolls"
결과: string2 = "Guys%20%26%20Dolls"

예2:

@DTW_rURLESCSEQ("Guys & Dolls")

결과: "Guys%20%26%20Dolls"

예3: 이 예에서는 ROW 블록에 있는 DTW_rURLESCSEQ를 사용합니다. 적용업무 사용자가 이름을 클릭하면, name 및 email 변수로서 코드화된 값과 함께, 이름과 전자우편 주소가 Net.Data 매크로 fullrpt.mac의 입력 블록으로 전송딥니다.

%ROW{
<P><a href="fullRpt.mac/input?name=@DTW_rURLESCSEQ(V1)&email=@DTW_rULRESCSEQ(V2)">
$(V1)</a>
%}

입력: V1="Patrick O'Brien", V2="obrien@ibm.com"

결과:

<P><a href="fullrpt.mac/input?name=Patrick%20O'Brien&email="obrien%40ibm.com">
Patrick O'Brien</a>

[ 페이지의 맨 위 | 이전 페이지 | 다음 페이지 | 목차 | 색인 ]

문자	이름	코드
SPACE	공간
"	큰 따옴표	"
#	숫자 기호	#
%	퍼센트	%
&	앰퍼샌드	&
/	역슬래쉬	\
:	콜론	:
;	세미콜론	;
<	보다 작음	<
=	같음	&#61:
>	보다 큼	&#62:
?	물음표	&#63:
@	위치 기호	@
[	여는 대괄호	(
\	슬래쉬	/
]	닫는 대괄호	)
^	캐럿	^
{	여는 중괄호	{
\|	직선	\|
}	닫는 중괄호	}
~	틸드	~