Tmax Gateway Guide (Serial)Serial).pdf · 2019-04-09 · SERIAL 게이트웨이에서 사용하는 API 함수에 대해 기술한다. 제4장: 예제 SERIAL 게이트웨이의 각

Tmax

Gateway Guide (Serial)

Tmax v5.0 SP1

Copyright © 2009 TmaxSoft Co., Ltd. All Rights Reserved.

Copyright Notice

Copyright © 2009 TmaxSoft Co., Ltd. All Rights Reserved.

대한민국 경기도 성남시 분당구 서현동 263 분당스퀘어(AK프라자) 12층

Restricted Rights Legend

All TmaxSoft Software (Tmax®) and documents are protected by copyright laws and the Protection Act of Com

puter Programs, and international convention. TmaxSoft software and documents are made available under the

terms of the TmaxSoft License Agreement and may only be used or copied in accordance with the terms of this

agreement. No part of this document may be transmitted, copied, deployed, or reproduced in any form or by any

means, electronic, mechanical, or optical, without the prior written consent of TmaxSoft Co., Ltd.

이 소프트웨어(Tmax®) 사용설명서의 내용과 프로그램은 저작권법, 컴퓨터프로그램보호법 및 국제 조약에 의해

서 보호받고 있습니다. 사용설명서의 내용과 여기에 설명된 프로그램은 TmaxSoft Co., Ltd.와의 사용권 계약 하에

서만 사용이 가능하며, 사용권 계약을 준수하는 경우에만 사용 또는 복제할 수 있습니다. 이 사용설명서의 전부 또

는 일부분을 TmaxSoft의 사전 서면 동의 없이 전자, 기계, 녹음 등의 수단을 사용하여 전송, 복제, 배포, 2차적 저

작물작성 등의 행위를 하여서는 안 됩니다.

Trademarks

Tmax®, Tmax WebtoB® and JEUS® are registered trademark of TmaxSoft Co., Ltd. Other products, titles or

services may be registered trademarks of their respective companies.

Tmax®, Tmax WebtoB® 와 JEUS®는 TmaxSoft Co., Ltd.의 등록 상표입니다. 기타 모든 제품들과 회사 이름은 각

각 해당 소유주의 상표로서 참조용으로만 사용됩니다.

Open Source Software Notice

This product includes various open source software that has been developed and/or licensed by “OpenSSL”, “RSA

Data Security, Inc.”, “Apache Foundation”, or “Jean-loup Gailly and Mark Adler.” TmaxSoft fully respects the

aforementioned parties and the open source software used in this product. More details can be found within the

directory “${INSTALL_PATH}/license/oss_licenses”

본 제품은 “OpenSSL”, “RSA Data Security, Inc.”, “Apache Foundation” 및 “Jean-loup Gailly와 Mark Adler”에 의

해 개발 또는 라이선스된 오픈 소스 소프트웨어를 포함합니다. 오픈 소스 소프트웨어와 개발자에 대해 경의를 표

합니다. 관련 상세 정보는 제품의 디렉터리 “${INSTALL_PATH}/license/oss_licenses”에 기재된 사항을 참고해 주

십시오.

안내서 정보

안내서 제목: Tmax Gateway Guide (Serial)

발행일: 2009-08-10

소프트웨어 버전: Tmax v5.0 SP1

안내서 버전: v2.1.1

내용 목차

안내서에 대하여 .......................................................................................................................... vii

제1장 소개 ................................................................................................................................. 1

1.1. 개요 ............................................................................................................................ 1

1.2. 서비스의 유형 .............................................................................................................. 2

1.2.1. Tmax에서 서비스 요청 ....................................................................................... 3

1.2.2. 리모트 노드에서 서비스 요청 .............................................................................. 5

제2장 환경 설정 .......................................................................................................................... 7

2.1. Tmax 환경 구성 ............................................................................................................ 7

2.1.1. SERIAL 게이트웨이 사용 옵션 ............................................................................ 8

2.1.2. ACK/NAK 응답 SRLGW 환경파일 ....................................................................... 9

2.1.3. 지연처리 SRLGW 환경파일 ................................................................................ 9

2.2. SERIAL 게이트웨이 환경파일 ...................................................................................... 10

2.2.1. 포트 정보 환경파일 .......................................................................................... 10

제3장 COM 라이브러리 ............................................................................................................. 13

3.1. ComOpen .................................................................................................................. 13

3.2. ComDetach ................................................................................................................ 14

3.3. ComClose .................................................................................................................. 14

3.4. ComSend .................................................................................................................. 15

3.5. ComRecv ................................................................................................................... 15

제4장 예제 ................................................................................................................................ 17

4.1. NOREPLY 서비스 호출 ............................................................................................... 17

4.1.1. 프로그램 구성 .................................................................................................. 17

4.2. REPLY 서비스 호출 .................................................................................................... 21

4.2.1. 프로그램 구성 .................................................................................................. 21

4.3. 리모트 노드 동기형 호출 ............................................................................................. 26

4.3.1. 프로그램 구성 .................................................................................................. 26

4.4. ACK/NAK 통신 방식 ................................................................................................... 29

4.4.1. 프로그램 구성 .................................................................................................. 29

Appendix A. 헤더 파일 ............................................................................................................. 33

A.1. COMMHEAD 파일 ..................................................................................................... 33

Tmax iii

그림 목차

[그림 1.1] SRLGW 동작 구조 ....................................................................................................... 1

[그림 1.2] Tmax NOREPLY 서비스 요청 SRLGW .......................................................................... 3

[그림 1.3] Tmax REPLY 서비스 요청 SRLGW ............................................................................... 4

[그림 1.4] 리모트 동기형 요청 SRLGW ......................................................................................... 5

[그림 1.5] 리모트 비동기형 요청 SRLGW ...................................................................................... 6

Tmax v

안내서에 대하여

안내서의 대상

본 안내서는 Tmax®(이하 Tmax) SERIAL 게이트웨이를 사용하여 개발하는 개발자를 대상으로 한다. 본

안내서는 Tmax 서버와 Non Tmax 서버가 Serial 통신을 하는 경우 인터페이스를 담당하는 Tmax에서 제

공되는 SERIAL(RS232) 게이트웨이에 대해 기술한 안내서이다.

안내서의 전제 조건

본 안내서는 Tmax 시스템에 대한 전반적인 이해와 Tmax 시스템이 제공하는 각종 기능 및 특성에 대한 습

득을 위한 기본서이다.

본 안내서를 원활하게 이해하기 위해서는 다음과 같은 사항을 미리 알고 있어야 한다.

● 미들웨어(Middleware) 및 UNIX 시스템에 대한 이해

● Tmax의 기본 개념 이해

● Java , C 프로그래밍의 이해

안내서의 제한 조건

본 안내서를 읽기 전에 Tmax의 기본 개념을 숙지하고 있어야 한다. 실무에서의 구체적인 사용방법이나

관리 및 운용에 관한 사항은 각 제품의 안내서를 참고한다.

참고

Tmax 시스템 개발에 대한 기본적인 내용은 "Tmax Administration Guide"나 "Tmax Application Devel

oment Guide"를 참고한다. Tmax에서 제공하는 명령어와 C API에 대한 설명은 “Tmax Reference

