기본 storage가 아닌 외부 storage를 사용하는 경우 HMS를 해당 storage 라이브러리에 맞추어 새롭게 빌드해야 한다. HMS를 빌드하기 위해서는 운영 시스템에 storage가 설치되어 있고 해당 storage를 지원하는 라이브러리가 있어야 한다. 또한 운영 시스템에 설치된 storage를 올바르게 사용하기 위한 환경변수 설정을 확인해야 한다.

예를 들어 UNIX 시스템에서 외부 storage를 Oracle로 사용할 경우 다음 환경변수 값들을 설정하거나 올바르게 설정되었는지 확인한다.

HMS가 사용하게 될 storage의 라이브러리 이외에 Tmax에서 각 storage 종류에 맞추어 제공하는 HMS 라이브러리도 준비되어 있어야 한다. HMS 라이브러리는 기본 storage를 사용할 경우에는 libhms.a 이름으로 제공되고, 외부 storage를 사용할 경우에는 libhms_<STORAGE>.a 형태의 이름으로 제공된다.

예를 들어 외부 storage로 Oracle을 사용할 경우 HMS 라이브러리는 libhms_ora.a의 이름으로 제공된다.

외부 storage를 사용하여 HMS를 새로 빌드하는 경우 Makefile을 이용한다. Makefile은 사용자의 플랫폼 및 개발 환경에 맞게 수정해서 사용한다.

다음은 Linux 환경에서 외부 storage로 Oracle을 사용하기 위한 HMS Makefile의 예제이다.

# HMS Makefile for Oracle
# Linux
TARGET  = hms_ora
APOBJ   = dumy.o
APPDIR  = $(TMAXDIR)/appbin
TMAXLIBD= $(TMAXDIR)/lib
TMAXLIBS= -lhms_ora -lpthread 
 
CFLAGS  = 

all: $(TARGET)
 
include $(ORACLE_HOME)/precomp/lib/env_precomp.mk
ORALIBDIR = $(LIBHOME)
ORALIB  = $(PROLDLIBS)
 
$(TARGET): $(APOBJ)
    $(CC) $(CFLAGS) -o $(TARGET) -L$(TMAXLIBD) -L$(ORALIBDIR) $(ORALIB) $(APOBJ) 
    $(TMAXLIBS)
    mv $(TARGET) $(APPDIR)/.
 
$(APOBJ):
    $(CC) $(CFLAGS) -c dumy.c
 
clean:
    -rm -f core $(TARGET) $(APPDIR)/$(TARGET)
~                                                                                                             
~                                                                                         

HMS Makefile을 이용할 경우 빌드된 HMS는 $TMAXDIR 아래 appbin 디렉터리로 옮겨진다. appbin 디렉터리로 옮겨지지 않았다면 빌드된 HMS를 appbin으로 복사해준다.

HMS의 파일명은 사용자가 지정할 수 있다. 지정한 HMS의 이름은 Tmax 환경설정 파일에 SVRGROUP 절의 HMSNAME 항목에 대한 값이 된다.

tmadmin의 st 명령을 사용해서 환경설정 파일에서 설정한 Destination의 목록, 각 Destination에서 처리 중인 메시지와 클라이언트의 정보를 확인할 수 있다.

tmadmin st -q

다음은 명령을 수행했을 때 조회되는 로컬 HMS 환경에 대한 정보이다.

$$2 Locke2 (tmadm): st -q
 ----------------------------------------------------------------------------------
 G  dest       cqcount   type   apqcnt   acqcnt  f_dscrd  t_dscrd cons_cnt prod_cnt
 ----------------------------------------------------------------------------------
 -  queue01         58  QUEUE      169      111        0        0       30        5
 -  topic01         32  TOPIC       42      283        0        0       28        3

다음은 조회되는 정보의 각 필드에 대한 설명이다.

tmadmin의 st 명령어를 사용해서 특정 Destination에 대한 각 클라이언트의 상세한 정보를 조회할 수 있다.

tmadmin st -q <DestinationName> -c

다음은 명령을 수행했을 때 조회되는 클라이언트 정보이다.

$$3 Locke2 (tmadm): st -q queue01 -c
   ------------------------------------------------------------------------------
      sesi     clid     cname      clitype qcnt  cnt  f_dscrd t_dscrd   listener 
   ------------------------------------------------------------------------------
         0    0x39d prodasync        ARCV    49    0    0    0         ASYNCSVC
       0x1        0 prod41           SND      0   32    0    0                 
       0x1        0 prod42           SND      0   11    0    0                 
       0x1        0 cons51           RCV      3    0    0    0                 
       0x1        0 cons52           RCV      9    0    0    0                 

$$4 Locke2 (tmadm): st -q topic01 -c
   ------------------------------------------------------------------------------
      sesi     clid     cname      clitype qcnt  cnt  f_dscrd t_dscrd   listener 
   ------------------------------------------------------------------------------
       0x1        0 prod11           PUB      0    2    0    0                 
       0x1        0 prod12           PUB      0    1    0    0                 
       0x1        0 cons11           SUB     30    0    0    0                 
       0x2      0x2 prod21           PUB      0   16    0    0                 
       0x2      0x2 prod22           PUB      0    8    0    0                 
       0x2      0x2 cons21           SUB     23    0    0    0                 
       0x3        0 prod31           PUB      0    3    0    0                 
       0x4      0x4 cons41           ADSUB   32    0    0    0          ASYNCSVC2

다음은 조회되는 정보의 각 필드에 대한 설명이다.