범위 : 15자 이내

DOMAIN 절은 Tmax 시스템의 전반적인 환경에 대한 정의이다.

범위 : 32768 ~ 262143

공유 메모리 세그먼트(shared memory segment)를 가리키는 값이다. Tmax에는 전체적인 Tmax 관리자로 다른 프로세스를 관리하는 TMM, 데이터베이스 및 리소스를 관리하는 TMS, 클라이언트의 연결을 관리하는 CLL, 클라이언트와 서버 프로세스 사이에서 요청 및 응답을 처리하는 CLH 등 기능별로 크게 4개의 프로세스가 존재한다.

SHMKEY에서 이러한 4개의 프로세스가 공유해야 할 정보를 관리하기 위한 공유 메모리 키 값을 정의한다. Tmax 시스템은 내부적으로 4개의 공유 메모리가 사용되어 정의된 값부터 차례대로 4개의 키 값(SHMKEY, SHMKEY+1, SHMKEY+2, SHMKEY+3)을 사용한다.

DOMAIN 절 뿐만 아니라 Tmax 환경 파일의 모든 절에서 사용할 수 있는 항목으로 자세한 내용은 "3.2.2 NODE 절"의 DEFAULT 항목을 참고한다.

범위 : 1 ~ MAX_INT

도메인에 동시에 접속할 수 있는 최대 클라이언트 수를 정의한다. 'MAXUSER로 설정된 값 + 1'만큼의 클라이언트 접속을 허용하고 있다.

범위 : 1 ~ 10

기본값 : 1

Tmax 시스템이 기동될 때 작동하는 CLH의 최소 개수를 정의한다.

CLH는 클라이언트의 요구를 처리하는 프로세스로 클라이언트의 서비스 요청을 받아 업무처리 서버 프로세스에게 서비스를 요청하고 그 결과를 받아 다시 클라이언트에게 돌려주는 기능을 한다. CLH는 모든 클라이언트와 연결이 이루어지는 프로세스로, 시스템에 따라 하나의 CLH에 연결될 수 있는 클라이언트의 수가 제한되어 있다. 그러므로 많은 클라이언트가 연결을 시도하는 대형 도메인의 경우, 하나 이상의 CLH 프로세스를 동작시켜야 한다. 그러기 위해서 적절한 MINCLH 값을 정의해야 한다.

[그림 3.2] MINCLH = 2인 경우

범위 : 1 ~ 10

기본값 : 10

CLH의 최대 개수를 정의한다. 처음 Tmax 시스템이 기동될 때, CLH는 MINCLH에 정의한 개수만큼 동작한다. MINCLH에 정의한 CLH 프로세스의 개수로는 감당할 수 없을 만큼 클라이언트의 요구가 증가하는 경우, CLH 프로세스를 추가적으로 동작시켜 원활하게 업무를 처리하도록 할 수 있다.

추가되는 CLH 프로세스의 개수에 이미 동작하고 있는 CLH 프로세스를 합쳐서 MAXCLH 개수를 초과할 수 없다. 현재는 클라이언트 요구 증가에 따라 MAXCLH 프로세스의 개수가 늘어나는 기능은 제공되지 않고 있다.

기본값 : 8888

클라이언트가 서버에 연결될 때 사용하는 Tmax 시스템의 포트 번호를 정의한다. 정의된 값(TPORTNO)과 바로 다음 값(TPORTNO+1)이 포트 번호로 사용된다.

처음 TPORTNO 값은 클라이언트가 서버에 연결할 때 사용하고, 다음 값(TPORTNO+1)은 노드 사이의 통신을 위해 사용된다. 클라이언트/서버 환경에서 클라이언트는 서버의 주소와 Tmax 시스템의 포트 번호를 알아야 한다.

Tmax 클라이언트 환경에서는 주소(TMAX_HOST_ADDR)와 포트 번호(TMAX_HOST_PORT)가 설정되어야 한다. 이 경우 설정되어야 할 포트 번호가 TPORTNO이다. 하지만 클라이언트와 서버가 같은 노드에 존재하는 경우에는 TCP/IP 소켓을 사용하지 않고 도메인 소켓을 사용하여 보다 효과적으로 서비스를 처리할 수 있다.

서버는 2가지 형태의 클라이언트를 모두 수신할 수 있도록 설정되어 있는데 TCP/IP 소켓을 위해서는 TPORTNO로 대기하고 있으며 도메인 소켓을 위해서는 PATHDIR의 cllrcad라는 스트림 파이프로 대기하고 있다.

클라이언트와 서버가 같은 노드에 존재하는 경우에는 환경변수의 TMAX_HOST_PORT 항목에 TPORTNO에서 사용한 포트 번호 대신에 PATHDIR을 지정하면 된다. 예를 들면 .profile 또는 tmax.env의 TMAX_HOST_PORT=/home/tmax/path로 지정할 수 있다.

TPORTNO+1은 노드 사이의 통신을 위해 또 하나의 포트 번호로 사용된다.

Tmax 시스템의 노드 사이의 구성 방식은 Peer-to-peer 형태이다. TPORTNO+1 값을 사용하여 환경 파일에 등록된 순서대로 다음 노드를 체크한다. 시스템 영역에서는 1024 미만의 포트 번호가 사용되고 있으므로 관리자는 이 범위를 피해야 한다.

클라이언트와 Tmax 시스템 또는 노드 사이에 통신을 할 때 TPORTNO와 TPORTNO+1 값에 정의된 포트 번호가 사용되기 때문에, 이 값이 다른 곳에서 사용되고 있는지 반드시 확인해야 한다. 또한 멀티 노드를 설정할 때 CLH가 추가적인 포트를 사용하므로 CLH 개수만큼 포트 번호가 유효한지도 확인해야 한다.

IPv6 프로토콜을 사용할 경우에는 CLIENT_IPV6 항목 설정을 'Y'로 설정해야 한다.

기본값 : 3333

한 도메인 내에 여러 노드가 구성되어 있는 경우, 여러 노드를 중앙에서 관리하기 위해서 각각의 노드 사이에 통신을 위한 포트 번호를 정의한다. 관리 프로세스 중의 하나인 racd에서 사용하는 포트 번호이다. 해당 포트 번호는 환경변수인 TMAX_RAC_PORT 번호에 정의된 값과 동일해야 한다. 시스템 영역에서는 1024 미만의 포트 번호가 사용되고 있으므로 관리자는 이 범위를 피해야 한다.

환경변수에서 값이 다를 경우 TMAX_RAC_PORT를 사용한다. RACPORT는 TPORTNO에서 정의한 포트 번호보다 작은 포트값을 사용할 것을 권장하며, 또한 RACPORT의 포트 번호도 다른 곳에서 사용되고 있는지의 여부를 반드시 확인해야 한다.

범위 : 1 ~ MAX_INT

기본값 : 0 (단위: 초)

값을 설정하지 않으면 기본값으로 설정되어 무한 대기한다.

서비스 요구에 대한 타임아웃(timeout) 시간을 결정한다. 클라이언트가 API 함수를 통해 서비스 요청 후 최대 BLOCKTIME 시간이 지나도록 응답이 없으면 클라이언트 자체적으로 타임아웃 처리를 한다. 그러나 서버 프로세스는 계속해서 서비스를 처리한다.

서비스도 종료하고 싶으면 SERVICE 절의 SVCTIME 항목에 서비스 타임을 지정해야 한다. BLOCKTIME은 SVCTIME과 깊이 연관되어 있다. BLOCKTIME이 SVCTIME보다 길다면 클라이언트 tpcall을 타임아웃할 때 SVCTIME이 적용된다. 반대로 SVCTIME이 BLOCKTIME보다 길다면 BLOCKTIME이 적용된다. BLOCKTIME은 클라이언트의 tpcall을 위한 타임아웃이고, SVCTIME은 서버 프로세스를 위한 타임아웃이기 때문에 SVCTIME의 타임아웃 시간까지 tpcall()된 서비스가 수행된다. 일반적으로 BLOCKTIME은 SVCTIME보다 큰 값을 갖는다.

범위 : 1 ~ 128

기본값 : 1

여러 노드로 구성된 Tmax 시스템에서 노드의 CLH 프로세스의 채널 수를 결정하는 항목이다. 양 노드 사이에 서비스 요청이 많거나, 또는 분산 트랜잭션이 많을 경우 노드 사이에 채널 수가 너무 적으면 서비스 처리가 지연되어 전체적으로 시스템 성능이 저하될 수 있다. 이처럼 전체 시스템의 성능을 높이려면 각 노드의 CLH 프로세스 사이에 적정 병렬 통신 채널 수를 지정해야 한다.

범위 : 1 ~ MAX_INT

기본값 : 0

값을 설정하지 않으면 기본값으로 설정되고 해당 기능은 사용하지 않는다.

TopEnd 시스템으로 구축된 시스템을 Tmax 시스템으로 전환할 때 TopEnd 시스템에서 사용하는 함수를 Tmax 시스템에서 제공할 수 있도록 함수 테이블의 크기를 결정하는 항목이다.

정상, 비정상 상태에서 수행될 서비스를 Tmax 서버의 클라이언트 로그아웃 프로세스에 등록한다.

LOGOUTSVC는 시스템에서 클라이언트의 정상적인 로그아웃을 위해 서비스에 로그인이나 로그아웃을 할 때 사용된다. LOGOUTSVC는 설정된 시간(CLICHKINT, IDLETIME)이 지나서 클라이언트가 자동으로 로그아웃이 되는 경우 이를 처리한다.

LOGOUTSVC 항목을 사용할 때 주의할 점은 반드시 Tmax 클라이언트인 경우에만 LOGOUTSVC가 수행이 된다는 점이다. 일반 소켓 연결이 발생하는 상황에서는 수행되지 않는다. service name을 서비스로 하는 프로그램에는 내부적으로 tpgetclid()를 호출하여 클라이언트 ID를 알 수 있고, 로그아웃 원인은 tpsvcinfo 구조체 항목의 CD를 참조한다.

범위 : 1 ~ MAX_INT

기본값 : 0

값을 설정하지 않으면 기본값으로 설정되고 해당 기능은 사용하지 않는다.

클라이언트의 정상 기동여부를 주어진 감시 시간 간격으로 체크하기 위한 항목이다. 단독으로 사용하는 것보다 다음 항목에 설명할 IDLETIME 항목과 조합해서 사용하면 클라이언트의 정확한 상태를 Tmax 엔진에서 감시하여 낭비되는 자원을 최소화할 수 있다.

해당 항목을 DOMAIN 절에 정의하면 해당 도메인에 접속한 모든 클라이언트를 감시하고 NODE 절에 등록하면 해당 노드에 접속한 클라이언트만 감시한다.

범위 : 1 ~ MAX_INT

기본값 : 0

값을 설정하지 않으면 기본값으로 설정되고 해당 기능은 사용하지 않는다.

클라이언트의 유휴시간(idle time)을 정의한다. CLICHKINT를 5로 설정하고 IDLETIME을 30으로 설정하였다면, 5초 간격으로 클라이언트의 상태를 확인하고 30초 이내에 요청이 들어오지 않으면 Tmax 엔진에서 해당 클라이언트를 제거한다.

IDLETIME은 클라이언트로부터 tpstart()로 연결을 맺거나 tpcall(), tpacall() 요청이 온 다음부터 유효하다. 이 값은 BLOCKTIME이나 SVCTIME보다 커야 한다. 만약 IDLETIME 값이 BLOCKTIME과 SVCTIME보다 더 작게 설정된다면 클라이언트가 응답을 받기 전에 자동으로 로그아웃이 된다.

범위 : 1 ~ 1024

기본값 : 8

서버 프로세스가 tpgetrply 없이 요청할 수 있는 tpacall의 개수를 정의한다. 서버 라이브러리는 각각의 tpacall을 따르기 때문에 테이블 크기를 설정하는 초기화 MAXSACALL에 테이블을 작성한다.

범위 : 1 ~ 1024

기본값 : 16

클라이언트 프로세스가 tpgetrply 없이 요청할 수 있는 tpacall의 개수를 정의한다. 클라이언트 라이브러리는 각각의 tpacall을 따르기 때문에 테이블 크기를 설정하는 초기화 MAXCACALL에 테이블을 작성한다.

범위 : 1 ~ MAX_INT

기본값 : 0 (단위: 초)

값을 설정하지 않으면 기본값으로 설정되어 무한 대기한다.

트랜잭션 모드에서 요청한 서비스의 처리가 주어진 시간 내에 수행되지 않으면 해당 서비스의 처리를 취소한다.

서비스 수행 전후에 XA를 처리하는 중 데이터베이스나 네트워크 장애로 인해 무한 블록이 일어나는 경우를 방지하기 위해서 내부 타임아웃을 적용한다.

범위 : 1 ~ MAX_INT

기본값 : 30 (단위: 초)

Tmax 시스템이 여러 노드로 구성되었을 경우, 노드 사이의 감시 시간 간격을 정하는 항목이다. Tmax 시스템은 양 옆의 노드를 Peer-to-peer로 연결하여 환경 파일에 등록된 순서대로 다음 노드를 감시하여 전체 노드가 원활하게 통신할 수 있도록 구성되어 있다.

NLIVEINQ 시간이 짧으면 양 노드를 빈번하게 감시해 노드의 이상 상태를 즉시 체크할 수 있으나, 많은 통신량으로 인해 통신 부하가 발생할 수 있다. 반대로 NLIVEINQ 시간이 너무 길면 통신량은 적으나 노드의 이상 상태를 즉시 감시를 할 수 없다. 따라서 시스템 성능을 최적화하기 위하여 네트워크 부하량, 업무의 중요도 등을 고려하여 적절한 NLIVEINQ 값을 정해야 한다.

범위 : 1 ~ MAX_INT

기본값 : 0 (단위: 초)

각 노드의 CLH 프로세스가 일정 시간동안 데이터의 흐름이 없을 경우 지정한 시간이 되면 자동적으로 각 노드의 CLH 프로세스끼리 감시 신호를 보내는 역할을 담당한다.

방화벽은 특정 시간동안 데이터의 흐름이 없으면 사용 프로세스를 제거하는 기능이 있는데 Tmax의 내부 CLH 프로세스도 영향을 받는다. 따라서 이 기능을 사용할 때는 세심한 주의가 필요하다.

범위 : 1 ~ 2048

기본값 : 16

CLH 별 동시에 실행 가능한 대화형 서비스 수이다. 즉, 모든 클라이언트 및 서버 프로세스에서 동시에 대화형 서비스를 100개까지 호출한다면 이 값은 100 이상이 되어야 한다.

MAX를 초과될 때 TPELIMIT 에러가 발생한다.

범위 : 1 ~ 256

기본값 : 8

각 클라이언트, 서버 프로세스별로 동시에 실행 가능한 대화형 서비스 수로 MAXCACALL, MAXSACALL과 같은 개념이다.

MAXCONV_NODE와 마찬가지로 최댓값을 초과할 경우 TPELIMIT 에러가 발생한다.

기본값 : "NO_SECURITY"

“NO_SECURITY” | ”DOMAIN_SEC” | ”USER_AUTH“ 중에 하나를 설정해서 보안 설정을 한다.

Tmax에서 제공하는 보안 설정에 대한 자세한 설명은 “3.9. 보안 환경설정”을 참고한다.

범위 : 15자 이내의 string

자세한 설명은 “3.9. 보안 환경설정”을 참고한다.

범위 : 0600 ~ 0777

기본값 : 0600(파일 접속 제어의 기본값은 IPCPERM이 없을 경우 600이다.)

IPCPERM(inter-process communication permission mask)는 공유 메모리 세그먼트와 $(TMAXDIR)/path에 위치한 파이프 파일의 제어 단위를 설정하는 데 쓰인다. 또한 시스템 로그 파일($(TMAXDIR)/log/slog)의 제어 단위도 설정한다.

UNIX 시스템 환경에서는 관리자가 개인이나 그룹, 기타에게 각각 파일 접속 제어(판독가능/기록가능/수행가능)를 지정할 수 있다. 사용자(개인)의 판독과 기록은 가능하지만 그룹과 기타는 불가능하다.

IPCPERM 필드는 다른 사용자에게 시작/종료 권한을 주기 위해 제어를 설정하는 데 사용된다. IPCEPERM이 없으면 다른 사용자는 서버 프로세스의 시동과 종료를 제어할 수 없다.

범위 : 0 ~ 255

기본값 : 0

여러 개의 도메인으로 작업을 할 때 특정 도메인을 나타내기 위한 키 값이 필요하다. 이 필드는 키 값을 정의하는 데 쓰인다. 멀티 도메인 환경에서는 반드시 설정되어 있어야 한다.

기본값 : Y

자세한 설명은 “3.4. 분산 트랜잭션 환경설정”을 참고한다.

범위 : 1 ~ MAX_INT

기본값 : 32

도메인 내 최대 노드 개수의 한계를 설정한다.

범위 : 1 ~ MAX_INT

기본값 : 32

해당 노드에서 사용할 수 있는 최대 서버 그룹 개수의 한계를 설정한다.

범위 : 1 ~ MAX_INT

기본값 : 64

한 노드에 최대로 기동할 수 있는 서버 프로세스의 개수로 각 서버 프로세스의 최댓값의 합으로 계산된다.

범위 : 1 ~ MAX_INT

기본값 : 64

한 노드에 최대로 등록할 수 있는 서버의 최대 개수를 의미한다.

한 노드에 svr1, svr2, svr3라는 3개의 서버가 등록되어 있고 각 서버마다 최댓값이 "50"이라면 "MAXSPR=150"이 되고 "MAXSVR=3"이 된다.

범위 : 1 ~ MAX_INT

기본값 : 512

한 도메인에 최대로 등록할 수 있는 서비스의 개수를 지정한다.

