tmax installation guide...안내서 구성 tmax installation guide는 총 3개의 장과 appendix로...

Tmax

Installation Guide

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 Installation Guide

발행일: 2009-08-10

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

안내서 버전: v2.1.1

내용 목차

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

제1장 설치 개요 .......................................................................................................................... 1

1.1. 설치 구성 요소 ............................................................................................................. 1

1.1.1. 패키지 구성 ....................................................................................................... 1

1.1.2. CD-ROM의 디렉터리 구성 ................................................................................. 3

1.1.3. 소프트웨어 배포 ................................................................................................ 3

1.2. 시스템 요구사항 ........................................................................................................... 3

1.3. Tmax 인스톨러 ............................................................................................................ 4

제2장 UNIX에서 설치와 제거 ....................................................................................................... 5

2.1. 설치 전 준비사항 .......................................................................................................... 5

2.2. 설치 ............................................................................................................................ 5

2.3. 설치 확인 ................................................................................................................... 10

2.4. 제거 ........................................................................................................................... 12

2.4.1. 설치 제거 확인 ................................................................................................. 14

2.5. 환경 설정 ................................................................................................................... 14

2.5.1. 라이선스 파일 설치 .......................................................................................... 14

2.5.2. 환경 변수 설정 ................................................................................................. 15

2.5.3. sample.m 파일의 구성 ...................................................................................... 19

2.6. 예제 프로그램 테스트 ................................................................................................. 19

2.6.1. 기본 환경 설정 ................................................................................................. 20

2.6.2. 서버 프로그램 컴파일 ....................................................................................... 21

2.6.3. Tmax 시스템의 기동 ........................................................................................ 22

2.6.4. 클라이언트 프로그램 컴파일 및 실행 ................................................................. 22

제3장 Windows에서 설치와 제거 .............................................................................................. 25

3.1. 설치 전 준비사항 ........................................................................................................ 25

3.2. 설치 ........................................................................................................................... 25

3.3. 설치 확인 ................................................................................................................... 30

3.3.1. 설치 후 디렉터리 구조 ...................................................................................... 30

3.3.2. 환경 변수 등록 ................................................................................................. 32

3.3.3. Windows 서비스 등록/제거 ............................................................................... 32

3.4. 제거 ........................................................................................................................... 33

3.4.1. 설치 제거 확인 ................................................................................................. 35

3.5. 환경 설정 ................................................................................................................... 35

3.5.1. 라이선스 파일 설치 .......................................................................................... 35

3.5.2. 환경 변수 설정 ................................................................................................. 37

3.5.3. 기본 환경 설정 ................................................................................................. 38

3.5.4. 서비스 프로그램 컴파일 ................................................................................... 39

3.5.5. 클라이언트 프로그램 컴파일 ............................................................................. 40

Appendix A. TMS 컴파일 ......................................................................................................... 43

Tmax iii

A.1. TMS for Oracle DBMS ................................................................................................ 43

A.2. TMS for Informix DBMS .............................................................................................. 44

Appendix B. Platform Specifications for Tmax Products ........................................................ 47

B.1. Compaq Tru64 v4.0 on Alpha ...................................................................................... 47

B.2. Compaq Tru64 v5.0(5.1) on Alpha ............................................................................... 48

B.3. HP UX v10.20 on HP9000 Series ................................................................................ 48

B.4. HP-UX v11.00 on HP9000 Series ................................................................................ 49

B.5. HP-UX v11.11 on HP9000 Series ................................................................................ 50

B.6. HP-UX v11i on Itanium ............................................................................................... 51

B.7. IBM AIX v4.3.x on RS/6000 ........................................................................................ 52

B.8. IBM AIX v5.1.x on RS/6000 ........................................................................................ 52

B.9. SUN Solaris v2.5.1(SunOS 5.5.1) on SPARC ............................................................... 53

B.10. SUN Solaris v2.6(SunOS 5.6) on UltraSPARC ........................................................... 54



B.13. SUN Solaris 8 on x86 ............................................................................................... 56

B.14. SCO Unixware 7 on x86 ........................................................................................... 57

B.15. SCO Unixware 2 on x86 ........................................................................................... 58

B.16. NCR MP-RAS v03.02 on x86 .................................................................................... 59

B.17. RedHat Linux 7.x on Intel .......................................................................................... 60

B.18. Windows NT 4.0 on Intel ........................................................................................... 60

B.19. Windows NT 5.0(Windows 2000) on Intel ................................................................... 61

B.20. Windows 98 on Intel ................................................................................................. 62

iv Tmax Installation Guide

그림 목차

[그림 3.1] 초기화면 ................................................................................................................... 25

[그림 3.2] License Agreement .................................................................................................... 26

[그림 3.3] Choose Install Set ...................................................................................................... 26

[그림 3.4] Choose Install Folder ................................................................................................. 27

[그림 3.5] Set Environment Varialbe ........................................................................................... 27

[그림 3.6] Pre-Installation Summary ........................................................................................... 28

[그림 3.7] Installing Tmax1 ........................................................................................................ 28

[그림 3.8] Installing Tmax2 ........................................................................................................ 29

[그림 3.9] Install Complete ......................................................................................................... 29

[그림 3.10] Indroduction ............................................................................................................ 33

[그림 3.11] Uninstalling .............................................................................................................. 34

[그림 3.12] Uninstall Complete ................................................................................................... 34

[그림 3.13] 실행 ........................................................................................................................ 36

[그림 3.14] Command Prompt .................................................................................................... 36

Tmax v

안내서에 대하여

안내서의 대상

본 안내서는 Tmax®(이하 Tmax)를 설치하고자 하는 사용자를 대상으로 기술되었다. 본 안내서는 Tmax를

설치하는 과정에 대해서 설명한다.

안내서의 전제 조건

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

득을 위한 기본서이다.

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

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

● Tmax의 기본 개념 이해

안내서의 제한 조건

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

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

참고

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

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

Guide”를 참고한다.

안내서에 대하여 vii

안내서 구성

Tmax Installation Guide는 총 3개의 장과 Appendix로 구성되어 있다.

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

● 제1장: 설치 개요

Tmax 시스템을 설치하기 전에 사용자가 사전에 점검하고 준비해야 할 사항들에 대해 기술한다.

● 제2장: UNIX에서 설치와 제거

UNIX 또는 Linux 운영체제에서 Tmax 서버/클라이언트를 설치하고 제거하는 방법에 대해 기술한다.

● 제3장: Windows에서 설치와 제거

Windows NT/2000 운영체제에서 Tmax 서버/클라이언트를 설치하고 제거하는 방법에 대해 기술한다.

● Appendix A: TMS 컴파일

Oracle과 Informix DBMS용 TMS 이진 파일의 생성 방법에 대해 기술한다.

● Appendix B: Platform Specifications for Tmax Products

Tmax를 사용하기 위한 시스템 사용환경에 대해 기술한다.

viii Tmax Installation Guide

안내서 규약

의미표기

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

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

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

강조진하게

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

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

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

메뉴의 진행 순서>

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

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

참고 또는 주의사항참고

그림 이름[그림 1.1]

표 이름[표 1.1]

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

옵션 인수 값[ ]

선택 인수 값|

안내서에 대하여 ix

관련 안내서

설명안내서

Tmax를 이용하기 위한 환경설정 파일과 시스템 운영방식에 대해 기

술한 안내서이다.

Tmax

Administration Guide

Tmax를 사용하여 프로그램을 개발하는 사용자를 위해 기술된 안내

서이다. 프로그램 개발에 대한 기본적인 내용을 기술한다.

Tmax

Application Development Guide

Tmax를 사용하여 프로그램을 개발하는 사용자를 위해 기술된 안내

서로 Tmax 애플리케이션 개발에 사용하는 명령어의 개념 및 사용법

과 예제에 대해서 설명한다.

Tmax

Reference Guide

Tmax에 대한 기본 개념과 구성에 대한 기본적인 사항을 기술한 안

내서이다.

Tmax

Getting Started Guide

x Tmax Installation Guide

연락처

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

안내서에 대하여 xi

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

xii Tmax Installation Guide

http://www.tmaxchina.com.cn

http://www.tmaxchina.com.cn

제1장 설치 개요

본 장에서는 Tmax 시스템을 설치하기 전에 사용자가 사전에 점검하고 준비해야 할 사항들에 대해 기술한

다.

1.1. 설치 구성 요소Tmax의 설치 구성 요소는 다음과 같다.

1.1.1. 패키지 구성

Tmax의 패키지 구성은 다음과 같다.

● Tmax Installation CD-ROM

1. Tmax Server/Client for UNIX(Linux 포함), Windows NT/2000 platform

2. Tmax Documents

● Printed Tmax Manuals

1. Tmax Getting Started Guide

2. Tmax Installation Guide

3. Tmax Administration Guide

4. Tmax Application Development Guide

5. Tmax Error Message Reference Guide

6. Tmax Reference Guide

7. Tmax JTmaxServer Guide

8. Tmax FDL Reference Guide

9. Tmax HostLink Guide (SNA LU0, SNA LU6.2)

제1장 설치 개요 1

10. Tmax WebtAsync User Guide

11. Tmax JCA User Guide

12. Tmax JTC User Guide

13. Tmax HMS User Guide

14. Tmax WebT User Guide

15. Tmax Cobol Guide

16. Tmax Gateway Guide (SERIAL)

17. Tmax Gateway Guide (TCP-IP)

18. Tmax Gateway Guide (TCP-IP Thread)

19. Tmax Gateway Guide (TCP-IP Service)

20. Tmax Gateway Guide (WebService)

21. Tmax Gateway Guide (X.25)

22. Tmax Programming Guide (4GL)

23. Tmax Programming Guide (Dynamic Library)

24. Tmax Programming Guide (RCA)

25. Tmax Programming Guide (RQ)

26. Tmax Programming Guide (SQ)

27. Tmax Programming Guide (UCS)

28. Tmax XA Library and XA Gateway Guide

2 Tmax Installation Guide

1.1.2. CD-ROM의 디렉터리 구성

TmaxSoft에서 제공하는 Tmax Installation CD-ROM의 각 디렉터리들은 다음과 같은 내용을 포함한다.

● Manuals : Tmax의 매뉴얼(일문 및 영문 매뉴얼은 필요에 따라 제공)

● UNIX : UNIX용 Tmax 서버 엔진과 클라이언트가 포함된 각 플랫폼별 디렉터리와 샘플 프로그램

● Windows : Windows NT/2000용 Tmax 서버 설치 프로그램

1.1.3. 소프트웨어 배포

Tmax 제품은 인터넷을 통해 사용자가 직접 다운로드하여 테스트할 수 있는 기회를 제공하고 있다.

제품을 내려 받을 수 있는 URL은 다음과 같다.

http://technet.tmax.co.kr

Tmax와 WebT의 경우 제품을 다운로드하여 설치할 수 있으나 실제 Tmax의 운용을 위해서는 TmaxSoft

로부터 평가판 라이선스를 발급 받아야 하며 평가 기간은 최대 6개월이다. 클라이언트 모듈만을 사용하고

자 할때는 라이선스를 필요로 하지 않는다.

라이선스에 관한 자세한 사항은 “2.5. 환경 설정” 에서 자세히 언급하기로 한다.

