TCS 서버 프로그램은 다음과 같은 구성된다.

UCS 서버 프로그램은 Tmax에서 관리하는 main() 루틴과 서비스 루틴, usermain() 루틴으로 구성된다.

TCS 프로세스는 보통의 3-Tier 개념을 가진 서버 프로세스이다. Tmax 시스템은 요청한 결과를 수신하고 그것을 클라이언트에게 반환하는 적절한 프로세스에 클라이언트의 요청을 스케줄한다. Tmax는 TCS 방식의 서비스 프로그램을 위한 main() 함수를 제공하기 때문에 개발자는 서비스 루틴만을 개발하면 된다. TCS 방식 프로그램은 지정된 서비스명을 함수로 하여 개발하면 된다.

TCS 방식의 main() 루틴과 서비스 루틴은 다음과 같다.

다음은 TCS 방식 프로그램의 예제이다.

SDLTOUPPER(TPSVCINFO *msg)
{
        ...
        struct  kstrdata *stdata;
        stdata = (struct kstrdata *)msg->data;
        ...
        for (i = 0; i < stdata->len; i++)
            stdata->sdata[i] = toupper(stdata->sdata[i]);
        ...
        tpreturn(TPSUCCESS,0,(char *)stdata, sizeof(struct kstrdata), TPNOFLAGS);
}

전형적인 TCS 방식 프로세스는 단지 클라이언트에서 요구한 일을 처리하는 수동적인 타입이지만, UCS는 클라이언트의 요청 없이도 연결하여 서비스를 제공한다. UCS는 서비스를 신속하게 제공할 수 있고 TCS 방식을 지원하여 더 많은 기능들을 제공할 수 있다. UCS 방식 프로그램은 usermain()과 서비스 루틴을 구성하고 있다.

UCS 방식의 main() 루틴과 서비스 루틴은 다음과 같다.

다음은 UCS 방식 프로세스를 사용하기 위한 Tmax 환경 파일의 예제이다.

*DOMAIN
res1        SHMKEY = 66999, MAXUSER = 256

*NODE
tmax       TMAXDIR = "/user/tmax",
           APPDIR  = "/user/tmax/appbin",
           PATHDIR = "/user/tmax/path",
           TLOGDIR = "/user/tmax/log/tlog",
           ULOGDIR = "/user/tmax/log/ulog",
           SLOGDIR = "/user/tmax/log/slog"

*SVRGROUP
svg1        NODENAME = tmax

*SERVER
svr1         SVGNAME = svg1

#UCS 방식 프로세스는 SVRTYPE = UCS라는 항목을 추가해야 한다.
ucssvr1      SVGNAME = svg1, SVRTYPE = UCS
ucssvr2      SVGNAME = svg1, SVRTYPE = UCS
ucssvr3      SVGNAME = svg1, SVRTYPE = UCS

*SERVICE
TOUPPER      SVRNAME = svr1
TOLOWER      SVRNAME = svr1
DUMY1        SVRNAME = ucssvr1
DUMY2        SVRNAME = ucssvr2

다음은 UCS 방식 프로그램의 예제이다.

#include    <stdio.h>
#include    <usrinc/atmi.h>
#include    <usrinc/ucs.h>

DUMY1(TPSVCINFO *msg)
{
        printf("svc start!");
        tpreturn(TPSUCCESS, 0, (char *)msg->data, 0, TPNOFLAGS);
}

int usermain(int argc, char *argv[])
{
        ...
        while (1) { 
            jobs = tpschedule(-1);
            cnt++;
            ...
            ret = tpcall("TOUPPER", sbuf, 0, &rbuf, &rlen, TPNOFLAGS);
            if (ret < 0) {
                error processing routine
            }
        }
}

RDP

RDP는 지속적으로 변하는 데이터를 클라이언트에게 효율적이고 빠르게 전달하기 위해 UCS 방식의 프로세스를 커널 수준에서 개량한 서버 프로세스이다. 소량의 데이터를 다수의 클라이언트에게 자주 보낼 필요가 있을 때(초당 10회 이상) 프로세스 점유율이나 처리 속도의 측면에서 월등한 성능을 보인다. 한 노드에는 하나의 RDP 방식 서버만을 사용할 수 있다. RDP는 형식상 UCS와 동일하며 환경 파일의 설정과 컴파일할 때 라이브러리만 다르다.