tmadmin에서 cfg -d로 보았을 때 지정한 값과 다르게 나타나는 이유는 추후 동적 서비스 및 동적 노드를 추가할 때 필요한 예비영역까지 포함되어 있기 때문이다.

범위 : 0 ~ 65535

기본값 : 32

한 노드당 CPC의 최댓값을 설정한다.

범위 : 1 ~ MAX_INT

기본값 : 32

해당 노드에서 기동 가능한 TMS의 최대 개수를 설정한다.

범위 : 1 ~ MAX_INT

기본값 : 16

서비스 중에서 ROUTING 항목을 지정할 수 있는 서비스의 최대 개수를 의미한다.

예를 들어 30개의 서비스가 있을 경우 그 중 10개의 서비스만 ROUTING 항목을 지정할 수 있다면 MAXROUT는 10이 된다.

범위 : 1 ~ MAX_INT

기본값 : 32

SERVICE 절의 ROUTING 항목에 지정한 라우팅할 그룹 수(서버 그룹 또는 도메인 게이트웨이)의 총 합의 최댓값을 의미한다.

예를 들면 서비스 A의 ROUTING 항목이 RT1이고 서비스 B의 ROUTING 항목이 RT2 일때 RT1의 RANGES 항목의 그룹 수는 2개이고 RT2의 RANGES 항목의 그룹 수가 4개라면 ROUT SVGs 수는 6개가 된다. 그러므로 MAXROUTSVG는 6개 이상으로 설정하여 한다.

*SERVICE
A        ROUTING = RT1
B        ROUTING = RT2

*ROUTING
RT1     RANGES = "'a':svg1,*:DGW1"
RT2     RANGES = "'a':svg1,'b':svg2,'c':DGW2,*:DGW1"

범위 : 1 ~ MAX_INT

기본값 : 2

해당 노드에서 사용할 수 있는 최대 RQ의 개수를 지정한다.

범위 : 1 ~ MAX_INT

기본값 : 2

해당 노드에서 사용할 수 있는 최대 게이트웨이의 개수를 지정한다.

범위 : 1 ~ MAX_INT

기본값 : 16

서버 그룹에서 COUSIN 항목을 지정할 수 있는 서버 그룹의 최대 개수를 의미한다. 예를 들어 30개의 서버 그룹이 있을 경우 그 중 10개의 서버 그룹만이 COUSIN 항목을 지정할 수 있다면 MAXCOUSIN은 10이 된다.

범위 : 1 ~ MAX_INT

기본값 : 32

SVRGROUP 절의 COUSIN 항목에 지정한 서버 그룹의 총 합의 최댓값을 의미한다. 예를 들어 MAXCOUSIN의 값이 10이고 COUSIN 항목에 2개의 서버 그룹을 지정할 수 있다면 MAXCOUSINSVG의 값은 20이 된다.

범위 : 1 ~ MAX_INT

기본값 : 16

서버 그룹에서 BACKUP 항목을 지정할 수 있는 서버 그룹의 최대 개수를 의미한다. 예를 들어 30개의 서버 그룹이 있을 경우 그 중 10개의 서버 그룹만이 BACKUP이란 항목을 지정할 수 있다면 MAXBACKUP은 10이 된다.

범위 : 1 ~ MAX_INT

기본값 : 32

SVRGROUP 절의 BACKUP 항목에 지정한 서버 그룹의 총 합의 최댓값을 의미한다.

예를 들어 MAXBACKUP의 값이 10이고 각각 BACKUP 항목에 2개의 서버 그룹을 지정할 수 있다면 MAXBACKUPSVG의 값은 20이 된다.

범위 : 1 ~ MAX_INT

기본값 : 64

지정할 수 있는 총 서버 그룹의 최댓값을 의미한다.

범위 : 1 ~ MAX_INT

기본값 : 0

값을 설정하지 않으면 기본값으로 설정되고 해당 기능은 사용하지 않는다.

TopEnd 시스템으로 구축된 시스템을 Tmax 시스템으로 전환할 때 사용하는 항목으로 지정할 수 있는 product name의 최댓값을 의미한다. (TopEnd 용)

범위 : 1 ~ MAX_INT (단위: 초)

멀티 도메인 환경에서 백업 노드 게이트웨이가 존재하는 경우, 리모트의 메인 노드 게이트웨이에 장애가 일어났을 때 백업 노드 게이트웨이에 접속하여 서비스 요청을 하게 된다. 이 상황에서는 메인 노드가 복구된 후에도 백업 노드에 서비스 요청을 한다. 메인 노드와 다시 연결을 맺기 위해서는 백업 노드 게이트웨이를 임의로 다운시켜야만 한다. 하지만 사용자가 메인 노드가 복구된 후에 메인 노드와의 거래를 원하는 경우 Tmax 환경 파일에 이 항목을 설정한다.

다음은 이 항목 설정할 때 고려사항이다.

범위 : 1 ~ MAX_INT (단위: 초)

도메인 게이트웨이는 초기 시스템이 기동될 때 리모트 게이트웨이와 연결을 시도한다.

환경 파일 DOMAIN 절에 GWCHKINT 항목이 설정되어 있지 않은 상태에서 리모트 게이트웨이가 설치되어 있는 머신이 기동되어 있지 않은 경우, 요청자 입장에서는 연결이 실패했다는 메시지가 출력될 때까지 오랜 시간을 기다리게 된다.

또한 이와 같은 상황에서 거래가 없을 경우 재연결을 시도하지 않게 되며 서비스가 요청되는 시점에 재연결을 시도하게 되는데, 이 경우에도 리모트 게이트웨이가 준비되어 있지 않은 상황이라면 오랜 시간을 기다려야 한다. 이와 같은 단점을 해소하기 위해서 연결 타임아웃을 지정할 수 있도록 한다.

Tmax v5.0 SP2부터 도메인 게이트웨이는 NonBlocking 방식으로 연결을 시도하며 환경설정의 NLIVEINQ, GWCHKINT 등의 설정에 따라 연결 타임아웃을 체크하는 주기가 결정되기 때문에 GWCONNECT_TIMEOUT 설정값보다 더 시간이 지난 뒤에 timeout 처리될 수 있다.

GWCONNECT_TIMEOUT이 설정되어 있지 않다면 기존과 같은 방식으로 동작한다.

기본값 : DETAIL

TMM의 로그 레벨을 설정한다. (COMPACT, BASIC, (DETAIL), DEBUG1, DEBUG2, DEBUG3, DEBUG4 중 1가지를 선택하여 설정한다.)

범위 : TMM과 동일

CLH의 로그 레벨을 설정한다.

범위 : TMM과 동일

TMS의 로그 레벨을 설정한다.

서버의 로그 레벨을 설정한다.

기본값 : N

Tmax 4.0부터 클라이언트와 서버 사이의 송, 수신 데이터를 보다 안정적으로 전달할 수 있도록 암호화 기능을 제공한다. 암호화 기능을 사용하기 위해서는 클라이언트와 서버 모두 암호화 기능이 설정되어 있어야 한다.

서버에 암호화 기능을 설정하기 위해서는 CRYPT 항목을 'Y'로 설정한다. 사용하지 않으려면 'N'으로 설정한다. 클라이언트 암호화 기능 설정 방법은 “2.2.2. 클라이언트 환경변수”의 TMAX_SEMANTICS 환경변수를 참고한다.

다음은 항목을 설정하는 경우 고려할 사항이다.

범위 : 1 ~ MAX_INT

기본값 : 0

값을 설정하지 않으면 기본값으로 설정되고 해당 기능은 사용하지 않는다.

Tmax 4.0 이후 버전에서는 Multi Thread 방식의 트랜잭션 매니저를 제공하여 적은 자원을 이용하여 보다 효율적으로 트랜잭션 처리가 가능하다. Multi Thread TMS를 사용하기 위해서 이 항목에 Multi Thread TMS의 최대 Thread 개수를 지정한다. 또한 SVRGROUP 절에 TMSTYPE, TMSTHREAD, TMSOPT 항목도 설정한다.

각 항목에 대한 내용은 "3.2.3 SVRGROUP 절"의 TMSTYPE, TMSTHREAD, TMSOPT를 참고한다.

다음은 항목을 설정할 때 고려할 사항이다.

기본값 : N

TDL(Tmax Dynamic Library) 암시적 버전 보호를 사용할 것인지 여부(Y|N)를 설정한다.

범위 : 1 ~ 65535

기본값 : 1024

한 도메인 내의 HMS에서 생성할 수 있는 세션 수의 최댓값을 설정한다. 자세한 내용은 “3.7. HMS 환경설정”을 참고한다.

범위 : 1 ~ MAX_INT

기본값 : 0

pending된 트랜잭션의 타임아웃을 설정한다. 타임아웃 시간동안 pending된 트랜잭션의 응답이 오지 않으면 Rollback을 시킨다. 설정하지 않으면 검사를 하지 않는다.

기본값 : N

Tmax 시스템에서 클라이언트의 접속을 위한 포트를 생성할 때 IPv6 프로토콜의 사용 여부를 결정한다.

기본값 : N

Tmax 시스템이 여러 노드로 구성되었을 경우에 노드 사이의 통신을 위한 포트를 생성할 때 IPv6 프로토콜의 사용 여부를 결정한다.

기본값 : N

Tmax 시스템에서 Extern Server의 접속을 위한 포트를 생성할 때 IPv6 프로토콜의 사용 여부를 결정한다.

기본값 : Y

클라이언트 접속을 위한 포트를 생성할 때, NODE 절의 IP에 설정된 주소의 인터페이스를 사용할 것인지 여부를 결정한다.

'N'으로 지정하거나 IP를 설정하지 않으면 모든 인터페이스로부터의 접속을 허용한다.

기본값 : 1

범위 : 1 ~ 2

2로 지정하면 검색 성능이 향상된 버전으로 동작하며, 기존의 Tmax와의 호환성이 없다.

이 옵션의 영향을 받는 것은 서버 애플리케이션, ROUTING 절 설정에 따른 CLH의 스케쥴링이다. 만약 fb* API를 사용할 때 FDL_VERSION 설정이 자신의 환경과 일치하지 않으면 FBESETVER 에러를 리턴한다.

크기 : 15자 이내

노드의 물리적인 이름으로, UNIX의 "uname -n" 명령으로 확인된 이름을 정의한다.

설정한 노드명은 반드시 "/etc/hosts" 파일에 등록되어 있어야 한다. 하나의 도메인(DOMAIN)은 하나 이상의 노드로 이루어지므로, NODE 절에는 최소한 하나 이상의 노드명이 정의되어야 한다.

크기 : 255자 이내

Tmax 프로그램이 설치(install)되어 있는 홈 디렉터리의 절대 경로이다. 경로는 환경변수 TMAXDIR과 동일한 값이 정의되어야 한다. TMAXHOME이 정의되지 않았을 경우 Tmax 관련 작업은 TMAXDIR 디렉터리에서 모두 이루어진다.

크기 : 255자 이내

Tmax를 이용하는 애플리케이션의 실행 파일이 존재하는 디렉터리의 절대 경로로 서버의 작업 디렉터리의 절대 경로이다.

Tmax 시스템에는 Tmax 자체 프로세스들 이외에도, 클라이언트 요구를 처리하는 애플리케이션이 있다. Tmax 시스템이 기동될 때 함께 기동되고, 종료될 때도 함께 종료된다.

애플리케이션의 실행 파일이 설치되어 있는 디렉터리를 정의하는 항목은 APPDIR이다. 또한 서버의 작업 디렉터리이기도 하며 서버 프로그램에서 발생하는 core 파일이 APPDIR에서 저장된다.

NODE 절뿐만 아니라 Tmax 환경 파일의 모든 절에서 정의할 수 있는 LABEL이다.

NODE 절에서 이 LABEL은 여러 노드로 구성된 경우 각 노드마다 같은 값을 가진 항목을 정의하려 할 때 유용하게 사용할 수 있다. LABEL로 "DEFAULT: "가 정의되면, 이후 해당 절이 끝나거나 다른 "DEFAULT: "에 의해서 Override될 때까지 유효하다.

"DEFAULT:"에 의해서 정의된 항목들이 NODE 절에 별도로 정의되어 있지 않으면 "DEFAULT:"에 의해서 정의된 값들이 모든 노드에 공통적으로 적용된다.

재정의되었으면 해당 노드에 대해서는 NODE 절에서 정의된 새로운 값이 적용된다.

크기 : 255자 이내

실제 호스트와 환경 파일에 정의하는 노드명이 다를 경우에도 동작하도록 하기 위한 항목으로 실제 호스트명을 지정한다. HOSTNAME을 지정헸을 경우 하나의 머신 내에서 논리적인 멀티 노드를 사용할 수 있다. 하나의 호스트명에 여러 개의 노드명을 사용할 수 있다.

NODE 절에는 TMAXHOME, NODETYPE, RACPORT, TPORTNO, SHMKEY 항목이 반드시 함께 정의되어야 한다. 정의되지 않았을 경우, 노드명이 HOSTNAME이 된다. 자세한 내용은 아래 NODE 절의 절 3.2.2. “사용 예제 ”를 참고한다.

크기 : 255자 이내

Tmax 설치 디렉터리와 작업 디렉터리를 분리하여 사용할 수 있도록 하기 위한 항목으로 Tmax 프로그램이 설치되어 있는 홈 디렉터리의 절대 경로를 정의한다. 이 경로는 환경변수 TMAXHOME과 동일한 값이 정의되어야 한다. TMAXHOME 항목이 정의되었을 경우 TMAXDIR은 작업 디렉터리가 되며 정의되지 않았을 경우 TMAXDIR이 설치 디렉터리와 작업 디렉터리가 된다.

Tmax 설치 디렉터리와 작업 디렉터리는 다음의 표와 같이 구분된다. HOSTNAME 항목과 함께 설정이 된 경우는 각각의 TMAXDIR이 하나의 논리 노드가 되며 TMAXHOME은 각 논리 노드가 공유하는 Tmax 설치 디렉터리가 된다. 따라서 동일 노드 내의 논리 노드의 TMAXDIR과 SHMKEY, TPORTNO는 모두 다르게 설정해야 한다.

기본값 : SHM_RACD

하나의 머신 내에 여러 로컬 노드를 정의하였을 경우, 각각의 로컬 노드를 관리하기 위한 방법을 결정하는 항목이다. 한 머신의 로컬 노드의 RACPORT는 반드시 달라야 한다. 따라서 2개 이상의 로컬 노드를 사용할 경우, RACPORT는 반드시 재정의해야 한다.

중요한 점은 NODETYPE 항목은 반드시 "tmboot/tmdown/tmadmin/cfl"을 수행하는 논리 노드와 같은 호스트에 있는 노드만을 관리할 때 사용해야 한다는 점이다. 다른 호스트에 있는 논리 노드들을 관리할 경우에는 NODETYPE에 관계없이 RACPORT를 사용한다.

"tmdown/tmadmin/cfl/tmboot"를 시작한 논리노드(node A)와 같은 호스트에 존재하는 다른 논리노드(node B)가 있는 상황에서 해당 노드(node B)의 "tmdown/tmadmin/cfl/tmboot command"를 수행할 때 racd를 이용할 것인지, 아니면 직접 수행할 것인지를 결정할 경우에 사용한다.

NODETYPE의 설정값에 대한 설명은 다음과 같다.

크기 : 255자 이내

기본값 : (TMAXDIR)/path

Tmax 시스템의 프로세스들이 통신하기 위한 Named stream pipe의 경로이다. 프로세스 사이의 통신 방법에는 Pipe(Unnamed pipe, Named pipe), 메시지 큐(Message queue), 공유 메모리(Shared memory)를 사용하는 방법이 있다.

Tmax에서는 프로세스 사이에 정보를 주고받기 위해 공유 메모리 ("3.2.1 DOMAIN 절"의 SHMKEY 항목 참고)와 더불어 Stream pipe 방식을 사용한다. 이 Stream pipe를 사용하기 위해서는 pathname이 필요하다.

PATHDIR은 Tmax 관련 프로세스가 Stream pipe를 통해 통신하는 데 필요한 pathname들이 생성되는 디렉터리로 이 디렉터리에 프로세스가 통신할 수 있도록 named pipe가 만들어진다. 항목이 정의되지 않은 경우에는 TMAXDIR에서 지정한 디렉터리 아래에 path 디렉터리에 pipe가 만들어진다.

PATHDIR을 "$TMAXDIR/path" 이외의 디렉터리로 지정했을 경우 Tmax 시스템이 종료될 때 올바르게 종료되지 않는 경우가 있다. Tmax 시스템이 종료될 때 시스템은 "$TMAXDIR/path" 디렉터리에 있는 Stream pipe를 사용하기 때문이다. 이를 해결하기 위해 사용자는 환경변수 TMAX_PATHDIR에 사용자가 환경 파일에 설정한 PATHDIR을 지정한다. 이렇게 한 후 Tmax 시스템을 종료할 경우 Tmax 시스템은 환경변수로 지정해 준 TMAX_PATHDIR을 참조하여 종료가 되기 때문에 정상적으로 종료된다.

export TMAX_PATHDIR = /home/tmax/path_new

Tmax 시스템을 기동할 때 config 디렉터리에 있는 이진 환경 파일이 환경 파일에 설정한 PATHDIR에 복사되는데 이는 Tmax 시스템이 기동한 후에 환경 파일이 수정되었을 경우 정상적으로 종료가 되지 않는 점을 해결하기 위한 것이다. 이 역시 환경변수 TMAX_PATHDIR에 변경되기 전(Tmax 시스템이 기동되었을 때 참조되었던 PATHDIR)의 PATHDIR을 설정하면 이 디렉터리 아래에 이진 환경 파일이 생성되며 이 환경 파일은 Tmax 시스템이 기동된 후에 환경 파일이 수정되더라도 변경되지 않는다.