다음은 Tmax 제품과 관련해서 연락을 취할 수 있는 URL 주소이다.

● 데모 라이선스발급 : http://technet.tmax.co.kr/ (다운로드 > 라이선스신청)

● 기술지원 홈페이지 : http://technet.tmax.co.kr/

1.2. 시스템 요구사항Tmax를 사용하기 위해 필요한 시스템 및 운영체제 사양은 다음과 같다.

버전엔진운영체제벤더

4.0, 5.0, 5.164 bitTru64 UNIXCompaq

Kernel Version 2.4Kernel Version 2.4Linux on IntelGNU/Redhat

(RedHat 6.X or higher)(RedHat 6.X or higher)

10.20, 10.30, 11.X32 bitHP-UXHP

11.X64 bit

4.3, 5L32 bitAIXIBM

4.3, 5L64 bit

제1장 설치 개요 3




버전엔진운영체제벤더

2.5.1 ~ 2.932 bitSolaris on SPARCSun

2.7, 2.864 bit

4.0, 2000, XP32 bitWindows NT on IntelMicrosoft

위의 표는 Tmax Products(Tmax 서버/클라이언트)에서 지원하는 시스템 및 운영체제를 나타내며 플랫폼

별 요구사항과 같은 자세한 내용은 “Appendix B. Platform Specifications for Tmax Products” 를 참고한다.

1.3. Tmax 인스톨러Tmax 인스톨러는 2가지 형태로 나뉜다. 인스톨러는 압축된 형식의 Tmax 아카이브를 복사하여 압축을 해

제하고 필요한 환경 변수를 설정해 주며 플랫폼별로 적절한 샘플과 Makefile을 제공한다.

2가지 인스톨러는 다음과 같다.

● UNIX/Linux 환경에서 사용하는 콘솔 인스톨러

● Windows 환경에서 사용하는 GUI 인스톨러


제2장 UNIX에서 설치와 제거

본 장에서는 UNIX 또는 Linux 운영체제에서 Tmax 서버/클라이언트 또는 Tmax 클라이언트를 설치하는

방법에 대해 설명한다. Tmax는 Full 인스톨러와 Patch 인스톨러 2가지 형태의 인스톨러를 제공한다. Full

인스톨러는 Tmax를 처음 설치할 경우에 Tmax core 파일, 샘플, 환경 변수등 모든 요소를 설치하기 위하

여 사용하며, Patch 인스톨러는 버전업 시 Tmax core 파일만을 교체할 때 사용한다. UNIX에 Tmax 시스

템을 설치하지 않는 경우는 본 장을 건너 뛰어도 좋다.

Tmax 시스템의 실제 운영을 위하여 Tmax 서버와 클라이언트를 모두 설치한다.

2.1. 설치 전 준비사항Tmax 서버/클라이언트 설치 전 준비사항은 다음과 같다.

● Tmax 계정을 만든다. root 계정으로 설치해도 되지만, 보통 Tmax 관리자 계정을 따로 만들 것을 권장한

다.

● 설치 환경이 Tmax의 최소 요구 사항에 합당한지 확인하고 CD-ROM을 마운트 한다. 각 플랫폼별 최소

요구사항과 CD-ROM의 마운트 방법은 “Appendix B. Platform Specifications for Tmax Products” 를 참

고한다.

● 설치 스크립트를 실행하기 전에 시스템에 대해 몇 가지 확인해야 할 사항이 있다. 서버에 설치된 운영체

제와 아키텍처(32bit or 64bit), Tmax를 설치하고자 하는 디렉터리의 절대 경로, 그리고 설치 후 테스트

를 위해 서버의 IP 주소를 미리 알고 있어야 한다.

● Tmax 관리자 계정으로 로그인 한다.

● 마운트 된 CD-ROM 디렉터리로 이동한다.

● 설치 스크립트를 실행한다.

2.2. 설치다음은 Full 인스톨러를 사용한 Tmax 설치 과정이다.

1. Tmax 설치 CD를 넣고 마운트 한다.

2. CD 의 “Tmax50_SP1_Fix0_HPUX_11i_PARISC_64.bin” 파일이 있는 곳으로 이동한다.

제2장 UNIX에서 설치와 제거 5

3. 다른 곳에 있는 설치 콘솔 인스톨러가 실행이 가능하도록 하려면

“Tmax50_SP1_Fix0_HPUX_11i_PARISC_64.bin” 파일의 실행 권한을 준다

$ chmod u+x Tmax50_SP1_Fix0_HPUX_11i_PARISC_64.bin

4. 콘솔로부터 “Tmax50_SP1_Fix0_HPUX_11i_PARISC_64.bin” 을 실행한다

$ ./ Tmax50_SP1_Fix0_HPUX_11i_PARISC_64.bin

tmaxh4@starbj81:/EMC01/starbj81>./Tmax50_SP1_Fix0_HPUX_11i_PARISC_64.bin

Preparing to install...

Extracting the JRE from the installer archive...

Unpacking the JRE...

Extracting the installation resources from the installer archive...

Configuring the installer for this system's environment...

Launching installer...

Preparing CONSOLE Mode Installation...

================================================================

Tmax50_SP1_Fix0 (created with InstallAnywhere by Macrovision)

----------------------------------------------------------------

================================================================

Introduction

------------

InstallAnywhere will guide you through the installation of Tmax50_SP1_Fix0.

It is strongly recommended that you quit all programs before continuing with

this installation.

Respond to each prompt to proceed to the next step in the installation. If you

want to change something on a previous step, type 'back'.

You may cancel this installation at any time by typing 'quit'.

PRESS <ENTER> TO CONTINUE:

5. Tmax 라이선스 준수 화면이 나타난다.


===============================================================================

License Agreement

-----------------

Installation and use of Tmax50_SP1_Fix0 requires acceptance of the following

License Agreement:

TP-Monitor Tmax Release

TmaxSoft Co., Ltd. (hereafter, TmaxSoft) End-User License Agreement

Product : Tmax

This is a legal agreement between you (either an individual or an company) and

TmaxSoft, Incorporated. By opening the sealed software package and/or by using

the software, you agree to be bound by the terms of this agreement.

TmaxSoft License

1. Grant of License: This TmaxSoft License Agreement ("License") permits you

to use one copy of the TmaxSoft product Tmax, on any single computer, provided

the software is in use on only one computer at any one time. If this package

is a license pack, you may make and use additional copies of the software up to

the number of licensed copies authorized. If you have multiple licenses for

the software, then at any time you may have as many copies of the software in

use as you have licenses.

The software is "in use" on a computer when it is loaded into the temporary

memory (i.e., RAM) or installed into the permanent memory (e.g., hard disk,

CD-ROM, or other storage devices) of that computer, except that a copy

installed on a network server for the sole purpose of distribution to other

computers is not "in use". If the anticipated number of users of the software

will exceed the number of applicable licenses, then you must have a reasonable


6. Tmax 라이선스 준수에 대한 다음 정보를 보기 위하여 <Enter> 키를 누른다.

mechanism or process in place to ensure that the number of persons using the

software concurrently does not exceed the number of licenses.

2. Copyright: The software (including any images, "applets," photographs,

animations, video, audio, music and text incorporated into the software) is

owned by TmaxSoft or its suppliers and international treaty provisions.

Therefore, you must treat the software like any other copyrighted materials

(e.g., a book or musical recording) except that you may either (a) make one

copy of the software solely for backup or archival purposes, or (b) transfer

the software to a single hard disk provided you keep the original solely for

backup or archival purposes. You may not copy the printed materials

accompanying the software, nor print copies of any user documentation provided


in "online" or electronic form.

3. Other restrictions: This license is your proof of license to exercise the

rights granted herein and must be retained by you. You may not rent, lease, or

transfer your rights under this license on a permanent basis provided you

transfer this license, the software, and all accompanying printed materials,

retain no copies, and the recipient agrees to the terms of this license. You

may not reverse engine, decompile, or disassemble the software, except to the

extent that the foregoing restriction is expressly prohibited by applicable

law.


7. 라이선스 동의 여부를 묻게 된다. 받아들인다면 ‘y’를 입력 후 <Enter> 키를 누르고, 아니면 ‘n’을 입력

후 <Enter> 키를 누른다.


DO YOU ACCEPT THE TERMS OF THIS LICENSE AGREEMENT? (Y/N):

8. Tmax 설치 요소를 선택한다.

-> 로 표기된 부분은 디폴트 선택 값으로 선택을 하지 않은 채 <Enter> 키를 누르면 1번이 자동으로 선

택된다. 엔진 전체를 설치하려면 1번을, 클라이언트만을 설치하려면 2번을 선택한다.

================================================================

Choose Install Set

------------------

Please choose the Install Set to be installed by this installer.

->1- Server + Client

2- Client

ENTER THE NUMBER FOR THE INSTALL SET, OR PRESS <ENTER> TO ACCEPT THE DEFAULT

9. 설치 디렉터리를 선택한다.

기본적으로 디폴트 값을 사용하려면 <Enter> 키를 누르고 아니면, 디렉터리 변경 시 설치 경로를 입력

한다.

=============================================================

Choose Install Folder

---------------------

Where would you like to install?


Default Install Folder: /EMC01/starbj81/tmax

ENTER AN ABSOLUTE PATH, OR PRESS <ENTER> TO ACCEPT THE DEFAULT

10. Tmax 기본 환경 파일 중 Tmax 시스템이 수행될 서버의 IP Address를 입력한다. 입력하지 않으면, 디폴

트로 현재 설치되고 있는 노드의 IP Address가 설정된다.

=============================================================

Set Environment Variable

------------------------

TMAX_HOST_ADDR : IP Address of your Tmax Host.

TMAX_HOST_ADDR (DEFAULT: 192.168.1.43):

11.다음 화면은 설치에 관련한 요약정보를 보여준다. <Enter> 키를 누르면 설치가 진행된다.

=============================================================

Pre-Installation Summary

------------------------

Please Review the Following Before Continuing:

Product Name:

Tmax50_SP1_Fix0

Install Folder:

/EMC01/starbj81/tmax

Link Folder:

/EMC01/starbj81

Disk Space Information (for Installation Target):

Required: 269,490,714 bytes

Available: 431,792,128 bytes


12.아래와 같은 메시지가 출력되면, Tmax를 설치할 준비가 되었다는 것을 의미한다. <Enter> 키를 누르면

본격적인 설치가 실행된다.

=============================================================

Ready To Install

----------------

InstallAnywhere is now ready to install Tmax50_SP1_Fix0 onto your system

at the following location:



PRESS <ENTER> TO INSTALL:

13.진행 바와 함께 설치가 진행된다.

=============================================================

Installing...

-------------

