참조서

일반 함수

일반 함수는 Net.Data를 이용하여 웹 페이지를 개발할 수 있도록 하며 다른 범주에는 속하지 않는 함수입니다. 다음과 같은 함수가 일반 함수입니다.

DTW_ADDQUOTE
DTW_CACHE_PAGE
DTW_DATE
DTW_EXIT
DTW_GETCOOKIE
DTW_GETENV
DTW_GETINIDATA
DTW_HTMLENCODE
DTW_QHTMLENCODE
DTW_SENDMAIL
DTW_SETCOOKIE
DTW_SETENV
DTW_TIME
DTW_URLESCSEQ

DTW_ADDQUOTE

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

목적

입력 문자열의 작은 따옴표 하나를 작은 따옴표 두 개로 교체합니다.

형식

@DTW_ADDQUOTE(stringIn, stringOut)

@DTW_rADDQUOTE(stringIn)

@DTW_mADDQUOTE(stringMult, stringMult2, ..., stringMultn)

매개변수

표 27. DTW_ADDQUOTE 매개변수

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

리턴 코드

표 28. DTW_ADDQUOTE 리턴 코드

리턴 코드	설명
-1001	서버가 메모리를 할당하기 위한 Net.Data 요청을 처리할 수 없습니다.
1003	함수 호출에 전달된 매개변수의 수가 허용되는 최대 수를 초과하거나 또는 함수에서 필요로하는 최소 수보다 작습니다.
1005	함수에 전달된 문자열 변수여야 하는 매개변수가 다른 변수 유형을 갖습니다.
1006	출력 매개변수여야 하는 매개변수에 대한 함수 호출에 리터럴 문자열이 전달되었습니다.

사용법 메모

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

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

DTW_ADDQUOTE 함수를 사용하면 SQL문이 변경되어 오류 발생을 막아줍니다.

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

예

예 1: 추가의 작은 따옴표를 OUT 매개변수에 추가합니다.

@DTW_ADDQUOTE(string1,string2)

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

예 2: 추가의 작은 따옴표를 함수 호출의 리턴 값에 추가합니다.

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

결과: "The title of the article is ''Once upon a time''"

예 3: 추가의 작은 따옴표를 함수 호출의 각 INOUT 매개변수에 추가합니다.

@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''"

예 4: 추가의 작은 따옴표를 DB2 테이블에 삽입되는 데이타에 추가합니다.

%FUNCTION(DTW_SQL) insertName(){
INSERT INTO USER1.CUSTABLE (LNAME,FNAME)
VALUES ('@DTW_rADDQUOTE(lastname)', '@DTW_rADDQUOTE(firstname)')
%}

입력: lastname="O'Brien", firstname="Patrick"
결과: "O''Brien", "Patrick"

DTW_CACHE_PAGE

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

목적

매크로 처리 결과로 생성된 부분 또는 전체 웹 페이지를 캐쉬합니다.

형식

@DTW_CACHE_PAGE(cacheid, url, age, status)

매개변수

표 29. DTW_CACHE_PAGE 매개변수

매개변수	사용	설명
`cache_id`	IN	페이지가 놓일 캐쉬를 식별하는 문자열 변수.
`cached_page_ID`	IN	후속하는 DTW_CACHE_PAGE 캐쉬 요청에서 캐쉬된 페이지를 찾는 데 사용되는 식별자가 들어 있는 문자열 변수. 문자열이 URL일 수 있습니다.
`age`	IN	초 단위의 시간 길이를 담고 있는 문자열 변수. 이 매개변수는 페이지가 만기되었는지의 여부를 판별합니다. 이 페이지가 `age` 값보다 오래된 경우, 페이지가 브라우저에 전송되지 않습니다. `age`가 -1로 지정되고 페이지가 캐쉬에 존재하는 경우, Net.Data는 페이지의 만기 여부에 관계없이 캐쉬에서 직접 페이지를 웹 브라우저에 전송합니다. Net.Data가 캐쉬의 페이지를 대체하지는 않습니다.
`status`	OUT	캐쉬된 페이지의 상태를 나타내는 문자열 변수. 가능한 값은 다음과 같은 소문자값입니다. ok: 매크로 실행이 종료되면 출력 페이지가 캐쉬됩니다. new: 페이지가 캐쉬에 없습니다. renew: 페이지가 캐쉬에 있지만 만기되었습니다. no_cache: 지정된 캐쉬 식별자가 존재하지 않습니다. 캐쉬 식별자는 캐쉬 구성 파일에 정의되어 있어야 합니다. 페이지를 캐쉬하지 않고도 매크로의 실행은 계속됩니다. inactive: 지정한 캐쉬가 비활성으로 표시되어 있습니다. 페이지를 캐쉬하지 않고도 매크로의 실행은 계속됩니다. busy: 이 실행 이전에 사용자 매크로에서 DTW_CACHE_PAGE 내장 함수를 호출하였습니다. 매크로의 실행은 계속됩니다. error: 캐쉬와 대화하는 중에 오류가 발생했습니다.

리턴 코드

표 30. DTW_CACHE_PAGE 리턴 코드

리턴 코드	설명
-1001	서버가 메모리를 할당하기 위한 Net.Data 요청을 처리할 수 없습니다.
1001	입력 매개변수가 널(NULL) 값을 포함합니다.
1002	입력 매개변수가 널(Null) 종료 문자로 이루어진 문자열을 포함합니다.
1003	함수 호출에 전달된 매개변수의 수가 허용되는 최대 수를 초과하거나 또는 함수에서 필요로하는 최소 수보다 작습니다.
1005	함수에 전달된 문자열 변수여야 하는 매개변수가 다른 변수 유형을 갖습니다.
1006	출력 매개변수여야 하는 매개변수에 대한 함수 호출에 리터럴 문자열이 전달되었습니다.
1007	매개변수가 유효하지 않은 값을 포함합니다.

사용법 메모

