클라이언트 프로그램은 사용자의 입력(input)을 받아들여서 서버에게 서비스를 요청하고, 서버로부터 응답을 받아서 사용자에게 서비스 응답을 출력(output)하는 프로그램이다.

클라이언트 프로그램 흐름

다음은 클라이언트 프로그램의 흐름이다.

main()
{
     Tmax 접속
     송, 수신 메시지 버퍼 할당
     클라이언트 업무 로직 작성 (사용자 요구 사항을 입력받아서 송신 메시지 버퍼에 저장)
     서비스 요청 및 응답 (송신 메시지 버퍼를 Tmax CLH로 보냄,
               Tmax CLH를 통하여 수신 메시지 버퍼에 응답 데이터를 수신)
               클라이언트 업무 로직 작성 (응답 데이터를 사용자에게 보여줌)
     송, 수신 메시지 버퍼 해제
     Tmax 연결 해제
}

다음은 클라이언트 프로그램의 주요 함수에 대한 설명이다.

다음은 클라이언트 프로그램의 주요 함수 프로세스에 대한 그림이다.

클라이언트 프로그램 구성

클라이언트 프로그램의 코딩이 완료되면 컴파일하여 실행 파일을 생성한다.

클라이언트 프로그램을 컴파일하기 위해서는 개발자가 작성한 클라이언트 프로그램, Tmax 클라이언트 라이브러리, 구조체 버퍼를 사용하는 경우에는 구조체 파일, 그리고 필드 테이블이 정의된 필드키 버퍼 파일이 정의되어 있어야 한다.

다음은 클라이언트 프로그램의 구성에 대한 그림이다.

서버 프로그램은 사용자의 요청을 받아서 처리하고 그 응답을 클라이언트에게 반환한다.

서버 프로그램 흐름

다음은 서버 프로그램의 흐름이다.

int tpsvrinit(int argc, char **argv)
{
     서버 초기화 작업(DBMS와의 Non-XA 모드 접속)
}

SVC_NAME(TPSVCINFO *msg)
{
     DB 트랜잭션 처리(ESQL), 업무 처리 로직 포함
     클라이언트로 응답 결과를 전송
}

int tpsvrdone()
{
     서버 종료 직전 작업(DBMS와의 Non-XA 모드 연결 해제)
}

void tpsvctimeout()
{
     SVCTIME 항목과 관련되며, 서비스 타임아웃 핸들러에 의해 호출됨
}

다음은 서버 프로그램의 주요 함수에 대한 설명이다.

다음은 서버 프로그램의 주요 함수 프로세스에 대한 그림이다.

서버 프로그램 구성

서버 프로그램은 Tmax에서 제공하는 main()과 애플리케이션 개발자가 작성한 서비스 루틴(Service Routine)들로 구성된다.

다음은 서버 프로그램의 구성에 대한 그림이다.

X/Open ATMI

X/Open ATMI(X/Open Application Transaction Monitor Interface) API는 X/Open DTP 모델에서 표준으로 규정한 ATMI 인터페이스로 애플리케이션 프로그램과 TP-Monitor 사이의 통신 방식을 하나로 사용한다.

함수는 atmi.h에 정의되어 있으며, 버퍼 관련 함수, 서비스 요청 및 응답 관련 함수, 대화형 모드 관련 함수, 서비스 종료 관련 함수로 나뉜다.

X/Open TX API

X/Open TX API는 애플리케이션 프로그램과 TP-Monitor 간의 트랜잭션에 관해서 통신하는 방식을 제공한다. 함수는 tx.h에 정의되어 있고 트랜잭션 관리 함수로 구성된다.

다음은 TX API 목록이다.

Tmax ATMI

Tmax ATMI 함수는 비요청 메시지 처리, RQ 관련, 에러 설정, 타임아웃 설정 등에 사용되는 함수로 tmaxapi.h에 정의되어 있다. 정의된 API는 비표준 인터페이스로서 개발자의 개발 생산성 향상을 위해 개발되었으며 개발자에 의해 작성되는 애플리케이션 프로그램과 TP-Monitor 간의 통신 방식의 하나로 사용될 수 있다.

다음은 tmaxapi.h에 정의된 비표준 API 목록이다.

다음은 atmi.h에 정의된 비표준 API 목록이다.

FDL API

FDL(Field Definition Language)은 비표준 API이며, 개발자의 개발 생산성 향상을 위해 개발되었다. FDL은 필드키라고 불리는 인덱스와 데이터가 함께 관리되는 associative-typed data에 해당한다. FIELD 버퍼에 관련한 API는 fbuf.h에 정의되어 있다.

이와 같은 데이터는 Tmax 시스템에서 제공하는 버퍼의 일종인 필드키 버퍼에 실리며 이 버퍼를 조작하기 위한 다음과 같은 함수를 제공한다.

X/Open DTP에서 제공하는 인터페이스와 Tmax 시스템에서 제공하는 비표준 인터페이스를 사용하는 경우에 에러가 발생하면 해당 상황에 적절한 에러 값이 tperrno라고 불리는 전역 변수에 설정된다. 따라서 개발자는 에러가 발생하면 tperrno를 확인하여 적절한 후속 조처를 할 수 있다.

다음은 tperrno 에러 메시지 목록이다. tperrno는 에러상황이 발생할 경우에 설정이 되는 전역변수이다.

FDL 인터페이스에 대한 에러는 전역 변수 fberrno에 설정된다. 따라서 개발자는 에러가 발생하면 fberrno를 확인하여 적절한 후속 조치를 할 수 있다. 본 절에서는 FDL 관련한 에러 메시지에 대해 설명한다.

다음은 fberror 에러 메시지 목록이다. fberror은 에러상황이 발생할 경우에 설정이 되는 전역변수이다.