따라서 Tmax 시스템 기동 후에 사용자가 환경 파일을 수정하더라도 Tmax 시스템이 비정상적으로 종료되는 경우를 없앨 수 있다.

크기 : 255자 이내

기본값 : (TMAXDIR)/log/slog

시스템 메시지가 기록(logging)될 디렉터리의 절대 경로를 지정한다. 시스템 메시지란, TMM, TMS, CLL, CLH 등이 출력하는 메시지와 시스템 내부적으로 발생한 메시지들을 일컫는다. 지정된 SLOGDIR 디렉터리에는 날짜별로 'slog.날짜' 파일이 생성되어, 각 파일에 날짜별로 발생한 메시지가 기록된다.

항목을 정의하지 않은 경우에는 TMAXDIR에서 지정한 디렉터리 하위에 위치한 "log/slog" 디렉터리에 기록된다.

크기 : 255자 이내

기본값 : (TMAXDIR)/log/tlog

XA를 이용한 트랜잭션이 발생한 경우 이에 대한 정보를 TXLOG 파일에 기록한다. TXLOG 파일이 생성될 절대 경로를 지정한다. 바이너리이기 때문에 해독은 불가능하며, Tmax 엔진에서 트랜잭션에 대한 정보 관리를 위해 필요하다. TXLOG 파일은 파일 시스템으로 생성하며 Tmax에서는 raw 파일에 따라 이 파일의 기록을 지원하지 않는다.

항목이 정의되지 않은 경우에는 TMAXDIR에 지정한 디렉터리 하위에 위치한 "log/tlog" 디렉터리에 기록된다.

부트할 때 이전에 부트했을 때의 로그가 남아 있으면 기존 파일을 .old로 백업하고 새로운 트랜잭션 로그 파일이 생성된다. 기본적으로 최대 16MB이고, 이 값은 TLMOPT의 -l 옵션을 통해 수정 가능하다.

txlog에 남는 하나의 xid에 대한 size는 대략 32Byte 정도이다(txlog는 무한히 커지지 않는다).

크기 : 255자 이내

기본값 : (TMAXDIR)/log/ulog

사용자 메시지가 기록(logging)될 디렉터리의 절대 경로를 지정한다.

사용자, 즉 Tmax 응용 프로그래머는 userlog() 함수를 이용하여 디버그용 메시지, 각종 에러 및 경고 메시지 등을 사용자에 따라 간편하게 기록할 수 있다.

사용자가 userlog() 함수를 통해 내보내는 메시지들이 저장될 디렉터리가 ULOGDIR이다. 지정된 ULOGDIR 디렉터리에는 날짜별로 'ulog_날짜' 파일이 생성된다. 각 파일에는 날짜별로 발생한 메시지들이 기록된다. userlog() 함수에 대한 자세한 설명은 Tmax 안내서 중에 "Tmax Application Development Guide"를 참고한다.

항목이 정의되지 않은 경우에는 TMAXDIR에 지정한 디렉터리 하위에 위치한 "log/ulog" 디렉터리에 기록된다

크기 : 15자 이내

하나의 환경 파일에 여러 개의 도메인을 정의할 수 있기 때문에 해당 노드가 속한 도메인명을 지정한다. 도메인명은 반드시 DOMAIN 절에서 정의한 이름이어야 한다.

범위 : 1 ~ MAX_INT

메시지가 큐에서 지정된 시간 이상 대기 상태에 있는 경우 시간이 경과된 메시지를 큐에서 제거하는 기능이다. 호스트 문제, 네트워크 문제 등으로 인하여 메시지가 큐에 계속 쌓이는 현상이 발생하는 경우 무한정 큐에 쌓지 않고 클라이언트에 현재 상황을 알려 적절한 대처를 하도록 유도하기 위한 설정값이다.

크기 : 255자 이내

ENVFILE은 응용 서버 프로그램을 실행하기 위해 필요한 특정 환경을 설정하기 위해 UNIX 환경변수가 정의되어 있는 환경 파일을 지정한다. 따라서 서버 프로그램은 ENVFILE에 지정된 환경에서 수행된다.

클라이언트가 서버에 연결할 때 사용하는 Tmax 시스템의 포트 번호이다. TPORTNO 항목에서 정의한 포트 외에 다른 포트로 Tmax 시스템에 접속하기 위해 지정한다.

TPORTNO2부터 TPORTNO5까지 모두 정의하면 Tmax 시스템에 접속할 수 있는 포트는 총 5개이다. 일반적으로 시스템 영역에서는 1024 이하의 포트 번호를 사용하므로 관리자는 이 범위를 피해야 한다.

TPORTNO에서 정의한 포트 번호와 그 다음 포트 번호(TPORTNO+1)는 클라이언트와 Tmax 시스템 혹은 다른 노드들 사이의 통신에 사용되므로 다른 포트 번호를 지정해야 한다. 또한 다른 곳에서 사용되고 있는지의 여부를 반드시 확인해야 한다. TPORTNO에서 지정한 포트 번호는 이미 지정한 포트 번호와 달라야 한다.

크기 : 255자 이내

TMM이 기동될 때 TMM 프로세스로 전달되는 명령어 옵션을 정의한다. 정의된 옵션 중에 '--' 이전에 지정된 옵션들은 시스템에서 사용하고, 그 이후에 지정된 옵션들은 사용자가 자유롭게 사용할 수 있다.

다음은 사용자 옵션에 대한 설명이다. 자세한 내용은 “Tmax Reference Guide”의 “3.2.2. _tmax_event_handler”를 참고한다.

크기 : 255자 이내

TLM이 기동될 때 TLM 프로세스로 전달되는 명령어 옵션을 정의한다.

사용되는 사용자 옵션은 다음과 같다.

CLH가 기동될 때 CLH 프로세스로 전달되는 명령어 옵션을 정의한다. 세부 옵션은 TMMOPT와 같다.

(W)CLH3017 no such svc : svcname

RDP 타입의 서버 프로세스를 운영하는 경우 서버 프로세스명을 설정한다.

Real 서버는 한 노드에 유일해야 하며 해당 노드에 존재하는 모든 서비스는 RDP 서버 프로세스를 통해 클라이언트에게 직접 전달되게 된다. 이를 위해서 다른 서버 프로세스가 처리한 결과를 얻어오기 위한 채널의 수인 RSCPC 값을 설정해야 하며 CLH와 RDP 서버 프로세스의 수는 일정하게 유지되어야 한다(MIN 값과 MAX 값이 같아야 한다).

단, RDP 서버 프로세스는 CLH보다 항상 많아야 하며 보통 2배수로 설정한다.

범위 : 1 ~ 128

RDP 서버 프로세스와 다른 서버 사이의 통신에 사용되는 채널의 수이다.

범위 : 1 ~ 128

기본값 : 32

해당 노드에서 최대로 설정 가능한 서버 그룹의 개수를 의미한다.

범위 : 1 ~ 128

기본값 : 32

해당 노드에서 기동 가능한 TMS의 최대 개수를 설정한다.

범위 : 1 ~ 128

기본값 : 2

MAXGW가 한 노드에서 사용할 수 있는 최대 게이트웨이의 개수라면 MAXGWSVR은 해당 노드에서 기동할 수 있는 게이트웨이 서버 프로세스의 최대 개수이다. 기본값은 2이며, 2개의 게이트웨이가 있고 각각의 게이트웨이는 하나의 게이트웨이 서버를 둘 수 있다는 의미이다.

범위 : 1 ~ 128

기본값 : 2

해당 노드에서 기동할 수 있는 RQ 서버 프로세스의 최대 개수이다. 기본값은 2이며, 2개의 RQ가 있고 각각의 RQ는 하나의 RQ 서버를 둘 수 있다는 의미이다.

범위 : 1 ~ 128

기본값 : 8

게이트웨이 서버와 CLH 사이의 연결 개수를 지정한다.

서버와의 CPC는 기본적으로 PAIR(input channel/output channel)로 구성되기 때문에 CPC=2의 환경에서 게이트웨이 서버의 개수가 2라면 8개의 연결이 필요하게 되므로 MAXGWCPC는 8 이상의 값을 설정해야 한다. 또한 MAXGWCPC의 값의 합은 MAXCPC의 값보다 작아야 한다.

MAXGWCPC의 값을 늘리는 경우에는 MAXCPC의 값도 함께 증가시켜 주어야 한다.

기본값 : Y

백업 서버를 지정한 경우 메인 서버에 문제가 발생했을 때 자동으로 백업 서버를 기동할 것인지를 설정한다.

TPORTNO, TPORTNO[2-5]를 대체하기 위한 항목으로, 여러 개의 포트를 사용하는 경우 TPORTNO[2-5]보다는 TMAXPORT를 사용할 것을 권장한다.

Tmax에서는 엔진과 클라이언트 사이의 데이터 압축을 통해서 통신할 수 있는 기능을 제공한다. 클라이언트가 압축 기능을 사용해서 통신하고자 할 때 접속해야 하는 포트 번호를 지정한다. 지정하지 않으면 압축을 하지 않는다. 중요한 것은 포트 번호를 현재 Tmax가 관리하고 있는 포트 번호로 지정해야 한다는 것이다.

NODE 절의 TMAXPORT 항목이 정의되어 있다면 TMAXPORT 항목에 지정되어 있는 포트 번호 중에서 지정해야 하며, TMAXPORT 항목이 정의되어 있지 않다면 DOMAIN 절의 TPORTNO 항목으로 지정해야 한다. 이렇게 지정한 후 해당 포트로 접속한 클라이언트만 압축 기능을 사용할 수 있다.

일반적인 네트워크 환경이라면 네트워크 전송 지연보다 압축하는 오버헤드가 더 크기 때문에 압축 기능을 사용하지 않는 것이 좋다. 압축이 필요한 경우는 클라이언트와 서버 사이의 네트워크 조건이 상당히 좋지 않은 환경에서 비교적 큰 데이터를 주고받으려고 하는 경우이다.

예를 들어 모뎀을 통해서 접속하는 클라이언트가 수십 Kbyte 이상의 데이터를 주고받으려고 하는 경우에 설정한다.

아래의 표는 클라이언트가 100Mbps 로컬 LAN과 56KB 모뎀을 사용하여 접속한 환경에서 1.5MB의 데이터를 받는 시간을 측정한 것이다. 테스트 결과에서 볼 수 있듯이 모뎀으로 접속하는 클라이언트가 텍스트 형식의 큰 데이터를 주고받는 경우에 압축 기능을 사용하는 것이 가장 효과적이다.

<전송 데이터의 크기>

압축 기능을 사용할 때 해당 항목에 지정한 크기 이상의 데이터만을 압축하도록 하는 항목으로, 단위는 Byte이다.

CompressSize는 반드시 CompressPort와 함께 지정되어야 한다.

아래 예제와 같이 설정한 경우 Tmax 엔진은 9999 포트 번호로 접속한 클라이언트와 압축 기능을 사용하여 통신하게 된다. 통신할 때 데이터의 크기가 10,000 Byte 이상의 메시지인 경우에만 압축을 하게 되고 데이터의 크기가 10,000 Byte 이하이거나, 클라이언트가 8888 포트 번호로 접속하였을 경우에는 압축을 사용하지 않고 통신하게 된다.

TMAXPORT = "8888, 9999", CompressPort = "9999" CompressSize = 10000

기본값 : Y

NODE 절에 지정하였을 경우 Tmax 엔진 프로세스 중 CLH와 CAS, CLL, TLM의 재기동 여부를 결정하는 항목으로 비정상적으로 종료되는 경우 재기동한다.

장애 대책에 사용되는 필드로 자세한 사항은 “3.8. 장애 대책 환경설정”을 참고한다.

Tmax는 Tmax 환경 파일에 등록된 서버의 기능을 Tmax 이외의 프로세스에서 처리하기 위하여 Extern 서버의 기능을 지원한다.

Extern 서버의 기능을 사용하기 위해서는 서버 프로세스의 TYPE을 EXTSVR이라고 지정하며 NODE 절에 EXTPORT와 EXTCLHPORT 항목을 설정한다. EXTPORT 항목에 TMM의 Listen 포트 번호를 설정한다.

CLH의 Listen 포트 번호를 설정한다. 지정하지 않을 경우, 시스템에서 자동으로 할당한다.

다음은 Extern 서버를 사용하는 예제이다.

*NODE
tmaxh3        ... 
              EXTPORT = 9000, EXTCLHPORT = 9010

*SERVER
alinkjmapp    SVGNAME = svg1,  
              MIN = 1, MAX = 1, 
              CPC = 10, 
              SVRTYPE=EXTSVR

*SERVICE
JMAPPER       SVRNAME = alinkjmapp, 
              SVCTIME = 30

기본값 : N

SysMaster Trace 기능 지원 여부를 선택하는 옵션으로 'Y'일 경우 Trace 기능을 지원하며, 'N'일 경우 지원하지 않는다. SysMaster Trace 기능은 수행 중인 서비스의 GID를 알아내어 시스템 단위의 업무 추적을 가능하게 한다.

다음은 GID의 구조이다(12Byte).

범위 : 1024~MAX_INT

기본값 : 50000

CLH별 SysMaster Trace 최대 저장 건수로 SMSUPPORT 항목이 'Y'일 경우에만 설정한다.

기본값 : N

CLL 블록 설정 여부를 결정한다. Y로 설정한 경우, 클라이언트가 Tmax 시스템에 접속할 경우 CLL이 블록된다.

Tmax 서비스가 완전히 기동되지 않은 상태에서 클라이언트의 요청이 왔을 경우, CLL이 기동되어 있는 상태라면 클라이언트는 Tmax 시스템에 접속이 허용되며, TPENOREADY 에러가 발생한다.

따라서 이러한 문제점을 없애기 위하여 관리자가 클라이언트 요청을 CLL에서 블록 처리하도록 한다. 이렇게 하면 서비스가 완전히 준비되기 전에 서비스 요청이 들어오는 것을 방지할 수 있다.

서비스가 모두 기동되었을 경우는 tmadmin을 이용하여 CLL 블록 기능을 해제할 수 있다.

CLL 블록 예외 포트 번호를 설정한다. TMAXPORT로 설정된 포트 번호 중에서 지정할 수 있다.

CLL 블록이 설정된 경우, Tmax 환경 파일에 CLL 블록 예외 포트를 지정할 수 있다. 블록 예외 포트를 설정하면 CLL 블록 기능이 설정되어 있어도 해당 포트로 접속한 클라이언트는 블록되지 않는다.

기본값 : 0

CLLBLOCK=Y일 경우 CLLBLOCKTIME을 통해 CLL의 블록 시간(초)을 지정할 수 있다. 블록 시간이 지나면 CLL의 블록이 해제된다.

만약 블록 시간이 0 이하의 값이거나 CLLBLOCK=Y일 때 CLLBLOCKTIME을 지정하지 않았다면 tmadmin을 사용하여 CLL 블록 기능을 해제해야 한다.

기본값 : RR

CLL이 CLH로 클라이언트 커넥션을 넘기는 방식을 설정한다.

CLLCONNLB = LC로 설정하면 Lease Connection 방식으로 CLL이 가장 적은 커넥션을 가진 CLH에 다음 커넥션을 맺는다.

CLLCONNLB를 지정하지 않거나 그 외의 값을 대입하면 기본값인 Round Robin 방식으로 다음 커넥션을 맺는다.

NODE 절에 CRYPTPORT 항목을 지정할 경우, CRYPTPORT에 지정된 포트로 접속한 클라이언트의 데이터만 암호화된다. 보다 유연한 암호화 기능을 위하여 세션별로 암호화를 선별하여 지정할 수 있도록 한다.

다음은 항목을 설정할 때 고려할 사항이다.

멀티 노드 및 멀티 도메인 환경에서 장비의 장애 등으로 인하여 특정 노드가 일시적으로 사용이 불가능할 경우, pending 트랜잭션으로 인한 가용성 저하를 해소하기 위하여 트랜잭션 복구를 대신할 수 있는 백업 노드(TRB 노드)를 구성한다.

다음 그림처럼 Node A에 대한 TRB Node A'를 미리 구성해 놓는다.

장비 A에 장애가 발생할 경우, TRB Node A'를 기동시켜, pending된 트랜잭션을 자동 복구시킨다.

[그림 3.3] TRB

TRB 항목은 트랜잭션 복구 백업 노드(TRB 노드)에 지정하며, Primary 노드명을 지정해 준다.

TRB 노드는 하나의 서버 그룹을 가지고 있어야 하며, 이 서버 그룹에는 사용할 데이터베이스의 정보를 지정하고 1개의 TMS를 설정한다. 게이트웨이를 사용할 경우, GATEWAY 절에도 TRB 항목을 지정해 준다.

다음은 항목을 설정할 때 고려할 사항이다.

TRB 노드의 기동, 종료

TRB 노드는 일반 노드와는 다른 방법으로 기동, 종료하기 위해 -B 옵션을 사용한다.

$tmboot –B <nodename>

TRB와 관련된 환경설정은 다음과 같다.

*NODE
#Primary node
NODE1     TMAXDIR = /data/tmax

#TRB node
NODE2     TMAXDIR = /data2/tmax, TRB = NODE1

범위 : 1 ~ 65535

기본값 : 1024

노드 내의 HMS에서 생성할 수 있는 세션의 수의 최댓값을 설정한다. 자세한 내용은 “3.7. HMS 환경설정”을 참고한다.

범위 : 32768~262143

SQ 저장소로 사용될 공유 메모리 세그먼트(shared memory segment)를 가리키는 키 값을 정의한다.

범위 : 4 ~ 4000000 (단위 : Kbyte )

SQ 저장소로 사용될 공유 메모리 세그먼트의 크기를 정의한다.

범위 : 2~MAX_INT-1 (단위 : Kbyte )

