동기형 방식은 Tmax의 클라이언트나 서버에서 서비스를 요청하고 서비스를 요청한 클라이언트나 서버로 응답이 오는 방식을 말한다. 반대로 리모트 노드에서 서비스를 요청하면 TCPGW는 Tmax의 서비스를 요청하고 그 결과를 서비스를 요청한 리모트 노드에 되돌려주는 방식이다.

전자의 경우 리모트 노드로 서비스를 요청한 Tmax 서비스가 블록되는가, 또는 블록되지 않는가에 따라 TCPGW는 다르게 동작한다. 후자의 경우에는 리모트 노드에서 요청한 처리 결과를 돌려줄 때 요청한 채널로 돌려주는 방식이다.

서비스 블록형 방식

Tmax의 서버나 클라이언트에서 TCPGW로 서비스를 요청하고, 그 결과가 올때까지 기다리는 가장 일반적인 방식이다. Tmax 클라이언트의 요청을 받은 서비스에서 TCPGW 서비스로 tpcall을 하면 리모트 노드에서 처리 결과를 송신할 때까지 Tmax 서비스(그림에서 SVC1)가 블록되어 있게 된다.

TCPGW를 동작시키면 Tmax 클라이언트에서 호출한 Tmax 서비스는 TCPGW를 호출한 후에 결과를 받을 때까지 블록이 되어 있게 된다. tpacall을 한 경우도 tpgetrply로 응답을 받는 곳에서 블록이 되기 때문에 tpcall과 마찬가지로 블록이 되게 된다. 많은 수의 요청을 받아들이기 위해서는 블록이 되는 시간까지 감안하여 많은 수의 서버를 실행해야 한다.

대외기관 통신에서는 대외기관의 장애(머신, 네트워크)에 따라서 많은 수의 서버를 필요로 하기 때문에 서비스 블록형 방식이 적합하다.

다음은 블록형 동기 방식으로 서비스 호출하는 경우 TCPGW 동작 구조이다.

서비스 NON 블록형 방식

서비스 NON 블록형 방식은 Tmax 클라이언트에서 직접 TCPGW를 요청하는 방식에서는 사용할 수 없고, TCPGW에 서비스를 요청하고 결과를 수신하는 서버를 중간에 두어서 처리하는 방식이다. 즉, TCPGW 앞에 송신 서비스와 수신 서비스를 두고 Tmax 클라이언트는 송신 서비스를 호출하고, 송신 서비스는 TCPGW로 서비스를 전달하고 서비스를 종료한다.

TCPGW는 리모트 노드로 서비스를 요청하여 그 결과를 수신하면, 해당 결과를 수신 서비스에게 전달한다. 수신 서비스는 TCPGW로부터 결과를 수신받아 클라이언트에게 전달하면 서비스 사이클이 종료되는 방식이다. 결과적으로 클라이언트는 서비스를 요청하고 결과를 받는 동기방식이나, 서버는 요청을 전달하고 종료하는 비동기방식과 같이 동작한다.

서비스 NON 블록형 방식은 블록형 방식에서 수행하는 방식보다도 적은 서버로도 많은 처리를 할 수 있다. 블록형 방식은 서비스가 TCPGW를 호출하고 블록되기 때문에 동시에 많은 처리를 위해서는 보다 많은 서버 프로세스를 실행해야 하지만, NON 블록형 방식에서는 자신의 일만 처리하고 서비스를 종료하기 때문에 적은 서버 프로세스로도 많은 일을 할 수 있다.

대외기관 간에 통신을 처리하는 경우에는 NON 블록형 방식이 보다 효율적이다.

다음은 서비스 NON 블록형 방식으로 서비스를 호출하는 경우 TCPGW 동작 구조이다.

리모트 동기형 호출 방식

리모트 노드에서 TCPGW로 먼저 서비스를 요청하는 방식이다. TCPGW는 리모트 노드에서 요청한 서비스를 호출하고 그 결과를 받아서 해당 서비스를 요청한 채널로 결과를 전송한다. 리모트 노드는 동시에 TCPGW로 Tmax 환경 파일에 정의되어 있는 MAXSACALL 개수를 초과하여 호출할 수 없다.

리모트 동기형 호출 방식은 리모트 노드에서 Tmax의 서비스를 호출하는 가장 보편적인 방식이다. TCPGW는 리모트 노드의 채널 정보를 보관하였다가 서비스로부터 결과를 수신받으면, 보관하고 있는 채널 중에서 해당 채널을 찾아서 결과를 전송한다. 이때 해당 채널로 결과를 되돌려 주기 전에 다른 요청은 얼마든지 가능하다. TCPGW는 리모트 노드에서 요청한 채널은 블록시키지 않고 다음 요청을 받을 수 있도록 처리하기 때문에 TCPGW의 운영 방식에 따라서 다르게 처리할 수 있다.

다음은 리모트 동기형 방식으로 서비스를 호출하는 경우 TCPGW의 동작 방식이다.

