참조서

영속적 매크로 함수

영속적 매크로 함수는 단일 트랜잭션내에서 영속성을 유지하는 매크로 블록을 정의하도록 함으로써 Net.Data에서의 트랜잭션 처리를 지원합니다. 이 함수를 사용하여 트랜잭션의 시작과 끝, 트랜잭션을 통해 영속성을 유지하는 HTML 블록, 트랜잭션내의 변경을 확약 또는 구간 복원할지의 여부를 정의할 수 있습니다.

• DTW_ACCEPT

• DTW_COMMIT

• DTW_ROLLBACK

• DTW_RTVHANDLE

• DTW_STATIC

• DTW_TERMINATE

DTW_ACCEPT

목적

영속적 매크로를 호출하는 데 사용되는 트랜잭션 핸들을 정의합니다.

형식

@DTW_ACCEPT(handle, timeout)

@DTW_ACCEPT(handle)

매개변수

표 209. DTW_ACCEPT 매개변수

리턴 코드

표 210. DTW_ACCEPT 리턴 코드

사용법 메모

1. Net.Data에서는 웹 브라우저의 응답으로 매크로를 호출하는 URL에 트랜잭션 핸들이 포함되어야 합니다. 웹 서버로 요청이 전달되는 경우, 서버는 트랜잭션 핸들을 사용하여 트랜잭션을 처리하는 CGI 프로세스로 이 요청을 경로지정합니다.

   DTW_TERMINATE()에 대한 호출이 들어 있는 마지막 논리 블록에 도달할 때까지 매크로에 있는 각 HTML 블록의 시작 부분에서 트랜잭션 핸들을 호출해야 합니다. 텍스트가 브라우저에 출력되기 전에 DTW_ACCEPT() 또는 DTW_TERMINATE()에 대한 호출이 없으면, Net.Data 오류가 발생합니다.

2. @DTW_STATIC() 함수에 지정된 시간종료 값을 대체하는 시간종료 값을 이 페이지에 대해 지정할 수 있습니다. 웹 서버는 사용자가 이 요청에 응답하기를 지정된 시간(초 단위) 동안 기다립니다.

3. 매크로가 영속적 상태에 있지 않을 때 이 함수가 호출되면, Net.Data 오류가 발생합니다.

4. 트랜잭션 핸들을 포함하는 URL은 양식 누름 버튼의 조치나 브라우저에 제공되는 페이지의 하이퍼텍스트 링크로 코드화할 수 있습니다.

예

예 1:

%DEFINE handle = ""
@DTW_RTVHANLDE(handle)
 
%HTML(REPORT){
@DTW_ACCEPT(handle)
 ...
%}

DTW_COMMIT

목적

최종 확약 범위 이후 확약 제어하에서 이루어진 자원에 대한 미결 변경사항을 영속적으로 만들고 새로운 확약 범위를 설정합니다.

형식

@DTW_COMMIT()

매개변수

없음.

리턴 코드

표 211. DTW_COMMIT 리턴 코드

예

예 1: 확약을 지정합니다.

@DTW_COMMIT()
%HTML(report){
%}
 

DTW_ROLLBACK

목적

최종 확약 범위를 현재의 확약 범위로 재설정합니다. 최종 확약 범위 이후 Net.Data가 수행되고 있는 프로세스에 대한 확약 제어하에서의 자원에 대한 모든 변경사항이 취소됩니다.

형식

@DTW_ROLLBACK()

매개변수

없음.

리턴 코드

표 212. DTW_ROLLBACK 리턴 코드

예

예 1: 구간 복원을 지정합니다.

@DTW_ROLLBACK()
%HTML(report){
%}

DTW_RTVHANDLE

목적

각 호출에서 이 매크로에 대해 고유하며 스레드 정보, 시간소인 및 현재 사용자의 조합에 기초하여 계산된 트랜잭션 핸들을 생성하여 리턴합니다.

형식

@DTW_RTVHANDLE(handle)

매개변수

표 213. DTW_RTVHANDLE 매개변수

리턴 코드

표 214. DTW_RTVHANDLE 리턴 코드

사용법 메모

트랜잭션 핸들은 영속적 트랜잭션의 일부로 지정된 URL이 HTTP 서버에 대해 고유하게 하고 유효한 요청으로 식별될 수 있도록 하는 데 사용할 수 있습니다.

예

예 1: 트랜잭션 핸들을 검색하는 데 사용되는 handle 변수를 정의합니다.

%DEFINE handle = ""
@DTW_RTVHANLDE(handle)

DTW_STATIC

목적

전체 매크로가 영속적임을 나타냅니다.

형식

@DTW_STATIC(timeout)

@DTW_STATIC()

매개변수

표 215. DTW_STATIC 매개변수

리턴 코드

표 216. DTW_STATIC 리턴 코드

사용법 메모

1. DTW_STATIC은 매크로의 첫번째 명령문이어야 합니다. 별다른 언급이 없는 한, 여러 매크로 호출에 걸쳐 이 함수 호출이 영속적이게 된 다음에 매크로에 정의된 모든 변수가 호출되거나 프로세스가 종료됩니다.

2. 함수 호출에 초단위 시간종료 값을 지정하여 Net.Data가 수행되는 프로세스가 브라우저의 응답을 기다리는 시간의 양을 나타낼 수 있습니다. 시간종료 값이 만료되면, 프로세스가 종료되고 최종 확약 범위 이후 확약 제어하에서 자원에 대한 모든 변경이 취소됩니다.

3. 후속하는 @DTW_ACCEPT() 호출에 시간종료 값이 지정되면, Net.Data는 후속 호출의 값으로 이 값을 대체합니다. 이 호출이나 후속하는 @DTW_ACCEPT() 호출에 시간종료 값이 지정되지 않으면, 웹 서버의 생략시 시간종료 값이 사용됩니다.

예

예 1: 60초의 시간종료 값을 지정하는 DTW_STATIC()에 대한 호출

@DTW_STATIC("60")

DTW_TERMINATE

목적

영속 트랜잭션을 종료합니다. 최종 확약 범위 이후 확약 제어하에서 자원에 대해 행해진 모든 변경이 영속적이 됩니다.

형식

@DTW_TERMINATE()

매개변수

없음

리턴 코드

표 217. DTW_TERMINATE 리턴 코드

사용법 메모

1. DTW_TERMINATE 함수는 텍스트가 브라우저에 출력되기 이전에 영속 트랜잭션의 논리적 최종 HTML 블록이 시작될 때 호출됩니다. 블록내에서 함수 앞에 텍스트 출력이 나타나면, Net.Data 오류가 발생합니다. 응용프로그램 작성 방법에 따라 둘 이상의 논리적 최종 HTML 블록이 있을 수 있습니다.

2. 매크로가 영속적 상태에 있지 않을 때 이 함수가 호출되면, Net.Data 오류가 발생합니다.

예

예 1: 영속 트랜잭션을 종료합니다.

%HTML(QUIT){
@DTW_TERMINATE()
 ...
%}