노드에 생성될 수 있는 최대 SQ 개수로서 짝수로 설정해야 한다. 홀수로 설정할 경우 하나 작아진다.

기본값 : 1~MAX_INT

각 SQ 에서 저장 가능한 최대 키 개수이다.

기본값 : 1~MAX_INT (단위: 초)

SQ 데이터 보관 타임아웃이다. 타임아웃의 경우 데이터가 자동 삭제된다.

크기 : 255자 이내

해당 노드의 IP주소를 지정한다.

다른 노드와의 연결을 시도할 때 호스트명으로부터 IP주소를 알 수 없을 경우에는 반드시 지정해야 한다.

IPv6 주소를 사용할 경우에는 SYSTEM_IPV6 설정을 'Y'로 지정해야 한다.

클라이언트 접속 요청을 위한 포트를 생성할 때 바인드될 인터페이스에 대한 IP주소로 사용된다. 관련 설정으로 CLL_BIND_IP가 있다.

기본값 : N

Tmax 시스템에서 클라이언트의 접속을 위한 포트를 생성할 때 IPv6 프로토콜의 사용 여부를 결정한다.

기본값 : N

Tmax 시스템이 여러 노드로 구성되었을 경우에 노드 사이의 통신을 위한 포트를 생성할 때 IPv6 프로토콜의 사용 여부를 결정한다.

기본값 : N

Tmax 시스템에서 Extern Server의 접속을 위한 포트를 생성할 때 IPv6 프로토콜의 사용 여부를 결정한다.

기본값 : Y

클라이언트 접속을 위한 포트를 생성할 때 NODE 절의 IP에 설정된 주소의 인터페이스를 사용할 것인지 여부를 결정한다.

크기 : 15자 이내

서버 그룹에 대한 논리적인 이름으로 SVRGROUP 절에서 유일한 이름이어야 한다.

SVRGROUP 절 이름은 SERVER 절의 SVGNAME 항목에서 사용된다.

크기 : 15자 이내

서버 그룹이 존재하는 노드를 정의한다. 사용되는 NODENAME은 NODE 절에서 정의한 노드명이어야 한다. 노드명에 하이픈(-)이 포함될 경우 반드시 큰따옴표(" ")로 묶어 주어야 한다.

"3.2.2 NODE 절"의 DEFAULT 항목을 참고한다.

기본값 : TMAX

서버 그룹의 유형을 지정하는 항목으로 유형에는 TMAX와 EXTSVG, MTMAX, STMAX가 있으며 기본값은 TMAX이다. MTMAX, STMAX 항목에 대한 설명은 "Tmax Programming Guide(MultipleRM)를 참조한다.

EXTSVG는 Extern 서버와 같은 형태로 웹 애플리케이션 서버와 2PC를 지원하기 위해서 EXTERN TMS를 사용할 때 지정한다. EXTSVG를 사용할 경우, OPENINFO 항목도 함께 지정해 주어야 하는데 OPENINFO 절은 사실상 큰 의미가 없지만, 큰따옴표(" ")로 설정한다.

<EXTSVG 서버 그룹을 사용한 예>

*NODE
tmaxh3         ... 
               EXTPORT = 9000, EXTCLHPORT = 9010

*SVRGROUP
Extsvg         NODENAME = "tmaxh4", 
               SVGTYPE = "EXTSVG", TMSNAME = TMSWAS
               OPENINFO = " "

*SERVER
alinkjmapp     SVGNAME = Extsvg1, 
               MIN = 1, MAX = 1, CPC = 20, 
               SVRTYPE = EXTSVR

*SERVICE
JMAPPER        SVRNAME = alinkjmapp, 
               SVCTIME = 30

크기 : 8000자 이내

그룹별로 서로 공유해야 할 프로세스가 있거나, 그룹 사이 라우팅이 필요한 경우 그룹명을 지정한다. 같은 노드이거나 다른 노드에 속한 그룹인 경우에도 그룹명을 지정할 수 있다. COUSIN과 BACKUP을 함께 지정할 수 있는데 이 경우 COUSIN, BACKUP 각각 다른 서버 그룹이어야 한다.

라우팅은 COUSIN에 지정한 서버 그룹이 담당하며, 장애가 발생할 경우 백업에 지정한 서버 그룹이 담당한다. 게이트웨이 서버도 COUSIN 그룹으로 묶을 수 있다.

크기 : 8000자 이내

장애 대책 방안의 하나로 제공되며, 백업되어야 할 그룹명을 지정하면 장애가 발생해도 중단없이 지속적인 서비스를 수행할 수 있다.

LOAD = -1

Static Routing을 의미하며, 특정 노드에 접속한 클라이언트는 그 노드에 속하는 그룹에서 처리한다. LOAD를 -1 (로컬 전용)로 설정한 경우 COUSIN 에 속해 있는 도메인 게이트웨이는 호출되지 않는다. 따라서 도메인 게이트웨이 COUSIN 설정에서 LOAD를 -1로 설정할 수 없다.

트랜잭션 및 비트랜잭션 게이트웨이 모두 사용이 불가능하다.

[그림 3.4] LOAD 항목이 -1인 경우 동작 원리

LOAD = -2

멀티 노드 환경에서 각각 게이트웨이를 설정하고 각각의 노드에 클라이언트를 분리 접속시켜 거래를 요청하는 경우, 1차적으로 접속된 노드에서 해당 서비스를 처리해 업무 부하를 줄일 수 있다.

로컬 우선 처리 기능을 사용할 경우, COUSIN으로 묶여 있는 멀티 노드 환경에서는 클라이언트가 접속한 노드에 속하는 서버 그룹이 1:1로 서비스를 처리하게 되며, 게이트웨이를 통해 다른 도메인에 거래를 요청하는 경우에는 클라이언트에서 접속한 노드에 속해있는 게이트웨이가 해당 거래를 처리한다.

특정 서버 그룹을 지정하여 호출(tpcallsvg, tpacallsvg)할 경우 로컬 노드 우선 처리 기능(LOAD=-2)을 설정했더라도 적용되지 않으며, 모든 서버 그룹에서 처리하게 된다. 또한 이 경우 해당 서버 그룹이 종료되면 다른 서버 그룹이 대신 처리하지 않고 TPENOREADY 에러가 발생한다.

트랜잭션 게이트웨이의 경우 COUSIN 구성을 위한 일반 서버 그룹을(dummy 서버 그룹) 설정할 때에도 반드시 XA 서버 그룹으로 설정해야 하며 COUSIN으로 묶인 모든 서버 그룹과 게이트웨이의 LOAD 값을 모두 -2로 설정해야 한다.

[그림 3.5] LOAD 항목이 -2인 경우 동작 원리

LOAD = -3

COUSIN으로 설정한 서버 그룹 간의 백업이 필요한 경우에 사용할 수 있는 설정이다.

SVRGROUP 절의 BACKUP 항목은 COUSIN으로 설정한 서버 그룹들에 대한 백업 설정이 아니라, 설정된 서버 그룹에 대한 백업 설정이다. 예를 들어 서버 그룹 A COUSIN="B,C", BACKUP="D"로 구성되어 있는 경우 A, B, C가 속한 노드가 모두 종료된 경우에 D로 스케줄링하는 것이 아니라 A가 속한 노드가 비정상일 경우 A 스케줄링 차례에서만 D로 스케줄링한다. A, B, C에 속한 서버가 모두 비활성화되어 있을 경우 D로 가기 위한 설정값이 LOAD=-3이다.

LOAD = 0

Dynamic Routing이 수행된다. Tmax 엔진이 판단하여 제일 부하가 적은 그룹이 서비스를 처리하여 부하를 분산시킨다.

LOAD > 0

Rule Based Routing을 의미하며, 분산을 하고자 하는 그룹에 각각 지정한 비율로 부하를 분산할 수 있다. COUSIN 필드에서 정의된 GROUP에서만 수행된다. Tmax 서버 그룹의 로드 밸런싱은 LOAD 항목과 ROUTING 항목에 설정할 수 있으며 2가지를 각각 다른 값으로 설정하여 사용할 수 없다. ROUTING 절에 서비스가 설정되어 있다면 해당 서비스는 ROUTING에 의해서만 스케줄링되며 2차적으로 LOAD 값이 영향을 줄 수 없다. 따라서 COUSIN 안에서 ROUTING별로 그룹을 맺어서 스케줄링은 불가능하다.

[그림 3.6] LOAD 항목이 양수인 경우 동작 원리

크기 : 63자 이내

TMS로 설정되는 경우에 지정하고, 그 외에는 지정하지 않아도 무방하다. 데이터베이스 고유의 이름을 지정한다.

크기 : 255자 이내

데이터베이스와 연결을 하기 위해 TMS가 필요할 때 정의한다. 데이터베이스로 연결을 초기화하고 각 데이터베이스에서 제공되는 문법으로 정의한다.

OPENINFO 절의 내용의 암호화를 원할 경우 암호화를 원하는 부분을 ***** (애스터리스크 5개)로 표시한다. 암호화가 설정된 부분에 대해서는 cfl를 사용하면 암호를 입력받는다.

부분 암호화

OPENINFO = "ORACLE_XA+Acc=P/scott/*****+SesTm=100"

전체 암호화

OPENINFO = "*****"

크기 : 255자 이내

데이터베이스와 연동하는 그룹인 TMS가 설정되는 경우에 지정한다. 데이터베이스와 연결을 종료하기 위한 것으로 각 데이터베이스에서 제공되는 문법으로 정의한다. 대부분의 데이터베이스는 이 항목이 필요없으나, Informix 경우에는 반드시 지정해야 한다.

범위 : 1~16

기본값 : 2

데이터베이스와 연동하는 그룹인 TMS가 설정되는 경우 부팅될 때 기동되는 TMS 프로세스의 수를 지정한다.

범위 :1~16

기본값 : 3

데이터베이스와 연동하는 그룹인 TMS가 설정되는 경우 최대 기동될 수 있는 TMS 프로세스의 수를 지정한다.

크기 : 15자 이내

데이터베이스와 연동하는 그룹인 TMS가 설정되는 경우 해당 서버 그룹의 데이터베이스 관리를 담당할 TMS 프로세스명을 정의한다.

크기 : 255자 이내

그룹에 속한 서버들에게 환경변수로 값을 전달하고자 할 때나 같은 노드에 복수의 동종 데이터베이스와 연동이 필요한 경우 지정한다.

대부분의 데이터베이스는 이 항목이 필요없으나, 특별한 데이터베이스의 경우에는 이 항목을 지정한다. DB2와 같이 Dynamic register 방식만을 지원하는 DBMS의 경우 "DYNAMIC"이라고 지정해준다.

Sybase나 Informix 구버전과 같이 64Bit 엔진임에도 불구하고 xaswitch 구조체의 필드가 long이 아니라 int인 데이터베이스의 경우 "XASWITCH32"라고 지정한다.

범위 : 1 ~ 128

SVGTYPE이 RQMGR일 때만 유효하다. CLH 프로세스들을 가진 채널의 수를 정의한다. 자세한 내용은 “3.6. 신뢰성 큐 환경설정”을 참고한다.

기본값 : Y

SVRGROUP 절에 지정하였을 경우 TMS의 재기동 여부를 결정하는 항목으로 비정상적으로 종료되었을 때 재기동한다.

장애 대책에 사용되는 필드로 자세한 사항은 “3.8. 장애 대책 환경설정”을 참고한다.

기본값 : Y

트랜잭션 복구 기능을 사용할지를 결정한다. 사용할 경우 'Y', 사용하지 않을 경우 'N'으로 설정한다.

Tmax 4.0 이상에서는 X/Open DTP에 정의된 트랜잭션 복구 기능을 지원한다. 복구 기능을 사용하게 되면 TMS가 재기동될 때 RM으로부터 pending되어 있는 트랜잭션의 XID list를 얻어오며, 이 결과물에 대하여 트랜잭션을 복구한다.

Tmax는 단일 노드, 멀티 노드, Tmax 도메인 게이트웨이를 이용한 멀티 도메인 환경에서 트랜잭션 복구를 지원한다.

그룹 전체를 기동/종료하는 경우 복구가 수행되기 때문에 TMS 그룹 단위로 복구가 가능하다. tmboot / tmdown 명령어에 특정 이름을 가진 TMS 전체를 기동/종료시키는 옵션이 추가되었다. 명령어에 대한 자세한 내용은 "Tmax Reference Guide"를 참고한다.

이 기능을 사용하기 위해서는 RM에서 pending list 조회 등을 위한 권한을 주어야 한다.

같은 노드에서 서로 다른 서버 그룹이 데이터베이스를 공유하는 경우 TMS가 운영 중에 복구가 일어나지 않도록 의존관계를 맺을 수 있다.

예를 들어 다음 예제와 같이 설정하여 서버 그룹 3개가 하나의 데이터베이스를 공유할 경우 tms1이 tms2와 tms3의 복구를 모두 수행하여 복구가 중복 수행되는 것을 사전에 막을 수 있다. 이렇게 의존 관계를 맺으면 tms2나 tms3가 운영 중에는 복구를 수행하지 않기 때문에 보다 안정적인 복구를 지원한다.

svg1 TMSNAME = tms1, 
     TMSDEP = "tms2, tms3" 

svg2 TMSNAME = tms2, 
     TMSRECOVERY = N 

svg3 TMSNAME = tms3, 
     TMSRECOVERY = N

기본값 : DOMAIN

서로 다른 노드에 있는 서버 그룹이 데이터베이스를 공유하는 경우 TMSRANGE를 "NODE"로 설정하면 각각 자신의 노드를 복구하기 때문에 노드 사이의 복구 메시지 트래픽을 줄일 수 있으며, 보다 안정적으로 복구가 수행된다.

기본값 : STD

TMSTYPE의 설정값은 다음과 같다 .

TMS 프로세스 1개당 working thread 개수를 설정한다.

TMS 로그가 저장될 디렉터리와 파일명을 지정할 수 있다. 사용 방법은 TMMOPT, CLHOPT와 동일하다.

단위 : 초

TMSXATIME보다 오래 걸리는 XA 처리의 경우 로깅 기능을 제공한다.

TMS에서 xa_prepare, xa_commit, xa_rollback 등 XA 처리가 비정상적으로 오래 걸리는 경우, 데이터베이스의 장애를 의심할 수 있다. 추후 장애 원인을 분석하기 위해 TMSXATIME에 설정된 값보다 XA 처리가 오래 걸리는 경우 로깅 기능을 제공한다.

로그는 다음과 같다.

CLH2160 XA 함수명(xid) processing was delayed (경과시간) by tms(서버 그룹 번호) 
       : XA함수 반환값
CLH2161 XA함수명(xid) processing may be stopped due to closed tms(서버 그룹 번호)

기본값 : N

임시로 서버 그룹명을 "__dummy"로 사용하는 방식을 대신해서 사용한다.

SVRGROUP 절에서 DUMMY=Y로 설정할 경우, tmboot될 때 해당 그룹의 TMS가 기동되지 않는다.

SVRGROUP 절의 DUMMY 설정은 SERVER 절에 승계되지 않으므로, SERVER 절에도 각각 지정해야 한다.

Domain Gateway Cousin 설정 등 dummy 서버 그룹 설정이 필요한 경우 유용하게 사용될 수 있다. 자세한 사항은 “B.2. 도메인 게이트웨이 COUSIN 설정 방법”을 참고한다.

DUMMY 옵션이 없을 경우에는 tmboot가 수행될 때 아래와 같은 에러가 발생한다.

(F) BOOT0014 exec error : /data1/tmaxkjh/tmax/appbin/tms_tbr [BOOT0029]: No such file or directory

크기: 15자 이내

HMS 프로세스명을 정의한다. HMS를 이용하기 위해서는 SVGTYPE=HMS로 설정해야만 한다.

HMS 설정과 관련한 자세한 내용은 "Tmax HMS User Guide"를 참고한다.

범위 : 0 ~ 65535

HMS의 메시지를 처리하는 데 필요한 설정값으로, 도메인 안에서 유일한 값으로 반드시 설정해야 한다.

범위 : 0 ~ 65535

HMS 메시지에 대한 스토리지 처리를 하지 않는 thread의 수를 설정한다.

범위 : 0 ~ 65535

HMS 메시지에 대한 스토리지 처리를 하는 thread의 수를 설정한다.

범위 : 1 ~ 65535

HMS 메시지에 대한 스토리지 처리를 일괄적으로 하는 thread의 수를 설정한다.

범위 : 2 ~ 65535

HMS 메시지에 대한 스토리지 일괄처리를 할 때 한번에 처리할 수 있는 메시지의 최대 개수를 설정한다.

크기 : 255자 이내

HMS가 기동될 때 HMS 프로세스로 전달되는 명령어 옵션들을 정의한다.

크기 : 255자 이내

영속적 구독자(Durable Subscriber)를 설정한 환경 파일의 경로와 이름을 설정한다. 환경 파일에 정의된 영속적 구독자는 HMS가 기동되면서 자동으로 등록된다.

범위 : 0 ~ 65535 (단위: 시간)

HMS는 영속적 메시지를 스토리지에 저장한다. 스토리지에 쌓인 메시지들을 주기적으로 삭제할 시간을 설정한다.

다수의 HMS를 클러스터링하는 경우 각 HMS는 서로 통신하기 위해 직접 채널을 생성한다. 사용할 포트 번호를 설정한다.

범위 : 0 ~ 65535 (단위: 초)

다수의 HMS를 클러스터링하는 경우 HMS 간의 네트워크 장애 감지를 위해 주기적으로 Heartbeat 메시지를 주고 받는다. 이 메시지를 전송하는 주기를 설정한다.

범위 : 0 ~ 65535 (단위: 밀리초)

HMS의 큐를 클러스터링 하는 데 필요한 상태 정보 갱신주기를 설정한다.