Guide”를 참고한다.

안내서에 대하여 vii

안내서 구성

Tmax Gateway Guide (Serial)는 총 4개의 장과 Appendix로 구성되어 있다.

각 장의 주요 내용은 다음과 같다.

● 제1장: 소개

시스템의 개요 및 서비스 유형에 대해 기술한다.

● 제2장: 환경 설정

SERIAL 게이트웨이의 환경 구성과 환경 파일 구성에 대해 기술한다.

● 제3장: COM 라이브러리

SERIAL 게이트웨이에서 사용하는 API 함수에 대해 기술한다.

● 제4장: 예제

SERIAL 게이트웨이의 각 역할에 대한 예제에 대해 기술한다.

● Appendix A.: 헤더 파일

COMMHEAD 파일에 대해 기술한다.

viii Tmax Gateway Guide (Serial)

안내서 규약

의미표기

프로그램 소스 코드의 파일명<AaBbCc123>

Ctrl과 C를 동시에 누름<Ctrl>+C

GUI의 버튼 또는 메뉴 이름[Button]

강조진하게

다른 관련 안내서 또는 안내서 내의 다른 장 및 절 언급" "(따옴표)

화면 UI에서 입력 항목에 대한 설명'입력항목'

메일계정, 웹 사이트하이퍼링크

메뉴의 진행 순서>

하위 디렉터리 또는 파일 있음+----

하위 디렉터리 또는 파일 없음|----

참고 또는 주의사항참고

그림 이름[그림 1.1]

표 이름[표 1.1]

명령어, 명령어 수행 후 화면에 출력된 결과물, 예제코드AaBbCc123

옵션 인수 값[ ]

선택 인수 값|

안내서에 대하여 ix

시스템 사용 환경

요구 사항

IBM AIX 5.xPlatform

HP-UX 11.xx

Solaris 7~9 (SunOS 5.7~5.9)

최소 120MB 하드디스크 공간Hardware

256MB 이상 메모리 공간

1GB 이상 하드디스크와 512MB 이상 메모리 공간 권장

Oracle 9i 또는 10gDatabase

x Tmax Gateway Guide (Serial)

관련 안내서

설명안내서

Tmax를 이용하기 위한 환경설정을 하는 방법과 시스템 운영방식을

기술한 안내서이다.

Tmax

Administration Guide

안내서에 대하여 xi

연락처

Korea

TmaxSoft Co., Ltd

263 BundangSquare (AK Plaza) 12th floor, Seohyeon-dong, Bundang-gu,

Seongnam-si, Gyeonggi-do, 463-824

South Korea

Tel: +82-31-8018-1000

Fax: +82-31-8018-1115

Email: [email protected]

Web (Korean): http://www.tmax.co.kr

기술지원: http://technet.tmaxsoft.com

USA

TmaxSoft, Inc.

560 Sylvan Avenue Englewood Cliffs, NJ 07632

U.S.A

Tel: 1-201-567-8266

Fax: 1-201-567-7339


Web (English): http://www.tmaxsoft.com

Japan

TmaxSoft Japan Co., Ltd.

5F Sanko Bldg, 3-12-16 Mita, Minato-Ku, Tokyo, 108-0073

Japan

Tel: +81-3-5765-2550

Fax: +81-3-5765-2567


Web (Japanese): http://www.tmaxsoft.co.jp

xii Tmax Gateway Guide (Serial)

http://www.tmax.co.kr

http://technet.tmaxsoft.com

http://www.tmaxsoft.com

http://www.tmaxsoft.co.jp

China

TmaxSoft China Co., Ltd.

Beijing Silver Tower, RM 1508, 2# North Rd Dong San Huan,

Chaoyang District, Beijing, China, 100027

China

Tel: +86-10-6410-6145~8

Fax: +86-10-6410-6144


Web (Chinese): http://www.tmaxsoft.com.cn

ASEAN Office

TmaxSoft Pte. Ltd.

30 Cecil Street, Level 15 Unit 05 Prudential Tower, Singapore 049712

Singapore

Tel: +65-6232-2889

Fax: +65-6232-2919


Web (English): http://asean.tmaxsoft.com

안내서에 대하여 xiii

http://www.tmaxchina.com.cn

http://www.tmaxchina.com.cn

제1장 소개

1.1. 개요SERIAL(RS232) 게이트웨이(이하 SRLGW)는 Tmax 서버와 Non Tmax 서버(이하 리모트 노드)간의 Serial

통신시 인터페이스를 담당하는 Tmax에서 제공되는 게이트웨이이다.

SRLGW는 크게 2개의 모듈로 나누어졌는데, 하나는 Tmax에서 리모트 노드와 Serial로 송수신하는 부분

이고, 나머지는 리모트 노드에서 Tmax의 SRLGW와 통신을 담당하는 COM 라이브러리로 분리되어 있다.

2개의 모듈을 이용하여 Tmax 시스템과 NON Tmax 시스템 사이에 Serial로 통신할 수 있도록 제공하는 모

듈이 SERIAL 게이트웨이이다.

Tmax에 설치되는 SRLGW는 Tmax 서버의 한 종류로서 Tmax 환경파일에 서버로 등록해야만 사용할 수

있다. 하지만 일반 다른 서버들을 만드는 방식과는 다르게 생성해 주어야 한다. 일반 서버는 TCS나 UCS

용 서버 라이브러리를 이용하여 서버를 생성하나 SRLGW는 이미 사용자가 직접 사용할 수 있도록 실행

가능한 파일로 제공함으로 사용자는 SRLGW를 Tmax Config 파일에 서버로 등록만 해주면 된다.

SRLGW는 NON Tmax에서 보내온 메시지를 받아서 사용자가 요청한 서비스로 tpacall()하며, 서비스 결

과는 처음 요청한 NON Tmax 서버로 전송한다. 반대로 Tmax 서비스에서 SRLGW를 tpcall()이나 기타 다

른 방식으로 서비스를 요청하면 SRLGW는 NON Tmax로 요청 메시지를 보낸 후 응답이 오면 자신을 call

한 서비스로 tpreturn()한다.

복잡하게 타 시스템과 Serial로 연결하기 위해 필요한 작업들, 예를 들어 포트를 열고 메시지를 주고 받는

일 등은 모두 SERIAL 게이트웨이와 COM 라이브러리에서 처리하므로 개발자는 업무 로직만을 작성하여

손쉽게 타 시스템과 연결할 수 있다. SRLGW의 대략적인 동작 구조는 다음과 같다.

[그림 1.1] SRLGW 동작 구조

제1장 소개 1

SRLGW는 위의 그림에서 보듯이 리모트 노드로부터 서비스 요청을 받아서 처리할 수 있고([그림 1.1]에

서 실선 표시), Tmax 클라이언트나 서비스로부터 서비스 요청을 받아서 리모트 노드로 서비스 요청을 할

수도 있다.([그림 1.1]에서 점선 표시)

이와같이 리모트 노드로 부터 서비스 요청을 받아서 처리하는 것을 OUTBOUND 서비스라 하고, Tmax 클

라이언트로부터 서비스 요청을 받아서 리모트 노드로 서비스 요청을 하는 것을 INBOUND 서비스라 한다.

