Tmax Host-link Guide

Transcription

1 Tmax Host-link Guide (SNA LU 0, SNA LU 6.2) Tmax v5.0 SP1 Copyright 2009 TmaxSoft Co., Ltd. All Rights Reserved.

2 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 Host-link Guide (SNA LU 0, SNA LU 6.2) 발행일 : 소프트웨어버전 : Tmax v5.0 SP1 안내서버전 : v2.1.1

3 내용목차 안내서에대하여... vii 제1장 소개 개요 구조 기능 기동및종료 파일목록... 4 제2장 세션관리 INBOUND OUTBOUND 세션문제해결 세션 Link 세션 세션 Pool 제3장 환경설정 Tmax 환경설정파일 SERVER 절 GATEWAY 절 SERVICE 절 Host-link 환경설정파일 HOSTLINK 절 SERVER 절 SERVICE 절 LOGGING 절 CONVERSION 절 DUMMYDATA 절 USERHEADER 절 LUINFO 절 환경설정파일컴파일 제4장 서비스 INBOUND tpcall tpacall tpforward OUTBOUND BID 및 ROP 제5장 상태모니터링 API와구조체 API tpgethlinksvr Tmax Host-link Guide iii

4 tpgethlinkproc tpgethlinkluinfo tpgethlinkssinfo 구조체 HLPROCINFO HLLUINFO HLSESSINFO 에러코드 Appendix A. 환경설정예제 A.1. SNA LU A.2. SNA LU Appendix B. 사용자함수 B.1. SNA LU B.2. SNA LU 색인 iv Tmax Host-link Guide (SNA LU 0, SNA LU 6.2)

5 그림목차 [ 그림 1.1] Host-link 개요... 1 [ 그림 1.2] Host-link 내부구조... 2 [ 그림 4.1] tpcall 서비스 [ 그림 4.2] tpcall - Tmax 시스템에응답하는서비스 [ 그림 4.3] tpacall - Tmax 시스템에응답하지않는서비스 [ 그림 4.4] tpforward - TPNOREPLY 를설정한경우 [ 그림 4.5] tpforward - TPNOREPLY 를설정하지않은경우 [ 그림 4.6] OUTBOUND 서비스처리과정 [ 그림 4.7] BID 및 ROP 서비스처리과정 Tmax Host-link Guide v

6

7 안내서에대하여 안내서의대상 본안내서는 Tmax ( 이하 Tmax) 와호스트를연결하는 Host-link 개발자를위한안내서이다. 안내서의전제조건 본안내서는 Tmax 시스템에대한전반적인이해와 Tmax 시스템이제공하는각종기능및특성에대한습득을위한기본서이다. 본안내서를원활하게이해하기위해서는다음과같은사항을미리알고있어야한다. 미들웨어 (Middleware) 및 UNIX 시스템에대한이해 Tmax 의기본개념이해 Java, C 프로그래밍의이해 SNA(System Network Architecture) 의이해 안내서의제한조건 본안내서를읽기전에 Tmax 의기본개념을숙지하고있어야한다. 실무에서의구체적인사용방법이나 관리및운용에관한사항은각제품의안내서를참고한다. 참고 Tmax 시스템개발에대한기본적인내용은 "Tmax Administration Guide" 나 "Tmax Application Devel oment Guide" 를참고한다. Tmax에서제공하는명령어와 C API에대한설명은 Tmax Reference Guide 를참고한다. 안내서에대하여 vii

8 안내서구성 Tmax Host-link Guide는총 5개의장과 2개의 Appendix로구성되어있다. 각장의주요내용은다음과같다. 제1장 : 소개 Host-link의개념, 구조, 기능을설명한다. 제 2 장 : 세션관리 INBOUND 세션과 OUTBOUND 세션의관리에대해설명한다. 제 3 장 : 환경설정 Tmax 와 Host-link 의환경설정파일을설명한다. 제 4 장 : 서비스 INBOUND, OUTBOUND, BID 및 ROP 의서비스에대해설명한다. 제 5 장 : 상태모니터링 API 와구조체 Host-link 의상태를모니터링하는 API 와구조체에대해설명한다. Appendix.A: 환경설정예제 SNA LU 0 과 SNA LU 6.2 의예제를보여준다. Appendix.B: 사용자함수 SNA LU 0 과 SNA LU 6.2 의사용자함수에대해설명한다. viii Tmax Host-link Guide (SNA LU 0, SNA LU 6.2)

9 안내서규약 표기 <AaBbCc123> <Ctrl>+C [Button] 진하게 " "( 따옴표 ) ' 입력항목 ' 하이퍼링크 > 참고 의미프로그램소스코드의파일명, 디렉터리 Ctrl과 C를동시에누름 GUI의버튼또는메뉴이름강조다른관련안내서또는안내서내의다른장및절언급화면 UI에서입력항목에대한설명메일계정, 웹사이트메뉴의진행순서하위디렉터리또는파일있음하위디렉터리또는파일없음참고또는주의사항 [ 그림 1.1] [ 표 1.1] AaBbCc123 그림이름 표이름 명령어, 명령어수행후화면에출력된결과물, 예제코드 [ ] 옵션인수값 선택인수값 안내서에대하여 ix

10 시스템사용환경 요구사항 Platform IBM AIX 5.x HP-UX 11.xx Solaris 7~9 (SunOS 5.7~5.9) Hardware 최소 120MB 하드디스크공간 256MB 이상메모리공간 1GB 이상하드디스크와 512MB 이상메모리공간권장 Database Oracle 9i 또는 10g x Tmax Host-link Guide (SNA LU 0, SNA LU 6.2)

11 관련안내서 안내서 Tmax Administration Guide Tmax Application Develoment Guide 설명 Tmax를이용하기위한환경설정파일과시스템운영방식에대해서기술한안내서이다. Tmax를사용하여프로그램을개발하는사용자를위해기술된안내서이다. 프로그램개발에대한기본적인내용을기술한안내서이다. 안내서에대하여 xi

12 연락처 Korea TmaxSoft Co., Ltd 263 BundangSquare (AK Plaza) 12th floor, Seohyeon-dong, Bundang-gu, Seongnam-si, Gyeonggi-do, South Korea Tel: Fax: Web (Korean): 기술지원 : USA TmaxSoft, Inc. 560 Sylvan Avenue Englewood Cliffs, NJ U.S.A Tel: Fax: info@tmaxsoft.com Web (English): Japan TmaxSoft Japan Co., Ltd. 5F Sanko Bldg, Mita, Minato-Ku, Tokyo, Japan Tel: Fax: info.jp@tmaxsoft.com Web (Japanese): xii Tmax Host-link Guide (SNA LU 0, SNA LU 6.2)

13 China TmaxSoft China Co., Ltd. Beijing Silver Tower, RM 1508, 2# North Rd Dong San Huan, Chaoyang District, Beijing, China, China Tel: ~8 Fax: Web (Chinese): ASEAN Office TmaxSoft Pte. Ltd. 30 Cecil Street, Level 15 Unit 05 Prudential Tower, Singapore Singapore Tel: Fax: Web (English): 안내서에대하여 xiii

14

15 제 1 장소개 본장에서는 Host-link 의개념, 구조, 기능, 기동및종료에대해설명한다 개요 Host-link는오픈환경에서도 IBM 호스트와같은기간계시스템에존재하는애플리케이션서비스에동일하게접근하도록하는게이트웨이이다. [ 그림 1.1] Host-link 개요 Host-link 는기간계시스템과오픈환경시스템사이의통신프로토콜에따라 SNA(System Network Archi tecture) 와 TCP 로나뉜다. 프로토콜 SNA 설명 CICS 의 DPL(Distributed Program Link) 와 DTP(Distributed Transaction Processing), IMS 의 APPC 와 CPI-C 인터페이스를제공한다. 요청 / 응답모델, 대화형모델을지원한다. TCP OS/390 의 TP-monitor 인 CICS, IMS 와연동한다. 요청 / 응답모델, 대화형모델을지원한다 SNA 의경우 Host-link 를이용하기위해서서버유형에맞게다음의 SNA 게이트웨이를설치해야한다. 서버 Solaris SNA 게이트웨이 SunLinkTM 제 1 장소개 1

16 서버 HP-UX AIX SNA 게이트웨이 SNAPlus2 IBM Communications 서버 Host-link 를사용할경우다음과같은장점이있다. 애플리케이션의프로그램코드를수정할필요가없다. 기간계시스템의리소스를그대로활용할수있다. 표준통신프로토콜인 SNA, TCP/IP 를이용하여기간계시스템과최적의상태로연동할수있다. 기간계시스템과동시에오픈환경의저렴하고다양한웹리소스를활용할수있다 구조 Host-link 의구조는내부구조와시스템전체로나누어볼수있다. Host-link 내부구조 Host-link 는 Tmax 서비스모듈, 세션매니저모듈, 호스트서비스모듈로구성된다. [ 그림 1.2] Host-link 내부구조 Tmax 서비스모듈 Tmax 서비스모듈은 Tmax 시스템과호스트시스템사이의세션을연결하고감시한다. 또한 Tmax 시스템에서요청한서비스를호스트서비스모듈에전달하거나호스트서비스모듈에서요청한서비스를 Tmax 시스템에요청하는역할을한다. 세션매니저 세션매니저는 Tmax 시스템과호스트시스템을 SNA LU 0 또는 SNA LU 6.2 방식으로연결하고, 이를 감시하여두시스템간의원활한서비스를수행하도록지원한다. 호스트서비스모듈 2 Tmax Host-link Guide (SNA LU 0, SNA LU 6.2)

17 호스트서비스모듈은호스트에존재하는프로세스에서 Tmax 서비스를요청할경우 Tmax 서비스모 듈에해당업무를전달하고, Tmax 시스템에서요청한서비스를호스트에전달하는모듈이다. Host-link 전체구조 거시적인관점에서 Host-link는 Tmax의 Custom 게이트웨이방식으로관리된다. 따라서 Host-link를실행하기위해서는 Tmax 환경설정파일에 Custom 게이트웨이유형으로등록해야한다. 또한 Host-link는오픈환경시스템에존재하는 SNA 게이트웨이와연결을맺고오픈시스템의요청을호스트에전달한다. 다음은 Custom 게이트웨이방식의장점이다. 다중채널의사용 Host-link는 Tmax 시스템과다중채널을연결함으로써동시에여러업무를처리할수있다. Host-link와오픈시스템의 SNA 게이트웨이를다중세션으로연결함으로써가능하다. 세션수제어 Host-link와 SNA 게이트웨이의세션수보다많은서비스가요청되는경우초과서비스를송신프로세스내의큐에저장한다. 사용가능한세션이생기면 FIFO(First In First Out) 방식으로서비스를요청한다. 일반서버프로세스형태와동일한관리일반프로세스는프로세스단위로기동과종료가가능하다. Host-link도마찬가지로 tmdown/tmboot 명령어를사용하여기동및종료가가능하다. 또한시스템관리툴인 tmadmin을통해처리건수및평균응답시간등을확인할수있다. 서비스형태로호출 Host-link는환경설정파일에하나의서비스를갖도록규정된다. 따라서오픈환경시스템에서 Host-link 를사용하기위해서는 Tmax 시스템내에서다른일반서비스호출방식과동일하게서비스명으로호출한다 기능 Host-link는 SNA 타입에따라 LU 0과 LU 6.2로구분된다. SNA LU 0와 LU 6.2의기능은다음과같다. SNA LU 0 하나의프로세스가다양한업무를처리한다. SNA LU 6.2 제 1 장소개 3