클러스터링된 큐를 사용하기 위해서는 반드시 설정해야 한다. 주기가 짧을수록 정확한 분배가 가능하지만 그만큼 네트워크의 부하는 크므로 적당한 크기의 값을 설정할 필요가 있다.

크기 : 255자 이내

서버 그룹에 속하는 애플리케이션의 실행 파일이 설치되어 있는 디렉터리의 절대 경로이다.

NODE 절에 등록된 APPDIR은 해당 노드에서 실행되는 모든 애플리케이션의 위치를 지정하는 항목이고, 이를 서버 그룹에 재지정하면 그룹별로 애플리케이션 실행 파일의 위치를 지정할 수 있다.

크기 : 255자 이내

NODE 절에서 사용자 메시지가 로깅될 디렉터리의 절대 경로를 서버 그룹별로 재지정하기 위해서 사용하는 항목이다. 사용자 메시지의 기록 방식은 NODE 절에서 설명한 ULOGDIR 내용과 동일하다.

TMS의 로그 레벨을 설정한다.

서버의 로그 레벨을 설정한다.

크기 : 15자 이내

서버의 실행 파일명으로 일반적으로 서버명은 고유(Unique)해야 하고 하나의 서버명은 SERVER 절에 한 번만 정의되어야 한다.

단, 멀티 도메인으로 구성할 경우에는 한 도메인 내에서 고유해야 한다.

크기 : 15자 이내

서버가 속해 있는 서버 그룹을 정의한다.

설정된 값은 SVRGROUP 절에서 정의된 서버 그룹명이어야 한다. 서버와 SVRGROUP 절의 연결을 통해서 서버가 어떤 노드에서 동작할 것인지, 어떤 리소스 매니저(데이터베이스)를 사용하는지 알 수 있으며, 해당 리소스 매니저를 열 때 필요한 파라미터를 넘겨줄 수 있다.

XA 모드에서는 Tmax가 모든 데이터베이스 트랜잭션을 관리하고 2PC(Two Phase Commit)를 보장한다. SVRGROUP 절은 OPENINFO 필드를 포함해서 정의되어야 한다.

XA 모드의 Tmax 사용자는 각각 서버 프로세스의 데이터베이스 연결에 관여할 필요가 없다. 그러나 XA 모드가 아닌 경우에는 OPENINFO를 포함하지 않은 SVRGROUP 절이 정의되어야 하고 사용자는 데이터베이스 연결을 관리해야 한다.

"3.2.2 NODE 절"의 DEFAULT 항목을 참고한다.

크기 : 255자 이내

서버 프로세스가 기동될 때 서버 프로세스로 전달되는 명령어 옵션을 정의한다. 정의된 옵션들 중에 '--' 이전에 지정된 옵션들은 시스템에서 사용하고, 그 이후에 지정된 옵션들은 사용자가 자유롭게 사용할 수 있다.

다음은 사용자 옵션에 대한 설명이다.

MACRO Commands1

아래의 MACRO를 지정했을 경우 파일명은 서버가 기동될 때 결정된다.

MACRO Commands2

아래의 MACRO를 지정했을 때 TCS 서버의 경우 tpsvrinit(), tpsvrdone() 그리고 서비스 함수가 불리기 직전에, UCS 서버의 경우에는 tpsvrinit(), tpsvrdone() 함수가 불리기 직전, tpschedule() 함수가 반환하기 직전에 시간을 검사하여 해당 파일명을 결정한다.

MACRO는 다양한 종류의 로그 파일(예: 날짜별)을 작성하는 데 사용한다.

다음은 MACRO 설정에 대한 예이다.

CLOPT="-o $(SVR).$(DATE).out –e $(SVR).$(DATE).err"

'[server name].03312001.out, [server name].03312001.err'의 ULOGDIR 필드에 정의된 디렉터리에 로그 파일을 작성한다. 표준 에러나 표준 출력의 파일명을 다른 이름으로 변경하고자 할 경우에는 '-e /usr/tmax/log/ulog/test.log' 형태로 절대 경로를 지정하면 된다. '--' 이후의 'abc' 옵션은 사용자가 사용할 수 있도록 서버 프로그램의 tpsvrinit() 함수에 argv[1]로 전달된다.

범위 : 1 ~ MAX_INT

기본값 : 1

기본적으로 기동될 서버 프로세스의 개수를 결정한다.

클라이언트당 서버 프로세스가 하나씩 기동되는 일반적인 클라이언트/서버 모델과 달리, Tmax 시스템에서는 서버 프로세스의 수를 조절하여 일정하게 유지한다. CLH 프로세스는 클라이언트의 요청이 들어올 때마다 서버들의 상태를 확인하고, idle 상태인 서버 프로세스에게 일을 처리하도록 하여 시스템이 최대 성능을 발휘하도록 한다.

MIN 항목에는 서버 프로세스의 개수를 지정하며, 운영 경험을 통하여 적절한 개수 조정이 필요하다. 아주 많은 서비스 요청이 들어오는 서비스에 서버 프로세스를 너무 적게 동작시킨다면 동작 중인 서버 프로세스만으로는 즉각적인 서비스 처리가 어려워 대기시간이 증가하는 등 시스템 성능이 떨어진다.

반대로 필요 이상으로 서버 프로세스를 과다하게 기동시키면 단지 몇 개의 프로세스만이 서비스를 처리하고 나머지 프로세스는 idle 상태로 남게 되어 시스템 자원의 낭비와 더불어 성능 저하를 초래할 수 있다. 따라서 시스템 성능의 효율적 활용을 위하여 MIN 항목의 값은 신중하게 설정해야 한다.

범위 : 1 ~ MAX_INT

기본값 : 1

MIN 항목과 더불어 서버 프로세스 개수를 결정하는 항목이다.

MIN 항목이 기본적으로 기동되는 서버 프로세스 개수를 나타내며, MAX 항목은 MIN 값을 포함해 추가적으로 기동시킬 수 있는 프로세스의 최대 개수를 나타낸다. MAX 항목은 이미 동작 중인 개수를 포함하여 더 기동시킬 수 있는 서버 프로세스의 최대 개수를 의미한다.

서버 프로세스는 기본적으로 MIN 개수만큼 기동되고, 갑자기 클라이언트의 요청이 집중되는 등으로 인해 부하가 발생할 경우, MAX 개수까지 서버 프로세스가 기동된다. MAX 항목도 MIN 항목과 같이 시스템의 성능에 영향을 주는 요인이므로 신중히 결정해야 한다. 포크 타입 서버 프로세스가 사용되었다면 MAX 값을 0으로 설정해야 한다.

기본값 : N

대화형 서버 여부를 나타낸다.

Tmax에서 제공하는 통신 유형은 동기형, 비동기형, 대화형의 3가지가 존재한다. 대화형 통신을 제공하는 서비스는 해당 서버에 반드시 대화형 서버로 등록하여야 한다. 대화형 서버가 아닌 경우, 동기형이나 비동기형의 통신만을 제공하며 CONV 항목을 'Y'로 정의하여 대화형 서버로 설정된다.

CONV=B 로 설정한 경우에 해당 서버 프로세스는 스케줄링 프로세스가 된다. B=BOTH 의 줄임말로써, 대화형(Y)과 비대화형(N) 을 모두 지원한다는 의미이다. 또한 도메인 게이트웨이를 통한 도메인간의 통신에서도 사용될 수 있다.

범위 : 1 ~ MAX_INT

기본값 : 0

자동으로 서버 프로세스가 추가 기동되기 위한 조건으로 큐에 쌓인 개수를 정의한다.

서비스 요청 건수가 큐에 ASQCOUNT 개수 이상 쌓이게 되면 MAX 개수 한도 내에서 서버 프로세스가 자동으로 기동된다. 지정되지 않은 경우, 큐에 쌓이는 것에 상관없이 서버 프로세스는 기동되지 않는다.

ASQCOUNT로 증가된 서버 프로세스는 서비스 처리량을 검사하여 일정 시간 간격으로 사용하지 않는 프로세스를 내려 리소스 사용량을 줄인다. 이 항목은 서버 프로세스의 유형이 POD일 경우에는 별 의미가 없기 때문에 사용하지 않는다.

범위 : 1 ~ MAX_INT

기본값 : -1

값을 설정하지 않으면 기본값으로 설정되고 maxqcount를 사용하지 않는다.

업무 폭주로 인하여 클라이언트의 요청이 큐에 쌓여서 정상적인 서비스가 진행되지 않을 경우 계속되는 업무 요청을 무시할 때 설정하는 값이다.

큐에 설정값 이상의 업무가 요청되면 해당 업무는 큐에 쌓이지 않고 클라이언트에 즉시 에러(tperrno = 26)로 응답한다. 이 기능은 은행이나 관공서같이 특정 시간에 대량의 업무가 요청되는 곳에서 부하를 해소하기 위하여 적절하게 사용될 수 있다.

기본값 : STD

서비스 프로세스의 타입을 지정하는 항목으로 다음은 각 설정값에 대한 설명이다.

범위 : 1 ~ 128

기본값 : 1

UCS 서버 프로세스와 CLH 프로세스 사이의 병렬 통신 채널 수를 결정하는 항목이다. 서버 프로세스의 처리량이 아주 많아 하나의 채널로는 처리 속도가 저하될 때, 다중 채널을 두어 병렬 통신으로 처리하여 처리속도를 증가시킬 수 있다.

CPC는 UCS, UCS_DYN, CUSTOM_GATEWAY, REALSVR, REALSVR_MT, STD_MT의 SVRTYPE에서만 유효하다.

서버 타입이 STD_MT일 경우에는 CPC의 값이 반드시 설정되어야 한다.

CPC 설정값은 MAXCLH 항목 및 MAXTHR 항목과 관련이 있다. CPC 값을 결정할 때 MAXCLH x CPC 값은 최소한 MAXTHR과 같거나 그 이상이어야 한다는 점에 주의한다.

예를 들어 MAXCLH가 1이고 MAXTHR이 8이면 CPC는 최소 8이상이어야 하며, MAXCLH가 2이고 MAXTHR이 8이면 CPC는 최소 4이상이어야 한다. 이는 하나의 서버 프로세스가 서비스 요청을 동시에 처리할 수 있는 최대 개수가 CPC x MAXCLH 값으로 결정되며, MAXTHR 항목의 값을 이 값 이상으로 설정하는 것은 불필요하기 때문이다.

만약 CPC를 지정하지 않는다면 MAXTHR / MAXCLH의 값이 적용된다.

범위 : 0 ~ MAXTHR

기본값 : 0

STD_MT 타입의 서버 프로세스에서 초기 기동할 경우 생성될 서비스 thread의 최소 개수를 결정하는 항목이다. STD_MT 타입 서버라면 반드시 설정해야 한다.

설정값이 0이면 CLH로부터 서비스 요청을 받았을 때 Thread가 생성된 뒤에 서비스를 처리한다.

범위 : 1 ~ 1000

기본값 : 1

STD_MT 타입의 서버 프로세스에서 Thread pool에서 관리하는 서비스 Thread의 최대 개수를 결정하는 항목이다. STD_MT 타입 서버라면 반드시 설정해야 한다.

매번 서비스 요청마다 Thread를 제한없이 계속 추가하여 생성하면 오히려 성능이 저하될 수 있으므로 최대 개수까지만 Thread를 생성할 수 있도록 제한해야 한다. 시스템의 성능에 영향을 주기 때문에 적절한 값으로 설정해야 한다.

Thread는 서비스 Thread의 최대 개수에 메인 Thread가 추가되므로 총 MAXTHR + 1개의 Thread가 동작한다. Main Thread는 서비스 요청을 직접 수행하지 않고 서비스 Thread들과 서비스 요청을 관리한다. 만약 설정값이 1이면 서비스 Thread가 1개만 생성되므로 일반 서버 라이브러리를 사용할 것을 권장한다.

MAXTHR 항목은 CPC 항목 및 MAXCLH 항목과 관련이 있다. 자세한 정보는 CPC 항목을 참고한다.

범위 : 0 ~ MAX_INT

기본값 : 0 (단위: Kbyte)

STD_MT 타입의 서버 프로세스에서 서비스 Thread들의 stack 크기를 설정하는 항목이다. 설정하지 않으면 OS에서 기본적으로 적용되는 크기로 설정된다.

기본값 : Y

서버 프로세스의 재기동 여부를 결정하는 항목으로 비정상적으로 종료될 때 재기동한다.

장애 대책에 사용되는 필드로 자세한 사항은 “3.8. 장애 대책 환경설정”을 참고한다.

서버명은 서버 실행 파일명인데 비해 TARGET 항목은 서버 프로세스명을 재정의하는 항목이다. 여기에서 말하는 서버 프로세스란 APPDIR에 존재하는 서버 실행 파일을 실행시킨 프로세스를 의미한다.

다음과 같이 TARGET 항목을 설정한 경우 tmadmin은 실제 서버명을 확인하며 ps를 통해 서버 프로세스명을 확인할 수 있다.

예) SVGNAME = svrgrp, MIN =1, MAX = 1, TARGET = "svr2"

/user1/starbj/tmax/sample/server> tmadmin   
--- Welcome to Tmax Admin (Type "quit" to leave) ---   
$$1 tmaxs1 (tmadm): st -p  
CLH 0:   
---------------------------------------------------
svr_name  svgname  spr_no  status  count  avg  svc
---------------------------------------------------
SVR      svrgrp     32     RDY      0   0 .00  -1  
 
/user2/starbj/tmax/sample/server> ps  
starbj 28702 1 0 11:13:03 pts/8 0:00 cll -b 28700  
starbj 28704 1 0 11:13:03 pts/8 0:00 svr2
 -b 28700 -S SVR -s SVR -d -1  
starbj 28701 1 0 11:13:03 pts/8 0:00 tmm -b 28700  
starbj 28703 1 0 11:13:03 pts/8 0:00 clh -b 28700 

다음은 TARGET의 사용 환경 파일 예제이다.

*SERVER
original        SVGNAME = svg0, 
copied1         SVGNAME = svg0, 
                TARGET  = "original", 
                CLOPT   = "-e $(SVR).err -o $(SVR).out -x ORIGINAL:COPIED1" 
copied2         SVGNAME = svg0, 
                TARGET  = "original", 
                CLOPT   = "-e $(SVR).err -o $(SVR).out -x ORIGINAL:COPIED2" 
*SERVICE 
ORIGINAL        SVRNAME = original 
COPIED1         SVRNAME = copied1 
COPIED2         SVRNAME = copied2 

copied1, copied2 서버는 original의 이름으로 서버 프로세스가 기동된다. 일반적으로 tmax에서 서버명과 서버 프로세스명은 동일하지만 TARGET을 사용하는 경우, 서버명과 서버 프로세스명이 동일하지 않다. 즉, Tmax가 기동될 때 original이라는 process가 3개 기동된다.

또한 서비스 요청이 COPIED1, COPIED2로 들어오면, CLOPT 절의 [-x]에 의해서 original로 대체된다. 클라이언트에서 COPIED1, COPIED2 각각에 대하여 서비스 요청을 할 수 있다. tmadmin에서 count를 확인하는 경우도 서버, 서비스가 증가한다.

TARGET 항목 설정은 같은 프로그램을 사용하는데 tpcall을 하는 주체에 따라서 COUNT 등을 다르게 확인하고 싶을 경우에 유용하게 쓰일 수 있다.

기본값 : N

mksvr 명령을 이용하여 서비스를 동적으로 추가하였을 경우 동적으로 추가된 서비스의 AUTOTRAN은 기본값인 'N'으로 설정된다.

SERVER 절의 AUTOTRAN 항목은 동적으로 추가된 서비스의 트랜잭션을 자동으로 기동할 수 있도록 하는 항목으로 서버의 AUTOTRAN 여부에 따라 동적으로 추가되는 서비스의 설정값에 영향을 주게 된다. AUTOTRAN 항목은 SERVICE 절의 AUTOTRAN 항목 설명에 자세하게 설명되어 있다.

SERVER 절과 SERVICE 절 모두에 AUTOTRAN이 설정되어 있다면 SERVICE 절의 AUTOTRAN에 설정한 값이 적용된다.

B는 구버전(~3.8.8) AUTOTRAN 호환 설정으로 Y와 동일하지만 해당 트랜잭션은 글로벌이 아닌 로컬 트랜잭션으로 동작한다.

기본값 : FA

SCHEDULE 항목은 MIN 값이 2이상으로 지정된 경우 서버 프로세스 사이의 처리 순서를 지정하기 위한 항목이다.

다음은 SCHEDULE 항목의 설정값이다.

기본값 : IDLE_DOWN

MIN개 이상 추가로 구동된 서버 프로세스의 종료 시점을 결정하는 항목으로 다음과 같은 경우 적용된다.

POD에 의해 구동된 서버 프로세스 (MIN=0 인 경우)

ASQCOUNT에 의해 추가 구동된 서버 프로세스

기본값 : N

임시로 서버명을 "__dummy"로 사용하는 방식을 대신해서 사용한다.

SERVER 절에서 DUMMY=Y로 설정할 경우, tmboot가 수행될 때 해당 서버 프로세스가 기동되지 않는다.

Domain Gateway Cousin 설정 등 dummy 서버 설정이 필요한 경우 유용하게 사용될 수 있다. 자세한 사항은 “B.2. 도메인 게이트웨이 COUSIN 설정 방법”를 참고한다.

DUMMY 옵션이 없을 경우에는 tmboot를 수행하면 다음과 같은 에러가 발생한다.

(F) BOOT0014 exec error : /data1/tmaxkjh/tmax/appbin/tbrtest [BOOT0029]: No such file or directory

기본값 : N

Allowing Unregisterd Services

환경설정에서 서비스를 삭제하고 AP에 서비스를 삭제(rebuild)하지 않은 상태로 부트를 진행하면 MAXRSTART 만큼 서버 재시작을 시도하게 되는데