비동기형 호출 방식은 Tmax의 클라이언트나 서버, 리모트 노드에서 TCPGW 서비스를 요청만 하고, 그 결과는 받지 않거나 또는 서비스를 요청한 곳이 아닌 다른 프로그램에서 처리하는 방식이다. Tmax의 서비스에서 TCPGW로 서비스를 요청하고 그 결과는 다른 서비스로 받을 수 있다.

클라이언트인 경우 비동기형으로 처리할 때는 tpacall로써 응답을 받지 않는 경우에만 가능하다. 반대로, 리모트 노드에서 서비스를 먼저 요청하는 경우에 위에서와 같이 서비스만 요청하고 결과를 받지 않을 수도 있고, 서비스를 요청하고 결과는 다른 채널로 돌려주는 방식이 비동기형 방식이다.

Tmax에서 서비스 요청 방식

Tmax의 서비스에서 TCPGW로 tpacall에 TPNOREPLY로 요청하고 해당 서비스는 종료한다. TCPGW는 리모트 노드로 요청를 보내고 해당 결과가 수신되면 Tmax의 다른 서비스를 tpacall에 TPNOREPLY로 호출하여 결과를 처리하는 방식이다.

다음은 Tmax에서 비동기형 방식으로 서비스 요청하는 경우 TCPGW의 동작 구조이다.

리모트에서 서비스 요청 방식

리모트 노드에서 서비스를 TCPGW로 요청하면, TCPGW는 tpacall로 Tmax 서비스를 요청한다. Tmax 서비스 처리가 완료되면 TCPGW는 리모트 노드와 연결되어 사용 가능한 채널 중 아무 채널에 처리 결과를 전송한다.

다음은 리모트 노드에서 비동기형 방식으로 서비스를 요청하는 경우 TCPGW의 동작 구조이다.

서버 TCPGW와 클라이언트 TCPGW는 연결을 맺을 때만 차이가 있고 연결이 맺어진 이후에는 기능상 차이가 없다. 서버 TCPGW는 TCPGW에서 기다리고 있으면 리모트 노드에서 연결하게 된다. 서버 TCPGW는 리모트 노드와 Tmax 클라이언트 어디서든지 서비스를 요청할 수 있다.

다음은 서버 TCPGW의 동작 구조이다.

클라이언트 TCPGW는 리모트 노드에서 기다리고 있는 포트로 연결을 맺으면서 기동된다. 서버 TCPGW는 리모트 노드와 Tmax 클라이언트 어디서든지 서비스를 요청할 수 있다.

다음은 클라이언트 TCPGW의 동작 구조이다.

TCPGW는 Tmax 클라이언트나 서버에서 호출할 때 게이트웨이 헤더를 사용할 수 있다. 게이트웨이 헤더를 사용하기 위해서는 TCPGW의 다른 라이브러리를 사용해야 한다. 보통은 libtcpgw.a, libtcpgw.so를 사용하고, 게이트웨이 헤더를 사용할 경우에는 libtcpgw.gwh.a나 libtcpgw.gwh.so를 사용해야 한다. 게이트웨이 헤더는 모든 데이터 버퍼의 가장 처음 Offset에 위치해야 한다. 즉, 사용자 헤더를 사용할 경우에 게이트웨이 헤더 다음에 사용자 헤더가 위치해야 한다.

게이트웨이 헤더는 여러 가지 다양한 목적으로 사용하는데, TCPGW에서는 여러 항목 중에서 svc 항목만 사용 가능하다. 이 항목은 NON 블로킹 모드로 사용하거나 비동기 방식으로 사용할 때 응답 데이터에 대해 처리할 서비스명을 지정하고자 하는 경우에 사용한다. 게이트웨이 헤더는 보통 사용자 헤더를 사용하지 않을 경우에 응답을 처리할 서비스를 메시지별로 처리할 경우에 사용한다.

TCPGW는 응답을 처리할 서비스를 찾는 순서는 다음과 같고 지정한 순서대로 찾는다.

일반적인 TCPGW 처리 방식은 한 번의 요청에 대해서 하나의 응답을 받는 형태이다. 경우에 따라서 여러 번의 응답이 올 수 있는데 이를 처리하기 위해서 TCPGW는 custom.c의 get_msg_info 함수의 호출을 통해서 이를 처리한다. 여러 번의 응답이 오는 경우에 매번 get_msg_info 함수가 호출되는데, 사용자는 수신받은 데이터가 마지막 데이터인지를 판단하여 적절한 값을 반환한다.

연속 데이터인 경우에 반환값으로 3을 반환하면, TCPGW는 다음 데이터가 있다고 판단하여 서비스를 요청한 클라이언트나 서비스에 응답을 하지 않고 다음 데이터를 기다린다. 사용자는 마지막 데이터를 수신한 경우에 REPLY 값(1)를 반환하면, TCPGW는 이전에 저장한 데이터와 마지막 데이터를 서비스를 요청한 클라이언트나 서비스에 돌려준다.

NON 블록형 TCPGW나 또는 비동기형 TCPGW인 경우 리모트 노드에서 온 요청이나 응답을 처리할 Tmax의 서비스가 있어야 한다. TCPGW는 이 서비스명을 알수가 없으므로 사용자가 적당한 서비스명을 지정해야 하는데 TCPGW는 3가지 방식으로 서비스명을 찾는다.