18 각프로세스는내부적으로스레드를생성하여서비스를처리한다. 스레드는커널레벨스레드로서최대 50개까지생성이가능하고각스레드는한개의 LU 세션을담당한다. 만약 50개이상의세션연결을원하는경우에는별도의프로세스를기동해서처리해야한다. SNA LU 6.2는호스트에서제공하는 Mirror를통해서비스를전달하는 DPL 방식과직접적으로호스트서비스와연결하는 DTP 방식을지원한다. DTP는 INBOUND, OUTBOUND 서비스모두지원하며 Hostlink 환경설정파일에지정된내용에따라선택적운영도가능하다. DPL의경우 INBOUND 서비스에서만지원한다. 서비스 INBOUND OUTBOUND 설명 오픈환경시스템에서호스트로서비스를요청하는형태이다. 호스트에서오픈환경시스템으로서비스를요청하는형태이다. 참고 "Logical Unit" 의약자로 IBM SNA 에서사용하는패키지의종류이다 기동및종료 Host-link의 Custom 게이트웨이특성때문에 Tmax 시스템에연결되어자동시작및종료된다. 따라서 Host-link 기동및종료를위한별도의실행이필요하지않고 Tmax 기동및종료에따라자동으로처리된다 파일목록 다음은 Host-link 에서사용하는파일을설명한다. 파일 bin/hkcfl appbin/hkh appbin/hkhd lib/liblu0gw.a lib/liblu0gwd.a lib/liblu62sgw.a lib/liblu62sgwd.a lib/liblu62rgw.a lib/liblu62rgwd.a 설명 Host-link 환경설정파일을컴파일하기위한실행파일이다. Host-link 공유메모리를관리하기위한서버실행파일이다. Host-link 공유메모리를관리하기위한서버디버그용실행파일이다. Host-link LU0 게이트웨이를빌드하기위한라이브러리파일이다. Host-link LU0 게이트웨이를빌드하기위한디버그용라이브러리파일이다. Host-link LU62S 게이트웨이를빌드하기위한라이브러리파일이다. Host-link LU62S 게이트웨이를빌드하기위한디버그용라이브러리파일이다. Host-link LU62R 게이트웨이를빌드하기위한라이브러리파일이다. Host-link LU62R 게이트웨이를빌드하기위한디버그용라이브러리파일이다. 4 Tmax Host-link Guide (SNA LU 0, SNA LU 6.2)

19 파일 lib/libhlinkapi.a lib/libtmaxgw.a lib/libtmaxgw.so lib/libtmaxgwmt.a lib/libtmaxgwmt.so lib/libtmaxcfl.a lib/libtmaxcfl.so usrinc/hlinkapi.h 설명 Host-link 공유메모리를모니터링하는 API를위한라이브러리파일이다. Host-link를하기위한 Tmax 공통라이브러리파일이다. Host-link를하기위한 Tmax 공통공유라이브러리파일이다. Host-link를하기위한 Tmax 공통멀티스레드용라이브러리파일이다. Host-link를하기위한 Tmax 공통멀티스레드용공유라이브러리파일이다. Host-link를하기위한 Tmax 공통 hkcfl용라이브러리파일이다. Host-link를하기위한 Tmax 공통 hkcfl용공유라이브러리파일이다. Host-link 헤더파일이다. 제 1 장소개 5

20

21 제 2 장세션관리 본장에서는 INBOUND와 OUTBOUND의세션관리에대해설명한다. Host-link 시스템은여러프로세스가존재하여세션을관리하고유지한다. Host-link 시스템에존재하는프로세스수는 Tmax의환경설정파일의 SERVER 절의 MIN, MAX 항목으로조절할수있다. 프로세스는한 Link 세션에서제공하는최대세션수만큼서비스를처리한다. 만약세션이부족할경우자동적으로처리가가능한다른 Host-link 프로세스로서비스를이전하여처리한다. Host-link 시스템에서관리하는세션은크게 INBOUND, OUTBOUND로구분된다. INBOUND, OUTBOUND 에서 IN, OUT은호스트를기준으로한다 INBOUND INBOUND는오픈환경시스템에서호스트시스템으로서비스를요청하는세션으로프로세스사이에세션공유대상이다. 세션을사용하는방식에따라 Pool 방식과 Dedicate 방식으로나뉜다. Pool 방식 Pool 방식은현재사용가능한세션으로서비스를요청하는방식이다. Tmax 시스템의 Load Balance에의해 Host-link 프로세스로서비스가요청되면 Host-link 프로세스는자신이보유하고있는사용가능한세션을찾아호스트로서비스를요청한다. 사용가능한세션이없을경우처리가가능한다른 Host-link 프로세스에게서비스를전달한다. Pool 방식으로세션을사용할경우세션을업무별로분할하여해당업무에서사용하는세션을지정하여서비스를요청할수있다. 이방식을사용하려면 Host-link 환경설정파일의사용자헤더를지정하고, 헤더의세션유형을지정하여원하는세션으로서비스를요청한다. Dedicate 방식 Dedicate 방식은세션을특정값으로지정하여지정한값으로세션을찾아서비스를요청하는방식이다. Dedicate 방식은단말별로세션을유지할경우에사용한다. 단말별로유일한번호를부여하여이번호에해당하는세션으로서비스를요청한다. 기존호스트시스템에서는단말별로세션을유지하여단말에서발생한입출금에대한시제를관리한다 SNA LU 0 SNA LU 0 는 Pool 방식과 Dedicate 방식을모두지원한다. 제 2 장세션관리 7

22 SNA LU 6.2 SNA LU 6.2 는 Pool 방식만을지원하고다음의 2 가지방식을사용할수있다. 구분 DPL 방식 DTP 방식 설명 DPL은 Tmax 대화형통신모드에서사용되는방식으로호스트에서제공하는 Mirror 를통해서비스를전달한다. DPL은 INBOUND 서비스에서만지원한다. DTP는 Tmax 동기형, 비동기형통신모드에서사용되는방식으로, 직접적으로호스트서비스와연결하는방식이다. INBOUND, OUTBOUND 서비스모두지원하며 Hostlink 환경설정파일에지정된내용에따라선택적운영도가능하다. 참고 통신모드에대한자세한내용은 Tmax 안내서중에 "Tmax Administration Guide" 를참고한다 OUTBOUND OUTBOUND는호스트시스템에서오픈환경시스템으로서비스를요청하는세션으로프로세스간세션공유대상에서제외된다. OUTBOUND는호스트에서사용가능한세션이므로오픈환경시스템의 CUS TOM_GATEWAY 인 Host-link는프로세스사이에세션을공유할수없다. SNA LU 0 SNA LU 0 의 OUTBOUND 세션은일반세션, BID 세션, ROP 세션으로나뉜다. 세션명일반세션 BID 세션 ROP 세션 설명 Tmax 시스템에서제공하는서비스를요청하는세션이다. 이세션으로서비스가요청되면 Host-link 프로세스는 Host-link 환경설정파일에등록된방식으로 Tmax 시스템에서비스를요청한다. 업무적으로긴급한메시지를특정지역이나특정사람에게전달하기위해사용하는세션이다. 이세션으로서비스가요청되면 Host-link 프로세스는일반세션과같이환경설정파일에등록된방식으로 Tmax 시스템에서비스를요청한다. BID 세션으로전달할수없는많은데이터를전달하여출력하는세션이다. 이전에는어떠한문서를다른지역으로전달할때우편을이용하였으나이세션을이용하여해당지역의특정단말에데이터를전달하여바로출력할수있다. 이세션도환경설정파일에등록된방식으로 Tmax 시스템에서비스를요청한다. 8 Tmax Host-link Guide (SNA LU 0, SNA LU 6.2)

23 SNA LU 6.2 SNA LU 6.2의 OUTBOUND 세션은 Tmax 시스템에서제공하는서비스를요청하는세션이다. 이세션으로서비스가요청되면 Host-link 프로세스는환경설정파일에등록된방식으로 Tmax 시스템에서비스를요청한다 세션문제해결 Tmax 시스템에서제공하는문제해결방법을따른다. Host-link의문제해결은다음 3종류로분류된다. 세션특정세션이비정상적으로비활성화되었을경우 Host-link 프로세스는주기적으로해당세션을호스트로연결하려고한다. Link 세션 한 Host-link 프로세스는한 Link 세션만관리하는데주기적으로 Link 세션을감시한다. Link 라인이비 활성화상태에서활성화상태로변하면이에속한모든세션을호스트로연결하려고한다. 세션 Pool 한 Host-link 프로세스는최대 256개의세션을관리하는데여러 Host-link 프로세스를하나의 Pool 개념으로사용할수있다. 이때요청한서비스를수행하는 Host-link 프로세스에사용가능한세션이없을경우사용가능한세션을보유한다른 Host-link 프로세스로데이터를전달한다 세션 세션별문제해결은 Host-link 프로세스가관리하는특정세션이비활성화되었을경우이를다시호스트와정상적인세션으로연결하는것이다. Host-link 프로세스는특정세션이비활성화된것을감지하면먼저 SNA 서버와세션을종료하고처음세션을맺는절차에따라호스트와다시연결을시도한다. 연결을시도할때 Timeout으로시간을제한하기때문에반복해서연결을시도해도시스템에부하가생기지않는다. 세션별문제해결은다음의순서로진행된다. 1. SNA 서버와세션을종료한다. 2. SNA 서버에세션을초기화한다. 3. 호스트에세션정보를전송한다. 제 2 장세션관리 9

24 4. 호스트로부터 Bind 를수신하면정상적으로세션이연결됨을의미하고그렇지않을경우일정시간이 경과된이후에 3 번과정부터반복한다. 5. 정상적인세션으로등록한다 Link 세션 한 Link 세션에는최대 256개의세션을연결할수있다. Link 세션이비활성화되면해당 Link 세션에속한모든세션은호스트와연결이종료된다. Link 세션의문제해결은다음의순서로진행된다. 1. Tmax 시스템과연결을잠시종료한다. 2. SNA 서버와세션을종료한다. 3. Link 세션을감시한다. 4. Link 세션이정상적으로연결되면세션중하나만연결을시도한다. 5. 한세션이호스트로부터 Bind 수신을받으면모든세션을호스트와연결한다. 6. Tmax 시스템과다시연결하여스케줄링작업을진행한다 세션 Pool Host-link 시스템에속한한 Host-link 프로세스는최대 256개의세션만관리하므로 256개이상의서비스가동시에요청되면해당 Host-link 시스템은서비스를처리할수없다. 이러한경우자신이속한 Host-link 시스템에서사용가능한세션을찾아해당세션을관리하는 Host-link 프로세스에게데이터를전달하여서비스가처리된다. 참고 Host-link 시스템은 Tmax 환경설정파일의 SERVER 절에등록된한서버를의미한다. 한 Host-link 시스템에는여러개의 Host-link 프로세스를설정할수있으며프로세스의개수는 SERVER 절의 MIN 항목과 MAX 항목으로설정할수있다. 자세한설정방법은 SERVER 절 을참고한다. 10 Tmax Host-link Guide (SNA LU 0, SNA LU 6.2)

25 제 3 장환경설정 본장에서는 Host-link 를등록하는방법을설명한다 Tmax 환경설정파일 Host-link는 Tmax 환경설정파일에별도의절을갖지않고 SERVICE 절에추가만하면사용이가능하다. 단, 트랜잭션 (2PC, Synclevel2) 기능을사용하려면 SERVER 절대신 GATEWAY 절을사용해야한다. 현재트랜잭션게이트웨이는 LU 6.2에서만사용가능하고게이트웨이유형이 SNACICS인경우에만지원한다. 참고 각절의설정항목에대한자세한설명은 "Tmax Administration Guide" 를참고한다 SERVER 절 다음은 SERVER 절의형식이다. 실제등록하는내용은사용예제를참고한다. *SERVER Server Name... SVGNAME=server-group-name, SVRTYPE=CUSTOM_GATEWAY, [MIN=number,] [MAX=number] 필수항목 Server Name=string Host-link 공유메모리를관리하는서버명이므로반드시 SERVER 절에한번설정해야한다. 사용자가임의의이름으로등록할수있고, 등록한후반드시환경설정파일의 APPDIR 항목에서지 정한경로에등록한이름의 Host-link 프로그램을복사해야한다. SVGNAME=string 서버그룹명을설정한다. 제 3 장환경설정 11