[==================|==================|==================|===

[------------------|------------------|------------------|---

=============================================================

Installation Complete

---------------------

Congratulations. Tmax50_SP1_Fix0 has been successfully installed to:


PRESS <ENTER> TO EXIT THE INSTALLER:

14.설치를 마치려면 <Enter> 키를 누른다.

PRESS <ENTER> TO EXIT THE INSTALLER:

참고

Tmax 클라이언트만 설치하여 사용하고자 할 때에는 Tmax 서버/클라이언트 설치과정을 참조하여

클라이언트를 설치한다.

Tmax 서버를 설치하고 애플리케이션을 개발하여 Tmax 시스템을 시작하는데 성공하였다면 실제로

서비스가 수행되는지 다양한 플랫폼에서 확인해 볼 필요가 있다. 사용자는 원하는 곳에 클라이언트

를 설치하고 클라이언트 프로그램을 개발하여 서비스를 사용할 수 있다. Tmax 클라이언트 모듈은

라이선스를 필요로 하지 않으며 홈페이지를 통해 자유롭게 받아서 사용할 수 있다.

2.3. 설치 확인

Tmax가 설치되면 다음과 같은 디렉터리가 생성된다.

+---- appbin

+---- bin

+---- config


+---- lib

+---- license

|---- log

+---- slog

+---- tlog

+---- ulog

+---- path

|---- sample

+---- client

+---- fdl

+---- sdl

+---- server

+---- svct

+---- usrinc

+---- topinc

+---- tuxinc

Tmax에서 사용하는 고유의 디렉터리는 다음과 같다.

appbin

Tmax를 이용해 개발된 응용 서버프로그램 디렉터리이다.

bin

Tmax 명령과 유틸리티가 위치한 디렉터리이다.

config

Tmax 시스템 환경파일이 위치한 디렉터리이다.

lib

Tmax 라이브러리(64bit 일 경우 lib64로 표시) 디렉터리이다.

license

라이선스 파일이 있는 디렉터리이다.

log

로그 파일(시스템, 유저, 트랜잭션)이 위치한 디렉터리이다.

path

프로세스간 통신 시 필요한 파이프 역할을 하는 디렉터리이다.

sample/client

클라이언트 샘플 프로그램 파일이 위치한 디렉터리이다.


sample/fdl

샘플 필드키 정의 파일(demo.f)이 위치한 디렉터리이다.

sample/sdl

샘플 구조체 정의 파일(demo.s)이 위치한 디렉터리이다.

sample/server

서버 샘플 프로그램 파일이 위치한 디렉터리이다.

svct

응용 서버프로그램 컴파일 시 필요한 서비스 테이블 파일이 위치한 디렉터리이다.

usrinc

Tmax 헤더 파일이 위치한 디렉터리이다.

demo.f와 demo.s는 FDL(Field Definition Language)과 SDL(Structure Definition Language) 형식의 필

드들을 정의하는 파일이다. 사용자는 실제 프로젝트에서 사용할 FDL및 SDL 형식 필드들을 필요에 따

라 직접 만들어서 사용할 수 있다.

topinc

topend 에서 tmax 전환시 해당 턱시도 함수들을 티맥스 함수로 바꿔 주는 헤더 파일이 위치한 디렉터

리이다.

tuxinc

tuxedo 에서 tmax 전환시 필요한 헤더 파일이 위치한 디렉터리 이다.

참고

자세한 사항은 Tmax 안내서 중 "Tmax Application Development Guide" 나 "Tmax Reference Guide"를

참고한다.

설치 후에 해주어야 할 사항들과 예제 프로그램 테스트에 관한 내용은 “2.5. 환경 설정” 에 설명되어 있다.

2.4. 제거다음은 Full 인스톨러를 사용한 Tmax 제거 과정이다.

$TMAXDIR/UninstallerData/Uninstall을 실행시켜 Tmax 엔진과 Tmax 설치 디렉터리, 환경 변수를 삭제한

다. (단, Tmax가 설치된 이후에 생성된 파일은 삭제되지 않는다.)

1. Uninstall을 실행시킨다. 패치하려는 버전의 정보 등을 확인한다.

tmaxh4@starbj81:/EMC01/starbj81/tmax/UninstallerData>./Uninstall

Preparing CONSOLE Mode Installation...


================================================================

Tmax50_SP1_Fix0 (created with InstallAnywhere by Macrovision)

----------------------------------------------------------------

================================================================

Uninstall Tmax50_SP1_Fix0

--------------------------

About to uninstall...

Tmax50_SP1_Fix0

This will remove features installed by InstallAnywhere. It will not remove

files and folders created after the installation.


2. <Enter> 키를 누르면 실제 Uninstall이 수행된다.

===============================================================================

Uninstalling...

---------------

...*

*

*************************

*************************

*************************

************************

...*

*

*************************

*************************

*************************

************************

...*

*

*************************

*************************

*************************

************************

...*

*

*************************


*************************

*************************

*************************

===============================================================================

Uninstall Complete

------------------

Some items could not be removed.

3. Uninstall이 성공적으로 수행되었는지 확인한다.

2.4.1. 설치 제거 확인

정상적으로 제거되었는지 다음 방법으로 확인한다.

● 파일과 디렉터리

$TMAXDIR 디렉터리의(기본: $HOME/tmax ) 모든 하위 파일과 하위 폴더가 제거되었는지 확인한다.

● 환경 변수

Tmax와 관련된 환경 변수들이 제거되었는지를 확인한다.

● PATH

시스템 path에서 Tmax path가 사라졌는지 확인한다.(예: “$HOME/tmax/bin”)

2.5. 환경 설정

2.5.1. 라이선스 파일 설치

Tmax 서버 시스템을 운영하거나 WebT를 통해 Tmax의 서비스를 이용하고자 할 때는 설치 후에 반드시

라이선스 파일의 설치가 이루어져야 한다. Tmax 클라이언트만 설치한 시스템이라면 이 절을 건너 뛰어도

좋다. Tmax 클라이언트는 라이선스를 별도로 필요로 하지 않는다.

Tmax 제품군에 대한 라이선스는 옵션별로 나뉘어 지며, 그 내용은 다음과 같다.

● 도메인 게이트웨이 : 서로 다른 Tmax 도메인 간에 통신을 할 수 있는 시스템

● 신뢰성 큐(Reliable Queue) : 신뢰성 큐를 사용하고자 하는 시스템


● HostLink : Tmax 서버와 Main Frame과의 연동을 위해 필요한 시스템

● WebT : Web에서 Tmax의 서비스를 이용할 수 있는 시스템

사용자가 Tmax의 기본 기능 또는 그 이외에 위와 같은 기능을 추가적으로 사용하고자 할 경우 라이선스

를 TmaxSoft로부터 발급 받아야 한다.

라이선스는 온라인 TmaxSoft 홈페이지 또는 E-mail을 통해 접수가 가능하며, Tmax가 필요로 하는 양식에

맞춰 정보를 기입하면 원하는 라이선스 파일을 받아 설치할 수 있다. 라이선스를 발급받기 위하여 사용자

는 Tmax 제품의 설치를 끝마친 후 아래와 같은 시스템 정보를 체크하는 유틸리티를 실행하여 그 결과를

라이선스 발급처에 알려주어야 한다. 보낼 E-mail 주소는 “1.1.3. 소프트웨어 배포” 를 참고한다.

Tmax 시스템이 정상적으로 설치 되었다면, 라이선스 디렉터리 내에 ncpu라는 이름의 파일을 찾을 수 있

을 것이다.

./ncpu

위와 같이 ncpu 유틸리티를 실행하면, 다음과 같은 정보가 화면에 나오게 된다.

HOST NAME1: tmaxs1

HOST NAME2: tmaxs1

HOSTID: 80FD0534

HOSTID: 80FD0534

H/W SERIAL: 2164065588

NCPUS: 2

UNAME: SunOS tmaxs1 5.7 Generic_106541-11 sun4u sparc

SUNW,Ultra-80

TmaxSoft는 정식으로 Tmax 제품군을 미리 사용해 볼 수 있도록 평가 라이선스를 제공하며 평가판은 기

능상의 제한은 두지 않고 사용기간만을 제한하고 있다. 평가 기간은 최장 6개월까지 연장할 수 있다. 자세

한 문의사항은 “1.1.3. 소프트웨어 배포” 부분에서 언급된 연락처를 참고한다.

2.5.2. 환경 변수 설정

설치 후 Tmax 응용프로그램을 컴파일 할 때, 또는 실제 개발환경에서 프로젝트 진행 시에는 C 컴파일러

나 make 유틸리티 등이 필요하다. 파일들(cc, make 등)이 포함된 디렉터리가 PATH 환경 변수에 설정이

되어 있는지 확인하고, 설정이 되어 있지 않다면 반드시 관련 디렉터리와 그외 필요한 기본 디렉터리들도

적용될 수 있도록 해야 한다.


다음은 Bourne 셸 또는 Korn 셸 사용자가 Tmax를 설치하면 .profile에 추가되는 Tmax 시스템 환경 변수

들을 보여준다. 자세한 내용은 플랫폼 마다 다를 수 있다.

# New environment setting added by Tmax50_SP1_Fix0 on Tue Apr 17 15:46:50

MDT 2007 1.

# The unmodified version of this file is saved in /EMC01/starbj81/.profile1486280820.

# Do NOT modify these lines; they are used to uninstall.

TMAXDIR=/EMC01/starbj81/tmax

export TMAXDIR

# End comments by InstallAnywhere on Tue Apr 17 15:46:50 MDT 2007 1.


MDT 2007 2.



PATH="/EMC01/starbj81/tmax/bin:${PATH}"

export PATH



MDT 2007 3.



TMAX_HOST_ADDR=192.168.1.43

export TMAX_HOST_ADDR



MDT 2007 4.



TMAX_HOST_PORT=8888

export TMAX_HOST_PORT



MDT 2007 5.



SDLFILE=/EMC01/starbj81/tmax/sample/sdl/tmax.sdl

export SDLFILE



MDT 2007 6.




FDLFILE=/EMC01/starbj81/tmax/sample/fdl/tmax.fdl

export FDLFILE



MDT 2007 7.



TMAX_CONNECT_TIMEOUT=3

export TMAX_CONNECT_TIMEOUT



MDT 2007 8.



SHLIB_PATH="${SHLIB_PATH}:/EMC01/starbj81/tmax/lib64"

export SHLIB_PATH


위의 항목들을 간단히 설명하면 다음과 같다.

설명항목

Tmax가 설치된 디렉터리의 경로이다.TMAXDIR

접속하고자 하는 Tmax 서버의 IP 주소이다.TMAX_HOST_ADDR

접속하고자 하는 Tmax 서버의 포트번호이다. 번호는 Tmax 서버의 시

스템 설정파일(예: sample.m)에서 정하는 TPORTNO와 일치해야 한다.

TMAX_HOST_PORT

구조체 버퍼 형식을 사용하기 위한 SDL 이진파일(filename.sdl)의 위치

를 설정하며, 응용 프로그램에서 구조체 버퍼 형식을 사용하지 않으면

정의할 필요가 없다.

SDLFILE

필드키 버퍼 형식을 사용하기 위한 FDL 이진파일(filename.fdl)의 위치

를 설정하며, 응용프로그램에서 필드키 버퍼 형식을 사용하지 않으면

정의할 필요가 없다.

FDLFILE

Tmax 시스템 접속 제한 시간을 의미한다.TMAX_CONNECT_TIMEOUT

공유라이브러리 PATH이며 OS별로 환경 변수가 다르게 지정된다.LD_LIBRARY_PATH

- SunOS/Compaq/Linux : LD_LIBRARY_PATH

- HP-UX 의 경우 : SHLIB_PATH

- AIX 의 경우 : LIBPATH


설명항목

접속 서버의 장애시 연결하고자 하는 백업 서버의 IP 주소이다.TMAX_BACKUP_ADDR

접속하고자 하는 Tmax 백업 서버의 포트번호이다.TMAX_BACKUP_PORT

번호는 Tmax 백업 서버의 시스템 설정파일(filename.m)에서 정하는

TPORTNO와 일치해야 한다.

Tmax는 공유 라이브러리를 사용해서 새로운 버전이나 패치된 엔진을 적용했을 때, 응용 서버 프로그램을

다시 컴파일 하여야 하는 불편함을 없앨 수 있다. 현재 Tmax 버전(4.0.x)에서는 정적 라이브러리와 공유

라이브러리를 함께 제공하고 있다.(단 IBM AIX는 일부만을 공유 라이브러리로 제공한다.)

공유 라이브러리를 사용하기 위해서는 응용 서버프로그램을 개발할 때 필요한 라이브러리를 포함하도록

하고 각 OS의 컴파일러에 공유 라이브러리 이용에 관한 FLAGS 설정을 해주어야 한다.

참고

자세한 내용은 Tmax 안내서 중 "Tmax Getting Started Guide" 나 "Tmax Application Development

Guide"를 참고한다.

각 플랫폼 별 컴파일 옵션은 다음과 같다.

● #Solaris 32bit, Compaq, Linux: CFLAGS = -O –I$(TMAXDIR)

● #Solaris 64bit: CFLAGS = -xarch=v9 -O –I$(TMAXDIR)

● #HP 32bit: CFLAGS = -Ae -O –I$(TMAXDIR)

● #HP 64bit: CFLAGS = -Ae +DA2.0W +DD64 +DS2.0 -O –I$(TMAXDIR)

● #IBM 32bit: CFLAGS = -q32 –brtl -O –I$(TMAXDIR)

● #IBM 64bit: CFLAGS = -q64 –brtl -O –I$(TMAXDIR)

공유 라이브러리의 디렉터리의 위치는 Tmax 설치 시 환경 파일에 자동으로 설정 된다. (LD_LIBRARY_PATH

또는 SHLIB_PATH )

설정한 Tmax 환경 변수를 적용하기 위해 홈 디렉터리에서 다음과 같이 수행한다.

Bourne/Korn 셸의 경우

. ./.profile

C 셸의 경우

source .cshrc


env 또는 set 명령으로 환경 변수가 잘 적용 되었는지 확인한다.

2.5.3. sample.m 파일의 구성

다음은 Tmax를 기동 시킬 때 필요한 각종 정보들이 들어있는 Tmax 시스템 환경 파일이다. 아스키 파일

형태로 작성하며, cfl 유틸리티로 컴파일 하여 이진파일을 생성한다. 생성된 이진파일은 Tmax 기동 및 종

료 시 참조된다.

*DOMAIN

tmax1 SHMKEY =79990, MINCLH=1, MAXCLH=3,

TPORTNO=8888, BLOCKTIME=30

*NODE

tmaxs2 TMAXDIR = "/user/mmidea/tmax",

APPDIR = "/user/mmidea/tmax/appbin",

PATHDIR = "/user/mmidea/tmax/path",

TLOGDIR = "/user/mmidea/tmax/log/tlog",

ULOGDIR = "/user/mmidea/tmax/log/ulog",

SLOGDIR = "/user/mmidea/tmax/log/slog"

*SVRGROUP

svg1 NODENAME = tmaxs2

*SERVER

svr1 SVGNAME = svg1, MIN=1

*SERVICE

SDLTOUPPER SVRNAME = svr1

SDLTOLOWER SVRNAME = svr1

2.6. 예제 프로그램 테스트Tmax가 올바르게 설치가 되었는지 간단한 예제 프로그램을 통해서 살펴보도록 한다.

프로그램에 사용된 각종 파일들은 다음과 같다.

● 테스트 환경

– 운영체제: SunOS 5.7 32bit 버전

– 셸: korn 셸

– $TMAXDIR=/user/tmax

● 프로그램


– sample.m : Tmax 환경 설정 파일($TMAXDIR/config)

– svr1.c : 서버 프로그램($TMAXDIR/sample/server)

– sdltoupper.c : 클라이언트 프로그램($TMAXDIR/sample/client)

– demo.s : 구조체 정의 파일($TMAXDIR/sample/sdl)

– demo.f : 필드키 정의 파일($TMAXDIR/sample/fdl)

– tmax.env : Tmax 환경 변수 정의 파일($TMAXDIR/sample/client)

2.6.1. 기본 환경 설정

$TMAXDIR/config 디렉터리로 이동하여 환경파일을 컴파일한다. Tmax 시스템이 설치된 홈 디렉터리를

TMAXDIR 이라 표현하기로 한다.

$>cfl –i sample.m

성공적으로 컴파일이 된 후에는 다음과 같은 메시지가 출력된다.

CFL is done successfully for node(<nodename>)

Tmax가 설치되면 TMAXDIR/config 디렉터리에 자동으로 sample.m 파일이 생성된다. 해당 서버의 호스

트 이름이 실제 호스트 이름과 맞지 않는 경우가 발생할 수 있다. 예를 들어, uname –n 명령을 사용했을

때 나오는 이름이 tmax1.tmax.co.kr과 같이 나왔는데 컴파일이 되지 않는 경우이다. 이럴 때는

TMAXDIR/license 디렉터리에 있는 ncpu 라는 유틸리티를 실행하여 확인할 수 있다. ncpu 를 실행해서 나

오는 호스트 이름을 sample.m에 입력하고, 그 호스트 이름에 맞는 라이선스를 다시 받아 설치한다. ncpu

에 관한 내용은 “2.5. 환경 설정” 에 언급되어 있다.

다음 서비스 테이블을 생성한다. 서비스 테이블은 각각의 서버 프로세스가 생성될 때 필요한 파일로서 각

각의 프로세스들이 어떤 서비스를 처리하는지에 대한 정보가 담겨 있다.

$>gst

성공적으로 처리되면 다음과 같은 메시지가 출력된다.

SVC tables are successfully generated GST is successfully done

TMAXDIR/sample/sdl 디렉터리로 이동하여 구조체 정의 이진파일을 생성한다. 이 때 서버에서와 클라이

언트에서 필요한 파일들이 다르므로 sdlc를 할 때 서버에서와 클라이언트에서 옵션을 다르게 해 주어야

한다.

서버에서는 다음과 같이 sdlc를 해 준다.


$>sdlc –i demo.s

위와 같이 하면 demo_sdl.h 및 demo_sdl.c 파일이 생성된다. 생성되는 파일들은 구조체 타입 버퍼를 사용

하는 서버 프로그램에서 컴파일할 때 참조가 된다. 물론 샘플로 제공되는 makefile에서는 구조체 타입 버

퍼를 사용하는 서버 프로그램을 컴파일 할 때 sdlc를 하는 루틴이 있지만 서버 프로그램 컴파일 하기 전에

미리 sdlc를 해 두는 것이 좋다.

클라이언트에서는 다음과 같이 sdlc를 해 준다.

$>sdlc –c –i demo.s –o tmax.sdl

위와 같이 하면 demo_sdl.h 및 tmax.sdl 파일이 생성된다. "–o" 옵션을 사용하지 않으면 디폴트로 <구조체

파일명>.sdl 이 생성된다. 파일은 이진파일로 구조체 타입 버퍼를 사용하는 클라이언트 프로그램에서 구

조체 타입 버퍼를 메모리에 할당할 때 사용된다. 파일의 위치는 사용자 환경파일에 설정된 SDLFILE이라

는 환경 변수를 참조한다. Tmax 시스템의 설치가 완료되었을때 Tmax 인스톨러는 디폴트로 값을

TMAXDIR/sample/sdl/ tmax.sdl 로 설정하므로 값을 그대로 사용하려면 sdlc 명령을 사용할 때 반드시 "–o"

옵션을 사용하여 이진 파일의 이름을 tmax.sdl 로 지정해 주어야 한다.

sdlc가 성공적으로 수행되었다면 아무런 메시지가 출력되지 않는다.

TMAXDIR/sample/fdl 디렉터리로 이동하여 필드키 이진파일을 생성한다. fdlc 는 서버나 클라이언트에 관

계없이 다음과 같이 하면 된다.

$>fdlc –c –i demo.f

성공적으로 컴파일이 이루어지면 다음과 같은 메시지가 출력된다.

FDLC is successfully done

2.6.2. 서버 프로그램 컴파일

TMAXDIR/sample/server 디렉터리로 이동하여 실제적으로 서비스를 제공하는 서버 프로그램을 컴파일

한다.

$>./compile sdl svr1

성공적으로 컴파일이 끝난 후에는 다음과 같은 메시지가 출력된다.

cc -O -I/user/tmax -c svr1.c

cc -O -I/user/tmax -L/user/tmax/lib -o svr1 svr1.o demo_sdl.o svr1_svctab.o

-lsvr -lnsl –lsocket -lnodb

mv svr1 /user/tmax/appbin

마지막 줄의 /user/tmax/appbin 은 서비스 프로그램들이 위치하는 디렉터리로 Tmax 환경파일에 사용자

임의로 설정할 수 있다.


참고

자세한 내용은 Tmax 안내서 중 "Tmax Administraion Guide"를 참고한다.

2.6.3. Tmax 시스템의 기동

서버 프로그램의 컴파일이 완료되면 Tmax 시스템을 기동할 수 있다. Tmax를 기동 시킨다.

$>tmboot 성공적으로 기동 되면 다음과 같은 메시지가 출력된다.

TMBOOT for node(<nodename>) is starting:

TMBOOT: TMM is starting: Thu Apr 12 23:05:51 2001

TMBOOT: CLL is starting: Thu Apr 12 23:05:51 2001

TMBOOT: CLH is starting: Thu Apr 12 23:05:51 2001

(I) CLH Current Tmax Configuration:

Number of client handler(MINCLH) = 1

Supported maximum user per node = 200

Supported maximum user per handler = 201

TMBOOT: SVR(svr1) is starting: Thu Apr 12 23:05:51 2001

<nodename>, <Supported maximum user per node>, <Supported maximu m user per handler>는 시스

템마다 다른 값을 가진다.

tmboot시 실패할 수 있는 경우는 다음과 같다.

● Tmax 시스템 환경파일(xxxx.m)에서 지정된 TPORTNO, TPORTNO+1 을 이미 시스템에서 사용중인 경

우

● SHMKEY 값이 이미 시스템에서 사용중인 경우

● Tmax 시스템 환경파일의 컴파일(cfl)이 제대로 수행되지 않은 경우

● Tmax 시스템 환경파일에 등록되어 있는 서비스 프로그램이 모두 컴파일되지 않은 경우

Tmax가 기동 되지 않거나 에러 메시지를 출력하면 위의 내용을 다시 확인해 보고 수정한 후 다시 기동시

켜야 한다.

2.6.4. 클라이언트 프로그램 컴파일 및 실행

TMAXDIR/sample/client

디렉터리로 이동하여 클라이언트 프로그램을 컴파일한다.

$>./compile c sdltoupper


성공적으로 컴파일이 끝난 후에는 다음과 같은 메시지가 출력된다.

cc -O -I/user/tmax -c sdltoupper.c

cc -O -I/user/tmax -L/user/tmax/lib -o sdltoupper sdltoupper.o -lcli -lnsl –lsocket

실행하기에 앞서 현재 디렉터리(sample/client)에 tmax.env 파일이 있는지 확인한다. tmax.env 파일은 클

라이언트에서 tmax 시스템에 접속하기 위한 환경 변수를 정의한 텍스트 파일이다.

파일이 존재하면 클라이언트 프로그램을 실행시킨다.

$>./sdltoupper tmax

성공적으로 서비스가 수행되면 다음과 같은 메시지가 출력된다.

send data: tmax

recv data: TMAX

위의 결과를 받으면 정상적으로 Tmax가 설치 되었음을 확인할 수 있다.

그 외에 인스톨러가 제공하는 예제에 대해서 간략하게 설명한다.

비고컴파일서버 프로그램클라이언트

구조체 버퍼compile sdl svr1svr1.csdltoupper.c sdltolower.c

스트링 버퍼compile c svr2svr2.ctoupper.c tolower.c

필드키 버퍼compile c svr3svr3.cfdltoupper.c fdltolower.c

구조체 버퍼 Oracle 연동compile psdl sdltestsdltest.pcsdl_main.c

필드키 버퍼 Oracle 연동compile pc fdltestfdltest.pcfdl_main.c

대화형 서비스compile c svr_convsvr_conv.ctoupper_conv.c

RQ 서비스compile c svr_rqsvr_rq.ctoupper_rq.c cli_rq.c

UCS 프로그램compile ucs svr_ucssvr_ucscli_ucs.c


제3장 Windows에서 설치와 제거

본 장에서는 Windows NT/2000 운영체제에서 Tmax 서버/클라이언트 또는 Tmax 클라이언트를 설치하는

방법에 대해 설명한다. Windows NT/2000에 Tmax 시스템을 설치하지 않는 경우는 이 장을 건너 뛰어도

좋다.

3.1. 설치 전 준비사항Tmax 서버/클라이언트 설치 전 준비사항은 다음과 같다.

● Windows 플랫폼은 여러가지 서비스를 등록하므로 완전한 설치를 위해서 Administrator 권한으로 설치

할 것을 권장한다.

● 설치 환경이 Tmax 설치 최소 요구사항에 합당한지 확인하고 CD-ROM 드라이브에 Tmax CD-ROM을

삽입한다.

● Oracle 데이터베이스를 사용할 경우는 Oracle의 버전을 확인한다.

3.2. 설치Tmax 시스템의 실제 운영을 위하여 Tmax 서버와 클라이언트를 모두 설치한다.

설치과정은 다음과 같다.

1. TMAX 설치 프로그램인 “Tmax5.0_SP1_Fix0_Win.exe” 이 있는 위치로 이동한다.

2. “Tmax5.0_SP1_FixO_Win.exe” 파일을 더블클릭해서 실행한다.

3. 설치 툴의 초기화면이 아래 그림과 같이 나타난다. 진행이 100 %가 될 때까지 기다린다.

[그림 3.1] 초기화면

제3장 Windows에서 설치와 제거 25

4. 소개화면이 나타나면 소개 내용을 읽고 [Next]버튼을 클릭한다. 설치를 종료 하려면 왼쪽의 [Cancel]

버튼을 클릭한다.

5. 라이선스 준수 화면이 나타난다. 라이선스 준수를 읽고 “I accept the terms of …” 체크박스를 체크한 후

[Next] 버튼을 클릭한다.

[그림 3.2] License Agreement

6. Install Set 선택 화면이 나타난다. Tmax 엔진 전체를 설치하려면 'Server + Client'항목을, 클라이언트

만을 설치하려면 'Client' 항목을 선택한다.

[그림 3.3] Choose Install Set

7. 설치 디렉터리 선택 화면이 나타난다. Tmax 바이너리들과 기타 다른 파일들은 텍스트 필드에 표시된

디렉터리의 하위에 놓이게 된다. 기본 폴더를 그대로 사용하길 권고한다(예: “C:\TmaxSoft\tmax”).


[Choose… ] 버튼을 클릭하면 다른 설치 폴더를 선택할 수 있고 [Restore Default Folder] 버튼을 클릭

하면 초기 기본 폴더로 복귀한다.

[그림 3.4] Choose Install Folder

8. Tmax 기본 환경 파일을 입력한다. TMAX_XA_DLL 항목에 Oracle 버전을 선택하게 되면, 각 XA dll 의

이름이 이 환경 변수에 설정된다. TMAX_HOST_ADDR 에는 Tmax 시스템이 수행될 서버의 IP Address

를 입력한다. 입력하지 않으면, 디폴트로 현재 설치되고 있는 노드의 IP Address가 설정된다.

TMAX_WIN_PORT 에는 Tmax 엔진 프로세스와 서버 프로세스가 통신할 포트 번호를 입력한다. 입력

하지 않으면, 디폴트로 8870 이 설정된다.

[그림 3.5] Set Environment Varialbe


9. 다음 화면은 설치에 관련한 요약정보를 보여준다. [Install] 버튼을 클릭하면 설치가 진행된다.

[그림 3.6] Pre-Installation Summary

10. Tmax 설치 화면이 나타난다.

[그림 3.7] Installing Tmax1


11.설치가 완료될 때까지 기다린다.

[그림 3.8] Installing Tmax2

12.다음과 같은 화면이 나올 때까지 기다린다. [Done] 버튼을 클릭하면 Tmax 설치가 완료된다.

[그림 3.9] Install Complete

설치 과정이 모두 완료된 후에는 입력한 환경 변수가 반영되도록 해야 한다. Windows 2000의 경우는

위의 과정이 필요 없으나 Windows NT의 경우 시스템 재부팅 과정이 꼭 필요하다. 재부팅을 하지 않을

경우 환경 변수로 설정은 되어 있지만 실제로 시스템에 반영되지는 않는다. Windows 2000의 경우는

No 를 선택하도록 하고 Windows NT의 경우는 'Yes'를 선택하여 재부팅 하도록 한다.


참고

Tmax 클라이언트만 설치하고자 하는 사용자는 Tmax 서버/클라이언트 설치 과정을 참조하여 클라

이언트를 원하는 곳에 설치한다. 사용자는 원하는 곳에 클라이언트를 깔고 클라이언트 프로그램을

개발하여 서비스를 사용할 수 있다. Tmax 클라이언트 모듈은 라이선스를 필요로 하지 않으며 홈페

이지를 통해 자유롭게 받아서 사용할 수 있다.

Tmax 클라이언트는 Windows NT/2000 뿐만 아니라 Windows 98/Me 에서도 사용할 수 있다. 이 경

우 GUI 인스톨러가 환경 설정을 해주지 않으므로 직접 해당 파일(autoexec.bat) 에 필요한 환경 변수

를 설정하고 재부팅 해야 한다.

3.3. 설치 확인

3.3.1. 설치 후 디렉터리 구조

Tmax가 설치되면 다음과 같은 디렉터리가 생성된다.

+---- appbin

+---- bin

+---- config

+---- lib

+---- license

|---- log

+---- slog

+---- tlog

+---- ulog

+---- path

|---- sample

+---- client

+---- fdl

+---- sdl

+---- server

+---- svct

+---- usrinc

+---- topinc

+---- tuxinc

Tmax에서 사용하는 고유의 디렉터리는 다음과 같다.

appbin

Tmax를 이용해 개발된 응용 서버프로그램 디렉터리이다.


bin

Tmax 명령과 유틸리티가 위치한 디렉터리이다.

config

Tmax 시스템 환경파일이 위치한 디렉터리이다.

lib

Tmax 라이브러리(64bit 일 경우 lib64로 표시) 디렉터리이다.

license

라이선스 파일이 있는 디렉터리이다.

log

로그 파일(시스템, 유저, 트랜잭션)이 위치한 디렉터리이다.

path

프로세스간 통신 시 필요한 파이프 역할을 하는 디렉터리이다.

sample/client

클라이언트 샘플 프로그램 파일이 위치한 디렉터리이다.

sample/fdl

샘플 필드키 정의 파일(demo.f)이 위치한 디렉터리이다.

sample/sdl

샘플 구조체 정의 파일(demo.s)이 위치한 디렉터리이다.

sample/server

서버 샘플 프로그램 파일이 위치한 디렉터리이다.

svct

응용 서버프로그램 컴파일 시 필요한 서비스 테이블 파일이 위치한 디렉터리이다.

usrinc

Tmax 헤더 파일이 위치한 디렉터리이다.

demo.f와 demo.s는 FDL(Field Definition Language)과 SDL(Structure Definition Language) 형식의 필

드들을 정의하는 파일이다. 사용자는 실제 프로젝트에서 사용할 FDL및 SDL 형식 필드들을 필요에 따

라 직접 만들어서 사용할 수 있다.

topinc

topend 에서 tmax 전환시 해당 턱시도 함수들을 티맥스 함수로 바꿔 주는 헤더 파일이 위치한 디렉터

리이다.


tuxinc

tuxedo 에서 tmax 전환시 필요한 헤더 파일이 위치한 디렉터리 이다.

참고

자세한 사항은 Tmax 안내서 중 "Tmax Application development Guide" 나 "Tmax Reference Guide"를

참고한다.

설치 후에 해주어야 할 사항들과 예제 프로그램 테스트에 관한 내용은 “2.5. 환경 설정” 에 설명되어 있다.

3.3.2. 환경 변수 등록

설치과정에서 지정한 환경 변수이외에 필드키버퍼나 구조체버퍼 사용시 필요한 환경 변수가 다음과 같이

자동으로 지정된다. TMAXDIR은 Tmax 시스템을 설치한 폴더의 경로를 의미한다.

● FILE : TMAXDIR\fdl\tmax.fdl

● SDLFILE : TMAXDIR\sdl\tmax.sdl

또한 PATH에 TMAXDIR\bin 디렉터리가 자동으로 추가된다.

3.3.3. Windows 서비스 등록/제거

Tmax는 Windows 운영체제에서 Windows 서비스로서 동작할 수 있도록 설계되었다. Tmax Loader 기능

을 사용하면 시스템 리부팅시 Tmax를 자동으로 기동할 수 있으며 백그라운드 프로세스로 동작시킬 수 있

다.

● 서비스 등록 방법

TMAXDIR\bin 디렉터리로 이동한다.

<svcinstall.exe> 파일을 실행하면 Tmax를 Windows 서비스로 등록하게 된다.

● 서비스 제거 방법

TMAXDIR\bin 디렉터리로 이동한다.

<svcremove.exe> 파일을 실행하면 Tmax를 Windows 서비스에서 제거하게 된다.

Tmax Loader를 이용할 경우 Tmax 시스템 프로세스들이 백그라운드 시스템 프로세스들로 움직이기 때문

에 도스 명령창에서와는 달리 애플리케이션 로그나 시스템 런타임 메시지들을 볼 수가 없고 디버깅을 하

길 원한다면 시스템 로그파일(slog파일)과 유저 로그파일(ulog 파일)에 기록되는 메시지들을 이용해야 한

다.


참고

로그파일 설정과 기록 내용에 관해서는 Tmax 안내서 중 "Tmax Administraion Guide" 와 "Tmax

Reference Guide" 를 참고한다.

3.4. 제거설치된 Tmax를 제거하는 과정은 다음과 같다.

1. 모든 Tmax 프로세스를 중지시킨다.

2. $TMAXDIR 디렉터리의 UninstallerData 디렉터리에서 Uninstall.exe를 실행하거나(예: “c:\Tmax

Soft\tmax\UninstallerData”), [시작] > [모든 프로그램] > [TmaxSoft] > [tmax] > [Uninstall]을 클릭한

다.

3. 다음과 같은 제거 화면이 나타난다.

제거 화면의 메시지를 읽고 Tmax 제거 준비가 되었다면 [Uninstall] 버튼을 클릭한다. Tmax를 제거하

지 않고 프로그램을 닫으려면 [Cancel]버튼을 클릭한다.

[그림 3.10] Indroduction

참고

제거 프로그램은 Tmax 설치 이후에 생성된 파일들은 제거하지 않는다. 파일들은 수동으로 제거하여

야 한다.


4. Uninstall Tmax 화면이 나타난다. Tmax 제거의 진행표시를 볼 수 있다.

[그림 3.11] Uninstalling

5. 다음과 같이 설치 완료 화면이 나타날 때까지 기다린다. Uinstaller로 제거되지 않는 파일이 출력되면 파

일들은 그대로 두거나 수작업으로 지울 수 있다.

[그림 3.12] Uninstall Complete


3.4.1. 설치 제거 확인

정상적으로 제거되었는지 다음 방법으로 확인한다.

● 파일과 디렉터리

%TMAXDIR% 디렉터리의(기본: c:\TmaxSoft\tmax ) 모든 하위 파일과 하위 폴더가 제거되었는지 확인

한다.

● Shortcuts

설치동안에 생성된 ‘바로가기’ (프로그램 메뉴의 항목과 같은)가 제거되었는지 확인한다.

● 환경 변수

다음 환경 변수들이 제거되었는지를 확인하고, 필요하다면 [시작] > [설정] > [제어판] > [시스템] > [고

급] > [환경 변수]에서 수동으로 제거할 수 있다. (Windows 2000/ Windows XP/ Windows 2003)

Windows 명령 프롬프트에 ‘set’ 명령으로 변수들을 확인할 수 있다. 만약 JEUS 제거 후에 컴퓨터를 재

부팅 했다면 갱신되어 있어야 한다.

● PATH

시스템 path에서 Tmax path가 사라졌는지 확인한다.(예: “c:\TmaxSoft\tmax\bin”)

3.5. 환경 설정

3.5.1. 라이선스 파일 설치

Tmax 서버 시스템을 운영하거나 WebT를 통해 Tmax의 서비스를 이용하고자 할 때는 설치 후에 반드시

라이선스 파일의 설치가 이루어져야 한다. Tmax 클라이언트만 설치한 시스템이라면 이 절을 건너 뛰어도

좋다. Tmax 클라이언트는 라이선스를 별도로 필요로 하지 않는다.

Tmax 제품군에 대한 라이선스는 옵션별로 나뉘어 지며, 그 내용은 다음과 같다.

● 도메인 게이트웨이 : 서로 다른 Tmax 도메인 간에 통신을 할 수 있는 시스템

● 신뢰성 큐(Reliable Queue) : 신뢰성 큐를 사용하고자 하는 시스템

● HostLink : Tmax 서버와 Main Frame과의 연동을 위해 필요한 시스템

● WebT : Web에서 Tmax의 서비스를 이용할 수 있는 시스템


사용자가 Tmax의 기본 기능 또는 그 이외에 위와 같은 기능을 추가적으로 사용하고자 할 경우 라이선스

를 TmaxSoft로부터 발급 받아야 한다.

라이선스는 온라인 TmaxSoft 홈페이지 또는 E-mail을 통해 접수가 가능하며, Tmax가 필요로 하는 양식에

맞춰 정보를 기입하면 원하는 라이선스 파일을 받아 설치할 수 있다. 라이선스를 발급받기 위하여 사용자

는 Tmax 제품의 설치를 끝마친 후 아래와 같은 시스템 정보를 체크하는 유틸리티를 실행하여 그 결과를

라이선스 발급처에 알려주어야 한다.

Tmax 시스템 실행 명령중에서 ncpu.exe를 실행시키면 Windows 서버에 대한 정보를 알 수 있다.

실행 방법은 다음과 같다.

1. 도스 명령창을 연다. 도스 명령창은 [시작] 버튼을 누르면 나오는 메뉴중에서 [실행]을 선택하고 입력창

에 'command'라고 입력하면 실행된다.

[그림 3.13] 실행

2. ncpu 명령을 입력하고 <Enter> 키를 누른다.

3. 도스 명령창에 Tmax 서버의 호스트명이 출력된다.

4. 출력된 호스트명을 TmaxSoft 라이선스 담당자에게 보내면 라이선스 파일을 생성하여 보내준다. 보낼

E-mail 주소는 “1.1.3. 소프트웨어 배포”를 참고한다.

[그림 3.14] Command Prompt


라이선스 파일을 설치하고 나면 도스 명령창에서 Tmax 시스템 사용이 가능하다. 도스 명령창을 열고 Tmax

시스템을 실행하면 애플리케이션 로그들과 시스템 런타임 메시지들이 화면상으로 출력되기 때문에 디버

깅 하기가 편리하다. 주의해야 할 점은 tmboot을 실행한 도스 명령창을 tmdown을 실행하지 않고 종료할

경우 에러가 발생하며 Windows 시스템에 의해 모든 프로세스들은 비정상 종료된다.

따라서 이런 경우가 발생하지 않도록 반드시 tmdown 후에 도스 명령창을 닫도록 주의해야만 한다.

애플리케이션 개발이 완료되어 더 이상 프로그램 디버깅을 할 필요가 없게 되면 도스 명령창에서 tmboot

또는 tmdown 명령을 입력하여 Tmax 시스템을 시작하거나 종료하지 않고 시스템 서비스로 등록된 Tmax

Loader를 이용하여 Tmax 시스템을 시작 또는 종료하는 방법을 사용해도 된다. Tmax Loader를 이용할 경

우 Tmax 시스템 프로세스들이 백그라운드 시스템 프로세스들로 움직이기 때문에 도스 명령창에서와는

달리 애플리케이션 로그나 시스템 런타임 메시지들을 볼 수가 없고 디버깅을 하길 원한다면 시스템 로그

파일(slog파일)과 유저 로그파일(ulog 파일)에 기록되는 메시지들을 이용해야 한다.

참고

1. TmaxSoft 제품군에 대한 라이선스는 24시간 이내에 발급함을 원칙으로 하고 있다.

2. TmaxSoft는 정식으로 Tmax 제품군을 구매했을 때 발급하는 라이선스와 어느 정도의 기간을 두

고 제품을 시험할 수 있도록 평가판 라이선스를 제공하고 있다. 평가판 라이선스에서는 기능상의 제

한은 두지 않고, 사용기간 제한을 두어 배포하고 있다.

3. 로그파일 설정과 기록 내용에 관해서는 Tmax 안내서 중 "Tmax Administraion Guide" 와 "Tmax

Reference Guide"를 참고한다.

자세한 문의 사항은 “1.1.3. 소프트웨어 배포” 부분에서 언급한 연락처를 참고한다.

3.5.2. 환경 변수 설정

시스템을 운용하기 전에 시스템 환경 변수들이 올바르게 지정되어져 있는지 확인한다. 확인하는 방법은

다음과 같다.

[제어판] > [시스템] > [고급] > [환경 변수]에서 확인할 환경 변수들은 설치 과정 중에 지정한 TMAXDIR,

TMAX_HOST_ ADDR, TMAX_HOST_PORT, TMAX_WIN_PORT, SDLFILE, FDLFILE, PATH이다.

PATH는 TMAXDIR\bin 디렉터리가 포함되어 있는지를 확인한다. 새로운 도스 명령창을 열고 시스템에 환

경 변수가 반영이 되었는지 확인한다. 환경 변수가 반영이 되어 있지 않았다면 시스템을 재부팅 하거나 환

경파일 변경 내용을 적용하여 적절히 반영시켜 주어야 한다.

모든 환경 변수들이 올바르게 지정되어져 있고 시스템에 완전히 반영되어져 있다면 Tmax 시스템에서 제

공하는 샘플 프로그램을 실행시켜 Tmax 시스템이 정상적으로 설치되어졌는지 확인해야 한다. 샘플 프로

그램은 Tmax 시스템이 설치된 폴더의 하위 디렉터리인 <TMAXDIR\sample> 내에 있다.


3.5.3. 기본 환경 설정

샘플 프로그램을 동작하기 위한 Tmax 환경파일을 구성한다. Tmax 환경파일은 Tmax 시스템이 동작하는

데 있어서 근거가 되는 파일이다.

구성방법은 다음과 같다.

1. 도스 명령창을 연다. 도스 명령창을 여는 방법은 [시작] 메뉴 버튼을 눌러 나온 메뉴 중에서 [실행]을 선

택하고 입력창에 ‘command’라고 입력하면 된다.

2. 도스 명령창에서 Tmax 시스템이 설치된 디렉터리의 하위 디렉터리 중 <config>라는 디렉터리로 이동

한다.

3. <sample> 디렉터리에서 샘플로 제공되는 Tmax 환경파일을 복사해온다.

4. 문서편집용 프로그램(예: notepad.exe)을 실행한 후 복사해온 Tmax 환경파일을 불러온다. Tmax 환경

파일 내용중 *NODE 절내의 노드명을 Tmax 서버의 호스트명으로 바꾸고 TMAXDIR 및 각종 디렉터리

들의 경로를 시스템에 설치된 경로와 맞도록 수정한다. 이 때 호스트명은 라이선스 파일을 만들기 위해

사용했던 ncpu.exe를 실행시켜 나온 호스트명과 동일해야 한다. 설치과정 중에 TMAX_HOST_PORT

환경 변수 값을 디폴트 값인 8888이 아닌 다른 포트번호로 입력한 경우 *DOMAIN 절의 TPORTNO라

는 항목 값을 지정한 포트번호와 동일하도록 수정해야만 한다.

참고

Tmax 환경파일에 대하여 좀 더 자세한 내용을 보고싶다면 Tmax 안내서 중 "Tmax Administraion

Guide" 를 참고한다.

5. Tmax 환경파일을 수정했다면 저장을 한 후, 다음과 같은 방법으로 컴파일을 한다.

Tmax 시스템은 Tmax 환경파일을 텍스트 형태로는 사용될 수 없고 바이너리 형태로 변환하여 사용한

다. 컴파일 과정은 텍스트로 작성된 Tmax 환경파일을 바이너리 파일로 변환해주면서 동시에 텍스트로

작성된 Tmax 환경파일이 형식에 맞도록 올바르게 작성되었지 확인하는 과정이다. ‘cfl’이란 명령은 Tmax

시스템에서 제공하는 Tmax 환경파일 컴파일 명령이다.

C:\tmax\config> cfl –i sample.m

6. 컴파일이 성공하면 ‘tmconfig’라는 이름의 바이너리 파일이 생성된다. 파일은 Tmax 시스템이 부팅, 동

작 또는 종료 시에 참조하는 환경파일이다. ‘tmconfig’라는 파일명은 디폴트로 지정되는 이름이다. 다른

파일명으로 바이너리 파일을 만들고자 할 경우엔 다음과 같이 "-o" 옵션을 주면 된다. 다음과 같이하면

‘myproj’라는 파일명으로 바이너리 파일이 생성된다.

C:\tmax\config> cfl –i sample.m –o myproj


7. 주의해야 할 점은 Tmax 시스템을 시작 또는 종료시킬 때에 반드시 "-f" 옵션의 인자로 생성된 바이너리

파일명을 써 주어야 한다는 것이다. Tmax 시스템은 "-f" 옵션이 없을 경우 디폴트로 ‘tmconfig’ 파일을

부팅 또는 종료의 근거파일로 사용하기 때문이다.

C:\tmax\config> tmboot –f myproj C:\tmax\config> tmdown –f myproj

8. 환경파일 컴파일을 완료하면 다음과 같은 명령을 입력하여 서비스 테이블을 생성해야 한다. 서비스 테

이블은 Tmax 시스템이 클라이언트가 서비스를 요청해 왔을 때에 서버 프로그램에서 요청한 서비스의

위치를 찾을 때에 사용하는 것이다. 생성되어진 서비스 테이블은 서버 프로그램이 컴파일을 완료하기

전에 함께 링크되어 컴파일 되어진다. 서비스 테이블은 ‘서버명_svctab.c’의 이름을 갖는 C프로그램 파

일이다.

9. 서비스테이블 생성까지 완료되면 Tmax 환경파일 구성과정은 끝난다.

3.5.4. 서비스 프로그램 컴파일

환경파일 구성이 끝나면 샘플 서버 프로그램과 클라이언트 프로그램을 컴파일한다. 물론 컴파일을 하려

면 C 컴파일러가 설치되어 있어야 한다. 일반적으로 윈도우에서는 Microsoft Visual Studio를 사용하므로

Microsoft Visual Studio를 설치해 두는 것을 권장한다. Microsoft Visual Studio를 설치한 후 환경 변수에

Microsoft Visual Studio 관련 환경 변수들이 등록되어 있는지 확인한다. nmake를 사용하기 위해서는 lib,

MSDevDir, PATH 등의 환경 변수들이 등록되어 있어야 한다.

서버 프로그램을 컴파일한다. 서버 프로그램은 Tmax 시스템이 부팅될 때에 Tmax 시스템 프로세스들과

함께 부팅되어 서비스를 제공하는 프로그램이다.

컴파일은 다음과 같은 방법으로 하면된다. 모든 과정은 도스 명령 창에서 수행한다. 샘플 프로그램의 구성

은 UNIX와 같다.

TMAXDIR\sample\server 디렉터리로 이동한다. 디렉터리는 샘플 서버 프로그램과 make 파일이 들어있

는 디렉터리이다.

서버 프로그램을 컴파일하기 전에 서버 프로그램에서 구조체 버퍼 또는 필드 버퍼를 사용하는 경우 sdlc

또는 fdlc를 통하여 구조체 파일(xxx.s) 또는 필드키 파일(xxx.f)을 컴파일 해야 한다.

구조체 파일은 UNIX 환경에서와 마찬가지로 서버와 클라이언트 각각에서 수행해야 한다.

서버에서는 다음과 같다.

C:\tmax\sample\sdl> sdlc –i demo.s

서버에서 sdlc를 위와 같이 하면 demo_sdl.h 와 demo_sdl.c 파일이 생성된다. 두 파일은 구조체 버퍼 타입

을 사용하는 서버 프로그램을 컴파일할 때 참조된다. 샘플로 제공하는 서비스 프로그램들의 make 파일에

는 sdlc를 하는 루틴이 포함되어 있지만 사용자가 개발한 프로그램을 컴파일 할 때는 반드시 이 부분을 잊

지 않도록 한다.

클라이언트에서는 다음과 같다.


C:\tmax\sample\sdl> sdlc –c –i –demo.s –o tmax.sdl

클라이언트에서 sdlc를 위와 같이 하면 demo_sdl.h 와 tmax.sdl 파일이 생성된다. "–o" 옵션을 사용하지

않으면 디폴트로 <구조체 파일>.sdl 이 생성되지만 " –o "옵션을 사용하여 원하는 파일 이름으로 바꿀 수

있다. 파일은 이진파일로 구조체 타입 버퍼를 사용하는 클라이언트 프로그램에서 구조체 타입 버퍼를 메

모리에 할당할 때 사용된다. 파일의 위치는 사용자 환경파일에 설정된 SDLFILE이라는 환경 변수를 참조

한다. Tmax 인스톨러는 디폴트로 이 값을 %TMAXDIR%\sdl\tmax.sdl 로 지정하므로 이 내용을 그대로 사

용하려면 반드시 "–o " 옵션을 사용하여 tmax.sdl 로 파일을 생성시켜야 한다.

프롬프트에 다음과 같이 입력하여 make 파일을 실행한다.

C:\tmax\sample\server> nmake /f svr2.mk

컴파일이 성공하면 서버 프로그램 실행파일이 생성되고 그 실행파일은 TMAXDIR\appbin이라는 디렉터

리 밑으로 자동 복사된다.

참고

서비스 프로그램들이 위치하는 디렉터리는 Tmax 환경파일에 사용자 임의로 설정할 수 있으며 자세

한 내용은 Tmax 안내서 중 " Tmax Administraion Guide" 를 참고한다.

여기까지 하면 Tmax 시스템을 기동시킬 수 있다. 클라이언트 프로그램 컴파일하는 방법까지 설명한 후

Tmax 시스템 기동에 대해 설명하도록 하겠다.

3.5.5. 클라이언트 프로그램 컴파일

샘플 클라이언트 프로그램을 컴파일한다. 클라이언트 프로그램은 사용자의 요청을 입력받아 해당하는 서

비스를 Tmax 시스템에 요청하는 프로그램이다. 컴파일 방법은 2가지가 있는데 비주얼 스튜디오를 사용

하는 방법과 서버 프로그램 컴파일하는 방법과 동일한 nmake를 이용하는 방법이다.

TMAXDIR\sample\client 로 이동하면 샘플 클라이언트 프로그램과 make 파일이 들어있는 것을 볼 수 있

다.

프롬프트에 다음과 같이 입력하여 make파일을 실행한다.

C:\tmax\sample\client> nmake /f toupper.mk

컴파일이 성공하면 클라이언트 프로그램 실행파일이 생성된다.

클라이언트 실행파일은 현재 디렉터리에 위치한다.

도스 명령창에서 위와 같이 클라이언트 프로그램을 실행시켜도 되고 Microsoft Visual Studio 5.0/6.0이 설

치되어 있다면 다음과 같은 방법으로도 클라이언트 프로그램을 컴파일 할 수 있다.

Microsoft Visual Studio를 실행시킨 후 샘플 클라이언트 프로그램을 연다. Default project를 생성시킨 후

F7을 누르거나 메뉴에서 컴파일을 눌러서 컴파일하면 된다. Visual Studio를 이용하면 별도의 Makefile이

필요하지 않다.


서버 프로그램과 클라이언트 프로그램의 컴파일이 완료되면 Tmax 시스템을 기동한다. Tmax 시스템을

기동하는 방법은 다음과 같이 하면 된다.

C:\tmax> tmboot

Tmboot 할 때에도 여러 가지 옵션을 사용할 수 있지만 기본적으로 위와 같이 하면 Tmax 시스템과 환경파

일에 등록해 놓은 서버 프로그램들이 기동된다.

참고

사용 가능한 다른 옵션들에 관하여 더 자세한 내용을 알고 싶다면 Tmax 안내서 중 " Tmax Administraion

Guide" 를 참고한다.

Tmax 시스템을 기동하고 나면 샘플 클라이언트 프로그램을 실행시켜 정상적인 결과가 나오는지 확인한

다. 클라이언트 프로그램 실행 방법은 다음과 같다.

C:\tmax\sample\client> toupper aabbcc

샘플 프로그램의 내용은 클라이언트가 사용자로부터 소문자를 입력 받고, Tmax 시스템을 통해 소문자를

대문자로 변환시키는 서비스를 요청하여 입력 받은 소문자를 대문자로 변환한 결과를 사용자에게 보여주

는 것이다. Tmax 시스템이 정상적으로 동작한다면 위의 입력결과로 대문자로 구성된 ‘AABBCC’라는 결

과를 출력하게 된다. 클라이언트를 실행시켜 대문자로 변환된 결과가 나오는지 확인하고 결과가 정상적

으로 나온다면 Tmax 시스템이 정상적으로 설치되었다는 것을 확인하는 것이다.


Appendix A. TMS 컴파일

TMS(Transaction Management Server)는 Tmax 시스템의 구성요소로서 데이터베이스 관리 및 분산 트랜

잭션 처리를 담당하는 프로세스이다. 본 장에서는 Oracle과 Informix DBMS용 TMS 이진 파일의 생성 방

법에 관하여 알아본다.

윈도우즈 환경에서는 TMS를 만드는 과정이 필요하지 않으며 현재 Oracle만을 지원한다.

A.1. TMS for Oracle DBMSTmax에서 제공하는 tms_ora.mk 파일을 컴파일 해서 Oracle용 TMS 이진 파일을 만들 수 있다. tms_ora.mk

는 TMAXDIR/sample/server 디렉터리에 있으며, 다음과 같이 컴파일 할 수 있다. TMAXDIR은 Tmax가 설

치된 디렉터리를 나타낸다.

● Step 1. Tmax 사용자 계정으로 로그인한다.

$su – tmax

● Step 2. Oracle 환경 변수들을 가져와 셸 환경파일에 붙여넣고 적용시킨다.

다음은 Oracle 환경 변수의 예이다.

## Oracle Environment ## ORACLE_HOME=/oracle/app/oracle/product/8.0.5;

export ORACLE_HOME PATH=$PATH:$ORACLE_HOME/bin; export PATH ORACLE_SID=ora805;

export ORACLE_SID NLS_LANG=American_America.KO16KSC5601;

export NLS_LANG ORA_NLS33=$ORACLE_HOME/ocommon/nls/admin/data;

export ORA_NLS33 LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$ORACLE_HOME/lib;

export LD_LIBRARY_PATH

● Step 3. $TMAXDIR/sample/server 디렉터리로 이동한다.

cd $TMAXDIR/sample/server

● Step 4. Oracle용 TMS makefile(tms_ora.mk)을 가지고 컴파일한다.

$make –f tms_ora.mk all

컴파일 되어 생성된 TMS 이진 파일은 $TMAXDIR/appbin 디렉터리로 옮겨지게 된다. 파일은 tmboot 시

메모리에 적재되어 XA 인터페이스를 이용하여 전역 트랜잭션 처리를 하는 Tmax 시스템에서 2PC(Phase

Commit)을 지원한다. Oracle용 TMS를 기동 시키기 위해 설정하는 Tmax 설정 파일은 $TMAXDIR/con

fig/sample.m을 참고한다.

Appendix A. TMS 컴파일 43

A.2. TMS for Informix DBMSInformix용 TMS를 생성하기 위한 make 파일은 $TMAXDIR/sample/server에 있으며, 파일명은 tms_info.mk

이다. TMS 이진파일을 생성하는 과정은 다음과 같다.

● Step 1. Informix 계정으로 로그인 한다. Informix에서 사용하는 환경 변수들이 제대로 설정되어 있다고

가정한다.

$su - informix

● Step 2. esql을 다음과 같이 실행하여 결과로서 result 파일을 만든다.

$esql -libs > result

● Step 3. result 파일을 /tmp 디렉터리로 옮긴다.

$mv result /tmp

result 파일의 내용은 다음과 같다.

<result>

-lifsql

-lifasf

-lifgen

-lifos

-lifgls

-lnsl

-lsocket

-laio

-lm

-ldl

-lelf

/user3/informix/lib/esql/checkapi.o

-lifglx

● Step 4. 2PC(Phase Commit)를 지원하는 XA 인터페이스를 사용할 수 있도록 하기 위해 플래그의 마지

막에 –lifxa를 추가하고, result 파일의 내용을 복사해서 tms_info.mk 파일의 ‘INFOLIBS = ’ 에 붙여 넣는

다. 플래그들은 한 줄로 연결해서 붙여 넣어야 한다.

<tms_info.mk>

INFOLIBDIR = ${INFORMIXDIR}/lib

INFOELIBDIR = ${INFORMIXDIR}/esql

INFOLIBD = ${INFORMIXDIR}/lib/esql

INFOLIBS = -lifsql -lifasf -lifgen -lifos -lifgls -lnsl -lsocket

-laio -lm -ldl -lelf /user3/informix/lib/esql/checkapi.o

-lifglx -lifxa


TMAXLIBDIR = $(TMAXDIR)/lib

TMAXLIBS = -ltms

$(TARGET):

$(CC) -o $(TARGET) -L$(TMAXLIBDIR) $(TMAXLIBS) -L$(INFOLIBD) -L$(INFOLIBDIR)

-L$(INFOELIBDIR) $(INFOLIBS)

cp $(TARGET) $(TMAXDIR)/appbin

clean:

-rm -f core $(TARGET)

● Step 5. tms_info.mk를 저장하고, make를 수행해서 Informix용 TMS 이진 파일을 만든다. Informix에 XA

라이브러리가 설치되어 있지 않을 경우, make 수행 중 해당 라이브러리를 찾을 수 없어 컴파일 오류가

날 수 있다. 이때는 해당 라이브러리를 설치한 후에 make를 수행하도록 해야 한다.

$make -f tms_ora.mk

컴파일 되어 생성된 TMS 이진 파일은 $TMAXDIR/appbin 디렉터리로 옮겨지게 된다.

Oracle용 TMS를 기동 시키기 위해 설정하는 Tmax 설정 파일은 $TMAXDIR/config/sample.m을 참고한

다.

Appendix A. TMS 컴파일 45

Appendix B. Platform Specifications for

Tmax Products

응용프로그램 및 시스템 또는 유저 로깅 정보에 따라 더 많은 디스크 공간이 필요할 수 있다. 컴파일러는

Tmax 응용프로그램 개발 시에만 필요하다.

B.1. Compaq Tru64 v4.0 on Alpha● 하드웨어 요구사항

– 플랫폼 : Compaq Alpha

– 메모리 : 128MBytes 이상(256 Mbytes 이상 권장)

– 디스크 : 30MBytes 이상의 여유공간(100Mbytes 이상 권장)

● 소프트웨어 요구사항

– 운영체제 : Tru64 4.0

– 컴파일러 : Compaq ANSI C compiler

● 네트워크

– TCP/IP 네트워크

● 설치된 제품의 디스크 사용공간

– Tmax 서버/클라이언트 : 6391 Kbyte

– Tmax 클라이언트 : 951 Kbyte

● CD-ROM 마운트 방법

– 수퍼유저 권한으로 CD-ROM을 마운트할 디렉터리가 없으면 새로운 디렉터리 생성

$mkdir /cdrom $/sbin/mount -r -t cdfs /dev/devicename /cdrom

Appendix B. Platform Specifications for Tmax Prod

ucts 47

B.2. Compaq Tru64 v5.0(5.1) on Alpha● 하드웨어 요구사항

– 플랫폼 : Compaq Alpha




– 운영체제 : Tru64 5.0

– 컴파일러 : Compaq ANSI C compiler

● 네트워크






$mkdir /cdrom $/usr/sbin/mount -r -t cdfs /dev/cdrom_devicename /cdrom

B.3. HP UX v10.20 on HP9000 Series● 하드웨어 요구사항

– 플랫폼 : HP PA-RISC





– 운영체제 : HP-UX 10.20

– 컴파일러 : HP-UX ANSI C Compiler

● 네트워크






$su - $mkdir /cdrom $mount -F cdfs -o cdcase /dev/dsk/cdrom_devicename /cdrom

B.4. HP-UX v11.00 on HP9000 Series● 하드웨어 요구사항





– 운영체제 : HP-UX 11.0(64bit 아키텍쳐 지원)


● 네트워크




ucts 49

– Tmax 서버/클라이언트(32bit) : 5078 Kbyte

– Tmax 클라이언트(32bit) : 700 Kbyte





B.5. HP-UX v11.11 on HP9000 Series● 하드웨어 요구사항





– 운영체제 : HP-UX 11.11(64bit 아키텍쳐 지원)


● 네트워크










B.6. HP-UX v11i on Itanium● 하드웨어 요구사항

– 플랫폼 : HP Intel Itanium-based 서버s




– 운영체제 : HP-UX 11i (64bit 아키텍쳐 지원)

– 컴파일러 : HP ANSI C compiler

● 네트워크










ucts 51

B.7. IBM AIX v4.3.x on RS/6000● 하드웨어 요구사항

– 플랫폼 : IBM PowerPC




– 운영체제 : AIX v4.3.x(64bit 아키텍쳐 지원)

– 컴파일러 : AIX XL C Compiler

● 네트워크








– smit 또는 smitty 유틸리티를 이용해서 CD-ROM 장치를 마운트 시킨다.

$smitty mount

B.8. IBM AIX v5.1.x on RS/6000● 하드웨어 요구사항

– 플랫폼 : IBM PowerPC





– 운영체제 : AIX v5.1.x(64bit 아키텍쳐 지원)

– 컴파일러 : AIX XL C Compiler

● 네트워크








– smit 또는 smitty 유틸리티를 이용해서 CD-ROM 장치를 마운트 시킨다.

$smitty mount

B.9. SUN Solaris v2.5.1(SunOS 5.5.1) on SPARC● 하드웨어 요구사항

– 플랫폼 : SUN UltraSPARC





ucts 53

– 운영체제 : SunOS 5.5.1

– 컴파일러 : SparCompiler C 4.0 또는 그 이상

● 네트워크






– 별도의 마운트 수행 명령 없이 CD-ROM 삽입 시 자동으로 마운트 가능

B.10. SUN Solaris v2.6(SunOS 5.6) on UltraSPARC● 하드웨어 요구사항





– 운영체제 : SunOS 5.6


● 네트워크







– 별도의 마운트 수행 명령 없이 CD-ROM 삽입 시 자동으로 /cdrom에 마운트






– 운영체제 : SunOS 5.7(64bit 아키텍쳐 지원)


● 네트워크










ucts 55






– 운영체제 : SunOS 5.8(64bit 아키텍쳐 지원)


● 네트워크









B.13. SUN Solaris 8 on x86● 하드웨어 요구사항

– 플랫폼 : Intel x86-based servers





– 운영체제 : Solaris 8

– 컴파일러 : SUN ANSI C compiler

● 네트워크









B.14. SCO Unixware 7 on x86● 하드웨어 요구사항





– 운영체제 : Unixware 7.1

– 컴파일러 : Unixware ANSI C compiler


ucts 57

● 네트워크





– Tmax 서버/ 클라이언트(64bit) : 6855 Kbyte



$mount -r -F cdfs /dev/cdrom/cdrom1 /mnt

B.15. SCO Unixware 2 on x86● 하드웨어 요구사항





– 운영체제 : Unixware 2.1

– 컴파일러 : Unixware ANSI C compiler

● 네트워크



– Tmax 서버/ 클라이언트 : 6825 Kbyte






$mount -r -F cdfs /dev/cdrom/cdrom1 /mnt

B.16. NCR MP-RAS v03.02 on x86● 하드웨어 요구사항

– 플랫폼 : NCR Intel x86-based SMP servers




– 운영체제 : NCR UNIX SVR4 MP-RAS 03.02

– 컴파일러 : NCR High Performance C Compiler

● 네트워크








ucts 59

B.17. RedHat Linux 7.x on Intel● 하드웨어 요구사항

– 플랫폼 : Based on Intel CPU




– 운영체제 : RedHat Linux 계열 또는 기타 배포판(Kernel 2.0 이상)

– 컴파일러 : (Tmax 응용프로그램 개발 시에만 필요)

● 네트워크



– Tmax 서버/클라이언트(32bit) : 3860 kbyte



– /mnt/cdrom 디렉터리가 없으면, 수퍼유저 권한으로 디렉터리를 생성 $mkdir /mnt/cdrom $mount

/mnt/cdrom 또는 mount –rt iso9660 /dev/devicename /mnt/cdrom

● 알아두어야 할 사항

– 레드햇 계열에서는 Tmax 제품이 테스트 되었음. RedHat 계열 이외의 배포판에 대해서는 일반적으로

잘 동작 할 것이라 기대되지만, 보장하지는 않음

B.18. Windows NT 4.0 on Intel● 하드웨어 요구사항






– 컴파일러 : Windows NT 4.0 서버(서비스팩 3.0 이상 필요)

– 운영체제 : Microsoft Visual C++ 5.0 또는 그 이상

● 네트워크



– Tmax 서버 또는 Tmax 클라이언트 설치 시 재시작 필요

B.19. Windows NT 5.0(Windows 2000) on Intel● 하드웨어 요구사항





– 운영체제 : Windows 2000 서버

– 컴파일러 : Microsoft Visual C++ 5.0 또는 그 이상(응용프로그램 개발 시에만 필요)

● 네트워크



– Tmax 서버 설치 시 재시작이 필요하다는 메시지가 나오나 실제로 재시작 필요하지 않음


ucts 61

Windows NT 4.0 서버에서만 설치 후 재시작 필요

B.20. Windows 98 on Intel● 하드웨어 요구사항


– 메모리 : 32MBytes 이상

– 디스크 : 10MBytes 이상의 여유공간


– 운영체제 : Windows 98 (or Windows Me)

– 컴파일러 : Microsoft Visual C++ 5.0 또는 그 이상(응용프로그램 개발 시에만 필요)

● 네트워크



– Tmax 서버에 서비스 요청하기 전에 Tmax 환경 변수(예:autoexec.bat) 적용 또는 환경파일(예:tmax.env)

의 설정 필요

– Tmax 환경 변수 예

• TMAX_HOST_ADDR(Tmax 서버의 IP 주소)

• TMAX_HOST_PORT(Tmax 서버의 포트번호)

• FDLFILE(Fieldkey buffer type 사용 시에만 필요)

• SDLFILE(Structure buffer type 사용 시에만 필요)