이 함수가 호출되면, DTW_CACHE_PAGE()는 캐쉬로부터 지정된 페이지를 검색하여 이것이 매크로에서 생성된 출력 매개변수인 것처럼 웹 브라우저에 이를 전송하려고 시도합니다. 페이지를 찾았는데 이 페이지가 아직 만기되지 않은 경우, Net.Data는 매크로 처리를 중지하고 매크로에서 나온 다음 캐쉬된 페이지를 웹 브라우저에 전송합니다.

요청된 페이지가 캐쉬에 없거나 캐쉬된 기존 페이지가 age 값보다 오래된 경우, Net.Data는 새로운 출력 페이지를 생성합니다. 매크로가 성공적으로 완료되면, Net.Data는 새로운 페이지를 브라우저에 전송하고 그 페이지를 캐쉬합니다.
대부분의 캐슁 응용프로그램에서, 매크로 실행시 생성된 모든 웹 페이지를 캐쉬하려면 DTW_CACHE_PAGE를 매크로의 상단에 지정하십시오. 이렇게 하면 매크로가 갱신될 때 매크로를 유지보수하는 것이 더 쉬워집니다. 예를 들어, 함수의 매크로의 중간에 있을 경우 HTML 보고서 섹션이 매크로에서 더 앞에 추가되는 경우 이것이 확인되지 않을 수도 있습니다. 이 경우 Net.Data는 새로운 보고서 출력을 캐쉬하지 않습니다. 또한, 이 방법을 이용할 경우 페이지가 캐쉬된다고 판단되면 Net.Data는 더 이상의 처리를 중단하므로 성능 향상을 꾀할 수 있습니다.

고급 캐슁 응용프로그램의 경우, 매크로의 도입부에서가 아니라 처리중 특정 시점에서 캐쉬 조작하도록 결정해야 할 때 매크로의 특정 위치에 함수를 배치할 수 있습니다. 예를 들어, 조회나 함수 호출로부터 리턴되는 행 수에 기초하여 캐슁을 결정해야 할 수도 있습니다.

예

예 1: 모든 HTML 출력을 캡쳐하기 위해 DTW_CACHE_PAGE() 함수를 매크로 서두에 배치합니다.

%IF (customer_status == "Classic")
@DTW_CACHE_PAGE("mymacro.mac", "http://www.mypage.org", "-1", status)
%ENDIF
 % DEFINE { ...%}
 
...
 
%HTML(OUTPUT) {
 <title>This is the page title
 </head>
<body>
<center>
 This is the Main Heading
 <p>It is $(time). Have a nice day!
 </body>
</html>
 
%}

예 2: 캐쉬 여부는 HTML 출력의 예상 크기에 따라 결정되므로 함수를 HTML 블록에 배치합니다.

%DEFINE { ...%}
 
...
 
%FUNCTION(DTW_SQL) count_rows(){
  select count(*) from customer
%REPORT{
%ROW{
  @DTW_ASSIGN(ALL_ROWS, V1)
%}
%}
%}
 
%FUNCTION(DTW_SQL) all_customers(){
  select * from customer
%}
 
%HTML(OUTPUT) {
 <html>
 <head>
 <title>This is the customer list
 </head>
<body>
 
@count_rows()
 
 %IF ($(ALL_ROWS) > "100")
@DTW_CACHE_PAGE("mymacro.mac", "http://www.mypage.org", "-1", status)
%ENDIF
 
@all_customers()
 
 </body>
</html>
%}

이 예에서, 페이지는 HTML 출력의 예상 크기에 따라 캐쉬 또는 검색됩니다. 데이타베이스 테이블에 100개보다 많은 행이 들어 있는 경우 HTML 출력 페이지는 캐쉬 전용으로 간주됩니다. Net.Data는 반드시 매크로 실행 후 OUTPUT 블록의 텍스트, This is the customer list를 브라우저에 전송합니다. 즉, 텍스트는 캐쉬되지 않습니다. 함수 호출 @count_rows() 다음의 행은 IF 블록의 조건이 충족되면 캐쉬 또는 검색됩니다. 이 두 부분이 합해져서 완전한 Net.Data 출력 페이지를 형성합니다.

예 3: 캐쉬 ID와 캐쉬된 페이지 ID를 동적으로 검색합니다.

%HTML(OUTPUT) {
 %IF (customer == "Joe Smith")
 
@DTW_CACHE_PAGE(@DTW_rGETENV("DTW_MACRO_FILENAME"), @DTW_rGETENV("URL"),"-1", status)
 
%ENDIF
 
...
 
 <html>
 <head>
 <title>This is the page title</title>
 </head>
<body>
<center>
 <h3>This is the Main Heading</h3>
 <p>It is @DTW_rDATE(). Have a nice day!
 </body>
</html>
 
%}

DTW_DATE

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

목적

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

형식

@DTW_DATE(format, stringOut)

@DTW_DATE(stringOut)

@DTW_rDATE(format)

@DTW_rDATE()

매개변수

표 31. 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	지정된 형식으로 된 날짜가 들어있는 변수.

리턴 코드

표 32. DTW_DATE 리턴 코드

리턴 코드	설명
-1001	서버가 메모리를 할당하기 위한 Net.Data 요청을 처리할 수 없습니다.
1001	입력 매개변수가 널(NULL) 값을 포함합니다.
1003	함수 호출에 전달된 매개변수의 수가 허용되는 최대 수를 초과하거나 또는 함수에서 필요로하는 최소 수보다 작습니다.
1005	함수에 전달된 문자열 변수여야 하는 매개변수가 다른 변수 유형을 갖습니다.
1006	출력 매개변수여야 하는 매개변수에 대한 함수 호출에 리터럴 문자열이 전달되었습니다.
1007	매개변수가 유효하지 않은 값을 포함합니다.

예

예 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_EXIT

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는 호출중인 DTW_EXIT() 이전에 생성된 모든 웹 페이지를 웹 브라우저에 전송합니다.

형식

@DTW_EXIT()

리턴 코드