SERVER 절에서 AUS=Y로 설정할 경우, 이를 무시하고 부팅한다.

기본값 : Y

UCS 서버 타입에서만 설정할 수 있다. 다른 서버 타입에서는 이 옵션을 사용할 수 없다.

UCS 타입의 서버에서 tpsavectx() 호출해서 클라이언트의 정보를 저장한 다음에 tprelay()를 호출하기 전에 tmdown -s, tmdown -s -i, 비정상 종료 등으로 인해 서버 프로세스가 종료되면 서비스 호출자는 해당 서비스 요청에 대한 응답을 받지 못한다. 'Y'로 설정하면 서버 프로세스가 종료될 때 아직 tprelay()로 처리되지 못한 요청건들에 대해서 호출자에게 에러 응답을 리턴한다.

CTX_EREPLY 옵션을 기본값으로 설정하면 서버 프로세스가 종료하는 경우에 해당 프로세스에서 서비스가 처리되었던 요청건들에 대해서 호출자에게 에러 응답이 전달된다. 즉, 같은 서버의 다른 프로세스들은 영향을 받지 않는다. tpsavectx() 호출로 생성된 클라이언트 정보(CTX_T)를 서버 프로세스 내부적으로만 관리하는 경우에는 정상적으로 동작한다.

그러나 만약 클라이언트 정보를 IPC 등을 통해 여러 프로세스가 공유하고 특정 프로세스가 비정상 종료되더라도 다른 프로세스에 의해서 tprelay()를 처리할 수 있도록 구성된 환경에서는 정상적으로 처리할 수 있음에도 불구하고 에러 응답이 전달될 수 있다. 따라서 이러한 경우에는 설정값을 'N'으로 설정해서 에러 응답이 전달되지 않도록 설정한다.

기본값 : Y

기본값으로 설정하면 MINCLH가 2 이상인 환경에서 한 서버 프로세스가 여러 CLH로우부터 서비스 요청을 동시에 받을 수 있다. 서버 프로세스는 서비스 요청을 동시에 받으면 먼저 들어온 서비스 요청을 처리하고, 해당 서비스가 tpreturn으로 끝났을 때 다른 CLH의 서비스 요청을 처리하게 된다.

설정값을 'N'으로 설정하면 각각의 서버 프로세스는 하나의 CLH로부터만 서비스 요청을 받아서 처리하게 된다. 따라서 여러 CLH로부터 한 서버 프로세스로 동시에 서비스 요청을 하는 것을 방지할 수 있다. 반면에 각 서버 프로세스는 하나의 CLH로부터만 서비스를 요청받기 때문에, 다른 CLH에서 부하가 발생하더라도 이와 상관없이 자신에게 할당된 CLH의 요청만 처리하게 되어 성능적인 측면에서 비효율적인 상황이 발생할 수 있다.

설정값을 N으로 설정할 경우 주의사항

기본값 : Y

tmapm 사용 여부를 서비스별로 설정한다.

사용자 함수로 타임아웃을 재조정할 경우(tpsetsvctimeout()) tmapm을 사용하지 않는 것을 권장한다.

기본값 : N

MAC(Master Alive Check)는 TMM이 종료되었을 때, 좀비 프로세스로 남는 것을 방지하기 위해 경우에 따라서 서버를 종료시킬 필요가 있다.

MAC=Y로 설정할 경우, TMM이 비정상 종료하면 서버도 따라서 종료한다.

기본값 : N

ROC(Reconncet Outbound CPC)는 서버가 CLH와 연결이 끊어졌을 경우 cpc 연결을 다시 해야 할 경우가 발생한다.

ROC=Y로 설정할 경우, CLH는 살아 있고 소켓의 연결이 끊겼을 경우 재연결을 시도한다.

기본값 : N

해당 서버의 서비스 호출 회수가 MAX_USE_COUNT 보다 크면 종료하고 재시작한다.

만약 MAX_USE_COUNT를 통해 서버가 재시작 되면 TMM은 sever closed due to MAX_USE_COUNT or MEM_USAGE(CLOPT:-m)을 출력한다.

서버의 로그 레벨을 설정한다.

사용자 메시지가 기록(logging)될 디렉터리의 절대 경로를 지정한다.

사용자, 즉 Tmax 응용 프로그래머는 userlog() 함수를 이용하여 디버그용 메시지, 각종 에러 및 경고 메시지 등을 사용자에 따라 간편하게 로깅(logging)할 수 있다. 이렇게 프로그래머가 userlog() 함수를 통해 내보내는 메시지들이 저장될 디렉터리가 ULOGDIR이다. 지정된 ULOGDIR 디렉터리에는 날짜별로 ‘ulog_날짜’ 파일이 생성되어 각 파일에는 일자별로 발생한 메시지들이 기록된다.

항목이 정의되지 않은 경우에는 TMAXDIR에서 지정한 디렉터리 아래 log/ulog 디렉터리에 기록된다. 지정된 경로에는 사용 중인 시스템이 존재해야 한다.

크기 : 15자 이내

서버 프로그램 내의 함수명(서비스 루틴명)이 사용된다. 반드시 SERVICE 절에서 고유한 이름이어야 한다. 멀티 도메인 환경에서는 모든 도메인에서 고유해야 한다.

크기 : 15자 이내

해당 서비스를 제공하는 서버 프로세스를 지정한다.

해당 서비스 루틴을 가진 서버 프로그램의 실행 파일명이 정의된다. 서버 프로세스는 SERVER 절에 정의되어 있어야 한다. 서버 프로세스에 특수문자가 있을 경우에는 "서버 프로세스명" 형태로 정의해야 한다. 하나의 서버 프로세스에 여러 개의 서비스를 제공할 때, 각 서비스마다 동일한 서버 프로세스명을 지정하는 경우, SERVICE 절에서 동일한 서버 프로세스명은 여러 번 나타날 수 있다.

"3.2.2 NODE 절"의 DEFAULT 항목을 참고한다.

서비스명과 실제로 동작시킬 모듈의 파일명이 다를 때 모듈의 실제 파일명을 기술한다.

범위 : 1 ~ 100

기본값 : 50

클라이언트의 요구를 처리하는 우선순위 값이다. 각 서비스 사이의 우선순위를 나타내며, 높은 우선순위의 서비스를 낮은 우선순위의 서비스보다 먼저 처리한다. 숫자가 클수록 높은 우선순위를 갖는다. 즉, 100을 가장 먼저 처리한다.

데이터 관련 라우팅에 사용되는 항목으로 자세한 설명은 “3.5. 부하 조절 환경설정”을 참고한다.

범위 : 1 ~ MAX_INT

기본값 : 0

값을 설정하지 않으면 기본값으로 설정되어 무한대기한다.

서비스 처리의 제한시간으로 각 서비스는 서비스 처리가 시작되는 순간부터 끝날 때까지 지정된 SVCTIME 시간 안에 처리되어야 한다.

만약, SVCTIME을 초과하면 서버 프로세스는 서비스를 중지하고, 클라이언트에게 에러를 반환한다. DOMAIN 절의 BLOCKTIME 항목이 클라이언트가 서비스를 요구하는 시점(tpcall()이나tpacall()이 불려지는 시점)부터라면, SVCTIME은 서버 프로세스가 CLH 프로세스로부터 서비스 요청을 넘겨받아 서비스 루틴이 시작되는 시점부터이다. 값이 0인 경우, 서비스 처리에 시간 제한이 없는 것으로 간주한다.

데이터베이스 세션을 사용 중일 때 서비스 타임아웃이 발생하는 경우 데이터베이스와 연결된 세션을 일방적으로 완전히 끊을 수 없어 다음 서비스의 수행이 불가능해진다. 이 경우 Tmax는 다른 방법을 사용하여 이 문제를 해결한다. 서비스 타임아웃이 발생할 경우 사용자는 tpsvctimeout 루틴에서 TPRETURN(TPEXIT, ...)을 이용하여 서버를 재기동할 수 있으며 이것은 SERVER 절에 정의한 MAXRSTART 횟수에 포함된다.

또한 Windows에서 XA 모드로 애플리케이션을 개발하는 것을 권장하며 Non-XA 모드를 사용하는 경우는 RESTART 횟수를 충분히 설정할 필요가 있다. SVCTIME은 서버가 동작하고 있을 때에만 적용된다. 따라서 클라이언트가 요청한 서비스가 큐에 저장되어 있는 동안에는 SVCTIME이 적용되지 않는다.

기본값 : Y

멀티 도메인 환경에서 게이트웨이를 통해 서비스를 요청받았을 경우 서비스를 수행할 것인지 여부를 정의한다.

EXPORT=N으로 설정할 경우 다른 도메인에서 서비스를 요청하면 TPESECURITY 에러가 발생한다.

기본값 : N

SERVICE 절에 속한 항목으로 트랜잭션 모드가 아닌 상태에서 서비스가 요청 메시지를 받았을 때 트랜잭션을 자동으로 기동할지 여부를 정의한다.

Tmax 3.8.8 이전에 있던 AUTOTRAN 항목과는 차이점이 있다.

이전에는 AUTOTRAN을 설정하지 않더라도 기본적으로 AUTOTRAN=Y로 설정되어 tx_begin을 수행하지 않아도 트랜잭션을 시동하였으며 이 트랜잭션은 로컬 트랜잭션이었다. 그러나 Tmax 3.8.8에서 추가된 AUTOTRAN은 이 항목이 설정되지 않은 경우 기본적으로 'N'이 설정되어 트랜잭션을 자동으로 시동하지 않는다.

따라서 이 항목을 설정하지 않은 경우는 tx_begin으로 트랜잭션을 명시적으로 기동시켜야 한다. 이 항목을 'Y'로 설정한 경우 해당 서비스가 다른 서비스를 요청하면 이들은 모두 하나의 트랜잭션(글로벌 트랜잭션)으로 묶이게 된다. 'Y'로 설정한 경우는 tx_begin으로 트랜잭션을 명시적으로 기동시키면 에러(TPESVCERR)가 발생한다.

다음은 환경 파일과 tmadmin의 예제이다.

< config.m>

*SVRGROUP
svg2            NODENAME = "tmax1"

### tms for Oracle ###
svg3            NODENAME = "tmax1",    DBNAME = ORACLE,
                OPENINFO = "Oracle_XA+Acc=P/scott/tiger+SesTm=60",
                TMSNAME  = tms_ora

*SERVER
svr2            SVGNAME = svg2
### servers for Oracle sample program###
fdltest         SVGNAME = svg3

*SERVICE
### services for fdltest ###
FDLINS          SVRNAME = fdltest
FDLSEL          SVRNAME = fdltest
FDLUPT          SVRNAME = fdltest
FDLDEL          SVRNAME = fdltest
TOUPPER         SVRNAME = svr2

<tmadmin의 예제>

tmax@tmax1;/user/tmax/tmax/config>tmadmin
--- Welcome to Tmax Admin (Type "quit" to leave) --- 

$$1 tmax1 (tmadm): cfg -s
   ------------------------------------------------- 
   svc_name    prio(pr)  autotran  svctime(st)  routno  svrname      svgno 
   ------------------------------------------------- 
FDLINS          50      YES         0           -1      fdltest         2 
FDLUPT          50      YES         0           -1      fdltest         2 
FDLSEL          50      YES         0           -1      fdltest         2 
FDLDEL          50      YES         0           -1      fdltest         2
TOUPPER         50       NO         0           -1        svr2          0

$$2 tmax1 (tmadm): q
ADM quit for node (tmax1)

범위 : 1 ~ MAX_INT

기본값 : 0

"3.2.1 DOMAIN 절"의 TXTIME 항목을 참고한다.

크기 : 15자 이내

게이트웨이에 대한 논리적인 이름으로, GATEWAY 절 내에서 유일한 값이어야 한다.

크기 : 255자 이내

도메인 내에서 게이트웨이 프로세스가 실행될 노드명을 지정하는 항목이다.

사용되는 NODENAME은 NODE 절에서 정의한 노드명이어야 한다.

로컬 게이트웨이 프로세스가 사용하는 Listen 포트 번호이다. 이 포트 번호는 리모트 게이트웨이 프로세스가 로컬 게이트웨이 프로세스와 연결할 때 사용한다. 이를 위해서 포트 번호를 RGWPORTNO 항목에 등록해야 한다. 일반적으로 시스템 영역에서는 1024 이내의 포트 번호를 사용하므로 관리자는 이 범위를 피해야 한다.

포트 번호는 게이트웨이 사이의 통신에 사용되므로 이 값들이 다른 곳에 사용되고 있는지 반드시 확인해야 한다.

크기 : 255자 이내

로컬 게이트웨이 프로세스가 접속하기를 원하는 리모트 게이트웨이의 프로세스가 실행되는 노드의 IP 주소나 노드명을 등록하는 항목이다.

노드명을 지정할 경우 그 노드명은 반드시 "/etc/hosts" 파일에 등록되어 있어야 한다. 로컬 게이트웨이 프로세스는 RGWADDR 항목의 IP 주소와 RGWPORTNO 항목의 포트 번호를 이용하여 리모트 게이트웨이 프로세스와 접속한다.

로컬 게이트웨이 프로세스가 리모트 게이트웨이 프로세스와 접속하기 위한 포트 번호이다.

포트 번호는 리모트 게이트웨이 프로세스의 Listen 포트 번호이다. 일반적으로 시스템 영역에서는 1024 이내의 포트 번호를 사용하므로 관리자는 이 범위를 피해야 한다.

로컬 게이트웨이 프로세스가 접속할 리모트 게이트웨이의 종류를 지정하는 항목이다.

현재는 TMAX, TMAXNONTX, JEUS, JEUS_ASYNC, TUXEDO, TUXEDO_ASYNC, WSGW의 7가지를 지원하고 있다.

"3.2.2 NODE 절"의 DEFAULT 항목을 참고한다.

범위 : 1 ~ 128

기본값 : 32

멀티 도메인 환경에서 한 게이트웨이로 들어올 수 있는 채널의 개수를 지정한다.

TMAXNONTX 타입의 경우에만 사용 가능하며 이 항목을 정의하지 않으면 하나의 게이트웨이는 32개의 도메인과 연결되어 서비스 요청을 받을 수 있다.

기본값 : N

로컬 게이트웨이가 listen을 위해 IPv6의 사용 여부를 결정하는 항목이다.

기본값 : N

로컬 게이트웨이가 리모트 게이트웨이에 접속할 때 IPv6를 사용하여 접속하는지의 여부를 결정하는 항목이다.

범위 : 1 ~ 128

기본값 : 1

게이트웨이 이용하는 경우 양 도메인의 CLH 프로세스 간 병렬 통신 채널 수를 지정하는 항목이다.

게이트웨이 프로세스가 처리량이 아주 많고 서비스의 소요시간이 길 경우 다중 채널을 두어 병렬 통신으로 처리하여 처리속도를 증가시킬 수 있다. TMAXNONTX 타입의 게이트웨이의 경우 2~3개 이하의 CPC로도 충분하다.

범위 : 1 ~ MAX_INT

기본값 : 0

값을 설정하지 않으면 기본값으로 설정되어 무한대기한다.

도메인 사이의 tpcall / tpacall 호출이 있을 경우 사용되는 타임아웃 시간을 지정한다.

0일 경우 제한이 없음을 나타내며 게이트웨이는 서버와 달리 30초 간격으로 타임아웃을 체크하므로 지연시간이 30초보다 작을 경우 TIMEOUT 항목이 적용되지 않는다.

크기 : 8000자 이내

동일한 서비스를 여러 게이트웨이를 통해 부하 분산할 필요가 있을 경우에 관련된 게이트웨이들의 이름을 지정한다. 같은 노드이거나 다른 노드에 속한 게이트웨이의 경우에도 이름을 지정할 수 있다. COUSIN과 BACKUP을 함께 지정할 수 있는데 이 경우 COUSIN, BACKUP 각각 다른 게이트웨이로 설정해야 한다.

라우팅은 COUSIN에 지정한 게이트웨이가 담당하며, 장애가 발생할 경우 백업에 지정한 게이트웨이가 담당한다.

COUSIN 항목에는 GATEWAY 절에 등록된 게이트웨이명만 지정할 수 있다. 서버 그룹은 지정할 수 없다.

다음은 환경 파일의 예제이다.

< config.m>

*SERVICE
GWSVC1       SVRNAME = gw1
GWSVC2       SVRNAME = gw1
GWSVC3       SVRNAME = gw1

*GATEWAY
gw1         NODENAME = node1, GWTYPE = TMAXNONTX, PORTNO = 10001,
            RGWADDR = "192.168.1.1",   RGWPORTNO = 10002,
            LOAD = 1, CPC = 5, CLOPT = "-i",
            COUSIN = "gw1"

gw2         NODENAME = node2, GWTYPE = TMAXNONTX, PORTNO = 10001,
            RGWADDR = "192.168.1.2",   RGWPORTNO = 10002,
            LOAD = 1, CPC = 5, CLOPT = "-i"

게이트웨이 gw1과 gw2를 COUSIN으로 설정하였다. GWSVC1 서비스 요청을 받으면 LOAD 설정에 따라 분산 처리된다.

"3.2.3. SVRGROUP 절" LOAD 항목을 참고한다.

크기 : 7999자 이내

주 게이트웨이에 장애가 발생하는 경우 사용할 백업 게이트웨이의 이름을 정의한다. 이 필드에 정의된 값은 Tmax 환경 파일의 GATEWAY 절에 정의된 값과 같아야 한다.

크기 : 255자 이내

백업을 위해 로컬 게이트웨이 연결에 사용된 리모트 게이트웨이의 노드명이나 IP 주소를 정의한다.