또한, SRLGW 사용자는 Serial통신에 관련된 프로그램을 작성하지 않아도 SRLGW와 Serial로 통신할 수

있도록 Serial 통신 라이브러리(이하 COM 라이브러리)를 제공한다.

사용자는 이 라이브러리를 이용하여 편리하게 SRLGW와 서비스를 받을 수 도 있고, 서비스를 요청할 수

도 있다. 이렇게 Tmax의 SRLGW와 리모트 노드의 Serial 통신 라이브러리를 이용하여 사용자는 양방향

의 서비스를 이용할 수 있다.

OUTBOUND인 경우에는 리모트에서 Tmax의 서비스명을 이용하여 서비스를 호출하고, INBOUND인 경

우에는 Tmax의 클라이언트나 서비스에서 SRLGW에 등록된 서비스명을 이용하여 리모트 노드로 서비스

를 요청 할 수 있다.

1.2. 서비스의 유형SRLGW는 리모트 노드와 Serial로 통신을 하며, Tmax 클라이언트의 요청을 리모트 노드로 보내기도 하

고 리모트 노드의 요청을 Tmax 서비스에서 처리하도록 중간역할을 해 준다. 리모트 노드에서 사용하는

COM 라이브러리 부분에 대한 설명은 “제3장 COM 라이브러리” 에서 설명하고, 본 장에서는 Tmax에 설

치되는 부분에서 제공하는 서비스 유형에 대해서만 설명한다.

SRLGW는 크게 동작하는 방식은 Tmax의 서비스나 클라이언트에서 리모트 노드로 서비스를 요청하는 방

식과 반대로 리모트 노드에서 Tmax의 서비스를 호출하는 방식으로 나눌 수 있다.

SRLGW는 TCP/IP처럼 서버와 클라이언트 모드로 구분되지 않기 때문에 리모트 노드와 Serial로 연결만

되면 어느쪽에서도 먼저 서비스를 요청할 수 있다.

SRLGW는 Tmax에서 리모트 노드로 요청하는 방식은 비동기형 방식으로 처리한다. 즉, 서비스나 클라이

언트에서 리모트로 서비스를 tpcall로 요청하더라도 SRLGW는 리모트로 서비스 요청을 보내고 서비스나

클라이언트에게 곧바로 정상 응답을 반환한다. 나중에 리모트 노드에서 서비스 요청에 대한 응답일지라

도 새로운 서비스 요청으로 간주한다. 그러므로 Tmax에서 요청하는 모든 서비스는 비동기형 방식으로 동

작한다.

반대로 리모트 노드에서 Tmax의 서비스를 요청하는 경우에는 비동기형, 동기형 모두 사용할 수 있다. 비

동기형은 COM 라이브러리를 이용하여 SRLGW에 서비스를 요청시 flags에 COMMNOREPLY를 주면

SRLGW는 Tmax에 사용자가 요청한 서비스를 호출만하고 응답은 받지 않는다.

동기형 방식은 COM 라이브러리를 이용하여 SRLGW에 서비스를 요청시 flags에 COMMNOREPLY를 주

지않고 요청하면 SRLGW는 Tmax에 사용자가 요청한 서비스를 호출하고 응답을 받으면 서비스를 요청한

리모트 노드에 응답을 전송한다.

또한 리모트 노드에서 Tmax에 서비스 요청시 지연처리 방식을 지원한다. flags에 COMMDELAY를 주면

SRLGW는 나중에 사용자가 RQ의 데이터를 일괄적으로 처리할 수 있도록 RQ에 요청 데이터를 저장한다.

지연처리는 항상 비동기형 방식으로 처리한다.

2 Tmax Gateway Guide (Serial)

1.2.1. Tmax에서 서비스 요청

Tmax의 클라이언트에서 먼저 리모트 노드로 서비스를 요청하는 경우이다. 리모트 노드로 서비스 요청을

보내고 응답을 받지 않는 경우와, 서비스 요청을 보내고 해당 응답을 새로운 요청으로 처리하는 2가지 방

식으로 구분할 수 있다. SRLGW는 지정된 리모트 노드로만 서비스를 요청할 수 있으므로 사용자는 서비

스 요청을 하고자하는 리모트 노드를 알고있어야 한다. 이를 위해서 Tmax Config 파일에 서비스명을 등

록하고, 해당 서비스명을 SRLGW Config 파일의 리모트 노드별 정보에 등록해 주어야 한다. SRLGW는

서비스 요청을 받으면 요청한 서비스명으로 리모트 노드를 찾아서 해당 리모트 노드에 데이터를 전송한

다.

NOREPLY 서비스 호출

NOREPLY 서비스 호출 방식은 Tmax의 서비스나 클라이언트에서 SRLGW로 tpcall로 서비스를 요청하고

결과에 관계없이 처리하는 방식이다. 아래 그림은 Tmax 클라이언트의 요청을 받은 서비스에서 SRLGW

로 서비스로 tpcall을 하면 SRLGW는 리모트 노드로 서비스를 요청하고, 리모트 노드의 결과에 관계없이

곧바로 반환한다.

[그림 1.2] Tmax NOREPLY 서비스 요청 SRLGW

NOREPLY 서비스 호출 동작 방식은 다음과 같다.

1. SRLGW와 리모트 노드는 연결되어 있는 상태이다.

2. Tmax 클라이언트는 Tmax 서비스를 tpcall한다.

3. Tmax 서비스에서는 클라이언트의 요청을 받아들여 SRLGW로 서비스를 tpcall한다. 사용자는 SRLGW

에는 많은 서비스가 등록되어 있으므로 사용자가 요청하고자 하는 리모트 노드와 연결된 Serial 포트의

서비스명을 지정해야 한다.

4. SRLGW는 사용자가 지정한 서비스와 연결된 리모트 노드에 서비스를 요청한다.

제1장 소개 3

5. SRLGW는 서비스를 요청한 서비스에 정상 응답을 tpreturn한다.

이와 같은 방식으로 SRLGW를 동작시키게 되면 Tmax 클라이언트에서 호출한 Tmax 서비스는 SRLGW

를 호출한 후에 결과에 관계없이 계속 처리하게 된다.

REPLY 서비스 호출

REPLY 서비스 호출 방식은 최초에 서비스를 요청하는 Tmax의 서비스나 클라이언트는 SRLGW로 tpcall

로 서비스를 요청하고 결과에 관계없이 처리한다. 리모트 노드는 해당 요청 서비스를 처리하고 결과를

Tmax의 새로운 서비스를 호출하는 방식이다.

아래 그림은 Tmax 클라이언트의 요청을 받은 서비스에서 SRLGW로 서비스로 tpcall을 하면 SRLGW는

리모트 노드로 서비스를 요청하고, 리모트 노드의 결과에 관계없이 곧바로 반환한다. 리모트 노드는 처리

결과를 가지고 Tmax의 새로운 서비스를 호출한다. 새로운 서비스 호출시에는 Tmax의 서비스 처리 결과

를 받을 수도 있고 받지 않을 수도 있다. ComSend 함수의 flags에 설정하는 값에 따라 응답을 받을 수도

있고 받지않을 수도 있다. 아래 그림은 서비스처리 결과를 받지 않은 경우이다.

[그림 1.3] Tmax REPLY 서비스 요청 SRLGW