표 33. DTW_EXIT 리턴 코드

리턴 코드	설명
1003	함수 호출에 전달된 매개변수의 수가 허용되는 최대 수를 초과하거나 또는 함수에서 필요로하는 최소 수보다 작습니다.

사용법 메모

DTW_EXIT()를 사용하여 즉시 매크로 처리를 중지하십시오. 이 기술을 사용하면 Net.Data가 전체 파일을 처리하는 데 사용하는 시간이 절약됩니다.
DTW_EXIT() 함수를 추가하기 전에 전체 매크로의 구문이 정확한지 확인하십시오. DTW_EXIT()를 사용하면 이 함수에 대한 호출이 있을 경우 Net.Data가 매크로의 처리를 중지하므로, DTW_EXIT() 함수가 처리된 이후 발생하는 오류를 파악할 수 없게 됩니다.

예

예 1: 매크로에서 나감

%HTML(cache_example) {
 
 <html>
 <head>
 <title>This is the page title</title>
 </head>
<body>
<center>
 <h3>This is the Main Heading</h3>
 <!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!>
 <! Joe Smith sees a very short page                   !>
 <!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!>
 %IF (customer == "Joe Smith")
 
@DTW_EXIT()
 
%ENDIF
 
...
 
 </body>
</html>
 %}

DTW_GETCOOKIE

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

목적

지정된 쿠키의 값을 리턴합니다.

형식

@DTW_GETCOOKIE(IN cookie_name, OUT cookie_value)

@DTW_rGETCOOKIE(IN cookie_name)

매개변수

표 34. DTW_GETCOOKIE 매개변수

자료 유형	매개변수	사용	설명
문자열	`cookie_name`	IN	쿠키의 이름을 지정하는 변수 또는 리터럴 문자열.
문자열	`cookie_value`	OUT	사용자 상태 정보와 같이 함수에 의해 검색된 쿠키의 값이 들어 있는 변수. OS/400 및 OS/390 사용자: 쿠키 값에 URL 형식 코드(에를 들어, "%20")가 포함된 경우, 쿠키 값이 리턴되기 전에 해독됩니다. 워크스테이션 사용자: 쿠키 값에 URL 형식 코드(예를 들어, "%20")가 포함된 경우, 쿠키 값이 리턴되기 전에 해독되지 않습니다.

리턴 코드

표 35. DTW_GETCOOKIE 리턴 코드

리턴 코드	설명
-1001	서버가 메모리를 할당하기 위한 Net.Data 요청을 처리할 수 없습니다.
1001	입력 매개변수가 널(NULL) 값을 포함합니다.
1002	입력 매개변수가 널(Null) 종료 문자로 이루어진 문자열을 포함합니다.
1003	함수 호출에 전달된 매개변수의 수가 허용되는 최대 수를 초과하거나 또는 함수에서 필요로하는 최소 수보다 작습니다.
1005	함수에 전달된 문자열 변수여야 하는 매개변수가 다른 변수 유형을 갖습니다.
1006	출력 매개변수여야 하는 매개변수에 대한 함수 호출에 리터럴 문자열이 전달되었습니다.
8000	쿠키를 찾을 수 없습니다.

사용법 메모

하나의 쿠키를 두 개의 개별 HTTP 요청으로 정의 및 검색하십시오. 쿠키는 클라이언트에 전송된 후에만 가시화되므로 매크로가 동일한 HTTP 요청에 정의된 쿠키를 얻고자 하면 예상치 못한 결과가 초래될 수 있습니다.

예

예 1: 사용자 ID와 암호 정보가 들어 있는 쿠키를 검색합니다.

@DTW_GETCOOKIE("mycookie_name_for_userID", userID)
@DTW_GETCOOKIE("mycookie_name_for_password", password)

예 2: 사용자 정보를 수집하기 전에 사용자에 대한 쿠키가 존재하는지 판별합니다.

  %MESSAGE {
    8000 : "" : continue
%}
 
%HTML(welcome) {
 <html>
<body>
  <h1>Net.Data Club</h1>
  @DTW_GETCOOKIE("NDC_name", name)
  %IF ($(RETURN_CODE) == "8000") %{ The cookie is not found. %}
  <form method="post" action="remember">
  <p>Welcome to the club. Please enter your name.<br>
  <input name="name">
  <input type="submit" value="submit"><br>
</form>
%ELSE
  <p>Hi, $(name). Welcome back.
%ENDIF
 </body>
</html>
  %}

HTML welcome 섹션에서는 쿠키 NDC_name이 존재하는지 점검합니다. 쿠키가 존재하면 브라우저는 개별화된 환영 화면을 표시합니다. 쿠키가 존재하지 않으면, 사용자 이름을 입력하라고 하는 프롬프트가 표시되고 HTML remember 섹션에 이를 기입하여, 아래와 같이 사용자 이름을 쿠키 NDC_name에 설정합니다.

%HTML(remember) {
 <html>
<body>
  <H1>Net.Data Club</H1>
  @DTW_SETCOOKIE("NDC_name", name, "expires=Wednesday, 01-Dec-2010 00:00:00;path=/")
  <p>Thank you.
  <p><a href="welcome">Come back</a>
 </body>
</html>
  %}

DTW_GETENV

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

목적

지정된 환경 변수의 값을 리턴합니다.

형식

@DTW_GETENV(envVarName, envVarValue)

@DTW_rGETENV(envVarName)

매개변수

표 36. DTW_GETENV 매개변수

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

리턴 코드

표 37. DTW_GETENV 리턴 코드

리턴 코드	설명
-1001	서버가 메모리를 할당하기 위한 Net.Data 요청을 처리할 수 없습니다.
1003	함수 호출에 전달된 매개변수의 수가 허용되는 최대 수를 초과하거나 또는 함수에서 필요로하는 최소 수보다 작습니다.
1005	함수에 전달된 문자열 변수여야 하는 매개변수가 다른 변수 유형을 갖습니다.
1006	출력 매개변수여야 하는 매개변수에 대한 함수 호출에 리터럴 문자열이 전달되었습니다.