IP 주소 대신 노드명이 정의되었다면 '/etc/hosts' 파일에도 정의되어 있어야 한다.

백업을 위해 로컬 게이트웨이 연결에 사용된 리모트 게이트웨이의 포트 번호를 정의한다.

대기(listening)하고 있는 리모트 게이트웨이의 포트 번호이다. 일반적으로 시스템 영역에서는 1024 이내의 포트 번호를 사용하므로 관리자는 이 범위는 피해야 한다.

BACKUP, BACKUP_RGWADDR, BACKUP_RGWPORTNO 필드는 장애 대책에 사용된다.

기본값 : N

로컬 게이트웨이가 백업 리모트 게이트웨이로 접속할 때 IPv6를 사용하여 접속하는지의 여부를 결정하는 항목이다.

주소가 BACKUP_RGWADDR에, 포트가 BACKUP_RGWPORTNO에 지정된 리모트 게이트웨이로 접속할 때 적용된다.

크기 : 255자 이내

Tuxedo 게이트웨이(GWTYPE = TUXEDO | TUXEDO_ASYNC)에서만 설정할 수 있다. 백업 Tuxedo 게이트웨이는 3개까지 지정할 수 있으며, BACKUP_RGWADDR2-BACKUP_RGWPORTNO2, BACKUP_RGWPORT3-BACKUP_RGWPORTNO3로 지정한다.

기본값 : N

Tuxedo 게이트웨이(GWTYPE = TUXEDO | TUXEDO_ASYNC)에서만 사용한다. 두 번째 및 세 번째의 백업 리모트 게이트웨이로 접속할 때 IPv6를 사용하여 접속하는지의 여부를 결정하는 항목이다.

각각 주소가 BACKUP_RGWADDR2이고 포트가 BACKUP_RGWPORTNO2에 지정된 리모트 게이트웨이, 주소가 BACKUP_RGWADDR3이고 포트가 BACKUP_RGWPORTNO3에 지정된 리모트 게이트웨이로 접속할 때 적용된다.

기본값 : BIDIR

DIRECTION은 GWTYPE이 TMAX와 TMAXNONTX인 경우에만 유효한 항목이다.

다음은 설정값에 대한 설명이다.

크기 : 255자 이내

게이트웨이가 기동될 때 그 게이트웨이로 전달되는 명령어 옵션을 정의한다. 정의된 옵션 중에 '--' 이전에 지정된 옵션은 시스템에서 사용하고, 그 이후에 지정된 옵션은 사용자가 자유롭게 사용할 수 있다.

주로 사용되는 사용자 옵션은 다음과 같다.

다음은 항목 설정에 고려할 사항이다.

기본값 : Y

GATEWAY 절에 지정하였을 경우 해당 게이트웨이 프로세스 재기동 여부를 결정하는 항목이다. 비정상적으로 종료될 때 재기동한다.

장애 대책에 사용되는 필드로 자세한 사항은 “3.8. 장애 대책 환경설정”을 참고한다.

범위 : 1 ~ MAX_INT/2

기본값 : -1

GW에서 pending list를 가지고 있는 최대시간을 지정한다.

최대 시간 설정은 TIMEOUT 항목의 값을 2로 나눈 값보다 작거나 같아야 한다(TIMEOUT >=PTIMEOUT).

도메인 게이트웨이에서 pending(Prepare-done, Commit, Rollback)을 재전송하여 Decision을 받지 못한 상황에서도 pending이 생기지 않도록 한다.

Gateway1, Gateway2가 2PC로 연결이 되는 경우 Gateway2가 Prepare를 받은 후 Commit/Rollback 등을 받지 못하면 Gateway2가 Gateway1로 Prepare-done 등을 보낸다. 게이트웨이 사이의 네트워크 문제(혹은 비정상 종료) 등으로 Decision을 받지못한 상황에서 pending이 생기는 경우 PTIMEOUT, PTIMEINT를 설정하여 pending을 제거할 수 있다.

범위 : 1 ~ MAX_INT/2

기본값 : -1

게이트웨이에서 pending(Prepare-done, Commit, Rollback)을 재전송하는 시간 간격을 지정한다.

최대시간은 PTIMEOUT 값보다 작거나 같아야 한다.

범위 : -1 ~ MAX_INT

기본값 : -1

게이트웨이에서 backup에 연결된 상태에서 failback으로 main으로 연결을 시도할 주기이다.

범위 : -1 ~ MAX_INT

기본값 : -1

GW에서 리모트 게이트웨이에 소켓 연결(connect) 시도시 연결이 맺어질 때 까지 기다릴 수 있는 시간이다.

범위 : -1 ~ MAX_INT

기본값 : -1

게이트웨이에서 리모트 게이트웨이에 연결한 채널이 가용한지 알기 위해 주기적으로 체크 메시지를 보내는 주기이다.

항목에 대한 자세한 내용은 "3.2.2 NODE 절"의 TRB 항목의 설명을 참고한다.

크기 : 63자 이내

사용하는 DBMS명을 기술한다. 사용되는 값은 Oracle, Informix, Sybase 등의 DBMS명이다.

크기 : 255자 이내

서버 그룹과 관련된 데이터베이스 정보를 등록하는 항목이다.

같은 리소스 매니저 즉, 같은 데이터베이스를 사용하는 경우 한 서버 그룹으로 관리하면 리소스의 효율을 높이고 분산 트랜잭션 처리를 할 수 있다.

OPENINFO 형식은 리소스 매니저를 제공하는 벤더(Oracle이나 Informix 등 데이터베이스)의 종류에 따라 다르다. 그 외 다른 데이터베이스는 해당 데이터베이스의 안내서를 참고해서 등록한다.

크기 : 255자 이내

기본값 : NULL

CLOSEINFO 항목은 리소스 매니저가 데이터베이스를 close할 때 필요한 정보를 지정한다.

보통 생략되거나 NULL로 정의된다. Informix 데이터베이스에서는 반드시 널 문자열("")로 지정해야 하며, Oracle 데이터베이스에서는 생략해도 된다.

<Oracle을 사용하는 서버 그룹의 예>

*SVRGROUP
svg1           NODENAME = tmax1,
               DBNAME = ORACLE,
               OPENINFO = "Oracle_XA+Acc = P/scott/tiger+SesTm= 60"

<Informix를 사용하는 서버 그룹의 예>