REPLY 서비스 호출 동작 방식은 다음과 같다.


2. Tmax 클라이언트는 Tmax 서비스를 tpcall한다.

3. Tmax 서비스에서는 클라이언트의 요청을 받아들여 SRLGW로 서비스를 tpcall한다. 사용자는 SRLGW

에는 많은 서비스가 등록되어 있으므로 사용자가 요청하고자 하는 리모트 노드와 연결된 Serial 포트의

서비스명을 지정해야 한다.

4. SRLGW는 사용자가 지정한 서비스와 연결된 리모트 노드에 서비스를 요청한다.


5. SRLGW는 서비스를 요청한 서비스에 정상 응답을 tpreturn한다.

6. 리모트 노드에서 결과에 대한 새로운 서비스 요청을 받는다.

7. SRLGW는 Tmax에 사용자가 지정한 서비스를 호출한다.

이와 같은 방식은 최초에 서비스를 호출하는 서비스와 결과를 처리하는 서비스를 분리하는데 사용하는

경우이다.

1.2.2. 리모트 노드에서 서비스 요청

리모트 노드에서 Tmax의 서비스를 호출하는 것으로 이 방식은 동기형 방식과 비동기형 방식으로 나눌 수

있다. 동기형은 서비스를 요청하고 응답을 기다리는 방식이고, 비동기형은 서비스를 요청하고 응답을 기

다리지 않는 방식이다. 그러나 동기형 방식중에 서비스를 요청하고 응답을 받기전에 다른 서비스 요청이

해당 리모트 노드로 전송될 수 있으므로 이에 대한 처리를 적절히 수행해야 한다.

리모트 동기형 호출 방식

리모트 동기형 호출 방식은 리모트 노드에서 SRLGW로 먼저 서비스를 요청하고 응답을 기다리는 방식이

다. SRLGW는 리모트 노드에서 요청한 서비스를 호출하고 그 결과를 받아서 해당 서비스를 요청한 채널

로 결과를 전송한다. 리모트 노드는 동시에 SRLGW로 Tmax Config에 정의되어 있는 MAXSACALL 개수

를 초과하여 호출할 수 없다. 리모트 노드의 사용자는 COM 라이브러리를 이용하여 SRLGW로 서비스를

호출하고 응답을 받는다. 리모트 노드의 사용자는 ComSend시 flags에 아무것도 설정하지 않아야 한다.

[그림 1.4] 리모트 동기형 요청 SRLGW

리모트 동기형 호출 동작 방식은 다음과 같다.


2. 리모트 노드는 SRLGW와 연결된 채널로 메시지를 전송한다.

3. SRLGW는 tpacall()로 Tmax 서비스를 호출한다.

4. 서비스 처리 결과를 SRLGW는 받아서 메시지를 요청한 채널을 찾는다.

제1장 소개 5

5. 해당 채널이 정상적으로 연결되어 있으면 결과를 전송한다.

이와 같은 동작 방식은 리모트 노드에서 Tmax의 서비스를 호출하는 가장 보편적인 방식이다. SRLGW는

리모트 노드의 채널 정보를 보관하였다가 서비스로 부터 결과를 수신받으면, 보관하고 있는 채널중에서

해당 채널을 찾아서 결과를 전송한다. 이때 해당 채널로 결과를 되돌려 주기전에 다른 요청을 할 수 있다.

즉, SRLGW는 리모트 노드에서 요청한 채널은 블록되지않으므로 요청에 대한 응답이 리모트 노드로 전

송되기 전에 다른 요청 서비스가 리모트 노드로 전송될 수 있으므로 이에 대한 처리를 해야 한다.

리모트 비동기형 호출 방식

리모트 비동기형 호출 방식은 리모트 노드에서 SRLGW로 먼저 서비스를 요청하고 응답을 기다리지 않는

방식이다. SRLGW는 리모트 노드에서 요청한 서비스를 호출하고 그 결과는 받지 않는다. 이런 방식으로

처리하기 위해서 리모트 노드에서는 ComSend시 flags에 COMMNOREPLY를 설정해야 한다. COMM

NOREPLY가 설정되어 있으면 SRLGW는 Tmax에 서비스를 요청만하고 응답은 받지 않도록 처리하다.

[그림 1.5] 리모트 비동기형 요청 SRLGW

리모트 비동기형 호출 동작 방식은 다음과 같다.


2. 리모트 노드는 SRLGW와 연결된 채널로 메시지를 전송한다.

3. SRLGW는 tpacall()로 Tmax 서비스를 호출한다.


제2장 환경 설정

SRLGW 서버를 구성하려면 다음과 같은 파일들이 존재하여야 한다.

다음은 UNIX에서 사용되는 환경파일이다.

파일명디렉터리

tmaxcom.a, tmaxcom.soLib

tmaxcom.a, tmaxcom.soLib64

serialgwappbin

다음은 Windows에서 사용되는 환경파일이다.

파일명디렉터리

tmaxcom.lib, tmaxcom.dllLib

serialgw.exebin

위의 파일(SRLGW와 라이브러리)들은 Tmax SRLGW 설치에 각 디렉터리 아래에 만들어진다. 단, 현재

Windows 시스템에 대해서만 SRLGW가 수행되므로 UNIX 사용자을 위해서는 다음 버전에서 지원할 예정

이다.

2.1. Tmax 환경 구성SRLGW를 사용하기 위해서는 Tmax 환경파일에 SRLGW를 서버로 등록해야 한다. Tmax 서버 중 UCS형

서버와 등록 방법이 비슷한데, 차이점은 SVRTYPE이 UCS에서 CUSTOM_GATEWAY라는 차이밖에 없

다.

등록하는 방법은 아래와 같다.

*DOMAIN

tmax SHMKEY = 88000, MINCLH = 1, MAXCLH=1, TPORTNO=8800

*NODE

tmax1 TMAXDIR=”/home/tmax”,

APPDIR=”/home/tmax/appbin”

*SVRGROUP

svg1 NODENAME=tmax1

*SERVER

제2장 환경 설정 7

serialgw SVGNAME=svg1, MIN=1, MAX=1, CPC=10,

SVRTYPE=CUSTOM_GATEWAY,

CLOPT=”-- -F /home/tmax/config/serlal.cfg -w 5050”

*SERVICE

COM1 SVRNAME= serialgw


SRLGW를 사용하기 위해 Tmax 환경파일을 수정할 때는 SERVER, SERVICE 절만 적절히 설정하면 된

다.

설명항목

SRLGW의 프로세스 개수를 지정하는 항목으로서 값은 항상 1로 지정해야 한다.MIN

CPC 항목은 Tmax 엔진과 SRLGW간의 채널 수를 지정하는 항목으로서, Tmax의 클라이

언트나 서비스에서 리모트 노드로 요청하는 경우에는 동시에 요청하는 수만큼 CPC 수

CPC

를 지정해야 한다. 반대인 경우에는 SRLGW는 Tmax 엔진으로 tpacall로 요청하므로 많

은 채널을 사용할 필요는 없다.

“2.1.1. SERIAL 게이트웨이 사용 옵션” 내용을 참고한다.CLOPT

SRLGW는 리모트 노드로 요청한 서비스에 대해서 서비스 타임 아웃을 적용하지 않는다.