26 선택항목 SVRTYPE=CUSTOM_GATEWAY 서버유형을설정한다. Host-link 이므로 CUSTOM_GATEWAY 로설정한다. MIN=numeric Host-link 프로세스의최소개수를설정한다. 범위 : 1 ~ MAX_INT 기본값 : 1 MAX=numeric Host-link 프로세스의최대개수를설정한다. 범위 : 1 ~ MAX_INT 기본값 : 1 사용예제 다음은 SERVER 절의설정에대한예제이다. *SERVER hkh snalugw... SVGNAME=svg1, SVRTYPE=CUSTOM_GATEWAY SVGNAME=svg1, MIN=2, MAX=2, SVRTYPE=CUSTOM_GATEWAY GATEWAY 절 다음은 GATEWAY 절의형식이다. GATEWAY 절은선택절로필요한경우관련내용을설정한다. 실제등 록하는내용은사용예제를참고한다. *GATEWAY Gateway Name NODENAME=node-name, GWTYPE=SNACICS, [CPC=channel-number] 12 Tmax Host-link Guide (SNA LU 0, SNA LU 6.2)

27 ... 필수항목 Gateway Name=string 게이트웨이이름으로 Host-link 실행파일명을설정한다. 사용자가임의의이름으로등록할수있고, 등록한후반드시환경설정파일의 APPDIR 항목에서지 정한경로에등록한이름의 Host-link 프로그램을복사해야한다. NODENAME=string 노드명을설정한다. GWTYPE=SNACICS 게이트웨이유형을설정한다. 현재지원하고있는 SNACICS 를설정한다. 선택항목 CPC = channel-number CPC 의수를설정한다. CPC 는 CLH Per Channel 의약자로, Tmax 시스템에서노드간의 CLH 프로세스채널수를의미한다. CLH 는서버와클라이언트를연결하는 Tmax 엔진이다. 사용예제 다음은 GATEWAY 절의설정에대한예제이다. *GATEWAY snacics_s snacics_r GWTYPE=SNACICS, NODENAME=node1, CPC=10 GWTYPE=SNACICS, NODENAME=node1, 제 3 장환경설정 13

28 ... CPC= SERVICE 절 다음은 SERVICE 절의형식이다. 실제등록하는내용은사용예제를참고한다. *SERVICE Service Name... SVRNAME=server-process-name 필수항목 Service Name=string 크기 : 16 자이내 ( 단, CONVERSION 의 Map 을사용하는경우 8 자이내의 string 으로설정한다. ) 서버프로그램내의함수이름 ( 서비스루틴명 ) 이사용된다. 반드시 SERVICE 절에서유일한 (unique) 이름이어야한다. 멀티도메인환경에서는모든도메인중에서유일한이름을권장한다. SVRNAME=server-process-name 서비스가속할서버명을설정한다. 사용예제 다음은 SERVICE 절의설정에대한예제이다. SNALUGW... SVRNAME=snalugw 3.2. Host-link 환경설정파일 Host-link 환경설정파일은 Host-link 시스템을실행하기위해필요한서비스정보, 데이터로깅, 데이터변환, 세션채널사용방식등다양한정보를등록하는파일이다. Host-link 환경설정파일은 8개의절로구성된다. HOSTLINK 절, SERVER 절, SERVICE 절, LUINFO 절은필수이고그외의절은필요한경우선택적으로설정한다. HOSTLINK 절전체적인 Host-link의환경을설정하는절이다. SERVER 절 14 Tmax Host-link Guide (SNA LU 0, SNA LU 6.2)

29 Host-link 서버의환경을설정하는절이다. SERVICE 절 SERVER 의 BID 서비스, ROP 서비스, OUT 서비스, TCL 서비스등을설정하는절이다. LOGGING 절 호스트와송수신하는모든데이터를지정한파일로저장하거나지정한서비스를호출할수있도록하 는절이다. CONVERSION 절 해당서버의데이터를변환하는절이다. DUMMYDATA 절호스트로부터수신한데이터의사이즈가 0이거나데이터중특정값이설정된경우 DUMMY 데이터로간주하도록설정하는절이다. DUMMYDATA 절은서버타입이 LU 0인경우에만설정한다. USERHEADER 절 Host-link 와오픈환경시스템사이에사용자헤더를설정하는절이다. LUINFO 절 호스트와 Host-link 시스템의세션정보를설정하는절이다 HOSTLINK 절 HOSTLINK 절은전체적인 Host-link 의환경을설정하는절로형식은다음과같다. *HOSTLINK Host-link Name TMAX = Y (N), SHMKEY = shared memory segment 키 필수항목 Host-link Name = string 크기 : 16 자이내 Host-link 이름을설정한다. 설정한이름은 HOSTLINK 절에서유일해야한다. 제 3 장환경설정 15

30 TMAX = Y N 필수항목으로현재는 Y 만지원한다. 다음은각설정값에대한설명이다. 설정값 Y N 설명 Tmax 와연동하여 Host-link 를운영한다. Host-link 를독립적으로운영한다. SHMKEY = numeric 범위 : ~ Host-link 는내부정보를공유메모리로관리하는데공유메모리의세그먼트를가리키는값이다 SERVER 절 SERVER 절은 Host-link 서버의환경을설정하는절이다. SERVER 절의형식은다음과같다. * SERVER Server Name TMAXSVRNAME = tmaxserver name, TMAXSVRNO = server index, SVRTYPE = {LU0 LU62S LU62R CTG CICSTCPIP IMSTCPIP }, [HLINKNAME = Host-Link명,] [FUNCTION = DPL DTP,] [HOSTID = host id,] [SESSION_TYPE = IMS_INITSELF IMS_AUTO CICS_INITSELF CICS_AUTO,] [MSGSIZE = 1 ~ MAX_INT,] [TIMEWAIT = WAIT NOWAIT,] [LINKDOWN_TIMEOUT = 1 ~ MAX_INT,] [SESSION_TIMEOUT = 1 ~ MAX_INT,] [BUFFERING = Y N,] [INBOUNDLU = (POOL) DEDICATE,] [BIDLU = (POOL) DEDICATE,] [LINKNAME = linkname,] [HOSTADDR = host ip 주소,] [HOSTPORT = host port,] [LISTENPORT = listen port,] [SESSION = 1 ~ MAX_INT,] [MAXSVR = 1 ~ MAX_INT,] 16 Tmax Host-link Guide (SNA LU 0, SNA LU 6.2)

31 [REPSEND = Y N,] [COMMSIZETYPE = INPUT_EQUAL INPUT_1024 INPUT_2048 INPUT_4096 [DELOUTHSIZE = 1 ~ MAX_INT,] [SVRLIST = 서버리스트 ] MAPFILE SPECIFY_SIZE,] 필수항목 Server Name=string 크기 : 16 자이내 서버이름으로 SERVER 절에서유일해야한다. 서버이름은한 Host-link 프로세스를표시하는논리명이다. Tmax 환경설정파일에한 Host-link 를서버로등록한후 MIN, MAX 항목을각 2 로설정했다면 SERVER 절에 2 개의서버가설정되어야한다. TMAXSVRNAME = string 크기 : 16 자이내 Tmax 환경설정파일의 SERVER 절에서설정한서버명과동일하게설정한다. TMAXSVRNO = string 크기 : 16 자이내 Tmax 환경설정파일의 SERVER 절에서 MIN, MAX 항목값에따른 Index 를설정한다. SERVER 절의 MIN, MAX 를각각 2 로설정한경우 Index 는 00 부터시작하여 00, 01 로설정할수있 다. SVRTYPE = {LU0 LU62S LU62R CTG CICSTCPIP IMSTCPIP} 호스트와통신할프로토콜의유형을설정한다. 현재 LU0, LU62S, LU62R, CTG 만지원한다. 제 3 장환경설정 17

32 선택항목 HLINKNAME = string 크기 : 16 자이내 HOSTLINK 절의 Host-link Name 과동일하게설정한다. FUNCTION = DPL DTP 함수를호출하는방식을설정한다. SVRTYPE 항목이 LU62S 혹은 LU62R 인경우에만설정한다. HOSTID = string 크기 : 4 자이내 세션을맺고자하는호스트의 ID 를설정한다. Host-link 가해당호스트와세션을연결하기위해 Initself 데이터를호스트로전송하는데 HOSTID 가 Initself 데이터에포함된다. SVRTYPE 항목을 LU0 으로설정한경우에만해당되는항목으로 SVRTYPE 이 LU0 로설정되는경우 필수로설정해야한다. SESSION_TYPE = IMS_INITSELF IMS_AUTO CICS_INITSELF CICS_AUTO 기본값 : IMS_INITSELF 호스트와세션연결을할때 Initself 처리방식을설정한다. SVRTYPE 항목을 LU0 으로설정한경우에만해당되는항목이다. MSGSIZE = numeric 범위 구분 LU 0 LU 6.2 설명 1~MAX_INT 1024~MAX_INT ( 단, OpenFrame 의 CICS 를사용할경우 으로설정한다. ) 기본값 : Tmax Host-link Guide (SNA LU 0, SNA LU 6.2)

33 TIMEWAIT = WAIT NOWAIT Tmax 클라이언트, 서버에서타임아웃이발생했을때의동작을설정한다. 다음은각설정값에대한설명이다. 구분 WAIT NOWAIT 설명 해당세션을그대로사용한다. 해당세션을끊고다시세션을시작한다. LINKDOWN_TIMEOUT = numeric 범위 : 1~MAX_INIT Host-link 와호스트간의 Link 라인이끊어졌을때 Link 라인이활성화되어있는지를체크하는시간간 격을설정한다. SESSION_TIMEOUT = numeric 크기 : 1~MAX_INIT 세션이끊어졌을때세션이활성화되어있는지를체크하는시간간격을설정한다. BUFFERING = Y N Pool 방식으로세션을사용할때설정한다. Host-link 프로세스에사용가능한세션이없는경우의동작을설정한다. 다음은각설정값에대한설명이다. 구분 Y N 설명 다른프로세스로요청을하지않고가능한세션이생길때까지큐에저장한다. 다른프로세스로요청을전달한다. INBOUNDLU = (POOL) DEDICATE Host-Link 에서세션을운용할수있는방식을설정한다. Pool 방식과 Dedicate 방식의자세한내용은 2.1. INBOUND 를참고한다. SVRTYPE 항목을 LU0 으로설정한경우에만해당되는항목이다. 제 3 장환경설정 19

34 LINKNAME = string 크기 : 16 자이내 호스트와통신할때물리적으로연결할이름을설정한다. 이름은 sna d l 명령을통하여확인할수 있다. Host-link 는 LINKNAME 이활성화된경우에만서비스를수행한다. 활성화상태가아닌경우 tmadmin 으로 Host-link 프로세스를확인하면 NOT-READY 로나타난다. SVRTYPE 항목을 LU0, LU6.2S, LU6.2R 로설정되는경우필수로설정해야한다. BIDLU = (POOL) DEDICATE BID 데이터의처리방식을설정한다. Pool 방식과 Dedicate 방식의자세한내용은 2.1. INBOUND 를참고한다. SVRTYPE 항목을 LU0 으로설정한경우에만해당되는항목이다. HOSTADDR = literal 크기 : 255 자이내 호스트주소를설정한다. SVRTYPE 항목을 CICSTCPIP 또는 IMSTCPIP 설정한경우에만해당되는항목으로현재는사용하 지않는다. HOSTPORT = numeric 범위 : 1~MAX_INT 호스트포트를설정한다. SVRTYPE 항목을 CICSTCPIP 또는 IMSTCPIP 설정한경우에만해당되는항목으로현재는사용하 지않는항목이다. LISTENPORT = numeric 범위 : 1~MAX_INT Listen 하고있는포트를설정한다. 20 Tmax Host-link Guide (SNA LU 0, SNA LU 6.2)