*SVRGROUP
svg2           NODENAME = tmax2,
               DBNAME = INFORMIX,
               OPENINFO = "test",
               CLOSEINFO = ''''

크기 : 15자 이내

TMSNAME은 해당 서버 그룹의 데이터베이스 관리를 담당할 TMS 프로세스명을 정의한다.

데이터베이스의 open 정보(OPENINFO 항목)를 등록한 경우에는 반드시 TMSNAME에 대한 정의가 필요하다. TMS 프로세스는 데이터베이스와 관련된 시스템에서 해당 서버 그룹의 데이터베이스 관리를 담당하기 위하여 반드시 필요하다. 그러므로 Tmax 시스템에서 데이터베이스를 관리하도록 하기 위해서는 데이터베이스의 open/close 정보를 등록하고, 서버 그룹별로 반드시 TMSNAME을 정의하여 TMS 프로세스를 기동시켜야 한다. TMS 프로세스는 데이터베이스와 연동하는 XA로 업무를 처리하는 트랜잭션 매니저이다. 이 프로세스는 "$TMAXDIR/lib"에 있는 <libtms.a>와 SVRGROUP 절에 있는 DBNAME의 데이터베이스 라이브러리를 연결하여 생성된다.

범위 : 1 ~ 32

기본값 : 2

해당 서버 그룹의 TMS 프로세스 기동 개수를 정의한다. TMS 개수는 데이터베이스 관리보다는 트랜잭션 관리에 영향을 주는 요소이다. 기본값으로 서버 그룹당 2개가 기동되는데, 데이터베이스 관리만을 원할 경우 1,2개의 TMS로 충분히 관리가 가능하다.

범위 : 1 ~ 32

기본값 : 3

동적으로 더 기동시킬 수 있는 TMS 프로세스 개수를 정의한다. 자세한 내용은 “3.4. 분산 트랜잭션 환경설정”을 참고한다.

기본값 : Y

2PC(Two Phase Commit) 여부를 결정한다. 2PC란, 준비(Prepare)와 실행(Commit / Rollback)의 2단계로 트랜잭션을 처리하는 것을 말하며, Tmax에서는 분산 트랜잭션 구현을 위한 2PC를 지원한다.

[그림 3.9] 2PC의 처리 과정

Tmax에서는 2PC에 대하여 2가지 방법을 지원한다. 1, 2단계를 거쳐 Commit하고 Rollback에 대한 완전한 로깅(logging)이 이루어진 후 서비스를 반환(complete return)한다. 보다 빠른 처리를 위하여 2단계에서 Commit / Rollback 명령만 지시하고 서비스를 반환하는 것이며 시스템 환경에 따라 선택적으로 지정 가능하다.

CMTRET 항목은 complete return에 대한 내용을 결정한다.

범위 : 0 ~ MAX_INT

기본값 : 0

트랜잭션 처리 제한시간을 결정한다. tx_begin()의 트랜잭션 시작에서부터 tx_commit()이나 tx_rollback()으로 트랜잭션이 끝날 때까지의 시간으로, TXTIME이 지나면 자동으로 Rollback 처리된다.

크기 : 255자 이내

기본값 : TMAXDIR

트랜잭션을 처리할 때 장애가 발생하면 복구를 위해 트랜잭션 처리에 대한 기록(logging)이 필요하다. TLOGDIR은 트랜잭션 정보가 저장될 파일을 지정한다.

로그 파일은 일반 파일로 저장된다. Tmax는 로그 파일을 저장할 때 raw 파일을 지원하지 않는다. 트랜잭션 처리가 많지 않은 경우에는 TLOGDIR에 정의된 일반 파일을 사용하고 임의의 파일명을 정의한다. 반대로 트랜잭션 처리가 많은 경우에는 응답시간을 단축시키기 위해 UNIX 파일 시스템을 거치지 않고, 정의된 raw 파일을 사용하여 TLOGDIR에 device명을 직접 디스크에 기록하며, 여기에 정의된 device는 트랜잭션 기록(logging)을 위해서만 사용한다.

사용하는 데이터베이스명을 설정한다.

데이터베이스의 open 정보를 등록한다.

기본값 : NULL

데이터베이스의 close 정보를 등록한다.

TMS 프로세스명을 설정한다.

TMS 프로세스의 최소 개수이다.

데이터베이스 관리만을 위해서는 TMS 프로세스 개수가 중요하지 않지만, 트랜잭션을 처리할 때는 매우 중요하다. 단순히 1,2개로 TMS 프로세스 개수가 고정되어 있다면, 트랜잭션 처리량이 많은 서버 그룹의 경우 Commit / Rollback 처리에 상당한 부하를 초래할 수 있다. 따라서 처리 속도와 리소스 관리를 위해 적절한 개수의 TMS를 기동시키는 것이 중요하다.

장애 대책에 사용되는 필드로 자세한 사항은 “3.8. 장애 대책 환경설정”을 참고한다.

SVRGROUP 절에 설정되었을 경우 TMS 또는 RQ의 MAXRSTART를 의미한다.

TMS 프로세스의 최대 개수로 적으로 더 기동시킬 수 있는 TMS 프로세스의 개수를 정의한다. 트랜잭션 처리량이 많아질 경우, MAXTMS 개수가 넘지 않는 범위 내에서 TMS 프로세스를 더 기동시킬 수 있다.

크기 : 255자 이내

2개 이상의 노드에서 부하 조절 기능을 사용하는 경우에 서버 그룹명을 지정하는 항목이다.

각 서버 그룹명은 SVRGROUP 절에 등록되어야 한다. 기본적으로 Tmax 시스템의 부하 조절 기능은 서버 그룹 단위로 이루어진다. 그러나 부하 조절이 다수의 노드에 걸쳐 이루어지는 경우 해당 노드명은 각각의 서버 그룹에 다르게 설정되어야 하며 노드명은 반드시 환경 파일의 NODE 절에 등록된 것이어야 한다.

다수의 서버 그룹을 정의할 경우는 콤마(,)로 분리하여 정의한다. 각 노드의 APPDIR에는 필요한 서버 프로그램이 존재해야 한다. 노드의 성능에 따라 부하 조절을 할 필요가 있을 경우에는 각 서버 그룹에 부하 조절을 위한 LOAD 값을 설정해야 한다.

범위 : -1 ~ MAX_INT

기본값 : 1

서버 그룹의 서비스 처리 능력을 의미한다. 값이 클수록 처리 능력이 높음을 나타낸다.

서비스 처리 능력이 탁월한 노드에 대해서는 LOAD 값을 크게 설정하며, 반대로 노드의 성능이 저하된다면 LOAD 값을 작게 설정해야 한다.

시스템 로드에 따른 부하 조절을 원한다면 COUSIN 항목 설정으로 서버 그룹을 복사한 후 각각의 서버 그룹에 적절한 LOAD 값을 설정하면 된다. 노드별 분산처리를 원하지 않는다면 LOAD 값을 -1로 설정하면 된다. 자동 부하분산은 LOAD 값을 설정하지 않거나 0으로 설정하면 되며 시스템 부하에 따라 자동적으로 서비스 요청이 분산된다.

크기 : 255자 이내

DDR은 라우팅을 원하는 서비스가 다수의 서버 그룹에서 제공되어야 한다. 따라서 COUSIN 항목의 설정에 따라 원래의 SVRGROUP이 다른 노드로 복사되어야 할 필요가 있다. 자세한 내용은 “3.2.3. SVRGROUP 절”에 COUSIN 항목을 참고한다.

크기 : 15자 이내

라우팅의 논리적 이름을 정의한다.

SERVICE 절 내에서 유일해야 하며 이 이름은 아래 설명된 ROUTING 절에도 사용되는 것이다. DDR을 특정 서비스에 응용하기 위해서는 라우팅명이 정의되어야 하며 유형 버퍼명과 라우팅을 원하는 필드 및 그 범위를 서버 그룹명과 함께 정의해야 한다.

크기 : 15자 이내

SERVICE 절의 ROUTING 항목에 정의한 이름이다. 데이터에 따른 부하 조절은 서비스별로 부하 조절이 이루어지므로 반드시 SERVICE 절에 등록된 이름이어야 한다.

크기 : 2000자 이내

FIELD에는 각 데이터 타입별로 설정하는 방법이 다르다. 데이터 의존형 라우팅을 적용할 서비스에 대해서 그 서비스가 사용하는 STRUCT, FIELD, STRING, CARRAY 형의 정보를 설정한다.

각 데이터 타입별 형식은 다음과 같다.

전체 데이터 중 일정 부분만을 DDR에 사용하고자 할 때 사용하는 항목으로, 입력 데이터 중 DDR에 사용하고자 하는 부분의 처음 시작 위치를 나타낸다. offset은 FLDLEN 항목과 함께 지정되어야 하며 입력 데이터의 해당 offset부터 FLDLEN 만큼의 데이터만 DDR될 때 사용된다. 예를 들어 STRING/0/4라고 설정했을 경우 offset은 0, length는 4가 되며 "Tmaxsoft"라는 입력 데이터를 처리하고자 한다면 0번째 위치부터 4Byte 만큼인 "Tmax"라는 문자열만이 DDR의 비교 기준이 된다. 이 항목은 STRING / CARRAY 형의 DDR의 경우만 유효하다.

offset과 length을 사용할 때 주의할 점은 매칭 타입일 경우에는 사용해서는 안되며, 범위 타입일 경우에만 사용할 수 있다는 것이다. 이것은 offset과 length는 입력 데이터만을 대상으로 지정하는 항목이며 RANGES 항목에 지정하는 데이터와는 관계가 없기 때문이다.

아래와 같이 설정되어 있는 경우 "aaaaaaa"라는 문자열의 0 offset부터 4Byte인 "aaaa"라는 문자열만이 DDR될 때 비교 기준이 된다. 입력 데이터의 비교 기준인 "aaaa"와 RANGES에 지정한 "aaaaaaa"는 일치하지 않으므로 SVG2에서 처리하게 된다. 이 경우 어떤 데이터가 들어오더라도 무조건 SVG2에서 처리하게 되므로 주의해야 한다.

ROUTE_1   FIELD = "STRING/0/4",
          RANGES = "aaaaaaa":SVG1, *:SVG2

범위 타입으로 설정되어 있는 경우에는 offset과 length가 유효하다.

아래와 같이 설정되어 있는 환경에서 입력 데이터가 "aaaaaaa" 일 경우, 입력 데이터 중 0 offset부터 4Byte 만큼의 "aaaa"만이 비교 기준이 되며, "aaaa"라는 문자열은 SVG1에서 지정한 범위보다 작게 되므로 SVG2에서 처리한다. 입력 데이터가 "bbbb"일 경우 SVG1에서 지정한 범위 안에 속하게 되므로 SVG1에서 처리한다.

ROUTE_1    FIELD = "STRING/0/4",
           RANGES = "aaaaaaa"-"ccccccc":SVG1, *:SVG2

offset이 입력 데이터 중 DDR될 때 비교 기준으로 사용하고자 하는 부분의 처음 시작 위치를 나타낸다면 length는 offset 위치부터 지정한 길이만큼을 비교 기준으로 사용하고자 할 때 지정하는 항목으로 반드시 offset과 함께 사용되어야 한다.

지정되지 않을 경우 NULL을 만날 때까지 혹은 메시지의 끝까지 비교하게 된다.

크기 : 2047자 이내

RANGES 항목은 FIELD에서 정의한 항목의 값을 기준으로 어디로 라우팅할 것인지에 대한 정보를 설정한다.

RANGES 항목의 값 지정 형식은 다음과 같다.

MATCH 항목을 사용하지 않을 경우

*ROUTING
rout1    FIELD = "STRING, CARRAY, FIELD/INPUT,
         STRUCT/test/a",
         RANGES = "min-'100':svg1,'101'-'200':svg1_2,min-'100':svg1_3,*:svg1_4"

위와 같은 환경 파일이 구성되어 있을 경우, 이전 버전에서는 min-100까지의 데이터를 처리하기 위하여, svg1의 서버를 먼저 검사하고, svg1이 속한 노드가 정상적으로 기동되어 있지 않은 경우, 백업을 검사하며, 백업이 기동되어 있지 않거나 존재하지 않으면 클라이언트에게 에러를 보내게 된다. 하지만 현재 버전에서 ROUTING 절에 MATCH 항목을 지정해 주면 새로운 방식으로 동작한다.

MATCH 항목을 사용할 경우

*ROUTING
rout1    FIELD = "STRING, CARRAY, FIELD/INPUT, 
         STRUCT/test/a",
         RANGES ="min-'100':svg1,'101'-'200':svg1_2, min-'100':svg1_3,*:svg1_4" , 
         MATCH=MULTIPLE

위와 같은 환경 파일이 구성되어 있을 경우, min-100 까지의 데이터를 처리하기 위하여, svg1의 서버를 먼저 검사하고, svg1이 속한 노드가 기동되어 있지 않을 경우, 백업을 검사한다. 백업이 기동되어 있지 않거나 존재하지 않으면 RANGES에서 다음 번 일치하는 서버 그룹을 찾게 된다. 따라서 svg1_3이 그 대상이 된다. svg1_3이 속한 노드가 살아 있는지 검사하고, svg1_3의 서버 그룹 역시 기동이 되어 있지 않을 경우, svg1_3 서버 그룹의 백업을 검사하며, 백업이 존재하지 않거나 정상적으로 기동되어 있지 않을 경우, 그 다음 일치되는 서버 그룹은 svg1_4가 된다.

"MATCH=FIRST"로 지정하면 기존과 동일한 방식으로 동작한다.

크기: 15자 이내

RQ 서버 그룹이 존재하는 노드를 정의한다. 사용되는 NODENAME은 NODE 절에서 정의한 노드명이어야 한다.

범위 : 1 ~ 128

기본값 : 4

RQS 프로세스와 CLH 프로세스 사이의 병렬 통신 채널 수를 지정하는 항목이다. 큐의 사용이 빈번할 경우에 다중의 채널을 유지하여 처리 속도를 향상시킬 수 있다.

RQ 서버 그룹의 타입을 정의하는 항목으로 RQMGR로 지정한다.

크기 : 15자 이내

RQ 절의 논리적인 이름이다. RQ 절 내에서 여러 개의 RQ 정의가 가능하며, 각각의 RQ명은 유일한 값이어야 한다. 또한 한 노드에 2개 이상의 RQ를 정의할 수 있다.

크기 : 15자 이내

RQ를 사용하는 그룹을 지정한다. SVGNAME은 SVRGROUP 절에 등록된 RQ SVRGROUP Name이어야 한다.

범위 : 1 ~ 2047

기본값 : 16 (단위 : Mbyte)

Enqueue된 데이터를 저장하는 RQ의 크기를 지정하여 사용할 수 있다.

RQ의 크기는 자동으로 증가하지 않으므로 RQ가 정의한 크기를 초과하여 에러가 발생하는 것을 막기 위해 적당한 크기로 설정할 것을 권한다. RQ 파일을 작성한 후에도 RQ에 데이터가 저장되지 않으면 Tmax가 종료될 때 파일이 자동으로 삭제된다.

크기 : 255자 이내

기본값 : $(TMAXDIR)/path/rq-name

RQ에서 사용되는 파일 위치를 지정한다. 이 필드는 RQ 데이터 파일을 생성하며 전체 파일명과 디렉터리명으로 정의되어야 한다.

기본값 : COLD

BOOT 필드는 Tmax 시스템을 재부팅할 때, RQ에 저장된 데이터를 조절한다.

다음은 설정값에 대한 설명이다.

기본값 : Y

각 디스크에 기록한 후에 fsync의 호출 여부를 지정한다.

다음은 설정값에 대한 설명이다.

기본값 : Y

RQ 파일 내용을 메모리에 캐시(cache)할지 여부를 지정한다.

N으로 지정하면 RQ 처리가 상대적으로 느려지나 요구되는 메모리가 작아진다.

범위 : 1 ~ 65535

기본값 : 1024

도메인 내의 HMS에서 생성할 수 있는 세션 수의 최댓값을 설정한다.

범위 : 1 ~ 65535

기본값 : 1024

노드 내의 HMS에서 생성할 수 있는 세션의 수의 최댓값을 설정한다.

크기: 15자 이내

HMS 서버 그룹에 대한 논리적인 이름으로, SVRGROUP 절 내에서 유일한 이름이어야 한다.

크기: 15자 이내

HMS 서버 그룹이 존재하는 노드를 정의한다. 사용되는 NODENAME은 NODE 절에서 정의한 노드명이어야 한다.

해당 서버 그룹의 종류를 정의한다. HMS를 사용하기 위해서는 반드시 HMS로 설정해야 한다.

크기: 15자 이내

사용자가 빌드한 HMS 프로세스명을 정의한다.

HMS는 기본적으로 데이터베이스를 스토리지로 사용한다. 따라서 HMS에서 연결을 할 DBMS의 OPENINFO를 설정해 주어야 한다.

데이터베이스로 연결을 초기화하고 각 데이터베이스에서 제공되는 문법으로 정의한다.

범위 : 0 ~ 65535

HMS의 메시지를 처리하는 데 필요한 설정값으로서 도메인 안에서 유일한 값으로 반드시 설정해야 한다.

범위 : 0 ~ 65535

스토리지 처리를 하지 않는 thread의 수를 설정한다.

비영속성 메시지만 송,수신하는 경우 이 항목의 값을 크게 늘려주어야 한다. 비영속적 메시지 이외에도 HMS의 기본적 동작을 위해 일정 수 이상 설정해야 한다.

범위 : 0 ~ 65535

스토리지 처리를 하는 thread의 수를 설정한다.

영속적 메시지가 많은 경우 이 값을 늘려줄 필요가 있다. 영속적 메시지 처리 외에도 HMS의 기본적 동작을 위해 일정 수 이상 설정해야 한다.

크기 : 255자 이내

영속적 구독자(Durable Subscriber)를 설정한 환경 파일의 경로와 이름을 설정한다.

파일 안의 내용은 LABEL을 [TopicName]으로 설정한 후, 각 라인마다 ClientName:Listener:Selector의 순으로 콜론(:)을 구분자로 구분하여 넣어준다.

환경 파일에 정의된 영속적 구독자는 HMS가 기동되면서 자동으로 등록된다.

범위 : 0 ~ 65535 (단위: 시간)

HMS는 영속적 메시지를 스토리지에 저장한다. 스토리지에 쌓인 메시지들을 주기적으로 삭제할 시간을 설정한다.

모든 구독자가 수신한 Topic 메시지, 소비가 완료된 큐 메시지는 설정된 시간이 경과되면 스토리지에서 삭제된다. 아직 받지 않은 영속적 수신자가 존재하는 메시지는 설정된 시간이 경과되어도 스토리지에서 삭제되지 않는다.

다수의 HMS를 클러스터링하는 경우 각 HMS는 서로 통신하기 위해 직접 채널을 생성한다. 이때 사용하는 포트 번호를 설정한다.

GLOBAL 속성을 설정한 Destination이 존재하는 경우 HMS는 설정된 포트 번호로 Listen한다. 따라서 이미 사용하고 있는 포트를 설정하지 않도록 주의해야 한다.

범위 : 0 ~ 65535 (단위: 초)

다수의 HMS를 클러스터링하는 경우 HMS 간의 네트워크 장애 감지를 위해 주기적으로 Heartbeat 메시지를 주고받는다. 이 메시지를 전송하는 주기를 설정한다. 이 주기 안에 Hearbeat 메시지가 다른 HMS에서 오지 않은 경우 장애로 감지해 해당 HMS와의 연결을 끊는다.

범위 : 0 ~ 65535 (단위: 밀리 초)

GLOBAL 속성을 설정한 큐 간의 메시지를 주고받기 위해서는 각 큐의 상태 정보를 주고받아야 하는데, 이 정보를 주고받는 주기를 설정한다.

클러스터링된 큐를 사용하기위해서는 반드시 설정해야 한다. 주기가 짧을수록 정확한 분배가 가능하지만 그만큼 네트워크의 부하는 크므로 적당한 크기의 값을 설정할 필요가 있다.

크기 : 15자 이내

Destination의 이름을 설정한다. 생산자와 소비자는 이 이름을 사용하여 생성된다.

크기 : 15자 이내

Destination이 존재하게 될 HMS 서버 그룹명을 정의한다. 사용되는 SVGNAME은 SVRGROUP 절에서 정의한 HMS 서버 그룹명이어야 한다.

Destination의 타입을 설정한다. 현재 TOPIC과 QUEUE만 지원한다.

기본값 : COLD

해당 Destination에 대해 기동할 때 복구할 메시지가 있을 경우 복구 여부를 설정한다.

RQ와 마찬가지로 WARM과 COLD만 설정할 수 있다.

다음은 설정값에 대한 설명이다.

기본값 : N

클러스터링된 HMS의 같은 이름을 갖는 Destination들을 논리적으로 하나의 Destination으로 동작하도록 설정한다.

GLOBAL 설정을 하기 위해서는 SVRGROUP 절의 HMS 설정에 HMSPORT가 설정되어 있어야 한다.

큐에 대한 GLOBAL 설정을 하기 위해서는 아래의 추가적인 설정이 필요하다.

범위 : 0 ~ 65535

클러스터링된 큐가 유지하고자 하는 버퍼 크기를 결정하는 계수값을 설정한다.

버퍼의 크기는 소비자의 수 X GQTHR 값이다. 현재 큐의 길이가 버퍼 크기보다 작을 때 나눠줄 메시지가 있는 클러스터링된 다른 큐로부터 메시지를 가져온다. 버퍼의 크기보다 적은 메시지를 가지고 있을 때 메시지 분배 요청을 받으면 메시지를 나누어주지 않는다.

범위 : 1 ~ 65535

클러스터링된 큐가 다른 큐에게 메시지를 요청할 경우 한 번에 요청할 수 있는 메시지의 수를 설정한다. 값이 클 경우 적은 횟수로 필요한 메시지를 채울 수 있지만 너무 클 경우 노드 사이에 불필요한 메시지의 이동이 발생할 수 있으므로 너무 크지 않도록 설정한다.

범위 : 0 ~ 65535

클러스터링된 큐의 메시지 소비가 이루어지지 않거나 메시지가 불균형적으로 너무 많이 쌓일 경우를 대비해 설정한 수 이상의 메시지가 쌓일 경우 그 초과분에 한해 다른 노드의 클러스터링 큐에게 메시지를 균등하게 나누어 준다.

크기 : 255자 이내

백업 서버 그룹을 지정한다.

하나 이상의 백업 서버 그룹을 지정할 수 있으며, 2개 이상의 백업 서버 그룹을 지정할 때는 콤마(,)로 분리하여 나열한다. 여러 개의 백업 서버를 지정한 경우, 원본 서버 노드에 장애가 발생하는 경우 첫 번째로 지정된 백업 노드가 동작하고, 그 백업 노드도 이상이 생기면 두 번째로 지정된 백업 노드가 동작하는 다중 장애 대책을 지원한다.

백업 노드의 서버 그룹명은 반드시 SVGROUP 절에 등록해야 한다. 또한 서버 그룹과 서버의 환경 옵션은 기본적으로 원본 서버 그룹의 환경을 그대로 따르며, 환경 옵션을 변경하고자 하는 경우 서버 그룹이나 서버별로 관련 항목들을 재정의할 수 있다. 다만, 서비스에 대한 환경 옵션은 이중 복사된 그룹별로 재정의할 수 없으며, 반드시 원본 서버 그룹과 동일한 환경을 갖는다.

이에 대한 규칙들은 부하 조절을 위해 이중 복사된 서버 그룹과 동일하다. 백업 노드는 부하 조절을 위해 복사된 서버 그룹과 달리, 원본 서버 그룹처럼 Tmax가 기동할 때 동작하는 것이 아니라, 장애가 발생했을 경우에만 원본 서버 그룹의 역할을 대신하여 동작한다.

기본값 : Y

Tmax 엔진 프로세스 중 CLH, CAS, CLL, TLM의 재시작 가능 여부를 결정한다.

CLH와 CAS, CLL, TLM에 문제가 발생하여 비정상적으로 종료되었을 경우, 재기동하려면 RESTART를 'Y'로 설정한다.

범위 : -1 ~ MAX_INT

기본값 : -1

Tmax 엔진 프로세스 중 CLH와 CAS 프로세스의 최대 재기동 가능 횟수를 결정한다.

GPERIOD 항목과 함께 사용된다.

RESTART가 'Y'라면 프로세스는 GPERIOD 시간 내에 최대 MAXRSTART 횟수까지 재기동되며 'N'으로 설정되면 시스템은 이 값을 무시한다. MAXRSTART가 –1일 경우 프로세스의 최대 재기동 가능 횟수는 무한이 된다.

범위 : 1 ~ MAX_INT

기본값 : 86400 (24시간) (단위 : 초)

MAXRSTART 횟수가 유효한 시간 주기이다.

GPERIOD 시간 동안 MAXRSTART 횟수까지 프로세스가 재기동된다. 그 시간이 경과하면 GPERIOD 시간 동안 다시 MAXRSTART 횟수만큼 재기동된다.

SVGTYPE이 RQMGR의 경우에는 해당 RQ의 재기동을, XA svg의 경우에는 해당 TMS의 재기동을 조절한다.

RQ와 TMS 프로세스가 비정상적으로 종료되었을 경우, 프로세스가 자동적으로 재기동되어 계속 서비스를 제공하게 된다.

각 항목에 대한 자세한 설명은 앞에서 설명한 절 3.8.2. “ NODE 절”을 참고한다.

서버 프로세스의 재기동 가능 여부를 결정한다.

서버 프로세스가 비정상 종료되었을 경우 프로세스가 자동적으로 재기동되어 계속 서비스를 제공하게 된다.

MAXRSTART의 기본값은 5이다.

각 항목에 대한 자세한 설명은 앞에서 설명한 절 3.8.2. “ NODE 절”을 참고한다.

게이트웨이의 재기동 가능 여부를 결정한다.

게이트웨이 프로세스가 비정상 종료되었을 경우, 프로세스가 자동적으로 재기동되어 계속 서비스를 제공하게 된다.

각 항목에 대한 자세한 설명은 앞에서 설명한 절 3.8.2. “ NODE 절”을 참고한다.

기본값 : "NO_SECURITY"

다음은 설정값에 대한 설명이다.

각 파일을 생성하기 위해서는 각각 mkgrp, mkpw, mkacl를 사용하여야 한다. ACL과 MANDATORY는 동일한 3단계 보안 설정에 해당하지만 아래와 같은 차이점을 가지고 있다.

크기 : 15자 이내

사용자는 Tmax 시스템에 접속할 때 TPSTART_T 구조체의 dompwd 항목에 이 계정의 패스워드를 입력하여 접속을 신청해야 한다. 패스워드가 등록되지 않았거나 틀린 경우에는 Tmax 시스템 접속에 실패하게 된다. 이 필드에서 정의된 사용자와 패스워드는 mkpw 유틸리티로 작성할 수 있다.

보안 환경설정을 한 뒤에 패스워드 파일은 mkpw로 작성되어야 한다. 이 파일은 각각의 사용자의 패스워드를 포함한다. 이 파일은 암호화되어 있어 패스워드의 노출이 방지된다. Tmax 보안 시스템을 정상적으로 작동하기 위해서는 Tmax 시스템이 설정되기 전에 패스워드 파일이 작성되어 있어야 한다.

DOMAIN_SEC의 경우, 패스워드가 tpstart() 안에 있는 TPSTART_T 구조체의 dompwd 필드의 값과 다르다면 그 클라이언트 프로그램은 서비스를 요청할 수 없다. tperrno는 TPESECURITY(25)로 설정된다. USER_AUTH의 경우, TPSTART_T 구조체의 usrpwd 필드와 usrname 필드는 mkpw로 작성한 패스워드 파일에 등록된 계정과 패스워드가 같아야 한다.

2단계(사용자 인증)는 1단계(시스템 접속 제어)를 포함하므로 dompwd도 설정되어 있어 도메인 패스워드와 일치해야 한다.

IPv4

192.168.1.43
192.168.1.48

IPv6

fe80::213:77ff:fe4d:c57d
fe80::213:77ff:fe4d:c570

IPv4

192.168.1.35
192.168.1.45

IPv6

fe80::213:77ff:fe4d:c50d
fe80::213:77ff:fe4d:c500

tmax.allow를 먼저 검색한 후 일치하는 ACL이 존재하면 접속을 허용한다.

tmax.deny를 검색한 후 일치하는 ACL이 존재하면 접속을 거부한다. 해당 ACL에 속하는 클라이언트 접속을 시도(TPSTART)할 때 TPECLOSE 에러가 발생한다.

tmax.allow, tmax.deny 파일에 모두 없으면 접속을 허용한다.

첫 번째 문자가 '#'일 경우 주석으로 처리한다.

IP 또는 NETWORK/NETMASK 방식만 허용한다.

예)

(IPv4)192.168.1.1 또는 192.168.1.0/24, 
(IPv6)fe80::213:77ff:fe4d:c57d 또는 fe80::213:77ff:fe4d:c57d/64

한 라인당 하나의 ACCESS CONTROL LIST만 허용하며 공백이나 탭이 허용되지 않는다.

ALL은 모든 IP를 의미하는 예약어이다.