왜냐하면 리모트 노드로 서비스 요청만하고 응답은 별도의 서비스로 처리하므로 SRLGW

에서는 서비스 타임 아웃을 적용하지 않는다.

SVCTIME

2.1.1. SERIAL 게이트웨이 사용 옵션

SRLGW는 Tmax config 파일에 등록할 수 있는 항목이 제한되어 있는 관계로 CLOPT 항목에 몇 가지 옵

션을 설정해야 한다. 아래에 설명하는 옵션에 따라서 SRLGW이 동작 방식이 다르므로 아래의 설명을 정

확히 이해해야 한다.

다음은 SERIAL 게이트웨이 옵션에 대한 설명이다.

설명옵션

SRLGW에서 사용할 Serial 포트에 대한 정보 및 리모트 노드를 찾는 서비스명이 등록된

파일을 지정하는 항목이다. SRLGW는 이 옵션에 지정한 파일의 정보를 로드하여 리모트

F

의 노드와 연결한다. 또한 Tmax의 서비스나 클라이언트에서 리모트 노드로 서비스 요청

시 요청한 서비스명으로 리모트 노드를 찾고자 하는 경우에도 사용한다. 파일의 등록 방

법은 “2.2. SERIAL 게이트웨이 환경파일” 설명을 참고한다.

SRLGW는 내부적으로 하나의 포트에 대해서 하나의 스레드가 처리하는 구조로 되어있

다. 각각의 포트 담당 스레드에서 메인 스레드로 데이터를 전달하기 위해서 하나의 소켓

을 사용하는데, 이때 사용할 포트번호를 지정하는 항목이다. (기본값 포트번호: 8880).

w

리모트 노드에서 Tmax의 서비스를 요청시 지연처리 방식으로 사용할 수 있다. 즉, Tmax

에서 제공하는 RQ에 임시 데이터를 보관한 후에 나중에 일괄적으로 처리하는 방식으로

SQLGW를 사용할 수 있는데 이때 사용할 RQ 이름을 등록하는 옵션이다.

q


설명옵션

SRLGW와 리모트 노드간 송수신 데이터에 대해서 ACK/NAK 메시지를 주고받을 것인지

를 지정하는 옵션이다. 이 옵션을 지정하면 송수신 데이터에 대해서 ACK/NAK를 주고 받

A

는다. Tmax의 SRLGW는 내부적으로 ACK/NAK 메시지를 처리하나 리모트 노드의 COM

라이브러리에서는 ACK/NAK를 처리하지 않으므로 사용자쪽 프로그램에서 이에 대한 처

리 부분이 있어야 한다. (기본값: ACK/NAK 주고 받지 않음)

리모트로부터 ACK를 수신받을 Waiting 시간을 지정하는 옵션이다. 이 시간내에 ACK/NAK

메시지가 없으면 ACK 메시지를 받은 것으로 간주한다. (기본값: 무한)

t

2.1.2. ACK/NAK 응답 SRLGW 환경파일

ACK/NAK 메시지를 받을 경우의 SRLGW 환경 설정은 아래와 같다.

*DOMAIN

...

*NODE

...

*SVRGROUP

...

*SERVER



CLOPT=”-- -F /home/tmax/config/serlal.cfg –w 5555 –A ”

*SERVICE

COM1 SVRNAME=serialgw

위와 같이 환경파일을 작성한 경우 serialgw라는 이름의 SRLGW는 1개가 Tmax boot시에 기동된다. seri

algw의 서비스명은 COM1이다. SRLGW는 리모트 노드와 데이터 송수신시 ACK/NAK 메시지를 주고 받

아야 하므로 리모트 노드쪽의 프로그램시 ACK/NAK에 대한 부분을 감안해야 한다.

2.1.3. 지연처리 SRLGW 환경파일

RQ를 이용하여 지연처리 방식으로 SRLGW를 사용할 경우의 환경 설정은 아래와 같다.

*DOMAIN

...

*NODE

...

*SVRGROUP

...

*SERVER




CLOPT=”-- -F /home/tmax/config/serlal.cfg –w 5555 –q testq ”

*SERVICE


위와 같이 환경파일을 작성하고 리모트 노드에서 COM 라이브러리를 이용하여(flags에 COMMDELAY

set) Tmax으로 서비스를 요청하면 SRLGW는 요청 데이터를 “testq”에 저장한다. SRLGW는 리모트 노드

에서 수신한 데이터를 RQ에 저장만 할 뿐 어떠한 처리도 하지 않으므로 사용자는 RQ에 저장된 데이터를

처리할 수 있어야 한다.

2.2. SERIAL 게이트웨이 환경파일Tmax 환경파일의 CLOPT절에 “-F” 옵션으로 지정한 파일은 아래에 설명하는 포맷으로 등록되어 있어야

한다. 이 파일은 리모트 노드와 Serial로 연결할 포트에 대한 정보를 등록하는 파일이다. 파일에 등록한 포

트 정보와 리모트 노드에서 사용하는 포트 정보는 반드시 일치해야만 한다.

2.2.1. 포트 정보 환경파일

#######################################################

# gwno baudrate stopbit Parity Byte Port Tmaxsvc

# 0 9600 1 ODD 8 COM1 SVC

#######################################################

# line start with "#" is comment line

# gwno must start at 0 and be increased by 1

# stopbit: 1, 1.5, 2

# parity : NONE, ODD, EVEN

# byte: 5, 6, 7, 8

# port: serial port name

# svc: tmax service name

#######################################################

0 9600 1 NONE 8 COM1 SVC1

0 9600 1 NONE 8 COM2 SVC2

다음은 포트 정보 환경파일 항목에 대한 설명이다.

설명항목명

Tmax Config 파일의 MIN 항목의 값이 2 이상인 경우에 사용하는 항목이다. 그러

나 MIN 항목이 항상 1 이므로 이 항목은 항상 0으로 지정해야 한다.

게이트웨이 번호

리모트 노드와 SRLGW 사이의 통신 속도를 지정하는 항목이다.Baudrate

serial 통신시 사용하는 Stop Bit 수를 지정하는 항목이다. Stop Bit는 1 Bit, 1.5

Bit, 2 Bit 3가지가 있다. 3가지 중 하나를 선택하여 지정한다.

Stop Bit


설명항목명

Parity를 지정하는 항목으로 NONE, ODD, EVEN 타입 중에서 하나를 선택하여

지정한다.

Parity

한 Byte가 몇 Bit로 구성 되었는지를 지정하는 항목이다. 5, 6, 7, 8중 하나를 지정

한다

Bit 수

리모트 노드와 연결된 포트의 이름을 지정하는 항목이다. SRLGW를 지정한 포

트를 이용하여 리모트 노드와 통신하므로 리모트 노드와 물리적으로 연결된 포

트명을 등록해야 한다.

포트명

Tmax의 클라이언트나 서비스에서 특정 리모트 노드에 서비스를 요청하기 위해

서는 SRLGW에 보내고자 하는 리모트 노드를 알려주어야 한다. 이러한 경우에

서비스명

사용하는 항목으로 SRLGW는 항목에 지정한 서비스명으로 SRLGW를 호출하

면 해당 서비스명으로 리모트 노드를 찾아서 해당 리모트 노드에 데이터를 전송