35 SVRTYPE 항목을 CICSTCPIP 또는 IMSTCPIP 설정한경우에만해당되는항목으로현재는사용하 지않는항목이다. SESSION = numeric 범위 : 1~MAX_INT SVRTYPE 항목을 CTG 로설정한경우이값은호스트와연결할세션값을의미한다. LU0, LU6.2 의경우해당서버 LU 의세션수의합으로자동설정되므로별도로설정할필요가없다. MAXSVR = numeric 범위 : 1~MAX_INT Tmax 환경설정파일에서 MIN, MAX 항목에설정된값과동일하게설정한다. Host-link 프로세스가기동할때 'SESSION' 에서설정한개수만큼의세션이 Host-link 프로세스에연 결된다. SVRTYPE 항목을 CTG 로설정한경우에만해당되는항목이다. COMMSIZETYPE = INPUT_EQUAL INPUT_1024 INPUT_2048 INPUT_4096 MAPFILE SPECI FY_SIZE COMMAREA 의크기를설정한다. 다음은세부설정값에대한설명이다. 구분 INPUT_EQUAL INPUT_1024 INPUT_2048 INPUT_4096 MAPFILE SPECIFY_SIZE 설명입력데이터의크기와동일하게설정한다. 입력데이터와크기가같거나큰수중가장가까운 1024 배수로설정된다. 입력데이터와크기가같거나큰수중가장가까운 2048 배수로설정된다. 입력데이터와크기가같거나큰수중가장가까운 4096 배수로설정된다. MAP 파일의 'COMMSIZE' 와동일한값이설정된다. 'MSGSIZE' 와동일한값이설정된다. SVRTYPE 항목을 LU62S 로설정한경우에만해당되는항목이다. DELOUTHSIZE = numeric 제 3 장환경설정 21

36 범위 : 1~MAX_INT 호스트가데이터를수신할때버릴데이터의크기를설정한다. 데이터의앞에서부터설정된크기만 큼버린다. SVRTYPE 항목을 LU0 또는 LU62S 로설정한경우에만해당되는항목이다. SVRLIST = string 크기 : 256 자이내 SVRTYPE 항목을 CTG 로설정한경우에만해당되는항목이다. 사용예제 다음은세션운영과관련된 'INBOUNDLU','BIDLU','FUNCTION' 항목설정에대한예제이다. SNA LU 0 INBOUNDLU 항목을 POOL로설정하면 Host-link는연결된세션을통해 Round Robin 방식으로호스트에서비스를요청한다. BIDLU 항목을 DEDICATE으로설정하면특정한세션으로 BID 데이터를받는다. *SERVER snalugw00... INBOUNDLU=POOL, BIDLU=DEDICATE,... SNA LU 6.2 FUNCTION 항목을 DPL 로설정하면 Tmax 시스템에서호스트로서비스를요청할때 DPL 방식으로세 션을사용한다. *SERVER snalusgw00... FUNCTION=DPL, SERVICE 절 SERVICE 절은 SERVER 의 BID 서비스, ROP 서비스, OUT 서비스, TCL 서비스등을설정하는절로형식 은다음과같다. 22 Tmax Host-link Guide (SNA LU 0, SNA LU 6.2)

37 *SERVICE Server Name [BIDSVCNAME = BID svc name,] [BIDSVCPOS = 1 ~ MAX_INT,] [BIDSVCSIZE = 1 ~ 16,] [ROPSVCNAME = ROP svc name,] [ROPSVCPOS = 1 ~ MAX_INT,] [ROPSVCSIZE = 1 ~ 16,] [OUTSVCNAME = outsvc name,] [OUTSVCPOS = 1 ~ MAX_INT,] [OUTSVCSIZE = 1 ~ 16,] [RLYSVCNAME = relay svc name,] [RLYSVCPOS = 1 ~ MAX_INT,] [RLYSVCSIZE = 1 ~ 16,] [TCLSVCNAME = tclsvc name,] [TCLSVCPOS = 1 ~ MAX_INT,] [TCLSVCSIZE = 1 ~ 16,] [CANSVCNAME = cansvc name,] [POSTOKSVCNAME = postoksvc name,] [POSTFAILSVCNAME = postfailsvc name] 필수항목 Server Name=string 크기 : 16 자이내 SERVER 절에서설정한서버명과동일하게설정한다. 선택항목 BIDSVCNAME = string 크기 : 16 자이내 호스트에서강제로전송한 BID 데이터를처리할 Tmax 시스템의서비스명을설정한다. 등록한서비스명은반드시 Tmax 시스템에등록된이름이어야한다. BIDSVCPOS = numeric 범위 : 1~MAX_INT BID 데이터를처리할서비스를 BID 데이터중어느위치에서가져올것인지설정한다. 설정한위치의서비스명은반드시 Tmax 시스템에등록된이름이어야한다. 제 3 장환경설정 23

38 설정하면 BIDSVCNAME 항목에서정의한서비스명은사용하지않는다. BIDSVCSIZE = numeric 범위 :1~16 BID 데이터를처리할서비스를 BID 데이터중특정위치에서가져올때, 서비스명의길이를설정한 다. BIDSVCPOS 항목을설정한경우이항목은반드시설정해야한다. ROPSVCNAME = string 크기 : 16 자이내 호스트에서특정단말에접속한프린터에데이터를전송한경우이데이터를처리할 Tmax 시스템의 서비스를설정한다. 설정한서비스명은반드시 Tmax 시스템에등록된이름이어야한다. ROPSVCPOS = numeric 범위 : 1~MAX_INT ROP 데이터를처리할서비스를 ROP 데이터중어느위치에서가져올것인지설정한다. 설정한위치의서비스명은반드시 Tmax 시스템에등록된이름이어야한다. 설정하면 ROPSVCPOS 항목에서정의한서비스명은사용하지않는다. ROPSVCSIZE = numeric 범위 : 1~16 ROP 데이터를처리할서비스를 ROP 데이터중특정위치에서가져올때, 서비스명의길이를설정한 다. OUTSVCNAME = string 크기 : 16 자이내 호스트로부터요청한데이터를처리할 Tmax 시스템의서비스명을설정한다. 24 Tmax Host-link Guide (SNA LU 0, SNA LU 6.2)

39 OUTSVCPOS 항목을등록하지않고이항목만등록할경우호스트로부터요청한모든데이터는이 항목에서정의한서비스로요청된다. 설정한서비스명은반드시 Tmax 시스템에등록된이름이어야한다. OUTSVCPOS = numeric 범위 : 1~MAX_INT 호스트로부터요청한데이터를처리할서비스를 OUTBOUND 데이터중어느위치에서가져올것인 지설정한다. 설정한위치의서비스명은반드시 Tmax 시스템에등록된이름이어야한다. 설정하면 OUTSVCNAME 항목에서정의한서비스명은사용하지않는다. OUTSVCSIZE = numeric 범위 : 1~16 OUTBOUND 데이터를처리할서비스를 OUTBOUND 데이터중특정위치에서가져올때, 서비스명 의길이를설정한다. RLYSVCNAME = string 크기 : 16 자이내 tpforward 로 Host-link 서비스를호출할경우 Host-link 시스템은처리결과를항상 Relay 서비스로연 계한다. Flag 에 TPNOREPLY 값을설정하는것과관계없이 Host-link 시스템은호스트로서비스를요 청하고응답받은데이터를이항목에서정의한서비스로 tprelay 를한다. RLYSVCPOS 항목과 RLYSVCSIZE 항목이설정된경우이항목은무시된다. 사용자헤더에 Relay 할 서비스가동시에설정된경우이항목이우선순위를갖는다. 설정한서비스명은반드시 Tmax 시스템에등록된이름이어야한다. RLYSVCPOS = numeric 범위 : 1~MAX_INT tpforward 로 Host-link 서비스를호출하고호스트로부터받은응답데이터중 tprelay 할서비스명의위 치를설정한다. 제 3 장환경설정 25

40 RLYSVCSIZE 항목이동시에설정된경우이항목이우선순위를갖는다. 설정하면 RLYSVCNAME 항목에서정의한서비스명은사용하지않는다. RLYSVCSIZE = numeric 범위 : 1~16 호스트로부터받은응답데이터중에서 tprelay 할서비스명을찾을때서비스명의길이를설정한다. TCLSVCNAME = string 크기 : 16 자이내 tpacall 에 Flag 값을 TPNOREPLY 로설정하여 Host-link 를호출한경우 Host-link 는호스트로서비스 를요청하고응답받은데이터를처리할수가없다. 이항목을설정하면 Host-link 는정의한서비스로 tpacall 한다. TCLSVCPOS 항목과 TCLSVCSIZE 항목이설정된경우이항목은무시된다. 사용자헤더에 Relay 할서비스가동시에설정된경우이항목이우선순위를갖는다. 설정한서비스명은반드시 Tmax 시스템에등록된이름이어야한다. TCLSVCPOS = numeric 범위 : 1~MAX_INT tpacall 에 Flag 값을 TPNOREPLY 로설정하여 Host-link 를호출한경우호스트로부터받은응답데이 터중에서 tpacall 할서비스명을찾을위치를설정한다. 설정하면 TCLSVCNAME 항목에서정의한서비스명은사용하지않는다. TCLSVCSIZE 항목이동시에설정된경우이항목이우선순위를갖는다. TCLSVCSIZE = numeric 범위 : 1~16 tpcall 할서비스명을호스트로부터받은응답데이터중에서찾을때서비스명의길이를설정한다. CANSVCNAME = string 26 Tmax Host-link Guide (SNA LU 0, SNA LU 6.2)

41 크기 : 16 자이내 호스트로부터응답이타임아웃이후에온다면데이터가버려지는데이항목을설정하면 Host-link 는 정의한서비스로 tpacall 한다. SVRTYPE 항목을 LU62S 로설정한경우에만해당되는항목이다. 설정한서비스명은반드시 Tmax 시스템에등록된이름이어야한다. POSTOKSVCNAME = string 크기 : 16 자이내 SVRTYPE 항목을 LU0 또는 LU62R 로설정한경우에만해당되는항목이다. 호스트로데이터를성공적으로전달하면해당데이터를정의한서비스로 tpacall 을한다. 설정한서비스명은반드시 Tmax 시스템에등록된이름이어야한다. POSTFAILSVCNAME = string 크기 : 16 자이내 SVRTYPE 항목을 LU0 또는 LU62R 로설정한경우에만해당되는항목이다. 호스트로데이터전달을실패하면해당데이터를정의한서비스로 tpacall 을한다. 설정한서비스명은반드시 Tmax 시스템에등록된이름이어야한다 LOGGING 절 LOGGING 절은호스트와송수신하는모든데이터를지정한파일로저장하거나지정한서비스를호출할 수있도록하는절로형식은다음과같다. * LOGGING Log Server Name [LOGPATH = log path,] [LOGTYPE = (HEX) TEXT E2A,] [LOGSVC = log 서비스명 ] 필수항목 Log Server Name=string 제 3 장환경설정 27

42 크기 : 16 자이내 로그를남길서버를설정하는항목으로 SERVER 절에서설정한서버명과동일하게설정한다. 설정하면해당서버는로그를파일로남기거나 LOGSVC 항목에설정한서비스를호출할수있게된 다. 선택항목 LOGPATH = string 크기 : 16 자이내 로그파일의경로와이름을설정한다. 절대경로 (/ 로시작되는경로 ) 로정의하면그경로를그대로사용한다. 상대경로 (/ 로시작되지않는경 로 ) 로정의하면 Tmax 의환경설정파일 NODE 절의 ULOGDIR 항목에정의한디렉터리의하위경로 에로그파일이저장된다. LOGSVC 항목이설정된경우이항목은무시된다. LOGTYPE 항목을동시에정의하지않으면로깅은실행되지않는다. LOGTYPE = (HEX) TEXT E2A 데이터를로깅할때어떤형식으로할것인지를설정한다. 다음은각세부설정값에대한설명이다. 설정값 HEX TEXT E2A 설명출력데이터를 16진수값으로출력한다. ( 기본값 ) 문자열형태의데이터를라인단위로출력한다. EBCDIC 코드를 ASCII 코드로변환한후 HEX로출력한다. LOGPATH 항목을동시에정의하지않으면로그를남길서버명으로로그파일이저장된다. LOGSVC = string 크기 : 16 자이내 송수신데이터를로깅할때 Host-link 시스템에서제공하는파일에로깅하지않고사용자가작성한서 비스로로깅하고자할때설정한다. 28 Tmax Host-link Guide (SNA LU 0, SNA LU 6.2)