다음은 RDP 방식 프로세스를 사용하기 위한 Tmax 환경 파일에 대한 예제이다.

*DOMAIN
tmax1   SHMKEY = 7090, MINCLH = 2, MAXCLH = 2

*NODE
tmax1   TMAXDIR = "/home/navis/tmax",
        APPDIR = "/home/navis/tmax/appbin",
        PATHDIR = "/home/navis/tmax/path",
        TLOGDIR = "/home/navis/tmax/log/tlog",
        ULOGDIR = "/home/navis/tmax/log/ulog",
        SLOGDIR = "/home/navis/tmax/log/slog",
        REALSVR = "real",rscpc = 2

일반적인 C 컴파일러를 이용한 컴파일 방법으로 Tmax를 설치하면 생성되는 셸 프로그램을 사용하거나 mksvr 유틸리티를 사용하여 간단하게 컴파일할 수 있다.

다음은 구조체 버퍼와 필드 버퍼를 사용하는 서버 프로그램의 작성 순서를 나타낸 그림이다.

다음 예제는 Linux에서의 실행 예제이며 개발 환경(32/64Bit)과 플랫폼에 따라 사용되는 flags 및 라이브러리가 조금씩 다르다.

셸 프로그램을 사용한 컴파일

Tmax를 설치하면 예제 서버 프로그램 디렉터리에는 기본적으로 예제 프로그램 외에 4개의 Makefile과 이를 이용하는 셸 프로그램이 설치된다(Makefile.c, Makfile.sdl, Makfile.pc, Makefile.psdl, compile).

다음은 구조체 버퍼를 사용하고 데이터베이스를 사용하지 않는 Tmax 서버 프로그램 Makefile(Makefile.sdl)의 예이다. $COMP_TARGET에는 개발한 프로그램명이 들어가며 셸 프로그램 컴파일을 사용하여 전달한다.

# Server makefile

TARGET = $(COMP_TARGET)
APOBJS = $(TARGET).o
SDLFILE = demo.s

#Not use Db
LIBS    = -lsvr -lnodb
#Solaris의 경우 –lsocket –lnsl 이 추가된다.
#Oracle의 경우 –lnodb 대신 -loras, Informix 의 경우 –linfs
#Db2의 경우 –ldb2, Sybase 의 경우 –lsybs 가 들어간다.

OBJS    = $(APOBJS) $(SDLOBJ) $(SVCTOBJ)

SDLOBJ  = ${SDLFILE:.s=_sdl.o}
SDLC    = ${SDLFILE:.s=_sdl.c}
SVCTOBJ = $(TARGET)_svctab.o

CFLAGS  = -O -I$(TMAXDIR)
#CFLAG 는 사용 환경(32/64비트)과 플랫폼에 따라 다르다.
#Solaris 32bit, Compaq, Linux: CFLAGS = -O –I$(TMAXDIR)
#Solaris 64bit: CFLAGS = -xarch=v9 -O –I$(TMAXDIR)
#HP 32bit: CFLAGS = -Ae -O –I$(TMAXDIR)
#HP 64bit: CFLAGS = -Ae +DA2.0W +DD64 +DS2.0 -O –I$(TMAXDIR)
#IBM 32bit: CFLAGS = -q32 –brtl -O –I$(TMAXDIR
#IBM 64bit: CFLAGS = -q64 –brtl -O –I$(TMAXDIR

APPDIR  = $(TMAXDIR)/appbin
SVCTDIR = $(TMAXDIR)/svct
LIBDIR  = $(TMAXDIR)/lib
#64비트 환경을 사용하는 경우 $(TMADIR)/lib64 가 된다.

#
.SUFFIXES : .c

.c.o:
        $(CC) $(CFLAGS) -c $<

#
# server compile
#

$(TARGET): $(OBJS)
        $(CC) $(CFLAGS) -L$(LIBDIR) -o $(TARGET) $(OBJS) $(LIBS)
        mv $(TARGET) $(APPDIR)/.
        rm -f $(OBJS)