한다. 항목에 지정한 서비스명은 반드시 Tmax Config 파일의 SERVICE 절에 등

록된 서비스명이어야 한다. SRLGW가 리모트 노드를 찾는 방법은 위와 같이 등

록한 서비스명으로 찾는 방법과 나중에 리모트 노드에서 SRLGW로 연결을 설

정할 때 리모트 노드의 이름을 등록할 수 있다. 이렇게 등록하는 리모트 이름은

반드시 Tmax Config의 SERVICE 절에 등록된 이름이어야 한다.

SRLGW는 위의 환경파일에 등록된 수 만큼 내부적으로 스레드를 할당하므로 리모트 노드와 Serial 통신

을 원하는 모든 포트를 등록해야 한다. 위 파일에 등록되지 않은 리모트 노드는 SRLGW와 통신할 수 없다.


제3장 COM 라이브러리

COM 라이브러리는 리모트 노드에서 Tmax의 SRLGW와 RS232로 통신할 수 있도록 Tmax에서 제공하는

라이브러리이다. SRLGW와 통신을 원하는 리모트 노드는 반드시 COM 라이브러리를 사용하여 통신해야

한다. 리모트 노드의 사용자는 COM 라이브러리를 이용하여 Tmax과 Serial로 서비스를 요청하거나, 또는

서비스 요청을 받을 수 있다. 리모트 노드의 사용자쪽에서는 Tmax와 통신시 통신관련 부분을 COM 라이

브러리에서 처리하므로 보다 쉽게 Tmax의 서비스를 이용할 수 있다. 본 장에서는 SRLGW 관점에서 COM

라이브러리에서 제공하는 각각의 API에 대한 사용법을 설명한다.

COM 라이브러리의 프로토타입은 comhead.h 헤더 파일에 정의되어 있다.

3.1. ComOpenTmax의 SRLGW와 Serial로 연결을 맺고 리모트 노드를 SRLGW에 등록하는 함수이다. Tmax의 SRLGW

의 환경파일의 서비스명 항목에 서비스명을 등록하지 않았으면 이 함수를 이용하여 반드시 서비스명을

등록해야 한다. 서비스명이 등록되지 않았으면 리모트 노드에서 Tmax으로 서비스는 요청할 수 있으나 반

대로 Tmax에서 리모트 노드로 서비스는 요청할 수 없다. 사용자는 다른 함수를 사용하기 전에 반드시 이

함수를 사용하여 Tmax의 SRLGW와 연결해야 한다.

● 프로토타입

int ComOpen(int type, char *id, char *port)

● 파라미터

설명파라미터

Tmax와 통신이 사용할 프로토콜(TCPIP/SERIAL)을 나타낸다. 각각의 프로

토콜은 comhead.h 파일에 등록되어 있다.

type

리모트 노드를 식별하는 코드이다. 이 코드는 위에서 설명한 SRLGW 환경파

일과 관련이 있다. 환경파일에 서비스명을 등록하거나 또는 코드를 지정하여

id

리모트 노드를 식별하는 코드를 등록할 수 있다. 록하는 코드는 반드시 Tmax

의 Config 파일의 SERVICE 절에 등록된 서비스명이어야 한다.

Tmax의 SRLGW와 연결할 때 사용할 포트를 지정하는 항목이다. Serial로 통

신하는 경우에는 위에서 설명한 SRLGW의 환경설정에 등록한 각각의 항목

port

을 지정한다. 포트에 대한 모든 정보를 String으로 연속해서 지정하면 된다.

(예:“COM1:9600:8:ODD:1”)

● 반환값

제3장 COM 라이브러리 13

설명반환값

함수 호출에 성공한 경우0

함수 호출에 실패한 경우-1

3.2. ComDetachTmax의 SRLGW와의 등록을 해제하기 위해서 사용하는 함수이다. 등록만 해제하고 실질적인 연결을 끊

지 않는다. ComDetach 함수를 사용하면 Tmax의 SRLGW와 데이터를 송수신 할 수 없다.

● 프로토타입

int ComDetach(void)

● 반환값

설명반환값



3.3. ComCloseTmax의 SRLGW와 등록을 해제하고 연결을 끊는 함수이다. 그러므로 Tmax의 SRLGW와 통신을 끊고자

하는 경우에는 반드시 함수를 호출해야만 한다. 특히 Serial 통신인 경우에 SRLGW에서 리모트 노드의 프

로그램이 다운되었는지의 여부를 알 수 없으므로 함수를 이용하여 SRLGW와 연결을 해제해야 한다.

● 프로토타입

int ComClose(void)

● 반환값

설명반환값




3.4. ComSend리모트 노드에서 Tmax의 SRLGW로 데이터를 전송하는 함수이다. 함수를 이용하여 Tmax에 서비스를 요

청하거나 또는 응답을 전송할 수 있다. Tmax의 서비스 요청에 대한 응답을 보낼 경우에도 반드시 Tmax의

새로운 서비스명을 지정해야 한다.

● 프로토타입

Int ComSend(char *svc, int msgtype, char *data, long len, long flags)

● 파라미터

설명파라미터

Tmax에 요청할 서비스명을 지정하는 항목이다.svc

Tmax의 SRLGW에 전송하는 데이터의 종류를 나타낸다. 각각의 메시지 타

입은 commhead.h 파일을 참고한다.

msgtype

Tmax의 SRLGW에 전송할 테이터가 저장된 버퍼의 포인터이다.data

전송할 데이터의 길이를 나타낸다.len

서비스 요청시 SRLGW가 해당 요청을 어떻게 처리해야 하는지를 나타낸다.

flags에 COMMDELAY가 set되어 있으면 SRLGW는 해당 데이터를 지연처리

flags

로 인식하여 RQ에 저장하고, COMMNOREPLY가 set되어 있으면 서비스만

요청하고 응답을 받지 않겠다는 의미로 인식된다. 현재 flags에 지정할 수 있

는 값은 2가지로 commhead.h 파일을 참고한다.

● 반환값

설명반환값



3.5. ComRecvTmax의 SRLGW로부터 데이터를 수신하는 함수이다. 데이터는 서비스 요청일 수도 있고, 응답 데이터일

수도 있다.

● 프로토타입

Int ComRecv(char *svc, int *msgtype, char *data, long *len, long flags)

● 파라미터

제3장 COM 라이브러리 15

설명파라미터

Tmax에 요청한 서비스명이 저장될 항목이다.svc

Tmax의 SRLGW에서 전송하는 데이터의 종류를 나타낸다. 각각의 메시지

타입은 commhead.h 파일을 참고한다.

msgtype

Tmax의 SRLGW에서 수신한 테이터가 저장될 버퍼의 포인터이다. 이 버퍼

는 수신 데이터중 가장 큰 데이터의 버퍼 크기를 가져야 한다.

data

수신한 데이터의 길이를 나타낸다.len

사용하지 않는다.flags

● 반환값

설명반환값




제4장 예제

본 장에서는 제1장에서 설명한 SRLGW의 각 역할에 대한 예제에 대해 설명하도록 한다.

4.1. NOREPLY 서비스 호출Tmax의 서비스나 클라이언트에서 SRLGW로 tpacall로 서비스를 요청하고 결과에 관계없이 처리하는 예