43 Host-link 시스템은특정헤더 (LOGHEADER, userinc/hlinkapi.h) 를추가하여데이터와같이서비스를 호출한다. 설정한서비스명은반드시 Tmax 시스템에등록된이름이어야한다. 사용예제 데이터로깅의예제는다음과같다. *LOGGING snalu0gw00 LOGPATH=aaa, LOGTYPE=HEX, LOGSVC=LOGSVC Tmax 환경설정파일의 NODE 절에 ULOGDIR=/home/tmax/log/ulog 로설정하면로그파일은 < /home/tmax/log/ulog/aaa_ 서버 index. 현재시간 > 으로저장된다. LOGTYPE 항목을 HEX 로설정하였으므로다음과같이 HEX 값으로데이터를저장한다. HOSTLINK HOST Length[70] time[14:10:58.375] e3f1c9d8 c3e5c840 40d3f0f f9f1f0 4040f0f0 f0f e5c8e3 f5f0f040 d a040f4f5 f9f9f5f0 f4f0f0f f0f91ed5 1e0d... HOST HOSTLINK Length[70] time[14:10:58.376] e3f1c9d8 c3e5c840 40d3f0f f9f1f0 4040f0f0 f0f e5c8e3 f5f0f040 d a040f4f5 f9f9f5f0 f4f0f0f f0f91ed5 1e0d... LOGSVC 항목을설정했으므로 Host-link 시스템이제공하는파일에로깅하지않고설정한 LOGSVC로 로깅한다 CONVERSION 절 CONVERSION 절은해당서버의데이터를변환하는절로형식은다음과같다. * CONVERSION Server Name [INBOUND = Y (N)] [INBOUND_KOR = Y (N),] [INBOUND_SKIP = 1 ~ MAX_INT,] [OUTBOUND = Y (N),] 제 3 장환경설정 29

44 [OUTBOUND_KOR = Y (N),] [OUTBOUND_SKIP = 1 ~ MAX_INT,] [MAPPATH = map path] 필수항목 Server Name=string 크기 : 16 자이내 SERVER 절에서설정한서버명과동일하게설정한다. 선택항목 INBOUND = Y (N) 기본값 : N 항목을 Y로설정하면 Host-link는호스트로전송하는모든데이터를 ASCII에서 EBCDIC으로, 완성형한글을조합형한글로변환한다. 한글을변환할경우 ASCII는 2 Byte 중첫번째 Byte의첫비트가 1로되어있으면이를한글로인식하는데호스트는한글시작과끝을의미하는문자를두어한글인지 EBCDIC 코드인지판단한다. 예를들어 ' 홍길동 ' 을변환할경우 '0x0e홍길동0x0f' 으로변환된다. ' 홍길동 ' 의경우 '0x0e홍0x0f + space + 0x0e길0x0f + space + 0x0e동0x0f' 로변환된다. INBOUND_KOR = Y (N) 기본값 : N 코드를변환할때한글을포함할것인지를설정한다. 다음은세부설정값에대한설명이다. 설정값 Y N 설명 한글을포함하여 ASCII 를 EBCDIC 으로변환한다. 한글은변환하지않고 ASCII 를 EBCDIC 으로만변한다. INBOUND = N 으로설정된경우 INBOUND_KOR=Y 로설정된설정값은무시된다. INBOUND_SKIP = numeric 범위 : 1~MAX_INT 30 Tmax Host-link Guide (SNA LU 0, SNA LU 6.2)

45 코드를변환할때제외할특정 Byte 를설정한다. 데이터에 HEX 데이터가포함된경우이를무시하기위해사용한다. INBOUND =N 으로설정된경우 INBOUND_SKIP 에설정된내용은무시된다. OUTBOUND = Y (N) 기본값 : N 항목을 Y 로설정하면 EBCDIC 을 ASCII 로, 조합형한글을완성형한글로변환한다. 한글시작과끝을 의미하는문자는 Space 로변환되어맨끝에삽입된다. 예를들어 '0x0e 홍길동 0x0f' 의경우 ' 홍길동 +space+space' 로변환된다. OUTBOUND_KOR = Y (N) 기본값 : N 코드를변환할때한글을포함할것인지를설정한다. 다음은세부설정값에대한설명이다. 설정값 Y N 설명 한글을포함하여 ASCII 를 EBCDIC 으로변환한다. 한글은변환하지않고 ASCII 를 EBCDIC 으로만변한다. OUTBOUND = N 로설정된경우 OUTBOUND_KOR=Y 로설정된설정값은무시된다. OUTBOUND_SKIP = numeric 범위 : 1~MAX_INT 코드를변환할때제외할특정 Byte 를설정한다. 데이터에 HEX 데이터가포함된경우이를무시하기위해사용한다. OUTBOUND =N 으로설정된경우 OUTBOUND_SKIP 에설정된내용은무시된다. MAPPATH = literal 크기 : 255 자이내 제 3 장환경설정 31

46 Host-link 와호스트가통신을하려면각서비스에서처리하는포맷으로데이터를주고받아야한다. 각포맷을정의하는파일이존재하는디렉터리를설정한다. 파일명은다음과같다. 구분 LU0 LU62S LU62R 설명데이터앞부분 8 Byte( 사용자헤더가있을경우는사용자헤더이후 8 Byte) 를사용한다. TPGWINFO_T 데이터구조체의 pgmname을사용한다. Tmax의서비스명을사용한다. Map 파일명이 8자이므로 Tmax 서비스는 8자이내로정의되어야한다. 사용예제 데이터변환예제는다음과같다. *CONVERSION snalugw00 INBOUND=Y, INBOUND_KOR=N, INBOUND_SKIP=50, OUTBOUND=N, OUTBOUND_KOR=N, OUTBOUND_SKIP=55,... 예제를실행하면 Host-link는호스트로전송하는모든데이터를 ASCII에서 EBCDIC으로, 완성형한글을조합형한글로변환한다. INBOUND_KOR 항목은 N으로설정했으므로한글은제외하고변환이진행되고 INBOUND_SKIP 항목에서설정한만큼제외하여변환한다. INBOUND와반대로 OUTBOUND 항목은 N으로설정했으므로 EBCDIC에서 ASCII로의변환은수행되지않는다. CONVERSION 절에서 MAPPATH 항목을설정하는경우 Map 파일을등록해야한다. MAP 파일명은 MAPPATH에서정의된패스에존재해야하며, < 파일명.map> 파일로등록되어야한다. 파일명은 8자이내로정의해야한다. 다음은 Map 파일의등록예제이다. # COMMSIZE는 INPUT/OUTPUT에서같이사용해야함으로 INPUT/OUTPUT중 # 큰 size의값을입력해야합니다. *COMMSIZE 1024 *INPUT 32 Tmax Host-link Guide (SNA LU 0, SNA LU 6.2)

47 # # 항목명항목길이데이터타입 # 데이터타입 : 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 <USER1> e1 6 CHAR e2 10 KOREAN e3 8 BINARY </USER1> 다음은 Map 파일의각항목에대한설명이다. 항목 COMMSIZE 설명 리모트노드와송수신하는데이터의길이를설정하는항목이다. 모든서비스메시지중가장긴메시지의길이로입력해야한다. INPUT 게이트웨이에서리모트노드로전송하는메시지의정보를등록하는항목이다. 게이트웨이에서리모트노드로서비스를요청하는경우리모트노드로요청하 는메시지의포맷을등록한다. 반대로리모트노드에서 Tmax 로서비스를요청 하는경우에는 Tmax 서비스의처리결과의포맷을등록한다. OUTPUT 리모트노드에서게이트웨이로수신받은메시지의정보를등록하는항목이다. 게이트웨이에서리모트노드로서비스를요청하는경우리모트노드에서처리한결과를수신받는메시지의포맷을등록한다. 반대로리모트노드에서 Tmax 로서비스를요청하는경우에는 Tmax로서비스를요청하는메시지의포맷을등록한다. 항목명 항목길이 사용자가참조용으로만사용하는이름이다. 게이트웨이는항목명으로인식하고 내부에서는사용하지않는다. 송수신데이터에서각항목의실제길이를나타낸다. 각항목의길이만표현하면게이트웨이내부에서 Offset 로변환하여사용한다. Offset 는항상 0 부터시작한다. 제 3 장환경설정 33

48 항목 데이터타입 설명 송수신데이터에서각항목의데이터타입을지정한다. 선택할수있는유형은다음표에서상세하게설명한다. 앞에서설명한항목중데이터타입항목에서선택할수있는타입은다음과같다. 타입 CHAR 설명 영문자, 숫자, 한글포함하는경우에사용한다. CHAR 타입을사용하는경우변 환후메시지의사이즈에대해정확히설정해야한다. 한글이포함된경우한글과다른코드 ( 영문자, 숫자, 특수문자 ) 사이에한글의시 작과끝문자가포함된다. UNIX 로전환할경우한글시작과끝문자는스페이스 로변경되어맨끝으로이동된다. NUMERIC 데이터가모두숫자인경우에사용하고코드변환은 CHAR 타입과동일하다. NUMERIC 이 Integer 를의미하는것은아님을주의한다. KOREAN 데이터가모두한글인경우사용한다. 2 Byte 단위로코드가변환된다. SOSI CHARSOSI BINARY KOREAN과유사하나호스트로전환할때처음과끝에한글시작과끝문자가포함된다. UNIX로전환할때에는한글시작과끝문자가스페이스로변경되어맨끝으로이동된다. SOSI와비슷하나 UNIX로전환할때한글시작과끝문자를전환하지않고그대로둔다. 호스트에서 UNIX로의전환만지원된다. 이타입의데이터는코드변환이수행되지않는다. 데이터중코드를변환하지않고자하는경우에는이타입으로설정한다. USER-TYPE Array 형식의데이터타입을지정하고자할경우에사용한다. 예를들어화면에여러개의항목이반복해서나올경우에각항목을반복횟수만큼등록해야하는번거로움이있다. 또는반복횟수를데이터로표현하는경우에는몇번의반복이되는지를알수없어코드변환이어렵다. 이를위해사용자는사용자정의타입을지정하여 Array 형태의데이터를쉽게변환할수있다. 위의 Map 파일에서 USER1는사용자가지정한사용자정의타입이다. 타입이름은사용자가임의로지정하면된다. 주의할점은, 사용자정의타입의데이터에서항목길이는 Array의반복횟수가저장될버퍼의크기를지정한다는점이다. 즉, Array의반복횟수는매전문마다유동적이다. 반복횟수의값은당연히숫자이며 CHAR 형태로저장되어야한다. 이후 Array 의각항목이시작되기전 <USER-TYPE>, 끝난후 </USER-TYPE> 를삽입해야한다. 위의경우에는 e1, 34 Tmax Host-link Guide (SNA LU 0, SNA LU 6.2)

49 타입 설명 e2, e3 을 Array 항목으로인식하며, 매전문의 e 항목의시작위치에서항목길이 인 3 만큼먼저읽어서반복횟수를읽어들인후, 그횟수만큼코드를반복하여 변환한다. 제 3 장환경설정 35

50 DUMMYDATA 절 DUMMYDATA 절은호스트로부터수신한데이터의사이즈가 0이거나데이터중특정값이설정된경우 DUMMY 데이터로간주하도록설정하는절이다. DUMMYDATA 절은서버타입 (SVRTYPE) 이 LU0인경우에만설정한다. 다음은 DUMMYDATA 절의형식이다. * DUMMYDATA Server Name [ZEROSIZE = (Y) N,] [DUMMYPOS = dummy position,] [DUMMYVAL = dummy value] 필수항목 Server Name=string 크기 : 16 자이내 SERVER 절에서설정한서버명과동일하게설정한다. 선택항목 ZEROSIZE = (Y) N 기본값 : Y 호스트로부터수신한데이터의길이가 0 Byte 인경우에사용하는항목이다. 다음은세부설정값에대한설명이다. 구분 Y N 설명호스트에서 0 Byte가수신되어도응답으로간주하고 Host-link 시스템의서비스를호출할클라이언트에응답을전송한다. 0 Byte가수신된경우해당데이터를무시한다. DUMMYPOS = numeric 범위 : 1~MAX_INT 호스트로부터수신한데이터에서무시하고자하는값이있는위치를설정한다. 설정하지않으면수신된모든데이터는클라이언트로전달된다. 36 Tmax Host-link Guide (SNA LU 0, SNA LU 6.2)