사용법 메모

ENVVAR를 사용하여 환경 변수의 값을 참조할 수도 있습니다. 자세한 내용은 ENVVAR 명령문을 참조하십시오.

예

예 1: PATH문에 대한 값을 OUT 매개변수에 리턴합니다.

@DTW_GETENV(myEnvVarName, myEnvVarValue)

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

예 2: PATH문에 대한 값을 리턴합니다.

@DTW_rGETENV(myPath)

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

예 3: 서버의 프로토콜에 대한 값을 리턴합니다.

The server is @DTW_rGETENV("SERVER_PROTOCOL").

결과: "HTTP/1.0"

DTW_GETINIDATA

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

목적

지정된 구성 변수의 값을 리턴합니다.

형식

@DTW_GETINIDATA(iniVarName, iniVarValue)

@DTW_rGETINIDATA(iniVarName)

매개변수

표 38. DTW_GETINIDATA 매개변수

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

리턴 코드

표 39. DTW_GETINIDATA 리턴 코드

리턴 코드	설명
-1001	서버가 메모리를 할당하기 위한 Net.Data 요청을 처리할 수 없습니다.
1003	함수 호출에 전달된 매개변수의 수가 허용되는 최대 수를 초과하거나 또는 함수에서 필요로하는 최소 수보다 작습니다.
1005	함수에 전달된 문자열 변수여야 하는 매개변수가 다른 변수 유형을 갖습니다.
1006	출력 매개변수여야 하는 매개변수에 대한 함수 호출에 리터럴 문자열이 전달되었습니다.

사용법 메모

구성 파일이 아닌 구성 변수가 지정된 경우, Net.Data는 빈 문자열을 리턴합니다.
OS/390, OS/2, Windows NT 및 UNIX 사용자의 경우: ENVIRONMENT 명령문 뿐만 아니라 구성 경로 변수(MACRO_PATH, EXEC_PATH INCLUDE_PATH)를 이 호출로 검색할 수 없습니다.
OS/400 사용자의 경우: ENVIRONMENT 명령문을 이 호출로 검색할 수 없습니다.

예

예 1: Net.Data 경로 변수 값을 리턴합니다.

@DTW_GETINIDATA(myEnvVarName, myEnvVarValue)

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

DTW_HTMLENCODE

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

목적

HTML 문자 이탈 코드를 사용하여 선택된 문자를 코드화합니다.

형식

@DTW_HTMLENCODE(stringIn, stringOut)

@DTW_rHTMLENCODE(stringIn)

매개변수

표 40. DTW_HTMLENCODE 매개변수

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

리턴 코드

표 41. DTW_HTMLENCODE 리턴 코드

리턴 코드	설명
-1001	서버가 메모리를 할당하기 위한 Net.Data 요청을 처리할 수 없습니다.
1003	함수 호출에 전달된 매개변수의 수가 허용되는 최대 수를 초과하거나 또는 함수에서 필요로하는 최소 수보다 작습니다.
1005	함수에 전달된 문자열 변수여야 하는 매개변수가 다른 변수 유형을 갖습니다.
1006	출력 매개변수여야 하는 매개변수에 대한 함수 호출에 리터럴 문자열이 전달되었습니다.

사용법 메모

이 함수를 사용하여, 웹 브라우저가 HTML로 해석하지 않기를 바라는 문자 자료를 코드화할 수 있습니다. 예를 들어, 적절한 이탈 코드를 사용하여 웹 페이지내에 보다 작음(<) 및 보다 큼(>) 기호와 같은 문자를 표시할수 있으며, 이외의 경우에 이 문자는 브라우저에 의해 HTML 태그의 구성요소로 해석됩니다.

표 42에는 DTW_HTMLENCODE 함수에 의해 코드화되는 문자가 나와 있습니다.

표 42. HTML의 문자 이탈 코드

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

예

예 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	Linux	OS/2	OS/390	OS/400	SCO	SUN	Win NT
X	X	X	X	X	X	X	X	X

목적