제이다.

4.1.1. 프로그램 구성

프로그램 구성은 다음과 같다.

● Config file : tmax.m, serial.cfg

● Remote Node : remote.c

< tmax.m >

*DOMAIN

res SHMKEY = 88000,

MINCLH = 1,

MAXCLH = 1,

TPORTNO = 8888

*NODE

node1 TMAXDIR=”/home/tmax”,


*SVRGROUP

svg1 NODENAME = node1

*SERVER

serialgw SVGNAME = svg1, MIN=1, MAX=1, CPC=10,


CLOPT=”-- -F /home/tmax/config/serial.cfg -w 5050”

svr SVGNAME = svg1, MIN=1, MAX=1,

*SERVICE

제4장 예제 17

COM1 SVRNAME = serialgw

TOUPPER SVRNAME = svr

< serial.cfg >

#######################################################


# 0 9600 1 ODD 8 COM1 SVC

#######################################################



# stopbit: 1, 1.5, 2


# byte: 5, 6, 7, 8



#######################################################

0 9600 1 NONE 8 COM1 COM1

< toupper.c >

#include <stdio.h>

#include <stdlib.h>

#include <string.h>

#include <usrinc/atmi.h>

main(int argc, char *argv[])

{

char *sndbuf, *rcvbuf;

long rcvlen;

if (argc != 2) {

printf("Usage: toupper string\n");

exit(1);

}

if (tpstart((TPSTART_T *)NULL) == -1){

printf("Tpstart failed\n");

exit(1);

}

if ((sndbuf = (char *)tpalloc("STRING", NULL, 0)) == NULL) {

printf("Sendbuf alloc failed !\n");

tpend();


exit(1);

}

if ((rcvbuf = (char *)tpalloc("STRING", NULL, 0)) == NULL) {

printf("Recvbuf alloc failed !\n");

tpfree((char *)sndbuf);

tpend();

exit(1);

}

strcpy(sndbuf, argv[1]);

if(tpcall("TOUPPER", sndbuf, 0, &rcvbuf, &rcvlen, 0)==-1){

printf("Can't send request to service TOUPPER\n");


tpfree((char *)rcvbuf);

tpend();

exit(1);

}

printf("Sendbuf data: %s\n", sndbuf);

printf("Recvbuf data: %s\n", rcvbuf);



tpend();

}

< svr.c >

#include <stdio.h>


TOUPPER(TPSVCINFO *msg)

{

char *sndbuf;

long sndlen;


printf("sendbuf alloc failed !\n");

tpreturn(TPFAIL, -1, NULL, 0, 0);

}

strcpy(sndbuf, msg->data);

sndlen = msg->len;

제4장 예제 19

if(tpacall("COM1", sndbuf, sndlen, TPNOREPLY)==-1){

printf("Can't send request to service TCPSVC1\n");


tpreturn(TPFAIL, -1, NULL, 0, 0 );

}


tpreturn(TPSUCCESS,0,(char *)msg->data, msg->len,0);

}

< remote.c >

#include <stdio.h>

#include <winsock2.h>

#include <usrinc/commhead.h>

#define COM_PORT "COM1:9600:8:NONE:1"

int main(int argc, char *argv[])

{

int n, msgtype;

long ilen, olen;

char buffer[1024];

char svcname[24];

/* Gateway에 리모트 노드를 등록한다 */

printf("Remote Service Start...\n\n");

n = ComOpen(SERIAL, "COM1", COM_PORT);

if (n < 0) {

perror("Gateway register error:");

return -1;

}

while(1) {

memset(svcname, 0x00, sizeof(svcname));

memset(buffer, 0x00, sizeof(buffer));

/* 데이터를 수신한다. */

n = ComRecv(svcname, &msgtype, buffer, &olen, COMMNOFLAG);

if (n < 0) {

perror("Data Receive error:");

ComClose();

return -1;

}

printf("REMOTE RECV : svcname = [%s]\n", svcname);

printf("REMOTE RECV : len = %d\n",olen);


printf("REMOTE RECV : data= [%s]\n\n", buffer);

}

/* Gateway와 연결을 해제한다 */

ComClose( );

}

4.2. REPLY 서비스 호출Tmax의 서비스나 클라이언트에서 SRLGW로 tpacall로 서비스를 요청하고 결과에 관계없이 처리하고, 리

모트 노드에서 서비스 요청에 대한 처리 결과를 Tmax의 다른 서비스에서 처리할 수 있도록 “TOLOWER”

를 호출하는 예제이다.





< tmax.m >

*DOMAIN

res SHMKEY = 88000,

MINCLH = 1,

MAXCLH = 1,

TPORTNO = 8888

*NODE



*SVRGROUP


*SERVER




svr SVGNAME = svg1, MIN=1, MAX=1,

*SERVICE


제4장 예제 21

TOUPPE SVRNAME = svr

TOLOWER SVRNAME = svr

< serial.cfg >

#######################################################


# 0 9600 1 ODD 8 COM1 SVC

#######################################################



# stopbit: 1, 1.5, 2


# byte: 5, 6, 7, 8



#######################################################


< toupper.c >

#include <stdio.h>

#include <stdlib.h>

#include <string.h>


main(int argc, char *argv[])

{

char *sndbuf, *rcvbuf;

long rcvlen;

if (argc != 2) {

printf("Usage: toupper string\n");

exit(1);

}

if (tpstart((TPSTART_T *)NULL) == -1){

printf("Tpstart failed\n");

exit(1);

}


printf("Sendbuf alloc failed !\n");

tpend();


exit(1);

}

if ((rcvbuf = (char *)tpalloc("STRING", NULL, 0)) == NULL) {

printf("Recvbuf alloc failed !\n");


tpend();

exit(1);

}

strcpy(sndbuf, argv[1]);

if(tpcall("TOUPPER", sndbuf, 0, &rcvbuf, &rcvlen, 0)==-1){

printf("Can't send request to service TOUPPER\n");



tpend();

exit(1);

}

printf("Sendbuf data: %s\n", sndbuf);

printf("Recvbuf data: %s\n", rcvbuf);



tpend();

}

< svr.c >

#include <stdio.h>



{

char *sndbuf;

long sndlen;


printf("sendbuf alloc failed !\n");

tpreturn(TPFAIL, -1, NULL, 0, 0);

}

strcpy(sndbuf, msg->data);

sndlen = msg->len;

제4장 예제 23

if(tpacall("COM1", sndbuf, sndlen, TPNOREPLY)==-1){

printf("Can't send request to service TCPSVC1\n");


tpreturn(TPFAIL, -1, NULL, 0, 0 );

}



}

TOLOWER(TPSVCINFO *msg)

{

int i;

printf("TOLOWER service is started!\n");

printf("INPUT : data=%s\n", msg->data);

for (i = 0; i < msg->len; i++)

msg->data[i] = tolower(msg->data[i]);

printf("OUTPUT: data=%s\n\n", msg->data);

tpreturn(TPSUCCESS,0,(char *)msg->data, 0,0);

}

< remote.c >

#include <stdio.h>