51 DUMMYVAL = string 크기 : 16 자이내 DUMMYPOS 항목에서지정한위치의값과비교할값을설정한다. 설정한값은 EBCDIC 코드로변환하여비교한다 USERHEADER 절 USERHEADER 절은 Host-link 와오픈환경시스템사이에사용자헤더를설정하는절로형식은다음과 같다. * USERHEADER Server Name [HSIZE = 1 ~ 512,] [SVCPOS = 1 ~ HSIZE - 1,] [SVCSIZE = 1 ~ 16,] [LUTYPEPOS = 1 ~ HSIZE - 1,] [LUTYPESIZE = 1 ~ 8,] [LUNAMEPOS = 1 ~ HSIZE - 1,] [LUNAMESIZE = 1 ~ 8,] [WSNAMEPOS = 1 ~ HSIZE - 1,] [WSNAMESIZE = 1 ~ 8,] [ERRCODEPOS = 1 ~ HSIZE - 1,] [ERRCODESIZE = 1 ~ 4,] [TIMEWAITPOS = 1 ~ HSIZE - 1] 필수항목 Server Name=string 크기 : 16 자이내 SERVER 절에서설정한서버명과동일하게설정한다. 선택항목 HSIZE = numeric 범위 : 1~512 헤더의길이를설정한다. 제 3 장환경설정 37

52 Host-link 는헤더데이터를보관했다가호스트로부터응답을수신하면해당헤더데이터를응답앞부 분에추가하여오픈환경시스템으로전송한다. 또한호스트로부터요청한서비스나 BID 데이터를 받은경우에도이헤더를수신데이터앞에추가하여지정한서비스를호출한다. 헤더데이터중에서세션을찾을정보를가져오므로세션운용을 Dedicate 방식으로설정하는경우 이헤더를반드시지정해야한다. SVCPOS = numeric 범위 : 1~HSIZE-1 사용자헤더데이터중에서서비스명의위치를설정한다. tpacall 에 TPNOREPLAY 나 tpforward 로 Host-link 를호출하고호스트로부터응답을수신하면 Hostlink 는이항목에설정한서비스명으로서비스를호출한다. SVCSIZE = numeric 범위 : 1~16 사용자헤더데이터중에서서비스명의길이를설정한다. LUTYPEPOS = numeric 범위 : 1~HSIZE-1 Host-link 시스템이데이터를호스트로전송할때업무별로구분된세션중원하는세션의위치를설 정한다. 한 Host-link 에속한많은세션을업무별로구분하여사용할경우설정하는항목이다. SVRTYPE 항목이 LU0 인경우에만사용하는항목이다. LUTYPESIZE = numeric 범위 : 1~8 Host-link 시스템이데이터를호스트로전송할때업무별로구분된세션중특정세션의길이를설정 한다. SVRTYPE 항목이 LU0 인경우에만사용하는항목이다. 38 Tmax Host-link Guide (SNA LU 0, SNA LU 6.2)

53 LUNAMEPOS = numeric 범위 : 1~HSIZE-1 Host-link 시스템이오픈환경시스템에요청한서비스를송수신할때사용하는세션의위치를설정한 다. SVRTYPE 항목이 LU0 인경우에만사용하는항목이다. LUNAMESIZE = numeric 범위 : 1~8 Host-link 시스템이 Open 환경시스템에요청한서비스를송수신할때사용하는세션의길이를설정 한다. SVRTYPE 항목이 LU0 인경우에만사용하는항목이다. WSNAMEPOS = numeric 범위 : 1~HSIZE-1 Host-link 시스템이세션운용을 Dedicate 방식으로사용할경우에만사용하는항목이다. 특정세션으로데이터를송수신하기위해세션의위치를설정한다. Host-link 시스템이세션운용을 Dedicate 방식으로사용할경우에만사용하는항목이므로,SVRTYPE 항목이 LU0 인경우에만사용하는항목이다. WSNAMESIZE = numeric 범위 : 1~8 특정세션으로데이터를송수신하기위해세션의길이를설정한다. Host-link 시스템이세션운용을 Dedicate 방식으로사용할경우에만사용하는항목이므로 SVRTYPE 항목이 LU0 인경우에만사용하는항목이다. ERRCODEPOS = numeric 범위 : 1~HSIZE-1 제 3 장환경설정 39

54 Host-link 시스템이호스트로서비스를요청할때오류가발생하거나타임아웃으로응답을수신하지 못할때오픈환경시스템에오류코드를전달하기위해사용하는항목이다. 오류코드가있는위치를설정한다. Host-link 는이항목에설정한위치에 ERRCODESIZE 항목에서설정한길이의오류코드를문자로 변환하여응답한다. ERRCODESIZE = numeric 범위 : 1~4 ERRCODEPOS 항목과함께사용하는항목으로오류코드의길이를설정한다. TIMEWAITPOS = numeric 범위 : 1~HSIZE-1 타임아웃이발생했을때세션을끊고다시시작할것인지 (NOWAIT), 세션을그대로사용할것인지 (WAIT) 를설정한위치를설정한다. 게이트웨이헤더 SVRTYPE 항목이 LU62S 의경우사용자헤더전에반드시게이트웨이헤더가있어야한다. 게이트웨이헤더는 <usrinc/hlinkapi.h> 에다음과같이선언되어있다. struct tpgwinfo { char svc[xatmi_service_name_length]; char trxid[host_trans_length]; char pgmname[host_program_length]; char userid[host_userid_size]; char passwd[host_passwd_size]; char resvd[16]; }; typedef struct tpgwinfo TPGWINFO_T; 다음은각멤버에대한설명이다. 호출될호스트의프로그램명을설정한다. 멤버 char svc[xatmi_ser VICE_NAME_LENGTH] 설명 Non Blocking 모드로사용하는경우나비동기방식일때응답 데이터를처리할서비스명을설정한다. 40 Tmax Host-link Guide (SNA LU 0, SNA LU 6.2)

55 멤버 char trxid[host_trans_length] 설명 호출될호스트의 TP 명을설정한다. 이항목은 SVRTYPE 이 LU62S 이고 function 이 DPL 일경우필 수적으로기재해주어야하는항목이다. 크기는 4 자이내로설 정한다. char pgmname[host_pro GRAM_LENGTH] char userid[host_userid_size] char passwd[host_passwd_size] char resvd[16] 호출될호스트의프로그램명을설정한다. SVRTYPE 항목이 LU62S 로설정된경우이항목에설정된이름으로 MAP 파일을참조한다. 사용자 ID를설정한다. 비밀번호를설정한다. 현재사용되지않는다. 사용예제 사용자헤더의예제는다음과같다. *USERHEADER snalu0gw00 HSIZE=41, <-- user total header size SVCPOS=1, <-- user defined svc name position SVCSIZE=15, <-- user defined svc name length LUTYPEPOS=16, <-- inbound lu type position LUTYPESIZE=7, <-- inbound lu type length LUNAMEPOS=23, <-- output only, lu name position LUNAMESIZE=7, <-- output only, lu name length WSNAMEPOS=30, <-- only INBOUNDLU is DEDICATE WSNAMESIZE=7, <-- only INBOUNDLU is DEDICATE ERRCODEPOS=37, <-- output only ERRCODESIZE=3, <-- output only TIMEWAITPOS=40 <-- time wait position LUINFO 절 LUINFO 절은호스트와 Host-link 시스템의세션정보를설정하는절이다. LUINFO 절의형식은다음과같다. *LUINFO LU Name SVRNAME = servername [HOSTID = host id,] [WSNAME = ws name,] 제 3 장환경설정 41

56 [DIRECTION = INBOUND OUTBOUND,] [LUTYPE = lu type,] [FQPLUNAME = partner-fully qualified lu name,] [TPNAME = Host와세션을연결하기위한 LU명,] [MODENAME = 세션용도,] [SYNCMODE = NONE CONFIRM SYNCPT,] [SESSION = 1 ~ 50,] [NETNAME = lu network명 ] 필수항목 LU Name =string 크기 : 8 자이내 LU 세션명을설정한다. SVRNAME = string 크기 : 16 자이내 LU 세션이연결되는서버명을설정한다. 선택항목 HOSTID = string 크기 : 4 자이내 해당세션이속한호스트 ID 를설정한다. WSNAME = string 크기 : 16 자이내 Host-link 가세션을 Dedicate 방식으로운용할경우에사용하는항목이다. SNA LU 0 에해당되는항목이다. 설정한값을사용자헤더정보에저장하고해당위치를 USERHEADER 절의 WSNAMEPOS 항목과 WSNAMESIZE 항목에설정하면해당세션으로데이터를송수신할수있다. DIRECTION = INBOUND OUTBOUND 42 Tmax Host-link Guide (SNA LU 0, SNA LU 6.2)

57 해당세션이 INBOUND 인지 OUTBOUND 인지설정한다. SNA LU 0 에해당되는항목이다. LUTYPE = string 크기 : 8 자이내 각세션을용도별로구분하기위한항목이다. SNA LU 0 에해당되는항목이다. INBOUND 세션일경우사용자가원하는값을설정하고, Host-link 환경설정파일의 USERHEADER 절중 LUTYPEPOS 와 LUTYPESIZE 항목에설정된위치에이항목에서설정한타입을설정한다. OUTBOUND 세션은 3 가지로나뉜다. 구분일반세션 BID 세션 ROP 세션 설명호스트에서먼저서비스를요청하는세션이다. 호스트에서강제메시지를전달하기위한세션이다. 특정단말의프린터에데이터를전송하는세션이다. FQPLUNAME = string 크기 : 17 자이내 SNA LU 6.2 에해당되는항목이다. 상대 LU 의전체이름 (partner-fully qualified lu name) 을설정한다. TPNAME = string 크기 : 8 자이내?? SNA LU 6.2 에해당되는항목이다. LU 의로컬 TPNAME 을설정한다. MODENAME = string 크기 : 8 자이내 제 3 장환경설정 43

58 SNA LU 6.2 에해당되는항목이다. 해당세션의모드명을설정한다. 사용할모드명에대해서는호스트관리자에게문의한다. 위 SYNCMODE = NONE CONFIRM SYNCPT 기본값은 NONE 이다. SNA LU 6.2 에해당되는항목이다. 호스트의 Syncpoint 의레벨을지원한다. SESSION = numeric 범위 : 1 ~ 50 하나의 LU 에설정될수있는세션개수를설정한다. LU 0 의경우는하나의 LU 당한세션만연결할수있으므로 1 로설정할수있다. NETNAME = string 크기 : 8 자이내 LU 의네트워크명을설정한다. 완전한 LU 명 (fully qualified lu name) 은 'LU 네트워크명.LU 명 ' 으로구성 된다. 예를들어 TESTNET.TESTLU 의경우 TESTNET 이 LU 네트워크명이다 환경설정파일컴파일 환경설정파일의컴파일은 hkcfl 명령어를사용한다. hkcfl hkcfl 은텍스트형태의 Host-link 환경설정파일을컴파일하여이진 Host-link 환경설정파일 (hlinkcfg) 을만 드는명령어이다. 컴파일하는중에러가발생하면컴파일을중단하고정상적으로컴파일이완료되면이 진환경설정파일이생성된다. hkcfl 사용법은다음과같다. hkcfl [-h] [-p] [-o 이진 Host-link 환경설정파일명 ] -i 텍스트 Host-link 환경설정파일명 -c 주석처리문자 44 Tmax Host-link Guide (SNA LU 0, SNA LU 6.2)