@DTW_HTMLENCODE와 동일한 기능을 수행하며, 작은 따옴표 문자(')를 '로 코드화합니다. DTW_QHTMLENCODE가 사용하는 HTML 문자 이탈 코드는 표 42에 나와 있습니다.

형식

@DTW_QHTMLENCODE(stringIn, stringOut)

@DTW_rQHTMLENCODE(stringIn)

매개변수

표 43. DTW_QHTMLENCODE 매개변수

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

리턴 코드

표 44. DTW_QHTMLENCODE 리턴 코드

리턴 코드	설명
-1001	서버가 메모리를 할당하기 위한 Net.Data 요청을 처리할 수 없습니다.
1003	함수 호출에 전달된 매개변수의 수가 허용되는 최대 수를 초과하거나 또는 함수에서 필요로하는 최소 수보다 작습니다.
1005	함수에 전달된 문자열 변수여야 하는 매개변수가 다른 변수 유형을 갖습니다.
1006	출력 매개변수여야 하는 매개변수에 대한 함수 호출에 리터럴 문자열이 전달되었습니다.

예

예 1: 어포스트러피와 공백을 코드화합니다.

@DTW_QHTMLENCODE(string1,string2)

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

예 2: 어포스트러피, 공백 및 앰퍼샌드를 코드화합니다.

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

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

DTW_SENDMAIL

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

목적

전자 우편(e-mail) 메세지를 동적으로 구축하여 전송합니다.

형식

@DTW_SENDMAIL(IN Sender, IN Recipient, IN Message, IN Subject, IN CarbonCopy, IN BlindCarbonCopy, IN ReplyTo, IN Organization)

@DTW_SENDMAIL(IN Sender, IN Recipient, IN Message, IN Subject, IN CarbonCopy, IN BlindCarbonCopy, IN ReplyTo)

@DTW_SENDMAIL(IN Sender, IN Recipient, IN Message, IN Subject, IN CarbonCopy, IN BlindCarbonCopy)

@DTW_SENDMAIL(IN Sender, IN Recipient, IN Message, IN Subject, IN CarbonCopy)

@DTW_SENDMAIL(IN Sender, IN Recipient, IN Message, IN Subject)

@DTW_SENDMAIL(IN Sender, IN Recipient, IN Message)

매개변수

표 45. DTW_SENDMAIL 매개변수

자료 유형	매개변수	사용	설명
문자열	`sender`	IN	저자의 주소를 지정하는 변수 또는 리터럴 문자열. 이 매개변수는 필수입니다. 유효한 형식은 다음과 같습니다. Name <user@domain> <user@domain> user@domain
문자열	`recipient`	IN	이 메세지가 전송되는 전자 우편 주소를 지정하는 변수 또는 리터럴 문자열. 이 값은 콤마(,)로 구분되는 여러 개의 수신인을 가질 수 있습니다. 이 매개변수는 필수입니다. 유효한 `recipient` 형식은 다음과 같습니다. Name <user@domain> <user@domain> user@domain
문자열	`message`	IN	전자 우편 메세지의 텍스트가 들어 있는 변수 또는 리터럴 문자열. 이 매개변수는 필수입니다.
문자열	`subject`	IN	주제 행의 텍스트가 들어 있는 변수 또는 리터럴 문자열. 이것은 선택적 매개변수입니다. 추가 매개변수를 지정하려면 널 문자열("")을 지정해야 합니다.
문자열	`CarbonCopy`	IN	전자 우편 주소나, 추가 수신인의 이름과 전자 우편 주소가 들어 있는 변수 또는 리터럴 문자열. 이 값은 콤마(,)로 구분된 여러 명의 수신인을 가질 수 있습니다. 유효한 수신인 형식을 알려면 `Recipient` 매개변수를 참조하십시오. 이것은 선택적 매개변수입니다. 추가 매개변수를 지정하려면 널 문자열("")을 지정해야 합니다.
문자열	`BlindCarbonCopy`	IN	전자 우편 주소나 추가 수신인의 이름과 전자 우편 주소가 들어 있는 변수 또는 리터럴 문자열로, 수신인이 전자 우편 표제에 나타나지는 않습니다. 이 값은 콤마(,)로 구분된 여러 명의 수신인을 가질 수 있습니다. 유효한 수신인 형식을 알려면 `Recipient` 매개변수를 참조하십시오. 이것은 선택적 매개변수입니다. 추가 매개변수를 지정하려면 널 문자열("")을 지정해야 합니다.
문자열	`ReplyTo`	IN	이 메세지에 대한 응답을 전송해야 하는 전자 우편 주소가 들어 있는 변수 또는 리터럴 문자열. 이것은 선택적 매개변수입니다. 추가 매개변수를 지정하려면 널 문자열("")을 지정해야 합니다. 유효한 `ReplyTo` 형식은 다음과 같습니다. Name <user@domain> <user@domain> user@domain
문자열	`Organization`	IN	`송신자`의 소속 단체명이 들어 있는 변수 또는 리터럴 문자열. 이것은 선택적 매개변수입니다.

리턴 코드

표 46. DTW_SENDMAIL 리턴 코드

리턴 코드	설명
-1001	서버가 메모리를 할당하기 위한 Net.Data 요청을 처리할 수 없습니다.
1001	입력 매개변수가 널(NULL) 값을 포함합니다.
1002	입력 매개변수가 널(Null) 종료 문자로 이루어진 문자열을 포함합니다.
1003	함수 호출에 전달된 매개변수의 수가 허용되는 최대 수를 초과하거나 또는 함수에서 필요로하는 최소 수보다 작습니다.
1005	함수에 전달된 문자열 변수여야 하는 매개변수가 다른 변수 유형을 갖습니다.
7000	Net.Data가 지정된 SMTP 서버에 연결할 수 없습니다.
7001	Net.Data가 지정된 SMTP 서버에 전자 우편 메시지를 중계하려고 시도하는 동안 SMTP 오류가 발생하였습니다.
7002	지정된 SMTP 서버가 ESTM(Extended Simple Mail Transfer Protocol)을 지원하지 않습니다.

사용법 메모

이 함수는 전자 우편 메세지 전송에 사용할 SMTP 서버를 지정하는 선택적 구성 변수, DTW_SMTP_SERVER와 함께 작동합니다. 이 매개변수의 값은 호스트명, IP 주소 또는 노드와 이름이 될 수 있습니다. 이 변수가 정의되지 않은 경우, Net.Data는 국지 호스트를 SMTP 서버로 사용합니다. 이 변수에 대한 자세한 내용은 운영 체제에 대한 Net.Data 관리 및 프로그래밍 안내서의 구성 장을 참조하십시오.
OS/400, OS/2, Windows NT 및 UNIX 사용자: SMTP(Standard Simple Mail Transfer Protocol) 서버가 미국 ASCII 문자와 같은, 7비트 자료만을 승인합니다. 메세지에 8비트 문자가 들어 있는 경우, ESMTP(Extended Simple Mail Transfer Protocol) 서버를 지정하도록 하십시오. ESMTP 서버는 8비트 문자를 승인합니다. Net.Data는 8비트 자료를 7비트 자료로 코드화하지 않습니다. ESMTP 서버에 대한 액세스권이 없는 경우, 전자 우편 메세지에서 8비트 문자를 모두 제거하십시오.

OS/390용 Net.Data 사용자는 SMTP 서버에 대하여 전자 우편 메세지를 수정할 필요가 없습니다.

문자 세트 지원:

OS/400 사용자: 선택적 구성 변수인, DTW_SMTP_CHARSET을 사용하여 EBCDIC에서 ASCII로 메세지를 변환할 때 사용할 ASCII 문자를 지정할 수 있습니다. DTW_SMTP_CHARSET을 지정하지 않는 경우, 생략시 문자 세트는 iso-8859-1입니다. 이 변수에 대한 자세한 내용과 지원되는 문자 세트에 대한 자세한 내용은 OS/400용 Net.Data 관리 및 프로그래밍 안내서의 구성 장을 참조하십시오.

OS/2, Windows NT 및 UNIX 사용자: 표 47에서는 지원되는 문자 세트를 설명합니다.

표 47. Net.Data가 지원하는 문자 세트

로칼	문자 세트	OS/2 또는 UNIX 코드 페이지	Windows NT 코드 페이지
미국, 서부 유럽	"iso-8859-1"	819	1252
일본	"x-sjis"	943	932
중국어(간체)	"gb2312"	1381	936
한국	"euc-kr"	970	949
중국어(정체)	"big5"	950	950

다음 목록은 Net.Data가 전자 우편 메세지를 전송하지 않는 조건을 설명합니다.
- 지정된 SMTP 서버에 도달할 수 없습니다.
- 지정된 SMTP 서버가 ESMTP(Extended Simple Mail Transfer Protocol)를 지원하지 않는데, 지정된 전자 우편 메세지에 미국 ASCII 문자 이외의 문자가 들어 있습니다.

예

예 1: 간단한 전자 우편 메세지를 작성하여 전송하는 함수 호출

@DTW_SENDMAIL("<ibmuser1@ibm.com>", "<ibmuser2@ibm.com>", "There is a meeting at 9:30.",
"Status meeting")

DTW_SENDMAIL 함수는 다음 정보와 함께 전자 우편 메세지를 전송합니다.

Date: Mon, 3 Apr 1998 09:54:33 PST
To: <ibmuser2@ibm.com>
From: <ibmuser1@ibm.com>
Subject: Status meeting
 
There is a meeting at 9:30.

Date 정보는 시스템 날짜 및 시간 함수를 사용하여 구성되어 SMTP 날짜 형식으로 포맷됩니다.

예 2: 여러 명의 수신인, 카본 카피 및 블라인드 카본 카피 수신인, 회사 이름과 함께 전자 우편 메세지를 작성하여 전송하는 함수 호출

@DTW_SENDMAIL("IBM User 1 <ibmuser1@ibm.com>", "IBM User 2 <ibmuser2@ibm.com>,
IBM User 3 <ibmuser3@ibm.com>, IBM User 4 <ibmuser4@ibm.com>", "There is a meeting at 9:30.",
"Status meeting", "IBM User 5 <ibmuser5@ibm.com>", "IBM User 6 <ibmuser6@ibm.com",
"meeting@ibm.com", "IBM")

DTW_SENDMAIL 함수는 다음 정보와 함께 전자 우편 메세지를 전송합니다.

Date: Mon, 3 Apr 1998 09:54:33 PST
To: IBM User 2 <ibmuser2@ibm.com>, IBM User 3 <ibmuser3@ibm.com>, IBM User 4 <ibmuser4@ibm.com>
CC: IBM User 5 <ibmuser5@ibm.com>
BCC: IBM User 6 <ibmuser6@ibm.com>
From: IBM User 1 <ibmuser1@ibm.com>
ReplyTo: meeting@ibm.com
Organzation: IBM
Subject: Status meeting
 
There is a meeting at 9:30.

예 3: 웹 양식 인터페이스를 통해 전자 우편을 작성 및 전송하는 매크로

  %HTML(start) {
 <html>
<body>
  <h1>Net.Data E-Mail Example</h1>
  <form method="post" action="sendemail">
  <p>To:<br><input name="recipient"><p>
  Subject:<br><input name="subject"><p>
  Message:<br><textarea name=message rows=20 cols=40>
  </textarea><p>
  <input type="submit" value="Send E-mail"><br>
</form>
 </body>
</html>
  %}
 
  %HTML(sendemail) {
 <html>
<body>
  <h1>Net.Data E-Mail Example</h1>
  @DTW_SENDMAIL("Net.Data E-mail Service <netdata@us.ibm.com>", recipient, message, subject)
  <p>E-mail has been sent out.
 </body>
</html>
  %}

이 매크로는 웹 양식 인터페이스를 통해 전자 우편을 전송합니다. HTML start 섹션에는 수신인의 전자 우편 주소, 주제 및 메세지를 입력할 수 있는 양식이 표시됩니다. 사용자가 전자 우편 전송 버튼을 누르면, HTML(sendemail) 섹션에 지정된 수신인에게 메세지가 전송됩니다. 이 섹션은 DTW_SENDMAIL를 호출하고 웹 양식에서 확보한 매개변수를 사용하여 수신인 및 수령인뿐 아니라 전자 우편 메세지의 내용을 판별합니다. 전자 우편 메세지가 전송되면 확인 메세지가 표시됩니다.

예 4: SQL 조회를 사용하여 수신인 목록을 결정하는 매크로

%Function(DTW_SQL) mailing_list(IN message) {
  SELECT EMAIL_ADDRESS FROM CUSTOMERS WHERE ZIPCODE='CA'
%REPORT {
      Sending out product information to all customers who live in California...<P>
  %ROW {
        @DTW_SENDMAIL("John Doe Corp. <John.Doe@doe.com>", V1, message, "New Product Release")
        E-mail sent out to customer $(V1).<BR>
      %}
    %}
  %}

이 매크로는 고객 데이타베이스에서의 SQL 조회를 통해 결정된 지정된 고객 그룹에 자동화된 전자 우편 메세지를 전송합니다. 또한 SQL 조회는 고객의 전자 우편 주소를 검색하기도 합니다. 전자 우편의 내용은 message 값에 의해 결정되며, 정적이거나 동적이 될 수 있습니다(예를 들어, 다른 SQL 조회를 사용하여 제품의 버전 번호나 여러 가지 상품의 가격을 동적으로 지정할 수 있습니다).

DTW_SETCOOKIE

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

목적

클라이언트 시스템에 쿠키를 설정하는 JavaScript 코드를 생성합니다.

형식

@DTW_SETCOOKIE(IN cookie_name, IN cookie_value, IN advanced_options)

@DTW_SETCOOKIE(IN cookie_name, IN cookie_value)

매개변수

표 48. DTW_SETCOOKIE 매개변수

자료 유형	매개변수	사용	설명
문자열	`cookie_name`	IN	쿠키의 이름을 지정하는 변수 또는 리터럴 문자열
문자열	`cookie_value`	IN	쿠키의 값을 지정하는 변수 또는 리터럴 문자열 `cookie_value`에는 세미콜론, 콤마 및 공백을 사용하지 마십시오. 이들을 사용해야 하는 경우, DTW_SETCOOKIENet.Data 함수 DTW_rURLESCSEQ를 사용하여 특수 문자가 들어 있는 문자열을 DTW_SETCOOKIE에 전달하기 전에 이 문자열을 처리하십시오. 예를 들면 다음과 같습니다. @DTW_SETCOOKIE("my_cookie_name", @DTW_rURLESCSEQ("my cookie value"))
문자열	`advanced_options`	IN	쿠키를 정의하는 데 사용되는 선택적 속성들(콤마로 구분됨)이 들어 있는 문자열. 속성은 다음과 같습니다. `expires` = `date` 쿠키의 유효 기간을 정의하는 날짜 문자열을 지정합니다. 날짜가 만기되고 나면, 쿠키는 더 이상 저장 또는 검색되지 않습니다. 구문은 다음과 같습니다. `weekday`, `DD`-`month`-`YYYY HH:MM:SS` GMT 여기서, `weekday` 완전한 요일 이름을 지정합니다. `DD` 월의 일자를 지정합니다. `month` 월에 대한 세 문자 약어를 지정합니다. `YYYY` 네 문자의 연도 수를 지정합니다. `HH:MM:SS` 시간, 분 및 초로 시간소인을 지정합니다. `domain` = `domain_name` 일치하는 도메인 속성에 사용하도록 쿠키의 도메인 속성을 지정합니다. `path` = `path` 쿠키가 효력을 갖는 도메인에서 URL의 서브세트를 지정합니다. `secure` 보안 채널을 통해서만 쿠키가 HTTPS 서버로 전송되도록 지정합니다. `secure` 옵션이 지정되지 않은 경우, 비보안 채널을 통해 쿠키를 전송할 수 있습니다. 보안 옵션에서는 브라우저가 쿠키를 코드화할 필요가 없으며, DTW_SETCOOKIE 문이 들어 있는 페이지가 SSL을 통해 전송되지도 않습니다. 확장 옵션에 대한 추가 정보는 `http://home.netscape.com`에서 Netscape 쿠키 스펙을 참조하십시오.

리턴 코드

표 49. DTW_SETCOOKIE 리턴 코드

리턴 코드	설명
-1001	서버가 메모리를 할당하기 위한 Net.Data 요청을 처리할 수 없습니다.
1001	입력 매개변수가 널(NULL) 값을 포함합니다.
1002	입력 매개변수가 널(Null) 종료 문자로 이루어진 문자열을 포함합니다.
1003	함수 호출에 전달된 매개변수의 수가 허용되는 최대 수를 초과하거나 또는 함수에서 필요로하는 최소 수보다 작습니다.
1005	함수에 전달된 문자열 변수여야 하는 매개변수가 다른 변수 유형을 갖습니다.

사용법 메모

클라이언트 웹 브라우저가 자바 스크립트를 지원하지 않는 경우, 브라우저는 쿠키를 설정하지 않습니다.
DTW_SETCOOKIE는 자바 스크립트 코드를 생성하므로, <SCRIPT> 또는 <NOSCRIPT> HTML 요소 내부에서는 DTW_SETCOOKIE를 호출하지 마십시오.
쿠키를 검색하려면 DTW_GETCOOKIE() 함수를 사용하십시오. 쿠키를 정의하는 방법에 대해서는 DTW_GETCOOKIE를 참조하십시오.
하나의 쿠키를 두 개의 개별 HTTP 요청으로 정의 및 검색하십시오. 쿠키는 클라이언트에 전송된 후에만 가시화되므로 매크로가 동일한 HTTP 요청에 정의된 쿠키를 얻고자 하면 예상치 못한 결과가 초래될 수 있습니다.

예

예 1: 보안 확장 옵션과 더불어 사용자 ID 및 암호 정보가 들어 있는 쿠키를 정의합니다.

@DTW_SETCOOKIE("mycookie_name_for_userID", "User1")
@DTW_SETCOOKIE("mycookie_name_for_password", "sd3dT", "secure")

예 2: 만기일 확장 옵션을 가지는 쿠키를 정의합니다.

@DTW_SETCOOKIE("mycookie_name_for_userID", "User1",
   "expires=Wednesday 01-Dec-2010 00:00:00")
@DTW_SETCOOKIE("mycookie_name_for_password", "sd3dT",
   "expires=Wednesday, 01-Dec-2010 00:00:00;secure")

함수 호출은 한 행에 작성해야 합니다. 이 예에서는 보기 쉽게 행을 분리했습니다.

예 3: 사용자 정보를 수집하기 전에 사용자에 대한 쿠키가 존재하는지 판별합니다.

%HTML(welcome) {
 <html>
<body>
  <h1>Net.Data Club</h1>
  @DTW_GETCOOKIE("NDC_name", name)
  %IF ($(RETURN_CODE) == "8000") %{ The cookie is not found. %}
  <form method="post" action="remember">
  <p>Welcome to the club. Please enter your name.<br>
  <input name="name">
  <input type="submit" value="submit"><br>
</form>
%ELSE
  <p>Hi, $(name). Welcome back.
%ENDIF
 </body>
</html>
  %}

HTML(welcome) 섹션에서는 쿠키 NDC_name이 존재하는지 점검합니다. 쿠키가 존재하면 브라우저는 개별화된 환영 화면을 표시합니다. 쿠키가 존재하지 않으면, 브라우저는 사용자 이름을 입력하라는 프롬프트를 표시하고 이를 HTML(remember) 섹션에 기재합니다. 이 섹션은 아래와 같이 사용자 이름을 쿠키 NDC_name에 기록합니다.

%HTML(remember) {
 <html>
<body>
  <H1>Net.Data Club>
  @DTW_SETCOOKIE("NDC_name", name, "expires=Wednesday, 01-Dec-2010 00:00:00;path=/")
  <p>Thank you.
  <p><a href="welcome">Come back</a>
 </body>
</html>
  %}

DTW_SETENV

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

목적

지정된 값으로 환경 변수를 지정하고 이전 값을 리턴합니다.

형식

@DTW_SETENV(envVarName, envVarValue, prevValue)

@DTW_rSETENV(envVarName, envVarValue)

매개변수

표 50. DTW_SETENV 매개변수

자료 유형	매개변수	사용	설명
문자열	`envVarName`	IN	환경 변수를 나타내는 리터럴 문자열 또는 변수.
문자열	`envVarValue`	IN	환경 변수가 지정된 값이 있는 변수 또는 리터럴 문자열.
문자열	`prevValue`	OUT	환경 변수의 이전 값이 들어 있는 변수.

리턴 코드

표 51. DTW_SETENV 리턴 코드

리턴 코드	설명
-1001	서버가 메모리를 할당하기 위한 Net.Data 요청을 처리할 수 없습니다.
1001	입력 매개변수가 널(NULL) 값을 포함합니다.
1003	함수 호출에 전달된 매개변수의 수가 허용되는 최대 수를 초과하거나 또는 함수에서 필요로하는 최소 수보다 작습니다.
1005	함수에 전달된 문자열 변수여야 하는 매개변수가 다른 변수 유형을 갖습니다.
1006	출력 매개변수여야 하는 매개변수에 대한 함수 호출에 리터럴 문자열이 전달되었습니다.

사용법 메모

환경 변수에 대한 이전 값이 없는 경우, 빈 문자열을 리턴합니다.

예

예 1: 이전 경로의 값을 리턴합니다.

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

입력: envVarName = "PATH", envVarValue = "myPath"
결과: prevValue = "myPreviousPath"

예 2: 이전 경로의 값을 리턴하고 PATH 값에 대한 값을 지정합니다.

@DTW_rSETENV("PATH", "myPath")

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

DTW_TIME

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

목적

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

형식

@DTW_TIME(stringIn, stringOut)

@DTW_TIME(stringOut)

@DTW_rTIME(stringIn)

@DTW_rTIME()

매개변수

표 52. DTW_TIME 매개변수

자료 유형	매개변수	사용	설명
문자열	`stringIn`	IN	시간 형식을 지정하는 리터럴 문자열 또는 변수. 유효한 형식은 다음과 같습니다. C - 12시간제(hh:mmAM/PM) L - 현지 시간(hh:mm:ss) N - 24시간제(hh:mm:ss); 생략시 값 X - 확장 시간(24시간 시계를 사용하는 hh:mm:ss.ccc-hour 여기서 ccc는 밀리초를 나타내는 수) H - 자정 이후 시간 M - 자정 이후 분 S - 자정 이후 초
문자열	`stringOut`	OUT	지정된 형식의 시간을 포함하는 변수.

리턴 코드

표 53. DTW_TIME 리턴 코드

리턴 코드	설명
-1001	서버가 메모리를 할당하기 위한 Net.Data 요청을 처리할 수 없습니다.
1003	함수 호출에 전달된 매개변수의 수가 허용되는 최대 수를 초과하거나 또는 함수에서 필요로하는 최소 수보다 작습니다.
1005	함수에 전달된 문자열 변수여야 하는 매개변수가 다른 변수 유형을 갖습니다.
1006	출력 매개변수여야 하는 매개변수에 대한 함수 호출에 리터럴 문자열이 전달되었습니다.
1007	매개변수가 유효하지 않은 값을 포함합니다.

예

예 1: 24시간제 형식

@DTW_TIME(results)

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

예 2: 12시간제 형식

@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	Linux	OS/2	OS/390	OS/400	SCO	SUN	Win NT
X	X	X	X	X	X	X	X	X

목적

URL에 허용되지 않는 선택된 문자를 URL 코드화 코드로 알려진 이탈 값으로 대체합니다.

형식

@DTW_URLESCSEQ(stringIn, stringOut)

@DTW_rURLESCSEQ(stringIn)

매개변수

표 54. DTW_URLESCSEQ 매개변수

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

리턴 코드

표 55. DTW_URLESCSEQ 리턴 코드

리턴 코드	설명
-1001	서버가 메모리를 할당하기 위한 Net.Data 요청을 처리할 수 없습니다.
1003	함수 호출에 전달된 매개변수의 수가 허용되는 최대 수를 초과하거나 또는 함수에서 필요로하는 최소 수보다 작습니다.
1005	함수에 전달된 문자열 변수여야 하는 매개변수가 다른 변수 유형을 갖습니다.
1006	출력 매개변수여야 하는 매개변수에 대한 함수 호출에 리터럴 문자열이 전달되었습니다.

사용법 메모

이 함수를 사용하여 표 56에 나열된 임의의 문자를 다른 매크로 또는 HTML 블록에 전달합니다.

표 56. URL용 문자 이탈 값

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

예

예 1: string1의 공백과 앰퍼샌드 문자를 이탈 코드로 대체하고 결과를 string2에 할당합니다.

@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를 사용하고 공백과 @ 기호를 이탈 코드로 대체합니다.

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

응용프로그램 사용자가 이름 "Patrick O'Brien"을 클릭하면, 이름과 전자 메일 주소로 지정된 값은 URL의 조회 문자열 내에서 흐르며 이에 따라 Net.Data는 fullrpt.mac 매크로의 입력 섹션을 실행하게 됩니다.

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