소개

본 장에서는 JTmax 서버의 소개 및 환경 구성, 설정에 대해 기술한다.

1. 환경 구성

Tmax 서버에 있는 서비스가 아닌 Java로 이루어진 애플리케이션의 서비스를 Tmax 클라이언트 혹은 서버가 호출하는 환경에서 사용한다. 반드시 Tmax는 Async Java Gateway를 사용해야 한다.

다음은 JTmax 서버 환경 구성에 대한 그림이다.

figure 1 1
JTmax 서버 환경 구성

Java Gateway는 Tmax가 시작할 때 JTmax 서버에 연결을 시도한다. 연결이 이루어지지 않는다면 Java Gateway를 통해서 호출할 서비스가 요청이 생기면 다시 연결을 시도한다.

JTmax 서버는 애플리케이션에서 객체를 생성하여 필요할 때 조작을 통하여 라이프 사이클을 관리할 수 있으며 callback interface를 구현하여 서비스 요청을 제어할 수 있다.

2. 환경설정

2.1. Tmax 설정

Tmax에서는 JTmax 서버와 연결하기 위해 Async Java Gateway를 다음과 같이 설정한다.

*SERVICE
JTMAXSERVICE       SVRNAME = javagw

*GATEWAY
javagw         GWTYPE = JEUS_ASYNC, PORTNO = 11100,
               RGWADDR = "192.168.11.20",
               RGWPORTNO = 9669,
               BACKUP_RGWADDR = "192.168.11.21",
               BACKUP_RGWPORTNO = 9669,
               CLOPT = "-r ",
               NODENAME = tmax,
               CPC = 1

  • SERVICE 절

    • SVRNAME을 게이트웨이 이름으로 하고 서비스를 정의한다.

  • GATEWAY 절

    • GATEWAY 절에 게이트웨이를 생성한다.

    • type은 반드시 JEUS_ASYNC로 해야 한다. Java Gateway 입장에서 INBOUND의 경우 listen할 포트 번호는 PORTNO이며 OUTBOUND의 경우 접속할 ip, port는 RGWADDR, RGWPORTNO이고 백업을 시도할 때에는 BACKUP_RGWADDR, BACKUP_RGWPORTNO로 연결을 맺는다.

    • JTmax 서버에는 "maxclh*cpc 수"의 연결이 맺어진다.

2.2. JTmaxServer 설정

특별히 파일에 의한 설정은 필요없으나 로그를 남길 경우 FDL 처리하는 경우에는 설정을 해야 한다.

log.level=info
log.bufsize=1024
log.dir=/logs/jtmaxserver
log.file=jtmaxserver.log

fdl.file=/fdl/tmax.fdl

  • 파일의 위치는 애플리케이션을 실행할 때 "-Dwebt.properties=절대경로"로 정의한다.

  • log.level은 none < info < debug가 있다.

3. API

3.1. JTmaxServer

Tmax의 Async Java gateWay 에서의 요청을 처리하기 위한 클래스이다. 사용자는 JTmaxEventHandler를 구현하여 요청이 들어오면 처리할 수 있도록 한다.

사용 방법은 다음과 같다.

JTmaxServer server = new JTmaxServer("jtmaxserver1", 6555, 10, new SampleHandler());
try {
        server.startServer();
}
catch (IOException e) {
        error 처리...
}

3.2. JTmaxResult

JTmaxEventHandler에서 요청된 처리 결과를 저장하는 클래스이다. 서비스의 성공 여부, 에러 코드, 반환할 데이터에 대한 정보를 가질 수 있다.

3.3. JTmaxEventHandler

서비스 요청 처리를 위해 사용자가 구현해야할 인터페이스이다. tpcall, tpacall에 대한 처리뿐만 아니라 트랜잭션 처리를 위한 메소드 또한 구현해야 한다.

기본적인 데이터 사용(WebtBuffer, WebtSetringBuffer, WebtCarrayBuffer, WebtFieldBuffer)은 Tmax WebT User Guide를 참조한다.