59 항목 [-h] [-p] [-o 이진 Host-link 환경설 정파일명 ] -i 텍스트 Host-link 환경설 정파일명 -c 설명온라인도움말을보여준다. Host-link 환경설정파일의컴파일실행내용을화면에출력한다. 컴파일결과물인이진 Host-link 환경설정파일명을명시하는데사용된다. 경로와함께지정할수있으며, 경로가지정되지않은경우 $TMAXDIR/config 에결과물이생성된다. 기본값은 hlinkcfg 이다. 텍스트형태의 Host-Link 환경파일이름을명시하는데사용된다. 필수옵션으로, 디렉터리가지정되지않았을경우 $TMAXDIR/config로설정된다. 경로와함께지정될수있으며, 소스파일을찾지못한경우에는경고메시지가출력된다. 텍스트형태의환경설정파일의주석문자를변경한다. 기본적으로는샵 ('#') 문자가주석문자로사용된다. 제 3 장환경설정 45

60

61 제 4 장서비스 본장에서는 INBOUND, OUTBOUND, BID 및 ROP 각각의서비스에대해설명한다 INBOUND INBOUND 에해당하는서비스는 tpcall, tpacall, tpforward 서비스이다 tpcall tpcall 서비스는 Tmax 시스템의다른서버프로세스에서제공하는서비스와동일하게사용할수있는서비스이다. Host-link 시스템은일반서버프로세스와다르게 CPC를사용하여동시에여러서비스를처리할수있다. 예를들어 CPC를 5로설정한경우 Host-link는동시에 5건의서비스를처리할수있다. 서비스의처리과정은다음과같다. [ 그림 4.1] tpcall 서비스 1. Tmax 시스템에서 Tmax 환경설정파일에정의한 Host-link 서비스를호출한다. 2. Host-link 는해당호스트에서제공하는프로그램에데이터를전송한다. 3. 호스트는해당서비스를처리하고처리결과를 Host-link 에전송한다. 4. Host-link 는서비스를호출한 Tmax 시스템에응답데이터를전송한다. 제 4 장서비스 47

62 tpacall tpacall 서비스는요청된서비스를처리한후 Tmax 시스템에응답하는서비스와응답하지않는서비스로나뉜다. Tmax 시스템에응답하는서비스 Tmax 시스템에응답하는서비스는 tpcall 서비스와동일하게처리된다. [ 그림 4.2] tpcall - Tmax 시스템에응답하는서비스 1. Tmax 시스템에서 Tmax 환경설정파일에정의한 Host-link 서비스를호출한다. 2. Host-link 는해당호스트에서제공하는프로그램에데이터를전송한다. 3. 호스트는해당서비스를처리하고처리결과를 Host-link 에전송한다. 4. Host-link 는서비스를호출한 Tmax 시스템에응답데이터를전송한다. Tmax 시스템에응답하지않는서비스 Tmax 시스템에응답하지않는서비스의경우 Host-link가호스트의응답을수신하여다른서비스로연계할수있다. 연계서비스명은다음의방법으로인식한다. 다음방법을 Host-link 환경설정파일에설정하지않으면호스트에서수신한응답데이터는무시된다. tpacall을할때 Flag에 TPNOREPLY값을설정하여서비스를호출하고 Host-link 환경설정파일에다음과같은연계서비스를정의한다. SECVICE 절 48 Tmax Host-link Guide (SNA LU 0, SNA LU 6.2)

63 *SERVICE snalu0gw00 TCLSVCNAME=TPACALL_RECV, # defaule svc name TCLSVCPOS=1, TCLSVCSIZE=10,... 호스트에서수신한데이터중 1번째부터 11번째데이터를서비스명으로인식하여해당서비스를호출 한다. TCLSVCPOS 항목과 TCLSVCSIZE 항목을정의하지않으면 TCLSVCNAME에정의한서비스명 으로호출한다. USERHEADER 절 *USERHEADER snalu0gw00 HSIZE=100, # user total header size SVCPOS=1, # user defined svc name position SVCSIZE=10, # user defined svc name size LUNAMEPOS=11, # output only LUNAMESIZE=10,# output only WSNAMEPOS=21, # only INBOUNDLU is DEDICATE WSNAMESIZE=10,# only INBOUNDLU is DEDICATE ERRCODEPOS=31,# output only ERRCODESIZE=4,# output only TIMEWAITPOS=1 # WAIT or NOWAIT value position SVCPOS 항목과 SVCSIZE 항목으로서비스명을인식한다. TPGWINFO_T TPGWINFO_T 의 SVC 멤버에서정의한서비스명을인식한다. Tmax 시스템에응답하지않는서비스의처리과정은다음과같다. 제 4 장서비스 49

64 [ 그림 4.3] tpacall - Tmax 시스템에응답하지않는서비스 1. Tmax 시스템에서 Tmax 환경설정파일에정의한 Host-link 서비스를호출한다. 2. Host-link 는해당호스트에서제공하는프로그램에데이터를전송한다. 3. 호스트는해당서비스를처리하고처리결과를 Host-link 에전송한다. 4. Host-link 는환경설정파일에설정된연계서비스를호출한다 tpforward tpforward 서비스는 Flag에 TPNOREPLY 값을설정하지않고 Host-link 서비스를호출하는서비스와 TP NOREPLY 값을설정하여 Hos-link 서비스를호출하는서비스로나뉜다. TPNOREPLY 값을설정하지않을경우 이서비스는서버프로그램에서만호출할수있는서비스이다. Tmax 3.5 버전에서는다음과같이동작하나 3.8 버전부터는 Flag 값설정과무관하게항상 TPNOREPLY 값을설정할경우로동작한다. 50 Tmax Host-link Guide (SNA LU 0, SNA LU 6.2)

65 [ 그림 4.4] tpforward - TPNOREPLY 를설정한경우 1. Tmax 시스템에서 Tmax 환경설정파일에정의한 Host-link 서비스를호출한다. 2. Host-link 는해당호스트에서제공하는프로그램에데이터를전송한다. 3. 호스트는해당서비스를처리하고처리결과를 Host-link 에전송한다. 4. Host-link 는 tpforward 서비스를호출한클라이언트로응답을전송한다. TPNOREPLY 값을설정할경우 서버프로세스에서 tpcall로 Host-link 시스템의서비스를호출하면응답이수신될때까지해당서버프로세스는블록상태이다. 이러한단점을보완하기위해서비스를송신과수신서비스로분리한다. 송신서비스는 Host-link 시스템에 tpforward로서비스를호출하고서비스를종료한다. Host-link 시스템은호스트에서응답을수신하면수신서비스를호출하여응답을처리하게한다. 수신서비스명은 tpacall과동일하게 Host-link 환경설정파일을통해인식한다. SERVICE 절 *SERVICE snalu0gw00... #RLYSVCNAME=TPACALL_RECV, # defaule svc name RLYSVCPOS=1, # svcname position RLYSVCSIZE=10, # max length Host-link 시스템이호스트로서비스를요청하다가오류가발생할경우 Host-link는 RLYSVCPOS 항목, RLYSVCSIZE 항목에정의한서비스로오류를전달한다. RLYSVCPOS 항목과 RLYSVCSIZE 항목에 제 4 장서비스 51

66 서정의한서비스는서비스를시작하기전에반드시서비스데이터가정상인지오류인지를판단하여야한다. tpurcode가 0보다크면오류로, 그렇지않으면정상적인데이터로판단한다. RLYSVCPOS, RLYSVCSIZE 항목이정의되어있지않다면 RLYSVCNAME에정의한서비스로오류를전달한다. USERHEADER 절 *USERHEADER snalu0gw00 HSIZE=100, # user total header size HSVCPOS=1, # user defined svc name position HSVCSIZE=10, # user defined svc name size... HSVCPOS 항목과 HSVCSIZE 항목으로서비스명을인식한다. TPGWINFO_T TPGWINFO_T 의 SVC 멤버에서정의한서비스명을인식한다. 서비스의처리과정은다음과같다. [ 그림 4.5] tpforward - TPNOREPLY 를설정하지않은경우 1. Tmax 시스템에서 Tmax 환경설정파일에정의한 Host-link 서비스를호출한다. 2. Host-link 는해당호스트에서제공하는프로그램에데이터를전송한다. 3. 호스트는해당서비스를처리하고처리결과를 Host-link 에전송한다. 52 Tmax Host-link Guide (SNA LU 0, SNA LU 6.2)

67 4. Host-link 는환경설정파일에정의된서비스로응답을전송한다 OUTBOUND OUTBOUND 서비스는호스트에서 Tmax 시스템의서비스를호출하여처리결과를받는형태의서비스이다. Tmax 시스템에서제공하는서비스명은다음두가지방식으로인식한다. SERVICE 절 *SERVICE snalu0gw00... #OUTSVCNAME=OUTBOUND, # defaule svc name OUTSVCPOS=1, # outsvc position OUTSVCSIZE=10, # max length Host-link는 OUTSVCPOS, OUTSVCSIZE 항목에서정의한위치에서서비스명을찾아서서비스를호출한다. OUTSVCPOS, OUTSVCSIZE 항목을정의하지않으면모든 OUTBOUND 데이터는 OUTSVC NAME 항목에서정의한서비스를호출한다. USERHEADER 절 *USERHEADER snalu0gw00... ERRCODEPOS=1, #reponse error position ERRCODESIZE=4, # max length 4... ERRCODEPOS와 ERRCODESIZE 항목은 Tmax 시스템에서제공하는서비스가없거나또는비정상적으로종료된경우오류를전송하기위해사용하는항목이다. 오류데이터는호스트로부터수신된데이터중 ERRCODEPOS 항목에정의한위치에 ERRORCODESIZE 항목만큼의사이즈로정의된다. 이오류데이터를호스트로전송한다. OUTBOUND 서비스의처리과정은다음과같다. 제 4 장서비스 53

68 [ 그림 4.6] OUTBOUND 서비스처리과정 1. 호스트에서 Host-link 로서비스를요청한다. 2. Host-link 는환경설정파일에정의된대로 Tmax 시스템의서비스를호출한다. 3. Tmax 시스템의서비스를처리하고처리결과를 Host-link 에전송한다. 4. Host-link 는응답데이터를호스트에전송한다 BID 및 ROP 호스트에서강제로 Host-link 시스템의특정세션에메시지를전달할수있는기능이있는데이를 BID나 ROP라고한다. Host-link 시스템은 BID나 ROP 데이터를수신하면 Host-link 환경설정파일의 SERVICE 절에정의한 BID나 ROP 서비스를호출한다. OUTBOUND 서비스는처리결과를반드시호스트로전송해야하나 BID 데이터는호스트로부터수신만받고응답하지않는형태이다. Tmax 시스템에서제공하는서비스명은환경설정파일의 SERVER 절을통해인식한다. *SERVICE snalu0gw00... #BIDSVCNAME=BIDSVC, # defaule svc name BIDSVCPOS=1, # svcname position BIDSVCSIZE=10, # max length 16 #ROPSVCNAME=ROPSVC, #default svc name ROPSVCPOS=11, #svcname position ROPSVCSIZE=10, # max length Tmax Host-link Guide (SNA LU 0, SNA LU 6.2)

69 Host-link는 BIDSVCPOS 항목과 BIDSVCSIZE 항목에서정의한대로서비스명을찾아서비스를호출한다. (ROP 서비스의경우 ROPSVCPOS 항목과 ROPSVCSIZE 항목 ) BIDSVCPOS 항목과 BIDSVCSIZE 항목을정의하지않은경우모든 BID 데이터는 BIDSVCNAME 항목에서정의한서비스를호출한다. (ROP 서비스의경우 ROPSVCNAME 항목 ) 서비스의처리과정은다음과같다. [ 그림 4.7] BID 및 ROP 서비스처리과정 제 4 장서비스 55

70

