이 절에서는 Net.Data 매크로에서 사용되는 언어 구조를 설명합니다.
각 언어 구문 설명에는 다음과 같은 정보가 들어 있습니다.
다음 구문은 매크로에서 사용됩니다. 구문과 예제에 대해서는 각 구문 설명을 참조하십시오.
목적
Net.Data 매크로의 함수를 문서화합니다. COMMENT 블록은 매크로의 어느 지점에서나 사용할 수 있으므로 다른 구문 도표에서는 문서화되지 않습니다.
COMMENT 블록은 Net.Data 초기화 파일에서도 사용할 수 있습니다.
구문
>>-%{---텍스트---%}--------------------------------------------><
값
문맥
주석은 Net.Data 매크로나 Net.Data 초기화 파일에서 Net.Data 언어 구조들 사이의 임의의 지점에 배치할 수 있습니다.
제한
어떤 텍스트나 문자도 사용할 수 있습니다. 그러나 주석 블록은 중첩시킬 수 없습니다.
예
예 1: 기본 주석 블록
%{
This is a comment block. It can contain any number of lines
and contain any characters. Its contents are ignored by Net.Data.
%}
예 2: FUNCTION 블록의 주석
%function(DTW_REXX) getAddress(IN name, %{ customer name %}
IN phone, %{ customer phone number %}
OUT address %{ customer address %}
)
{
....
%}
예 3: HTML 블록의 주석
%html(report) {
%{ run the query and save results in a table %}
@myQuery(resultTable)
%{ build a form to display a page of data %}
<form method="POST" action="report">
%{ send the table to a REXX function to send the data output %}
@displayRows(START_ROW_NUM, submit, resultTable, RPT_MAX_ROWS)
%{ pass START_ROW_NUM as a hidden variable to the next invocation %}
<input name="START_ROW_NUM" type="hidden" value="$(START_ROW_NUM)">
%{ build the next and previous buttons %}
%if (submit == "both" || submit == "next_only")
<input name="submit" type="submit" value="next">
%endif
%if (submit == "both" || submit == "prev_only")
<input name="submit" type="submit" value="previous">
%endif
</form>
%}
예 4: DEFINE 블록의 주석
%define {
START_ROW_NUM = "1" %{ starting row number for output table %}
RPT_MAX_ROWS = "25" %{ maximum number of rows in the table %}
resultTable = %table %{ table to hold query results %}
%}
예 5: Net.Data 초기화 파일의 주석
%{ changes: removed RETURN_CODE parm and DTW_DEFAULT ENVIRONMENT statement %}
...
ENVIRONMENT (DTW_SQL) dtwsql (IN LOCATION, DB2SSID, DB2PLAN, TRANSACTION_SCOPE)
ENVIRONMENT (DTW_ODBC) odbcdll (IN LOCATION, TRANSACTION_SCOPE)
ENVIRONMENT (DTW_PERL) perldll ()
ENVIRONMENT (DTW_REXX) rexxdll ()
ENVIRONMENT (DTW_FILE) filedll ()
ENVIRONMENT (DTW_APPLET) appldll ()
ENVIRONMENT (DTW_SYSTEM) sysdll ()
목적
DEFINE 섹션은 매크로의 선언 부분에 변수명을 정의하며 명령문이 되거나 블록이 될 수 있습니다.
변수 정의는 큰 따옴표("")를 사용하여 한 행이 되게 할 수도 있고, 중괄호와 퍼센트 기호({ %})를 사용하여 여러 행이 되게 할 수도 있습니다. 변수가 정의되면 매크로의 임의의 지점에서 이를 참조할 수 있습니다.
구문
>>-%DEFINE----+----------------------------+-------------------->
| (1) |
'-(--+-STATIC---------+---)--'
| (1) |
'-TRANSIENT------'
>-----+-| 항목 정의 |-----------------------------+------------><
'-{--+------------------------------+---%}--'
| .------------------------. |
| V | |
'----+-define entry------+--+--'
'-include statement-'
항목 정의
.--------------------------.
V |
|---+-variable name--=--+-"-----+--------------------+--+---"---+-+->
| | +-string-------------+ | |
| | +-variable reference-+ | |
| | '-function call------' | |
| | .--------------------------. | |
| | V | | |
| +-{-----+--------------------+--+---%}--+ |
| | +-string-------------+ | |
| | +-variable reference-+ | |
| | +-function call------+ | |
| | '-new_line-----------' | |
| +-exec statement------------------------+ |
| +-table statement-----------------------+ |
| +-envvar statement----------------------+ |
| +-| 조건 변수 |-------------------------+ |
| '-| 축약 조건 변수 |--------------------' |
'-list statement----------------------------------------------'
>---------------------------------------------------------------|
조건 변수
|---variable name---?------------------------------------------->
.--------------------------.
V |
>-----+-"-----+--------------------+--+---"---+----------------->
| +-string-------------+ |
| +-variable reference-+ |
| '-function call------' |
| .--------------------------. |
| V | |
'-{-----+--------------------+--+---%}--'
+-string-------------+
+-variable reference-+
'-function call------'
.--------------------------.
V |
>-------:--+-"-----+--------------------+--+---"---+------------|
| +-string-------------+ |
| +-variable reference-+ |
| '-function call------' |
| .--------------------------. |
| V | |
'-{-----+--------------------+--+---%}--'
+-string-------------+
+-variable reference-+
'-function call------'
축약 조건 변수
.--------------------------.
V |
|---?----+-"-----+--------------------+--+---"---+--------------|
| +-string-------------+ |
| +-variable reference-+ |
| '-function call------' |
| .--------------------------. |
| V | |
'-{-----+--------------------+--+---%}--'
+-string-------------+
+-variable reference-+
'-function call------'
주:
값
문맥
DEFINE 블록이나 명령문은 IF 블록의 내부 또는 Net.Data 매크로의 선언 부분에서 다른 모든 블록의 외부에 있어야 합니다.
제한
%DEFINE var = "The value is $(var)."
예
예 1: 간단한 변수 정의
%DEFINE var1 = "orders" %DEFINE var2 = "$(var1).html"
수행시 변수 참조 $(var2)는 orders.html로 평가됩니다.
예 2: 문자열 안의 인용 부호
%DEFINE hi = "say ""hello""" %DEFINE empty = ""
표시될 때, 변수 hi는 say "hello"의 값을 갖습니다. 변수 empty는 널(NULL)이 됩니다.
예 3: 복수 변수의 정의
%DEFINE{ DATABASE = "testdb"
home = "http://www.software.ibm.com"
SHOWSQL = "YES"
PI = "3.14150"
%}
예 4: 변수의 복수 행 정의
%DEFINE text = {This variable definition
spans two lines
%}
예 5: 이 조건 변수 예에서는 결과 값에 널(NULL)이 포함되지 않은 경우 변수 var이 인용 부호("")안에 결과 값을 갖도록 하는 방법을 보여줍니다.
%DEFINE var = ? "Hello! $(V)@MyFunc()" %}
목적
DEFINE 블록에서 변수를 환경 변수로 정의합니다. ENVVAR 변수가 참조되면, Net.Data는 환경 변수의 현재 값을 동일한 이름으로 리턴합니다.
구문
>>-%ENVVAR-----------------------------------------------------><
문맥
ENVVAR 명령문은 DEFINE 블록이나 명령문이 될 수 있습니다.
값
제한
ENVVAR 명령문은 다른 요소를 포함할 수 없습니다.
예
예 1: 이 예에서 ENVVAR은 참조되었을 때 웹 서버의 이름인 환경 변수 SERVER_SOFTWARE에 대한 현재 값을 리턴하는 변수를 정의합니다.
%DEFINE SERVER_SOFTWARE = %ENVVAR
%HTML(REPORT) {
The server is $(SERVER_SOFTWARE).
%}
목적
변수가 참조되거나 함수가 호출될 때 실행되는 외부 프로그램을 지정합니다.
Net.Data는 매크로에서 실행 가능 변수를 발견하면, 다음의 방법으로 참조된 실행 가능 프로그램이 있는지 조회합니다.
권한 부여 정보: Net.Data를 실행하는 사용자 ID는 EXEC문이나 블록에 참조된 모든 파일에 대한 액세스 권한을 가지고 있어야 합니다. 자세한 내용은 운영 체제에 대한 Net.Data 관리 및 프로그래밍 안내서의 구성 장에서 Net.Data 파일에 대한 웹 서버 액세스 권한 지정 절을 참조하십시오.
EXEC 명령문과 블록은 두 개의 서로 다른 컨텍스트에 사용되며, 사용되는 컨텍스트에 따라 서로 다른 구문을 갖습니다. DEFINE 블록에서는 EXEC 명령문을 사용하고 FUNCTION 블록에서는 EXEC 블록을 사용하십시오.
구문
DEFINE 블록에서 사용되는 EXEC 명령문 구문
.--------------------------.
V |
>>-%EXEC------"-----+--------------------+--+---"--------------><
+-string-------------+
+-variable reference-+
'-function call------'
FUNCTION 블록에서 사용되는 EXEC 블록 구문
.-------------------------.
V |
>>-%EXEC------{----+-string-------------+--+---%}--------------><
+-variable reference-+
'-function call------'
값
문맥
EXEC 블록이나 명령문은 다음의 컨텍스트에서 찾을 수 있습니다.
제한
EXEC 블록이나 명령문에는 다음의 요소가 포함될 수 있습니다.
다음의 Net.Data 제공 언어 환경은 EXEC문을 지원합니다.
예
예 1: 변수에 참조되는 실행 가능 파일
%DEFINE mycall = %EXEC "MYEXEC.EXE $(empno)"
%HTML (report){
<P>Here is the report you requested:
<HR>$(mycall)
%}
이 예는 변수 mycall을 참조할 때마다 MYEXEC.EXE를 실행합니다.
예 2: 함수에 참조되는 실행 가능 파일
%FUNCTION(DTW_REXX) my_rexx_pgm(INOUT a, b, IN c, INOUT d){
%EXEC{ mypgm.cmd this is a test %}
%}
이 예는 함수 my_rexx_pgm이 호출되면 mypgm.cmd를 실행합니다.
목적
Net.Data가 매크로에서 호출하는 서브루틴을 정의합니다. FUNCTION 블록의 실행 가능 명령문은 언어 환경에서 직접 해석되는 인라인 명령문이 되거나 외부 프로그램에 대한 호출이 될 수 있습니다.
FUNCTION 블록내에 EXEC 블록을 사용하는 경우, 이것이 FUNCTION 블록에서의 유일한 실행 가능 명령문이 되어야 합니다. 실행 가능 명령문을 언어 환경에 전달하기 전에, Net.Data는 EXEC 블록에 있는 프로그램의 파일명을 초기화 파일의 EXEC_PATH 구성 명령문에 의해 정해진 경로명에 추가합니다. 이 결과 얻어진 문자열이 실행될 언어 환경으로 전송됩니다.
언어 환경이 EXEC 블록을 처리하는 데 사용하는 방법은 특정 언어 환경에 따라 다릅니다. REXX, System 및 Perl Net.Data 제공 언어 환경은 EXEC 블록을 지원합니다.
Net.Data 언어 구문과 일치하는 문자가 함수 블록의 언어 명령문 섹션에서 구문상으로 유효한 내포 프로그램 코드(예: REXX 또는 Perl)의 일부로 사용되는 경우, 이들은 Net.Data 언어 구문으로 잘못 해석되어 매크로에서 오류나 예상치 못한 결과를 초래할 수 있습니다.
예를 들어, Perl 함수는 COMMENT 블록 분리문자 %{를 사용할 수 있습니다. 매크로가 수행되는 경우, %{ 문자는 COMMENT 블록의 시작으로 해석됩니다. 이 경우 Net.Data는 COMMENT 블록의 끝을 찾게 되고, 함수 블록의 끝을 찾게 되면 COMMENT 블록의 끝을 찾은 것으로 생각합니다. Net.Data는 다시 함수 블록의 끝을 찾게 되고 함수 블록의 끝을 찾을 수 없는 경우 오류를 발생시킵니다.
내포된 프로그램 코드를 Net.Data에서 특수 문자로 해석하지 않게 하면서 Net.Data 특수 문자를 내포된 프로그램 코드의 일부로 사용하려면 다음 방법 중 하나를 사용하십시오.
예를 들어, 다음과 같은 Perl 함수는 COMMENT 블록 분리문자, %{를 나타내는 문자를 Perl 언어 명령문의 일부로 포함합니다.
%function(DTW_PERL) func() {
...
for $num_words (sort bynumber keys %{ $Rtitles{$num} }) {
&make_links($Rtitles{$num}{$num_words});
}
...
%}
Net.Data가 %{ 문자를 Net.Data COMMENT 블록 분리문자가 아닌 Perl 소스 코드로 해석하게 하려면 다음 중 한 방법으로 함수를 다시 쓰십시오.
%function(DTW_PERL) func() {
%EXEC{ func.prl %}
%}
%define percent_openbrace = "%{"
%function(DTW_PERL) func() {
...
for $num_words (sort bynumber keys $(percent_openbrace) $Rtitles{$num} }) {
&make_links($Rtitles{$num}{$num_words});
}
...
%}
구문
>>-%FUNCTION--(--lang_env--)--function_name--| 매개변수 전달 스펙 |-->
.-;--------------------------------------.
>----+-| 리턴 스펙 |--{--| 함수 내용 |----%}--+----------------><
매개변수 전달 스펙
|---(--+---------------------------------------------+---)------|
| .-,-------------------------------------. |
| | (1) | |
| V .-IN-------. | |
'----+----------+---+-----------+---name---+--'
+-OUT------+ '-datatype--'
'-INOUT----'
리턴 스펙
|---+----------------------+------------------------------------|
'-RETURNS--(--name--)--'
함수 내용
|---+-------------------------------+--------------------------->
| .--------------------------. |
| V | |
+----inline statement block---+-+
'-exec block--------------------'
>-----+-----------------------------------------------+---------|
| .---------------------. |
| V (2) | |
+----report block--------+---+----------------+-+
| '-message block--' |
| .--------------------------. |
| V | |
'-message block-----+--------------------+--+---'
| (2) |
'-report block-------'
주:
값
문맥
FUNCTION 블록은 다음 컨텍스트에 들어 있습니다.
제한
DB2에는 다음의 제한사항이 있습니다.
예
다음 예제는 범용 예제로써 모든 언어 환경에 적용되지는 않습니다. 특정 언어 환경에서 FUNCTION 블록을 사용하는 데 대한 자세한 내용은 Net.Data Language Environment Reference를 참조하십시오.
예 1: REXX 부속 문자열 함수
%DEFINE lstring = "longstring"
%FUNCTION(DTW_REXX) substring(IN x, y, z) RETURNS(s) {
s = substr("$(x)", $(y), $(z));
%}
%DEFINE a = {@substring(lstring, "1", "4")%} %{ assigns "long" to a %}
a가 평가되면, @substring 함수 호출이 찾아지고 부속 문자열 FUNCTION 블록이 실행됩니다. 변수는 FUNCTION 블록내의 실행 가능 명령문에서 대체되고, 텍스트 스트링 s = substr("longstring", 1, 4)이 REXX 해석기로 전달되어 실행됩니다. RETURNS 절이 지정되었기 때문에, a의 평가시 @substring 함수 호출의 값은 s의 값인 "long"으로 대체됩니다.
예 2: 외부 REXX 프로그램 호출
%FUNCTION(DTW_REXX) my_rexx_pgm(INOUT a, b, IN c, OUT d) {
%EXEC{ mypgm.cmd this is a test %}
%}
%HTML(INPUT) {
<P> Original variable values: $(w) $(x) $(z)
<P> @my_rexx_pgm(w, x, y, z)
<P> Modified variable values: $(w) $(x) $(z)
%}
함수의 INOUT 매개변수 a 및 b에 해당하는 변수 w 및 x. 이 값과 IN 매개변수 c에 해당하는 y의 값은 HTML 양식 입력이나 DEFINE 명령문에서 이미 정의했어야 합니다. 매개변수 a와 b가 값을 리턴하면 변수 a 및 b에 새로운 값이 지정됩니다. OUT 매개변수 d가 값을 리턴하면 변수 z가 정의됩니다.
/* Sample REXX Program for Example 2 */ /* Test arguments */ num_args = arg(); say 'There are' num_args 'arguments'; do i = 1 to num_args; say 'arg' i 'is "'arg(i)'"' end; /* Set variables passed from Net.Data */ d = a || b || c; /* concatenate a, b, and c forming d */ a = ''; /* reset a to null string */ b = ''; /* reset b to null string */ return;
There are 1 arguments arg 1 is "this is a test"
EXEC 명령문은 REXX 해석기가 외부 REXX 프로그램인 mypgm.cmd를 실행하도록 REXX 언어 환경에 지시합니다. REXX 언어 환경은 REXX 프로그램과 Net.Data 변수를 직접 공유할 수 있기 때문에, mypgm.cmd를 실행하기 전에 REXX 변수 a, b 및 c에 Net.Data 변수 w, x 및 y의 값을 지정합니다. mypgm.cmd는 REXX 명령문에 변수 a, b 및 c를 바로 사용할 수 있습니다. 프로그램이 종료되면, REXX 프로그램으로부터 REXX 변수 a, b 및 d가 검색되고, 이의 값이 Net.Data 변수 w, x 및 z에 지정됩니다. my_rexx_pgm FUNCTION 블록의 정의에는 RETURNS 절이 사용되지 않으므로, @my_rexx_pgm 함수 호출의 값은 널(NULL) 문자열 ""이 되거나(리턴 코드가 0인 경우), REXX 프로그램 리턴 코드의 값이 됩니다(리턴 코드가 0이 아닌 경우).
예 3: SQL 조회 및 보고서
%FUNCTION(DTW_SQL) query_1(IN x, IN y) {
SELECT customer.num, order.num, part.num, status
FROM customer, order, shippingpart
WHERE customer.num = '$(x)'
AND customer.ordernumber = order.num
AND order.num = '$(y)'
AND order.partnumber = part.num
%REPORT{
<P>Here is the status of your order:
<P>$(NLIST)
<UL>
%ROW{
<LI>$(V1) $(V2) $(V3) $(V4)
%}
</UL>
%}
%}
%DEFINE customer_name="IBM"
%DEFINE customer_order="12345"
%HTML(REPORT) {
@query_1(customer_name, customer_order)
%}
@query_1 함수 호출은 SELECT문에서 $(x)를 IBM으로, $(y)를 12345로 대체합니다. SQL 함수 query_1의 정의가 출력 테이블 변수를 식별하지 못하므로, 생략시 테이블이 사용됩니다(자세한 내용은 TABLE 변수 블록을 참조하십시오). REPORT 블록에서 참조되는 NLIST 및 Vi 변수는 생략시 테이블 정의에 의해 정의됩니다. REPORT 블록에 의해 작성된 보고서는 query_1 함수가 호출된 출력 HTML에 배치됩니다.
예 4: Perl 스크립트를 실행하기 위한 시스템 호출
%FUNCTION(DTW_SYSTEM) today() RETURNS(result) {
%exec{ perl "today.prl" %}
%}
%HTML(INPUT) {
@today()
%}
$date = `date`;
chop $date;
open(DTW, "> $ENV{DTWPIPE}") || die "Could not open: $!";
print DTW "result = \"$date\"\n";
System 언어 환경은 FUNCTION 블록내의 실행 가능 명령문들을 C 언어 system() 함수 호출을 통해 운용 시스템으로 전달하여 해석합니다. 이 방법은 Net.Data 변수를 REXX 언어 환경에서처럼 실행 가능 명령문으로 직접 전달하거나 검색하지 못하도록 합니다. 따라서 System 언어 환경은 다음과 같은 방식으로 변수를 전달 및 검색합니다.
@today 함수 호출이 발견되면, Net.Data는 실행 가능 명령문에서 변수 대체를 수행합니다. 이 예제에서는 실행 가능 명령문에 Net.Data 변수가 없으므로, 어떠한 변수 대체도 수행되지 않습니다. 실행 가능 명령문과 매개변수가 System 언어 환경으로 전달되면, 언어 환경은 named pipe를 작성하고 환경 변수 DTWPIPE를 파이프 이름으로 설정합니다.
그런 다음, 외부 프로그램이 C system() 함수 호출을 사용하여 호출됩니다. 외부 프로그램은 파이프를 쓰기 전용으로 열어 표준 스트림 파일인 것처럼 파이프에 출력 매개변수의 값을 기록합니다. 외부 프로그램은 STDOUT에 기록하여 HTML 출력을 생성합니다. 이 예제에서, 시스템 날짜 프로그램의 출력은 FUNCTION 블록의 RETURNS 절에서 식별되는 변수인 result에 지정됩니다. result 변수의 값은 HTML 블록내의 @today() 함수 호출을 대체합니다.
예 5: Perl 언어 환경
%FUNCTION(DTW_PERL) today() RETURNS(result) {
$date = `date`;
chop $date;
open(DTW, "> $ENV{DTWPIPE}") || die "Could not open: $!";
print DTW "result = \"$date\"\n";
%}
%HTML(INPUT) {
@today()
%}
EXEC 블록이 사용되는 방법을 보려면 예 4와 비교해 보십시오. 예 4에서, System 언어 환경은 Perl 프로그램을 해석하는 방법은 알지 못하지만, 외부 프로그램을 호출하는 방법은 알고 있습니다. EXEC 블록은 perl 프로그램을 외부 프로그램으로 호출하도록 지시합니다. 실제 Perl 언어 명령문은 외부 Perl 프로그램에 의해 해석됩니다. 예 5에는 Perl 언어 환경이 Perl 언어 명령문을 직접 해석할 수 있으므로 EXEC 블록이 없습니다.
목적
FUNCTION 블록, MACRO_FUNCTION 블록 또는 인수가 지정된 내장 함수를 호출합니다. 함수가 내장 함수가 아닌 경우, 함수 호출을 지정하기 전에 이를 Net.Data 매크로에 정의해야 합니다.
구문
>>-@function_name---(------------------------------------------->
>-----+-----------------------------------------------+--)-----><
| .-,----------------------------------------. |
| V | |
'----+-variable_name-----------------------+--+-'
+-variable reference------------------+
+-function call-----------------------+
| .-------------------------. |
| V | |
'-"----+-string-------------+--+---"--'
+-variable reference-+
'-function call------'
값
문맥
다음의 컨텍스트에서 함수 호출을 찾을 수 있습니다.
제한
예
예 1: SQL 함수 formQuery에 대한 호출
%FUNCTION(DTW_SQL) formQuery(){
SELECT $(queryVal) from $(tableName)
%}
%HTML (input){
<P>Which columns of $(tableName) do you want to see?
<FORM METHOD="POST" ACTION="report">
<INPUT NAME="queryVal" TYPE="CHECKBOX" VALUE="NAME">Name
<INPUT NAME="queryVal" TYPE="CHECKBOX" VALUE="MAIL">E-mail
<INPUT NAME="queryVal" TYPE="CHECKBOX" VALUE="FAX">FAX
<INPUT TYPE="SUBMIT" VALUE="Submit request">
%}
%HTML (report){
<P>Here are the columns you selected:
<HR>@formQuery()
%}
예 2: 입력 및 출력 매개변수를 포함한 REXX 함수에 대한 호출
%FUNCTION(DTW_REXX) my_rexx_pgm(INOUT a, b, IN c, OUT d) {
%EXEC{ mypgm.cmd this is a test %}
%}
%HTML(INPUT) {
<P> Original variable values: $(w) $(x) $(z)
<P> @my_rexx_pgm(w, x, y, z)
<P> Modified variable values: $(w) $(x) $(z)
%}
예 3: 변수 참조 및 함수 호출을 사용하는 입력 매개변수가 있는 REXX 함수에 대한 호출
%FUNCTION(DTW_REXX) my_rexx_pgm(IN a, b, c, d, OUT e) {
...
%}
%HTML(INPUT){
<p> @my_rexx_pgm($(myA), @getB(), @retrieveC(), $(myD), myE)
%}
예 4: INOUT 매개변수의 사용을 설명하는 매크로.
%DEFINE a = "initial value of a"
%FUNCTION(DTW_REXX) func1(INOUT x) {
Say 'value at start of function:<br>
Say 'x =' x
Say '
<p>
'
x = "new value of a"
%REPORT {
<p>
value at start of report block:<br>
x = $(x)<br>
@dtw_assign(x, "newest value of a")
value at end of report block:<br>
x = $(x)<br>
%}
%}
%HTML(report) {
initial values:<br>
a = $(a)<br>
@func1(a)
value after function call:<br>
a = $(a)<br>
%}
결과 출력:
initial values: a = initial value of a value at start of function: x = initial value of a value at start of report block: x = new value of a value at end of report block: x = newest value of a value after function call: a = newest value of a
목적
웹 페이지 표시 방법을 정의합니다. 실행할 HTML 블록의 이름은 Net.Data 호출시에 URL에 지정됩니다. HTML 블록에는 대부분의 Net.Data 매크로 언어 명령문과 HTML 및 Javascript와 같은 유효한 표시 명령문이 포함될 수 있습니다.
구문
>>-%HTML----(--name--)------------------------------------------>
.-----------------------------.
V |
>-----{-----+-----------------------+--+---%}------------------><
+-exec_sql statement----+
+-variable reference----+
+-if block--------------+
+-function call---------+
+-HTML statement--------+
+-include statement-----+
+-include_url statement-+
'-while block-----------'
값
문맥
HTML 블록은 다음 컨텍스트에 들어 있습니다.
제한
HTML 블록에는 다음의 요소가 포함될 수 있습니다.
예
예 1: 머리말 및 꼬리말을 위한 include 파일이 있는 HTML 블록
%HTML(example1){
%INCLUDE"header.html"
<P>You can put <EM>any</EM> HTML in an HTML block.
An SQL function call is made like this:
@xmp1()
%INCLUDE"footer.html"
%}
예 2: 이름에 마침표가 포함된 HTML 블록
%HTML(my.report){
%INCLUDE"header.html"
<P>You can put <EM>any</EM> HTML in an HTML block.
An SQL function call is made like this:
@xmp1()
%INCLUDE"footer.html"
%}
조건부 문자열 처리를 수행합니다. IF 블록은 하나 이상의 조건을 테스트하고 조건 테스트의 결과에 따라 명령문 블록을 수행하도록 합니다. 또다른 IF 블록내에 IF 블록을 중첩시킬 수 있을 뿐 아니라 Net.Data 매크로의 선언부에 있는 IF 블록, HTML 블록, MACRO_FUNCTION 블록, REPORT 블록, WHILE 블록 및 ROW 블록을 사용할 수 있습니다.
조건 목록의 문자열 값은 이것이 정수를 나타내는 문자열이고 선행 또는 후미 공백이 없는 경우 비교를 위해 숫자로 취급됩니다. 여기에는 하나의 플러스(+) 또는 마이너스(-) 기호가 선행할 수 있습니다.
제한사항: Net.Data는 유동 소수점 수와 같이 정수가 아닌 숫자의 숫자 비교는 지원하지 않습니다.
중첩된 IF 블록: IF 블록 구문의 규칙은 매크로에서 블록의 위치에 의해 결정됩니다. IF 블록이 선언부에서 다른 블록의 외부에 있는 IF 블록내에 중첩되어 있는 경우, 외부 블록이 사용할 수 있는 모든 요소를 사용할 수 있습니다. IF 블록이 IF 블록에 있는 다른 블록내에 중첩되어 있는 경우, 내부에 있는 블록의 구문 규칙을 따릅니다.
다음 예에서 중첩된 IF 블록은 HTML 블록 내부에 있을 때 사용된 규칙을 따라야 합니다.
%IF block
...
%HTML block
...
%IF block
최대 1024개의 IF 블록을 중첩시킬 수 있습니다.
구문
>>-%IF--| 조건 목록 |------------------------------------------->
>-----| statement_block |--| else_if spec |--%ENDIF------------><
조건 목록
|---(--+-(--condition list--)----------------+---)--------------|
+-condition list--&&--condition list--+
+-condition list--||--condition list--+
+-!--condition list-------------------+
+-| 조건 |----------------------------+
'-| 용어 |----------------------------'
statement_block
.---------------------------------.
V |
|------+---------------------------+--+-------------------------|
| (1) |
+-define block--------------+
| (1) |
+-define statement----------+
| (2) |
+-exec_sql statement--------+
| (1) |
+-function block------------+
+-function call-------------+
| (1) |
+-HTML block----------------+
| (2) |
+-HTML statement------------+
+-if block------------------+
+-include statement---------+
+-include_url statement-----+
| (1) |
+-macro_function block------+
| (1) |
+-message block-------------+
| (2) |
+-string--------------------+
| (2) |
+-variable reference--------+
| (2) |
'-while block---------------'
조건
|---term--+-<--+---term-----------------------------------------|
+->--+
+-<=-+
+->=-+
+-!=-+
'-==-'
용어
|---+-variable_name-----------------------+---------------------|
+-variable reference------------------+
+-function call-----------------------+
| .-------------------------. |
| V | |
'-"----+-string-------------+--+---"--'
+-variable reference-+
'-function call------'
else_if spec
|---+---------------------------------------------------------------+->
| .----------------------------------------------------. |
| V | |
'--+----%ELIF--(--condition_list--)--| statement_block |---+-+--'
'-%ELSE--| statement_block |------------------------------'
>---------------------------------------------------------------|
주:
값
참이 아닌 조건이 있는 경우, 일반적인 문자열 비교가 수행됩니다.
문맥
IF 블록은 다음 컨텍스트에 들어 있습니다.
제한
IF 블록이 Net.Data 매크로의 선언 부분에 있는 다른 블록의 외부에 위치할 경우, 다음의 요소를 포함할 수 있습니다.
IF 블록이 Net.Data 매크로의 HTML 블록, MACRO_FUNCTION 블록, REPORT 블록, ROW 블록 또는 WHILE 블록에 위치할 경우, 이 IF 블록에는 다음의 요소가 포함될 수 있습니다.
최대 1024개의 IF 블록을 중첩시킬 수 있습니다.
예
예 1: Net.Data 매크로의 선언 부분에 있는 IF 블록
%DEFINE a = "1"
%DEFINE b = "2"
...
%IF ($(DTW_HTML_TABLE) == "YES")
%define OUT_FORMAT = "HTML"
%ELSE
%define OUT_FORMAT = "CHARACTER"
%ENDIF
%HTML(REPORT){
...
%}
예 2: HTML 블록 내의 IF 블록
%HTML(REPORT){
@myFunctionCall()
%IF ($RETURN_CODE) == $(failure_rc))
<P> The function call failed with failure code $(RETURN_CODE).
%ELIF ($(RETURN_CODE) == $(warning_rc))
<P> The function call succeeded with warning code $(RETURN_CODE).
%ELIF ($(RETURN_CODE) == $(success_rc))
<P>The function call was successful.
%ELSE
P>The function call returned with unknown return code $(RETURN_CODE).
%ENDIF
%}
예 3: 숫자 비교
%IF (ROW_NUM < "100")
<p>The table is not full yet...
%ELIF (ROW_NUM == "100")
<p>The table is now full...
%ELSE
<p>The table has overflowed...
%ENDIF
숫자 비교는 내재된 테이블 변수, ROW_NUM가 항상 정수 값을 리턴하고 비교되는 값도 정수이기 때문에 수행됩니다.
예 4: 중첩된 IF 블록
%IF (MONTH == "January")
%IF (DATE = "1")
HAPPY NEW YEAR!
%ELSE
Ho hum, just another day.
%ENDIF
%ENDIF
목적
파일을 읽어 명령문이 지정된 Net.Data 매크로에 통합시킵니다.
Net.Data는 초기화 파일의 INCLUDE_PATH 명령문에 지정된 디렉토리에서 Include 파일을 찾습니다.
대부분의 고급 언어에서와 동일한 방법으로 Include 파일을 사용할 수 있습니다. Include 파일은 공통 머리말과 꼬리말을 삽입하고, 공통 변수 세트를 정의하거나 FUNCTION 블록 정의의 공통 서브루틴 라이브러리를 Net.Data 매크로에 통합시킬 수 있습니다.
Net.Data는 매크로 처리시에만 INCLUDE 명령문을 실행하고 포함된 파일의 내용을 매크로의 INCLUDE 명령문 위치에 삽입합니다. 포함된 파일의 이름에 있는 변수 참조는 이 파일의 내용이 실행될 예정인 경우만 아니면 INCLUDE문이 처음 실행될 때 해석됩니다.
INCLUDE 명령문이 ROW 또는 WHILE 블록에 있는 경우, Net.Data는 INCLUDE 명령문을 반복적으로 실행하지 않습니다. Net.Data는 ROW 또는 WHILE 블록을 처음 실행할 때만 INCLUDE 명령문을 실행하고 포함된 파일의 내용을 블록에 통합한 다음 포함된 파일의 내용을 사용하여 ROW 또는 WHILE 블록을 반복적으로 실행합니다.
권한 부여 관련사항: Net.Data를 실행하는 사용자 ID는 INCLUDE 문에 참조된 모든 파일에 대해 액세스권을 가져야 합니다. 자세한 내용은 Net.Data Administration and Programming Guide의 구성 장에서 Net.Data 파일에 대한 웹 서버 액세스권 지정과 관련한 부분을 참조하십시오.
참조: 국지 웹 서버의 HTML 파일을 포함시키고자 하는 경우, INCLUDE_URL에 대한 예 3에 보인 것처럼 INCLUDE_URL 구문을 사용하십시오. 예시된 구문을 사용하면 이미 웹 서버가 알고 있는 디렉토리를 지정하기 위해 Net.Data 초기화 파일의 INCLUDE_PATH를 갱신할 필요가 없습니다.
구문
.-------------------------.
V |
>>-%INCLUDE----"----+-string-------------+--+---"--------------><
'-variable reference-'
값
문맥
INCLUDE 명령문은 다음의 컨텍스트에서 찾을 수 있습니다.
제한
INCLUDE 명령문에는 다음의 요소가 포함될 수 있습니다.
문자열에는 함수 호출을 사용할 수 없습니다.
최대 10개의 INCLUDE 명령문을 중첩시킬 수 있습니다.
예
예 1: HTML 블록 내의 INCLUDE 명령문
%HTML(start){
%INCLUDE "header.hti"
...
%}
예 2: REPORT 블록 내의 INCLUDE 명령문
%REPORT {
%INCLUDE "report_header.txt"
%ROW {
%INCLUDE "row_include.txt"
%}
%INCLUDE "report_footer.txt"
%}
예 3: INCLUDE 명령문의 변수 참조
%define library = "/qsys.lib/mylib.lib/" %define filename = "macros.file/incfile.mbr" %include "$(library)$(filename)"
목적
다른 파일을 읽어 명령문이 지정된 Net.Data 생성 출력에 통합합니다. 지정된 파일은 국지 또는 원격 서버에 존재할 수 있습니다.
INCLUDE_URL 명령문을 사용하면 응용프로그램 사용자가 제출 버튼을 선택하지 않아도 다른 매크로에서 매크로를 호출할 수 있습니다.
Net.Data는 매크로 처리시에만 INCLUDE_URL 명령문을 실행하고 포함된 파일의 내용을 매크로의 INCLUDE_URL 명령문 위치에 삽입합니다. 포함된 파일의 이름에 있는 변수 참조는 이 파일의 내용이 실행될 예정인 경우만 아니면 INCLUDE_URL 명령문이 처음 실행될 때 해석됩니다.
INCLUDE_URL 명령문이 ROW 또는 WHILE 블록에 있는 경우, Net.Data는 INCLUDE_URL 명령문을 반복적으로 실행하지 않습니다. Net.Data는 ROW 또는 WHILE 블록을 처음 실행할 때만 INCLUDE_URL 명령문을 실행하고 포함된 파일의 내용을 블록에 통합한 다음 포함된 파일의 내용을 사용하여 ROW 또는 WHILE 블록을 반복적으로 실행합니다.
구문
.-------------------------.
V |
>>-%INCLUDE_URL---"------+-string-------------+--+--"----------><
'-variable reference-'
값
문맥
INCLUDE_URL 명령문은 다음의 컨텍스트에서 찾을 수 있습니다.
제한
INCLUDE_URL 명령문에는 다음의 요소가 포함될 수 있습니다.
OS/390에서 INCLUDE_URL 파일은 최대 256KB일 수 있습니다. 기타 운영 체제에는 제한이 없습니다.
INCLUDE_URL 명령문을 사용할 때, 현재 매크로 파일을 순환적으로 호출하여 무한한 매크로 요청 시퀀스를 시작하지 마십시오.
INCLUDE_URL은 OS/400 환경에서 지원되지 않습니다.
예
예 1: 다른 서버의 HTML 파일 포함
%include_url "http://www.ibm.com/path/myfile.html"
예 2: 서버명을 호출하여 원격 서버의 HTML 파일 포함
%include_url "myserver/path/myfile.html"
여기서 myserver는 서버명입니다.
예 3: 국지 웹 서버의 HTML 파일 포함
%include_url "/path/myfile.html"
참고: 이 방법을 이용하면 이미 웹 서버가 알고 있는 디렉토리를 지정하기 위해 Net.Data 구성 파일의 INCLUDE_URL 경로를 갱신할 필요가 없습니다. string이 슬래쉬로 시작되지 않는 경우, Net.Data는 문자열이 서버명인 것으로 간주하고 해당 이름을 갖는 서버에서 파일을 검색합니다.
예 4: 원격 서버의 다른 Net.Data 매크로 포함
%REPORT{
<P>Current hot pick as of @DTW_rTIME():
%include_url "http://www.ibm.com/cgi-bin/db2www/hotpic.mac/report?custno=$(custno)"
이 예에서는 매크로 hotpic.mac가 호출되고 custno가 변수로 전송됩니다. 문자열이 슬래쉬로 시작되면 Net.Data는 국지 웹 서버에서 INCLUDE 파일을 검색합니다.
목적
제한된 값 목록을 구축합니다. 일부 WHERE 또는 HAVING 절에 있는 것과 같은 여러 항목을 사용하여 SQL 조회를 구축할 때 LIST 명령문을 사용할 수 있습니다.
구문
.--------------------------.
V |
>>-%LIST--"-----+--------------------+--+---"----variable name--><
+-string-------------+
+-variable reference-+
'-function call------'
값
문맥
LIST 명령문은 다음의 컨텍스트에서 찾을 수 있습니다.
제한
LIST 명령문에는 다음의 요소가 포함될 수 있습니다.
예
예 1: 변수 목록
%DEFINE{
DATABASE="custcity"
%LIST " OR " conditions
conditions="cond1='Sao Paolo'"
conditions="cond2='Seattle'"
conditions="cond3='Shanghai'"
whereClause=conditions ? "WHERE $(conditions)" : ""
%}
목적
Net.Data 매크로로부터 호출할 수 있는 서브루틴을 정의합니다. MACRO_FUNCTION 블록의 실행 가능 명령문은 Net.Data 매크로 언어 소스 명령문이어야 합니다.
구문
>>-%MACRO_FUNCTION--function_name--| 매개변수 전달 스펙 |------->
(4)
>-----| 리턴 스펙 |-------{--| 함수 내용 |----%}---------------->
.--------------------------.
V |
>--------+--------------------+--+--%}-------------------------><
| (3) |
'-report block-------'
매개변수 전달 스펙
|---(--+-----------------------------+---)----------------------|
| .-,---------------------. |
| | (1) | |
| V .-IN-------. | |
'----+----------+---name---+--'
+-OUT------+
'-INOUT----'
리턴 스펙
(4)
|----------+----------------------+-----------------------------|
'-RETURNS--(--name--)--'
함수 내용
.----------------------------------.
V |
|------+----------------------------+--+------------------------|
+-exec_sql statement---------+
+-variable reference---------+
+-if block-------------------+
+-function call--------------+
+-HTML statement-------------+
+-include statement----------+
| (2) |
+-include_url statement------+
'-while block----------------'
주:
값
문맥
MACRO_FUNCTION 블록은 다음의 컨텍스트에서 찾을 수 있습니다.
제한
MACRO_FUNCTION 블록은 다음과 같은 요소를 포함할 수 있습니다.
OS/400에는 지원되지 않음
예
예 1: 메세지 처리를 지정하는 매크로 함수
%MACRO_FUNCTION setMessage(IN rc, OUT message) {
%IF (rc == "0")
@dtw_assign(message, "Function call was successful.")
%ELIF (rc == "-1")
@dtw_assign(message, "Function failed, out of memory.")
%ELIF (rc == "-2")
@dtw_assign(message, "Function failed, invalid parameter.")
%ENDIF
%}
예 2: 머리말 정보를 지정하는 매크로 함수
%MACRO_FUNCTION setup(IN browserType) {
%{ call this function at the top of each HTML block in the macro %}
%INCLUDE "header_info.html"
@dtw_rdate()
%IF (browserType == "IBM")
@setupIBM()
%ELIF (browserType == "MS")
@setupMS()
%ELIF (browserType == "NS")
@setupNS()
%ELSE
@setupDefault()
%ENDIF
%}
목적
함수로부터의 리턴 코드에 기초하여 표시할 메세지와 취할 조치를 지정합니다.
리턴 코드, 이의 관련 메세지 및 조치를 MESSAGE 블록에 정의하십시오. 함수 호출이 완료되면, Net.Data는 여기서 리턴된 리턴 코드를 MESSAGE 블록에 정의되어 있는 리턴 코드와 비교합니다. 함수의 리턴 코드가 MESSAGE 블록에 있는 리턴 코드와 일치하는 경우, Net.Data는 메세지를 표시하고 조치를 평가하여 처리를 계속할지 또는 Net.Data 매크로를 종료할지를 결정합니다.
MESSAGE 블록은 범위내에서 전역이거나 하나의 FUNCTION 블록에 대해 국지가 될 수 있습니다. MESSAGE 블록이 가장 바깥의 매크로 계층에 정의되어 있으면, 이는 범위내에서는 전역으로 간주됩니다. 여러 개의 전역 MESSAGE 블록이 정의되면, 마지막으로 처리된 블록만이 활동중인 것으로 간주됩니다. MESSAGE 블록이 FUNCTION 블록 내부에 정의되어 있으면, 블록이 정의된 FUNCTION 블록에 대한 범위내에서는 국지입니다. 규칙을 처리하는 리턴 코드에 대해서는 Net.Data Administration and Programming Guide의 MESSAGE 블록 부분을 참조하십시오.
구문
>>-%MESSAGE--{-------------------------------------------------->
.-----------------------------------------------------------------------------------.
V |
>--------+-----------------------------------------------------------------------------+--+>
'--+-| 리턴 코드 스펙 |--+--:---| 메세지 텍스트 스펙 |----+----------------+--'
'-| SQLSTATE |--------' '-| 조치 스펙 |--'
>----%--}------------------------------------------------------><
리턴 코드 스펙
|---+-DEFAULT---------------+-----------------------------------|
+-+DEFAULT--------------+
+- -DEFAULT-------------+
+-+----+---msg_code-----+
| +- --+ |
| '-+--' |
+-include statement-----+
'-include_url statement-'
SQLSTATE
|---SQLSTATE--:------state_id-----------------------------------|
메세지 텍스트 스펙
.--------------------------.
V |
|----+-"-----+--------------------+--+---"---+------------------|
| +-string-------------+ |
| +-variable reference-+ |
| +-function call------+ |
| '-(new_line)---------' |
| .--------------------------. |
| V | |
+-{-----+--------------------+--+---%}--+
| +-string-------------+ |
| +-variable reference-+ |
| '-function call------' |
+-include statement---------------------+
'-include_url statement-----------------'
조치 스펙
.-EXIT-----.
|---+-:--+----------+--------+----------------------------------|
| '-CONTINUE-' |
+-include statement------+
'-include_url statement--'
값
문맥
MESSAGE 블록은 다음의 컨텍스트에서 찾을 수 있습니다.
제한
MESSAGE 블록에는 다음의 요소가 포함될 수 있습니다.
OS/390, OS/2, Windows NT 및 UNIX 운영 체제의 경우: SQL 함수를 SQL 함수 내에서 호출할 수 없습니다.
예
예 1: 국지 MESSAGE 블록
%{ local message block inside a FUNCTION block %}
%FUNCTION(DTW_REXX) my_function() {
%EXEC { my_command.cmd %}
%MESSAGE{
-601: {<H3>The table has already been created, please go back and enter your name.</H3>
<P><a href="input">Return</a>
%}
default: "<H3>Can't continue because of error $(RETURN_CODE)</H3>"%} : exit
%}
예 2: 전역 MESSAGE 블록
%{ global message block %}
%MESSAGE {
-100 : "Return code -100 message" : exit
100 : "Return code 100 message" : continue
+default : {
This is a long message that spans more
than one line. You can use HTML tags, including
links and forms, in this message. %} : continue
%}
%{ local message block inside a FUNCTION block %}
%FUNCTION(DTW_REXX) my_function() {
%EXEC { my_command.cmd %}
%MESSAGE {
-100 : "Return code -100 message" : exit
100 : "Return code 100 message" : continue
-default : {
This is a long message that spans more
than one line. You can use HTML tags, including
links and forms, in this message. %} : exit
%}
예 3: INCLUDE 명령문이 포함된 MESSAGE 블록
%message {
%include "rc1000.msg"
%include "rc2000.msg"
%include "defaults.msg"
%}
목적
함수 호출의 출력을 포맷합니다. 테이블명 매개변수를 지정하여 명명된 테이블의 자료가 보고서에 사용되도록 지정할 수 있습니다. 그렇지 않으면, 함수 호출 매개변수 목록의 첫번째 출력 테이블을 사용하여 보고서가 생성되거나, 목록에 테이블명이 없는 경우 생략시 테이블 자료가 보고서 생성에 사용됩니다.
구문
>>-%REPORT----+-------------+--{-------------------------------->
'-(--name--)--'
.-----------------------------.
V |
>--------+-----------------------+--+---+-----------+----------->
+-string----------------+ '-row block-'
+-if block--------------+
+-variable reference----+
+-function call---------+
+-HTML statements-------+
+-include statement-----+
+-include_url statement-+
'-while block-----------'
.-----------------------------.
V |
>--------+-----------------------+--+--%}----------------------><
+-string----------------+
+-if block--------------+
+-variable reference----+
+-function call---------+
+-HTML statements-------+
+-include statement-----+
+-include_url statement-+
'-while block-----------'
값
문맥
REPORT 블록은 다음의 컨텍스트에서 찾을 수 있습니다.
제한
REPORT 블록에는 다음의 요소가 포함될 수 있습니다.
OS/390, OS/2, Windows NT 및 UNIX 운영 체제의 경우: SQL 함수를 SQL 함수 내에서 호출할 수 없습니다.
OS/390의 경우: REPORT 블록은 MACRO_FUNCTION 블록에서 허용되지 않습니다.
예
예 1: 이름 및 위치의 목록을 나타내는 두 컬럼으로 구성된 HTML 테이블
%FUNCTION(DTW_SQL) mytable() {
%REPORT{
<H2>Query Results</H2>
<P>Select a name for details.
<TABLE BORDER=1>
<TR><TD>Name</TD><TD>Location</TD>
%ROW{
<TR>
<TD>
<a href="/cgi-bin/db2www/name.mac/details?name=$(V1)&location=$(V2)">$(V1)</a></TD>
<TD>$(V2)</TD>
%}
</TABLE>
%}
테이블에 있는 이름을 선택하면 name.mac Net.Data 매크로의 details HTML 블록이 호출되어 URL의 일부인 두 값에 전송됩니다. 이 예에서, 이름에 대한 좀더 자세한 정보를 얻으려면 name.mac의 값을 사용할 수 있습니다.
목적
함수 호출로부터 리턴된 각 테이블 행을 처리합니다. Net.Data는 각 행마다 한번씩 ROW 블록내의 명령문을 처리합니다.
구문
.-----------------------------.
V |
>>-%ROW--{-------+-----------------------+--+--%}--------------><
+-string----------------+
+-if block--------------+
+-variable reference----+
+-function call---------+
+-HTML statements-------+
+-include statement-----+
+-include_url statement-+
'-while block-----------'
값
문맥
ROW 블록은 다음의 컨텍스트에서 찾을 수 있습니다.
제한
ROW 블록에는 다음의 요소가 포함될 수 있습니다.
OS/390, OS/2, Windows NT 및 UNIX 운영 체제의 경우: SQL 함수를 SQL 함수 내에서 호출할 수 없습니다.
예
예 1: 이름 및 위치의 목록을 나타내는 두 컬럼으로 구성된 HTML 테이블
%REPORT{
<H2>Query Results</H2>
<P>Select a name for details.
<TABLE BORDER=1>
<TR><TD>Name</TD><TD>Location</TD>
%ROW{
<TR>
<TD>
<a href="/cgi-bin/db2www/name.mac/details?name=$(V1)&location=$(V2)">$(V1)</a></TD>
<TD>$(V2)</TD>
%}
</TABLE>
%}
테이블에 있는 이름을 선택하면 name.mac Net.Data 매크로의 details HTML 블록이 호출되어 URL의 일부인 두 값에 전송됩니다. 이 예에서, 이름에 대한 좀더 자세한 정보를 얻으려면 name.mac의 값을 사용할 수 있습니다.
목적
관련 자료 집합인 변수를 정의합니다. 변수에는 각 행의 필드를 설명하는 컬럼 헤더 행을 포함하는 일련의 행과 컬럼이 들어 있습니다. 테이블 명령문은 DEFINE 명령문이나 블록에서만 정의할 수 있습니다.
TABLE 변수를 참조할 때, Net.Data는 테이블의 내용을 일반 문자 테이블로, DTW_HTML_TABLE 변수가 YES로 설정된 경우 HTML 파일로 표시합니다.
구문
>>-%TABLE--| 상한 |--------------------------------------------><
상한
|---+--------------------+--------------------------------------|
'-(--+-number-+---)--'
'-ALL----'
값
문맥
TABLE 명령문은 다음의 컨텍스트에서 찾을 수 있습니다.
제한
TABLE 명령문에는 다음의 요소가 포함될 수 있습니다.
예
예 1: 상한이 30행인 Net.Data 테이블
%DEFINE myTable1=%TABLE(30)
예 2: 생략시 값(모든 행)을 사용하는 Net.Data 테이블
%DEFINE myTable2=%TABLE
예 3: 모든 행을 지정하는 Net.Data 테이블
%DEFINE myTable3=%TABLE(ALL)
목적
조건부 문자열 처리에 기초하여 루핑 구문을 제공합니다. WHILE 블록은 HTML 블록, REPORT 블록, ROW 블록, IF 블록 및 MACRO_FUNCTION 블록에 사용할 수 있습니다. 조건 목록의 문자열 값은 이것이 정수를 나타내는 문자열이고 선행 또는 후미 공백이 없는 경우 비교하기 위해 숫자로 취급됩니다. 여기에는 하나의 플러스(+) 또는 마이너스(-) 기호가 선행할 수 있습니다.
구문
.-----------------------------.
V |
>>-%WHILE--| 조건 목록 |---{-------+-----------------------+--+->
+-exec_sql statement----+
+-function call---------+
+-HTML statement--------+
+-if block--------------+
+-include statement-----+
+-include_url statement-+
+-while block-----------+
+-variable reference----+
'-string----------------'
>----%}--------------------------------------------------------><
조건 목록
|---(--+-(--condition list--)----------------+---)--------------|
+-condition list--&&--condition list--+
+-condition list--||--condition list--+
+-!--condition list-------------------+
+-| 조건 |----------------------------+
'-| 용어 |----------------------------'
조건
|---term--+-<--+---term-----------------------------------------|
+->--+
+-<=-+
+->=-+
+-!=-+
'-==-'
용어
|---+-variable_name-----------------------+---------------------|
+-variable reference------------------+
+-function call-----------------------+
| .-------------------------. |
| V | |
'-"----+-string-------------+--+---"--'
+-variable reference-+
'-function call------'
값
참이 아닌 조건이 있는 경우, 일반적인 문자열 비교가 수행됩니다.
문맥
WHILE 블록은 다음의 컨텍스트에서 찾을 수 있습니다.
제한
WHILE 블록에는 다음의 요소가 포함될 수 있습니다.
예
예 1: 테이블에 행을 생성하는 WHILE 블록
%DEFINE loopCounter = "1"
%HTML(build_table) {
%WHILE (loopCounter <= "100") {
%{ generate table tag and column headings %}
%IF (loopCounter == "1")
<TABLE BORDER>
<TR>
<TH>Item #
<TH>Description
</TR>
%ENDIF
%{ generate individual rows %}
<TR>
<TD>
<TD>$(loopCounter)
<TD>@getDescription(loopCounter)
</TR>
%{ generate end table tag %}
%IF (loopCounter == "100")
</TABLE>
%ENDIF
%{ increment loop counter %}
@dtw_add(loopCounter, "1", loopCounter)
%}
%}