$(APOBJS): $(TARGET).c
        $(CC) $(CFLAGS) -c $(TARGET).c

$(SVCTOBJ):
        touch $(SVCTDIR)/$(TARGET)_svctab.c
        $(CC) $(CFLAGS) -c $(SVCTDIR)/$(TARGET)_svctab.c

$(SDLOBJ):
$(TMAXDIR)/bin/sdlc -i ../sdl/$(SDLFILE)
        $(CC) $(CFLAGS) -c ../sdl/$(SDLC)

#
clean:
        -rm -f *.o core $(TARGET)

각 Makefile의 사용법은 다음과 같다. svr1, svr2, svr3, fdltest, sdltest는 모두 Tmax 설치할 때 제공되는 샘플 프로그램이다. 자세한 내용은 해당 Makefile을 참고한다.

$./compile sdl svr1
$./compile c svr2
$./compile c svr3
$./compile pc fdltest
$./compile psdl sdltest

mksvr 유틸리티를 사용한 컴파일

mksvr 유틸리티를 사용하는 경우 Tmax 시스템 환경 파일을 작성할 때 미리 서비스명을 설정할 필요가 없으며 gst를 이용한 서비스 테이블 생성 과정도 필요로 하지 않는다. 그러나 구조체를 사용하는 경우 구조체-표준 버퍼 변환/역변환 프로그램은 미리 생성되어 있어야 하며 데이터베이스를 사용할 경우 미리 프리 컴파일 과정이 끝난 파일을 사용하거나 RM 파일을 지정해야 한다.

$cfl –i sample.m

$sdlc –i demo.s
$sdlc –c –i demo.s –o tmax.sdl
$mksvr –s SDLTOUPPER,SDLTOLOWER –o svr1 –f svr1.c –S ../sdl/demo_sdl.c

$mksvr –s TOUPPER,TOLOWER –o svr2 –f svr2.c 

$fdlc –c –i demo.s –o tmax.fdl
$mksvr –s FDLTOPPER, FDLTOLOWER –o svr3 –f svr3.c 

$proc iname=fdltest include $TMAXDIR
$mksvr –s FDLINS,FDLSEL,FDLDEL,FDLUPT –o fdltest –f fdltest.c

$mksvr –s SDLINS,SDLSEL,SDLDEL,SDLUPT –o sdltest –f sdltest.c
–S ../sdl/demo_sdl.c –r ORACLE

UCS 서버 프로그램의 컴파일은 TCS 서버 프로그램과 크게 다르지 않다. 준비 사항과 컴파일 순서는 동일하고 서버 라이브러리를 libsvr.a(혹은 libsvr.so)가 아닌 libsvrucs.a (혹은 libsvrucs.so)를 사용한다. 일반적인 C 컴파일러를 이용한 컴파일 방법으로 셸 프로그램을 사용하거나 mksvr 유틸리티를 이용하면 간단하게 컴파일할 수 있다.

다음 예제는 Linux에서의 실행 예제이며 개발 환경(32/64Bit)과 플랫폼에 따라 사용되는 flags 및 라이브러리가 조금씩 다르다. 사용 라이브러리를 제외하고는 TCS 방식과 완전히 동일하므로 자세한 내용은 “3.4.1. TCS”를 참고한다.

mksvr 유틸리티를 사용한 컴파일

mksvr 유틸리티를 사용하는 경우 Tmax 시스템 환경 파일을 작성할 때 미리 서비스명을 써 줄 필요가 없으며 서비스 테이블 생성(gst) 과정도 필요로 하지 않는다. 그러나 구조체를 사용하는 경우 구조체-표준 버퍼 변환/역변환 프로그램은 미리 생성되어 있어야 하며 데이터베이스를 사용할 경우 미리 프리 컴파일 과정이 끝난 파일을 사용하거나 RM 파일을 지정해야 한다.

$cfl –i sample.m
$sdlc –i demo.s
$sdlc –c –i demo.s –o tmax.sdl
$mksvr –s UCSSAMPLE –o ucs_svr –f ucs_svr.c –S ../sdl/demo_sdl.c –t UCS