{

int n, msgtype;

long ilen, olen;

char buffer[1024];

char svcname[24];




if (n < 0) {



return -1;

}

while(1) {



/* 데이터를 수신한다. */


if (n < 0) {


ComClose();

return -1;

}




strcpy(buffer,"I'M REMOTE SERVICE.");

ilen = strlen(buffer) + 1;

/* 응답 데이터를 전송한다. */

n = ComSend("TOLOWER", COMMDATA, buffer, ilen, COMMNOREPLY);

if (n < 0) {

perror("Data send error:");

ComClose();

return -1;

}

}


ComClose( );

}

제4장 예제 25

4.3. 리모트 노드 동기형 호출SRLGW가 Tmax boot시에 기동되어 있다가 리모트 노드의 요청이 수신되면, 사용자가 지정한 서비스를

호출한 후에 다시 리모트 노드로 처리 결과를 주는 예제이다.





< tmax.m >

*DOMAIN

res SHMKEY = 88000,

MINCLH = 1,

MAXCLH = 1,

TPORTNO = 8888

*NODE

node1 TMAXDIR=”/home/tmax”, APPDIR=”/home/tmax/appbin”

*SVRGROUP


*SERVER




svr SVGNAME = svg1, MIN=1, MAX=1

*SERVICE



< serial.cfg >

#######################################################


# 0 9600 1 ODD 8 COM1 SVC

#######################################################




# stopbit: 1, 1.5, 2


# byte: 5, 6, 7, 8



#######################################################


< svr.c >

#include <stdio.h>



{

int i;

char *sndbuf;

printf("TOUPPER service is started!\n");

printf("INPUT : data=%s, len = %d\n", msg->data, msg->len);


msg->data[i] = toupper(msg->data[i]);

printf("OUTPUT: data=%s, len = %d\n",msg->data,msg->len);


}

< remote.c >

#include <stdio.h>





{

int n, msgtype;

long ilen, olen;

char buffer[1024];

제4장 예제 27

char svcname[20];

char *ptr;




if (n < 0) {


return -1;

}

ptr = argv[1];

ilen = strlen(argv[1]) + 1;

printf("Send Data = [%s], len = %d\n",ptr,ilen);

n = ComSend("TOUPPER", COMMDATA, ptr, ilen, COMMNOFLAG);

if (n < 0) {


ComClose();

return -1;

}



/* 응답 데이터를 수신한다. */


if (n < 0) {


ComClose();

return -1;

}





ComClose( );

}


4.4. ACK/NAK 통신 방식SRLGW가 Tmax boot시에 기동되어 있다가 리모트 노드의 요청이 수신되면, 사용자가 지정한 서비스를

호출한 후에 다시 리모트 노드로 처리 결과를 주는 예제이다. 이 경우에 송수신 데이터에 대해서 ACK/NAK

를 처리하는 예제이다.





< tmax.m >

*DOMAIN

res SHMKEY = 88000,

MINCLH = 1,

MAXCLH = 1,

TPORTNO = 8888

*NODE



*SVRGROUP


*SERVER

Serialgw SVGNAME = svg1, MIN=1,MAX=1,CPC=10,


CLOPT=”-- -F /home/tmax/config/serial.cfg -w 5050 -A”

avr SVGNAME = svg1, MIN=1, MAX=1

*SERVICE



< serial.cfg >

#######################################################


# 0 9600 1 ODD 8 COM1 SVC

제4장 예제 29

#######################################################



# stopbit: 1, 1.5, 2


# byte: 5, 6, 7, 8



#######################################################


< svr.c >

#include <stdio.h>



{

int i;

char *sndbuf;

printf("TOUPPER service is started!\n");

printf("INPUT : data=%s, len = %d\n", msg->data, msg->len);


msg->data[i] = toupper(msg->data[i]);

printf("OUTPUT: data=%s,len = %d\n", msg->data,msg->len);


}

< remote.c >

#include <stdio.h>





{

int n, msgtype;

long ilen, olen;


char buffer[1024];

char svcname[20];

char *ptr;




if (n < 0) {


return -1;

}

while(1) {

ptr = argv[1];

ilen = strlen(argv[1]) + 1;

printf("Send Data = [%s], len = %d\n",ptr,ilen);

n = ComSend("TOUPPER", COMMDATA, ptr, ilen, COMMNOFLAG);

if (n < 0) {


ComClose();

return -1;

}



/* ACK/NAK 수신. */


if (n < 0) {


printf("RT = %d\n",n);

ComClose();

return -1;

}

if (msgtype == COMMACK)

break;

}

printf("REMOTE RECV OK! : ACK msgtype = [%d]\n", msgtype);

/* ACK/NAK 송신. */

n = ComSend("TOUPPER", COMMACK, NULL, 0, COMMNOFLAG);

if (n < 0) {


ComClose();

return -1;

}

제4장 예제 31

printf("REMOTE SEND OK! : Return = [%d]\n", n);


ComClose( );

}


Appendix A. 헤더 파일

A.1. COMMHEAD 파일

#ifndef _COMM_H_

#define _COMM_H_

#ifndef _WIN32

#define __cdecl

#endif

#ifndef _LOBYTE

#if (defined(_SOCK1) || defined(_SOCK11))

#define _LOBYTE 1

#define _HIBYTE 1

#else

#define _LOBYTE 2

#define _HIBYTE 0

#endif

#endif

/* type */

#define TCPIP 1

#define SERIAL 2

/* flags */

#define COMMNOFLAG 0x00

#define COMMDELAY 0x01

#define COMMNOREPLY 0x10

/* msgtype */

#define COMMDATA 1

#define COMMACK 2

#define COMMNAK 3

#define COMMREGISTER 4

#define COMMUNREGISTER 5

define COMM_MSG_SIZE 1024

#define COMM_DATAP(cp) ((char *)((struct comm_header_t *)cp+1))

#define COMM_HEADER_SIZE sizeof(struct comm_header_t)

#define COMM_LEN_SIZE 4

#define COMM_UID_SIZE 5

Appendix A. 헤더 파일 33

#define COMM_SVC_SIZE 16

#define COMM_ERRCODE_SIZE 4

struct comm_header_t {

char len[COMM_LEN_SIZE]; /* data length: 순수 데이터 길이 */

char msgtype; /* Message type */

char uid[COMM_UID_SIZE]; /* Unique Value: ACK, NAK에서 사용*/

char svc[COMM_SVC_SIZE]; /* Destination Id. */

char errcode[COMM_ERRCODE_SIZE]; /* 미사용: 차후 사용할 예정 */

char flags; /* 위에서 지정한 flag중 하나 */

unsigned char crc; /* Check Byte */

};

typedef struct comm_header_t COMM_HEADER;

#if defined(__cplusplus)

extern "C" {

#endif

/* ------------------ function prototypes ------------------- */

int __cdecl ComOpen(int type, char *id, char *port);

int __cdecl ComDetach(void);

int __cdecl ComClose(void);

int __cdecl ComSend(char *svc, int msgtype, char *data, long len, long flags);

int __cdecl ComRecv(char *svc, int *msgtype, char *data, long *len, long flags);

#if defined (__cplusplus)

}

#endif

#endif /* _COMM_H_ */


Documents

Tmax Gateway Guide (Serial)Serial).pdf · 2019-04-09 · SERIAL 게이트웨이에서 사용하는 API 함수에 대해 기술한다. 제4장: 예제 SERIAL 게이트웨이의 각