다음에서 설명하는 서비스명은 반드시 Tmax 설정 파일에 등록되어 있어야 한다.

완전한 비동기 방식으로 TCPGW를 구성한 경우에 사용자는 리모트 노드로 전송할 채널을 지정할 수있다. CLOPT 절에 [-a]를 사용한다. 완전한 비동기 방식은 서로 간에 응답이 없다. 응답 데이터도 서비스 요청 형식으로 전달되어야 한다.

예를 들어 Tmax의 클라이언트나 서비스에서 TCPGW로 tpacall에 TPNOREPLY로 호출하면 TCPGW는 서비스 요청에 대한 UID와 어떤 정보 데이터도 보관하지 않고 리모트 노드로 데이터를 전송하고 해당 서비스를 종료한다. 나중에 리모트 노드로부터 응답에 대한 메시지를 수신받았을 경우에도 이를 서비스 요청으로 처리한다. 반대인 경우(리모트 노드에서 먼저 요청)에도 동일하게 처리한다.

위와 같은 경우에 사용자는 CLOPT 절에 [-u] 옵션을 사용해서 리모트 노드로 전송할 채널번호를 지정할 수 있다. 채널 지정은 다음과 같은 2가지 경우가 있다.

TCPGW가 실행되는 머신는 모두 ASCII 코드(한글은 완성형)를 사용한다. 리모트 노드는 사용하는 코드가 다른 머신에 있어 이들과 메시지를 주고받기 위해서는 코드를 일치시켜야 한다. 이러한 코드 변환은 리모트에서 할 수도 있고, 아니면 TCPGW에서 할 수도 있다.

TCPGW는 모든 코드를 변환하지 않고 ASCII ↔ EBCDIC, 조합형 ↔ 완성형 코드만을 서로 변환한다. TCPGW에서 리모트 노드로 메시지를 전송하는 경우에는 ASCII에서 EBCDIC로 완성형에서 조합형으로 코드를 변환한다. 리모트에서 수신하는 경우에는 EBCDIC에서 ASCII로 조합형에서 완성형으로 코드를 변환한다.

TCPGW는 코드 변환을 서비스 처리 단위별로 변환한다. TCPGW는 서비스 단위별로 송수신 포맷을 등록(Map 파일)하여 변환한다. 사용자는 TCPGW와 리모트 노드 간에 코드를 변환하려면 모든 서비스에 대해서 Map 파일을 등록해야 한다.

또한 TCPGW에서 코드 변환 기능을 이용하려면 반드시 게이트웨이 헤더를 사용해야만 한다. 리모트로 전송하는 서비스에 대해서 TCPGW는 서비스명을 알 수가 없으므로 게이트웨이 헤더를 사용하여 TCPGW에 리모트 서비스명을 전달해야 하기 때문이다. 게이트웨이 헤더 중 pgmname 항목에 리모트 서비스명을 설정하고, TCPGW는 이 항목의 값으로 Map 파일을 로드하여 코드를 변환한다.

TCPGW는 Tmax 클라이언트나 서비스에서 리모트로 서비스를 요청할 경우에는 게이트웨이 헤더의 pgmname 항목의 값으로 Map 파일을 로드하고, 리모트 노드에서 Tmax로 서비스를 요청하는 경우에는 get_msg_info 함수에서 지정한 서비스명으로 Map 파일을 로드한다.

사용자가 Map 파일을 등록하는 방법에 대해서 설명한다. Map 파일은 사용자가 텍스트 파일로 지정한 형식에 맞게 등록해주면 된다.

# COMMSIZE는 INPUT/OUTPUT에서 같이 사용해야 함으로 INPUT/OUTPUT 중
# 큰 size의 값을 입력해야 한다.
*COMMSIZE
1024

*INPUT
#---------------------------------------------------------------
# item-name  length  data-type
# data-type: CHAR, NUMERIC(UNPACK), KOREAN, BINARY, USER-TYPE
#---------------------------------------------------------------
  a            10       CHAR
  b            10       KOREAN
  c             5       NUMERIC
  d            10       BINARY

*OUTPUT
  a            10       CHAR
  b            10       KOREAN
  c             5       NUMERIC
  d            10       BINARY
  e             3       USER1
  e1            6       CHAR
  e2           10       KOREAN
  e3            8       BINARY

위의 Map 파일에서 USER1은 사용자가 지정한 사용자 정의 타입이다. 타입 이름은 사용자가 임의로 지정하면 된다. 사용자 정의 타입의 데이터는 Array 데이터의 반복을 나타내는 항목이므로 반드시 숫자로 이루어져야 한다. TCPGW는 사용자 정의 타입을 만나면 이를 Array의 횟수로 인식한다.

Array의 끝은 마지막 항목의 이름을 슬래시(/)로 시작하면 된다. 위의 경우에는 e1, e2, e3을 Array 항목으로 인식해서 e 항목으로 지정한 횟수만큼 코드를 변환한다.