71 제 5 장상태모니터링 API 와구조체 5.1. API Host-link 시스템은 Host-link의상태를모니터링할수있는 API 함수를제공한다. 이 API 함수는 Host-link 시스템이실행된후 Tmax 시스템의클라이언트, 서버프로그램및기타일반프로그램에서사용할수있다. Host-link 시스템의상태를모니터링하는 API는다음 4가지이다. API tpgethlinksvr tpgethlinkproc tpgethlinkluinfo tpgethlinkssinfo 설명 Host-link 시스템에속한프로세스의수를알려주는함수이다. Host-link 시스템에속한프로세스정보를알려주는함수이다. Host-link 시스템에속한서버의 LU 정보를알려주는함수이다. Host-link 프로세스별로관리하는세션정보를알려주는함수이다 tpgethlinksvr 서버타입에해당하는 Host-link 시스템의프로세스수를알려주는함수이다. 이함수를통해얻은 Host-link의공유메모리정보를 tpgethlinkproc, tpgethlinkluinfo, tpgethlinkssinfo 세 API 함수에서사용한다. 프로토타입 int tpgethlinksvr(int shmkey, int svrtype) 파라미터 파라미터 shmkey svrtype 설명 Host-link의공유메모리키값이다. 서버타입이다.(SVRTYPE_LU0, SVRTYPE_LU62S, SVRTYPE_LU62R, SVR TYPE_CTG, SVRTYPE_CSKL, SVRTYPE_IMSLSTN, SVRTYPE_IMSOTMA) 반환값 제 5 장상태모니터링 API 와구조체 57

72 반환값 Host-link의프로세스수 -1 설명 함수호출에성공한경우이다. 함수호출에실패한경우이다 tpgethlinkproc 서버타입에해당하는 Host-link 프로세스의정보를알려주는함수이다. 프로토타입 int tpgethlinkproc(int svrtype, HLPROCINFO *info) 파라미터 파라미터 svrtype info 설명서버타입이다. (SVRTYPE_LU0, SVRTYPE_LU62S, SVRTYPE_LU62R, SVR TYPE_CTG, SVRTYPE_CSKL, SVRTYPE_IMSLSTN, SVRTYPE_IMSOTMA) 서버프로세스정보가담길구조체테이블의버퍼이다. 반드시 tpgethlinksvr() 에서받은수만큼구조체버퍼를할당해야한다. 반환값 반환값 0-1 설명 함수호출에성공한경우이다. 함수호출에실패한경우이다 tpgethlinkluinfo Host-link 시스템에속한서버의 LU 정보를알려주는함수이다. 이함수는내부에서 LU 수만큼메모리를할당하므로이함수를사용한이후에는반드시할당된메모리를해제해야한다. 프로토타입 HLLUINFO * tpgethlinkluinfo(char *svrname, int *lunum) 파라미터 파라미터 svrname 설명 Host-link 시스템에속한서버명이다. 58 Tmax Host-link Guide (SNA LU 0, SNA LU 6.2)

73 파라미터 lunum 설명 반환되는 LU 의개수이다. 반환값 반환값 구조체테이블 NULL 설명함수호출에성공한경우이다. (Host-link 서버의 LU 정보를담고있는구조체테이블 ) 함수호출에실패한경우이다 tpgethlinkssinfo Host-Link 시스템에속한 LU의세션정보를알려주는함수이다. 이함수는내부에서세션수만큼메모리를할당하므로이함수를사용한이후에는반드시할당된메모리를해제해야한다. 프로토타입 HLSESSINFO * tpgethlinkssinfo(char *luname, int *ssnum) 파라미터 파라미터 luname ssnum 설명 Host-link 시스템에속한 LU 명이다. 반환되는세션의개수이다. 반환값 반환값 구조체테이블 NULL 설명함수호출에성공한경우이다. (Host-link LU의세션정보를담고있는구조체테이블 ) 함수호출에실패한경우이다 구조체 API 설명중 Host-link 에서정의한구조체는 HLPROCINFO, HLLUINFO, HLSESSINFO 이다. 구조체 HLPROCINFO HLLUINFO 설명 Host-link 서버의프로세스정보를담고있는구조체이다. Host-link 서버의 LU 정보를담고있는구조체이다. 제 5 장상태모니터링 API 와구조체 59

74 구조체 HLSESSINFO 설명 Host-link LU 의세션정보를담고있는구조체이다 HLPROCINFO Host-link 서버의프로세스정보를담고있는구조체이다. 정의 struct HLPROCINFO { int svrno; int msgsize; int function; int cpc; int buffering; int innum; int outnum; int line_status; char svrname[20]; char linkname[8]; char trxid[4]; char svrlist[128]; } 멤버 멤버 int svrno int msgsize int function int cpc int buffering int innum int outnum int line_status char svrname[20] char linkname[8] char trxid[4] char svrlist[128] 설명 SERVER 절의 TMAXSVRNO이다. SERVER 절의 MSGSIZE이다. SERVER 절의 FUNCION이다. (DPL(1), DTP(2)) SERVER 절의 CPC이다. SERVER 절의 BUFFERING이다. (YES(1), NO(0)) SERVER 절의 SESSION이다. 미사용멤버이다. 해당서버의회선상태이다. (Active(1), Inactive(0)) SERVER 절의 Server Name이다. SERVER 절의 LINKNAME이다. SERVER 절의 TRXID이다. SERVER 절의 SVRLIST이다. 60 Tmax Host-link Guide (SNA LU 0, SNA LU 6.2)

75 HLLUINFO Host-link 서버의 LU 정보를담고있는구조체이다. 정의 struct HLLUINFO { char luname[8]; char wsname[8]; char lutype[12]; char svcname[16]; char tpname[64]; char pluname[16]; char modename[8]; int status; int send; int direction; int session; int available; int count; } 멤버 멤버 char luname[8] char wsname[8] char lutype[12] char svcname[16] char tpname[64] char pluname[16] char modename[8] int status int send int direction int session int available int count 설명 LUINFO 절의 LUNAME이다. LU 처리중인 WSNAME이다. LUINFO 절의 LUTYPE이다. LU 처리중인서비스명이다. LUINFO 절의 TPNAME이다. LUINFO 절의 PLUNAME이다. LUINFO 절의 MODENAME이다. LU 상태이다. (LU-LU(0x50), LU-SSCP(0x51), DOWN(0x52), CSDN(0x53), ACTLU(0x54), INACTLU(0x55), NSPE(0x56)) LU 0 호스트로의메시지전송여부이다. (NONE(0), SENT(1), TIMEOUT(2)) LUINFO 절의 DIRECTION이다. (INBOUND(1), OUTBOUND(2)) LUINFO 절의 SESSION이다. LU6.2의이용가능한세션수이다. LU 처리건수이다. 제 5 장상태모니터링 API 와구조체 61

76 HLSESSINFO Host-link LU 의세션정보를담고있는구조체이다. 정의 struct HLSESSINFO { int status; char luname[8]; char local_tp[16]; unsigned char tp_id[8]; char remote_tp[16]; char pgmname[8]; char wsname[8]; unsigned int conv_id; time_t time; } 멤버 멤버 int status char luname[8] char local_tp[16] unsigned char tp_id[8] char remote_tp[16] char pgmname[8] char wsname[8] unsigned int conv_id time_t time 설명 LU6.2 세션의상태이다. (READY(1), BUSY(2)) LU6.2 세션명이다. LU6.2 세션의로컬 TPNAME이다. LU6.2 세션의로컬 TPID이다. LU6.2 세션의리모트 TPNAME이다. LU6.2 세션의 PGMNAME이다. LU6.2 세션의 WSNAME이다. LU6.2 세션의 Conversation ID이다. LU6.2 세션의 Timestamp이다 에러코드 Host-link 의에러코드는다음과같다. 에러코드 TPEOS TPENOREADY TPESVCERR 설명 Host-link에서사용하는메모리를할당하는과정에서발생하는에러이다. Host-link 시스템에서관리하는많은세션중사용가능한세션이없을경우발생하는에러이다. Host-link 프로세스에서호스트로데이터를전송할때발생하는에러이다. 62 Tmax Host-link Guide (SNA LU 0, SNA LU 6.2)

77 에러코드 TPESVCFAIL TPEBADDESC TPETIME TPEPROTO 설명 Host-link 프로세스에서호스트로데이터를수신할때발생하는에러이다. Host-link 프로세스에서호스트로데이터를전송한후에호스트로부터센스코드가전송된경우발생하는에러이다. Host-link 프로세스에서호스트로데이터를전송한후에지정된시간이초과할경우발생하는에러이다. Host-link 프로세스에서관리하는 Link 세션이비활성화된경우발생하는에러이다. 제 5 장상태모니터링 API 와구조체 63

78

79 Appendix A. 환경설정예제 본장에서는 SNA LU 0 와 SNA LU 6.2 의환경설정예제를설명한다. A.1. SNA LU 0 다음은 SNA LU 0 프로세스를실행하는데필요한전체환경설정의예제이다. *HOSTLINK aaa SHMKEY=98765, TMAX=Y *SERVER snalu0gw00 TMAXSVRNAME=snalu0gw00, TMAXSVRNO=0, SVRTYPE=LU0, HOSTID="X3", MSGSIZE=8192, TIMEWAIT=WAIT, LINKDOWN_TIMEOUT=60, SESSION_TIMEOUT=300, BUFFERING=YES, INBOUNDLU=DEDICATE, BIDLU=DEDICATE, LINKNAME=AAA *SERVICE snalu0gw00 BIDSVCNAME=BIDSVC, BIDSVCPOS=1, BIDSVCSIZE=10, ROPSVCNAME=BIDSVC, ROPSVCPOS=1, ROPSVCSIZE=10, OUTSVCNAME=OUTBOUND, OUTSVCPOS=1, OUTSVCSIZE=10, OUTERRPOS=20, OUTERRVAL="0001", RLYSVCNAME=BIDSVC, RLYSVCPOS=1, RLYSVCSIZE=10, TCLSVCNAME=BIDSVC, Appendix A. 환경설정예제 65

80 TCLSVCPOS=1, TCLSVCSIZE=10 *LOGGING snalu0gw00 LOGPATH=aaa, LOGTYPE=HEX, LOGSVC=AAA *CONVERSION snalu0gw00 INBOUND=YES, INBOUND_KOR=YES, INBOUND_SKIP=50, OUTBOUND=YES, OUTBOUND_KOR=YES, OUTBOUND_SKIP=50 *DUMMYDATA snalu0gw00 ZEROSIZE=YES, DUMMYPOS=1, DUMMYVAL="xxxx" *USERHEADER snalu0gw00 HSIZE=20, SVCPOS=1, SVCSIZE=10, LUTYPEPOS=2, LUTYPESIZE=6, LUNAMEPOS=2, LUNAMESIZE=8, WSNAMEPOS=10, WSNAMESIZE=8, ERRCODEPOS=1, ERRCODESIZE=4, TIMEWAITPOS=1 *LUINFO TLU015 TLU016 TLU017 svrname=snalu0gw00, HOSTID=I9, WSNAME="A000001", LUKIND=INBOUND, LUTYPE=i svrname=snalu0gw00, HOSTID=I9, WSNAME="A000002", LUKIND=OUTBOUND, LUTYPE=BID svrname=snalu0gw00, 66 Tmax Host-link Guide (SNA LU 0, SNA LU 6.2)

81 TLU018 TLU019 HOSTID=I9, WSNAME="A000002", LUKIND=OUTBOUND, LUTYPE=NORMAL svrname=snalu0gw00, HOSTID=I9, WSNAME="A000002", LUKIND=OUTBOUND, LUTYPE=ROP svrname=snalu0gw00, HOSTID=I9, WSNAME="A000002", LUKIND=OUTBOUND, LUTYPE=ROP A.2. SNA LU 6.2 다음은 SNA LU 6.2 프로세스를실행하는데필요한전체환경설정의예제이다. *HOSTLINK aaa SHMKEY=98765, TMAX=Y *SERVER sna62rgw00 sna62sgw00 TMAXSVRNAME=sna62rgw00, TMAXSVRNO=0, SVRTYPE=LU62R, MSGSIZE=8192, REPSEND=Y, LINKNAME=AAA TMAXSVRNAME=sna62sgw00, TMAXSVRNO=0, SVRTYPE=LU62S, MSGSIZE=8192, FUNCTION=DPL, LINKNAME=AAA *SERVICE sna62rgw00 sna62sgw00 OUTSVCNAME=BIDSVC, OUTSVCPOS=1, OUTSVCSIZE=10 RLYSVCNAME=BIDSVC, RLYSVCPOS=1, RLYSVCSIZE=10, TCLSVCNAME=BIDSVC, TCLSVCPOS=1, Appendix A. 환경설정예제 67