openframe msi 운영자 안내서 - tmaxsoft · 2019. 4. 9. · msi 운영자 안내서는 총...

50
OpenFrame MSI 운영자 안내서 소프트웨어 OpenFrame/MSI v3.3.0 안내서 버전 v1.2 Copyright © 2008 TmaxSoft Co., Ltd. All Rights Reserved.

Upload: others

Post on 24-Jan-2021

2 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: OpenFrame MSI 운영자 안내서 - TmaxSoft · 2019. 4. 9. · msi 운영자 안내서는 총 5개의 장으로 구성되어 있다. 각 장의 주요 내용은 다음과 같다

OpenFrame MSI 운영자 안내서

소프트웨어

OpenFrame/MSI v3.3.0

안내서 버전 v1.2

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

Page 2: OpenFrame MSI 운영자 안내서 - TmaxSoft · 2019. 4. 9. · msi 운영자 안내서는 총 5개의 장으로 구성되어 있다. 각 장의 주요 내용은 다음과 같다

Copyright Notice

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

TmaxSoft Co., Ltd.

서울특별시 강남구 대치동 946-1 글라스타워 18층 우)135-708

Restricted Rights Legend

This 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 reproduced, transmitted, or translated in any form or by any means, electronic, mechanical, manual, or optical, without the prior written consent of TmaxSoft Co., Ltd.

이 소프트웨어 및 안내서는 오직 TmaxSoft Co., Ltd.와의 사용권 계약 하에서만 이용이 가능하며, 사용권 계약에 따라서 사용하거나 복사할 수 있습니다. 또한 이 안내서에서 언급하지 않은 정보에 대해서는 보증 및 책임을 지지 않습니다. 이 안내서에 대한 권리는 저작권에 보호되므로 발행자의 허가 없이 전체 또는 일부를 어떤 형식이나, 사진 녹화, 기록, 정보 저장 및 검색 시스템과 같은 그래픽이나 전자적, 기계적 수단으로 복제하거나 사용할 수 없습니다.

Trademarks

Tmax, WebtoB, WebT, JEUS and OpenFrame are registered trademarks of TmaxSoft Co., Ltd. Other products, titles or services may be registered trademarks of their respective companies.

Tmax, WebtoB, WebT, JEUS, OpenFrame은 TmaxSoft Co., Ltd.의 등록 상표입니다. 기타 모든 제품들과 회사 이름은 각각 해당 소유주의 상표로서 참조용으로만 사용됩니다.

안내서 정보

안내서 제목: OpenFrame MSI 운영자 안내서

발행일: 2008년07월15일

소프트웨어 버전: OpenFrame/MSI v3.3.0

안내서 버전: v1.2

OpenFrame MSI 운영자 안내서 2

Page 3: OpenFrame MSI 운영자 안내서 - TmaxSoft · 2019. 4. 9. · msi 운영자 안내서는 총 5개의 장으로 구성되어 있다. 각 장의 주요 내용은 다음과 같다

연락처

Korea TmaxSoft Co., Ltd. 18F Glass Tower, 946-1, Daechi-Dong, Kangnam-Gu, Seoul 135-708 South Korea Tel: 82-2-6288-2114 Fax: 82-2-6288-2115 Email: [email protected]: http://www.tmax.co.kr

USA TmaxSoft, Inc. US Headquarter (San Jose) 130 Rio Robles San Jose, CA 95134, USA Tel: 1-408-321-2400 Fax: 1-408-321-2444 Email: [email protected]: http://www.tmaxsoft.com Sales Office (New Jersey) 560 Sylvan Ave, Englewood Cliffs NJ 07632, USA Tel: 1-201-567-8266 Fax: 1-201-567-7339 Email: [email protected]: 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 Email: [email protected]: http://www.tmaxsoft.co.jp

OpenFrame MSI 운영자 안내서 3

Page 4: OpenFrame MSI 운영자 안내서 - TmaxSoft · 2019. 4. 9. · msi 운영자 안내서는 총 5개의 장으로 구성되어 있다. 각 장의 주요 내용은 다음과 같다

China TmaxSoft China Co., Ltd. Beijing Silver Tower, RM 1508, 2# North Rd Dong San Huan, Chao yang District, Beijing, China, 100027 Tel: 86-10-6410-6145~8 Fax: 86-10-6410-6144 Email: [email protected]: http://www.tmaxchina.com.cn Shanghai Office Room 4123, 41 Floor, China Development Bank Building, No.500 Pudong Road(s), Shanghai, China, 200120 Tel: 86-21-6019-5751 Fax: 86-21-61095750 Email: [email protected]: http://www.tmaxsoft.com.cn

OpenFrame MSI 운영자 안내서 4

Page 5: OpenFrame MSI 운영자 안내서 - TmaxSoft · 2019. 4. 9. · msi 운영자 안내서는 총 5개의 장으로 구성되어 있다. 각 장의 주요 내용은 다음과 같다

내용 목차

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

안내서의 대상 ........................................................................................................... 9

안내서의 전제 조건 ................................................................................................... 9

안내서의 제한 조건 ................................................................................................. 10

안내서 구성............................................................................................................. 11

안내서 규약............................................................................................................. 12

시스템 사용 환경 .................................................................................................... 13

관련 안내서............................................................................................................. 14

제1장 MSI 개요................................................................................................. 15

1.1 개요 .................................................................................................................. 15

1.2 구조 .................................................................................................................. 16

1.3 OSI 화면 구성 ................................................................................................... 17

제2장 게이트웨이.............................................................................................. 19

2.1 개요 .................................................................................................................. 19

2.2 인터페이스........................................................................................................ 19

2.3 데이터 흐름....................................................................................................... 19

게이트웨이와 에뮬레이터 .............................................................................................. 20

게이트웨이 내부 흐름 .................................................................................................... 20

게이트웨이와 서버......................................................................................................... 22

2.4 데이터 변환....................................................................................................... 22

2.5 게이트웨이의 에뮬레이터 관리 ......................................................................... 23

제3장 포맷 ........................................................................................................ 25

3.1 개요 .................................................................................................................. 25

3.2 포맷 작성 규칙 .................................................................................................. 25

3.3 포맷 구조 .......................................................................................................... 30

3.4 포맷 동작 구조 .................................................................................................. 31

3.5 포맷 컴파일....................................................................................................... 31

제4장 시스템 설정............................................................................................. 35

OpenFrame MSI 운영자 안내서 5

Page 6: OpenFrame MSI 운영자 안내서 - TmaxSoft · 2019. 4. 9. · msi 운영자 안내서는 총 5개의 장으로 구성되어 있다. 각 장의 주요 내용은 다음과 같다

4.1 개요 .................................................................................................................. 35

4.2 MSI 설정 파일................................................................................................... 35

4.3 Tmax 환경 설정................................................................................................ 36

4.4 기동 스크립트 파일 설정 ................................................................................... 37

4.5 CPM 설정 ......................................................................................................... 39

4.6 OSD 설정 ......................................................................................................... 40

제5장 MSI 운영................................................................................................. 43

5.1 개요 .................................................................................................................. 43

5.2 서버 기동 및 종료 ............................................................................................. 43

5.3 서버 관리 .......................................................................................................... 44

5.4 에뮬레이터의 접속 및 종료 ............................................................................... 46

Appendix. A 포맷 컴파일 툴............................................................................. 49

A.1 msimapc ......................................................................................................... 49

OpenFrame MSI 운영자 안내서 6

Page 7: OpenFrame MSI 운영자 안내서 - TmaxSoft · 2019. 4. 9. · msi 운영자 안내서는 총 5개의 장으로 구성되어 있다. 각 장의 주요 내용은 다음과 같다

그림 목차

[그림 1-1] OSI 시스템 아키텍처................................................................................................... 15

[그림 1-2] OSI 어플리케이션과 에뮬레이터와의 통신을 나타내는 MSI 시스템 .......................... 16

[그림 1-3] TN3270 에뮬레이터 예제 화면.................................................................................... 18

[그림 2-1] 게이트웨이와 에뮬레이터 사이의 데이터 흐름 ........................................................... 20

[그림 2-2] 게이트웨이 내부의 데이터 흐름 .................................................................................. 21

[그림 2-3] 서버 데이터를 physical map 필드에 매핑 ................................................................... 21

[그림 2-4] 게이트웨이와 어플리케이션 서버 사이의 데이터 흐름 ............................................... 22

[그림 3-1] MSI 포맷 구조 ............................................................................................................. 30

[그림 5-1] 에뮬레이터 접속 설정 1............................................................................................... 46

[그림 5-2] 에뮬레이터 접속 설정 2............................................................................................... 47

[그림 5-3] 에뮬레이터 접속 설정 3............................................................................................... 47

[그림 5-4] 예제 화면..................................................................................................................... 48

OpenFrame MSI 운영자 안내서 7

Page 8: OpenFrame MSI 운영자 안내서 - TmaxSoft · 2019. 4. 9. · msi 운영자 안내서는 총 5개의 장으로 구성되어 있다. 각 장의 주요 내용은 다음과 같다

표 목차

[표 0-1] 안내서 규약..................................................................................................................... 12

[표 0-2] 시스템 사용 환경 ............................................................................................................ 13

[표 0-3] OpenFrame 관련 안내서 ................................................................................................ 14

[표 0-4] Tmax 관련 안내서........................................................................................................... 14

[표 0-5] MainFrame 관련 안내서 ................................................................................................. 14

[표 4-1] MSIGW의 [OSI_ATI]....................................................................................................... 38

OpenFrame MSI 운영자 안내서 8

Page 9: OpenFrame MSI 운영자 안내서 - TmaxSoft · 2019. 4. 9. · msi 운영자 안내서는 총 5개의 장으로 구성되어 있다. 각 장의 주요 내용은 다음과 같다

안내서에 대하여

안내서에 대하여

안내서의 대상

OpenFrame의 MSI는 IBM Mainframe의 MFS(Message Format Service)에 대응하는

제품이다. MSI는 IMS/DC의 MFS에 대응하는 제품이며, OSI 시스템으로 접근하는

TN3270 에뮬레이터에 대한 게이트웨이 역할을 담당한다.

본 안내서는 IBM Mainframe의 MFS 시스템에 대한 이해를 바탕으로 MSI를 운영 및

관리하려는 사용자를 대상으로 한다.

안내서의 전제 조건

본 안내서에서 다루는 MSI 시스템은 IBM Mainframe IMS/DC 하위 시스템인

MFS(Message Format Service)에 대응하는 서비스를 제공한다.

MSI 시스템은 OpenFrame/Online OSI 시스템에 대한 매핑 기능을 지원하며, OSI 시

스템과 마찬가지로 TmaxSoft 사의 TP-Monitor인 Tmax 엔진을 기반으로 실행되도록

설계되었다.

따라서 본 안내서를 제대로 이해하려는 사용자는 적어도 다음과 같은 사항을 미리 알

고 있어야 한다.

UNIX 시스템

TmaxSoft의 TP-Monitor인 Tmax

IBM Mainframe IMS/DC 시스템

IBM Mainframe MFS 시스템

OpenFrame/Online OSI 시스템

OpenFrame MSI 운영자 안내서 9

Page 10: OpenFrame MSI 운영자 안내서 - TmaxSoft · 2019. 4. 9. · msi 운영자 안내서는 총 5개의 장으로 구성되어 있다. 각 장의 주요 내용은 다음과 같다

안내서에 대하여

안내서의 제한 조건

MSI는 OpenFrame/Online 시스템 중에서 IBM Mainframe IMS/DC에서 지원하는

MFS(Message Format Service)에 대응하는 모듈이다. 또한 MSI 시스템은 CPM을 사

용하여 EBCDIC 코드를 사용하는 TN3270 에뮬레이터와 ASCII 코드를 사용하는

OpenFrame 사이에서 게이트웨이 역할을 담당한다.

본 안내서는 이와 같이 매핑과 게이트웨이 역할을 담당하는 MSI의 시스템 운영에 필

요한 정보 중 OpenFrame 시스템을 통해 설계된 정보만을 제공한다.

리호스팅 호스트인 IBM Mainframe MFS에 대한 정보 또는 EBCDIC 코드 기반의 데이

터를 ASCII 코드 기반의 데이터로 변환하는 방법에 대해서는 본 안내서에 기술되지

않는다.

OpenFrame MSI 운영자 안내서 10

Page 11: OpenFrame MSI 운영자 안내서 - TmaxSoft · 2019. 4. 9. · msi 운영자 안내서는 총 5개의 장으로 구성되어 있다. 각 장의 주요 내용은 다음과 같다

안내서에 대하여

안내서 구성

MSI 운영자 안내서는 총 5개의 장으로 구성되어 있다.

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

제1장: MSI 개요

MSI 시스템 전반에 대한 개념 설명과 MSI의 동작 구조 및 OSI 화면 구성에 대해

기술한다.

제2장: 게이트웨이

클라이언트와 서버 사이에서 이루어지는 데이터 흐름 및 MSI 시스템에서의 데이

터 변환 구조 등에 대해 기술한다.

제3장: 포맷

OSI 시스템 화면 구성을 위한 MSI 시스템 포맷 작성 규칙에 대해 기술한다.

제4장: 시스템 설정

MSI 시스템의 엔진 역할을 수행하는 Tmax, 프로파일, 서버 기동 및 종료 스크립

트 파일, CPM 및 OSD 등 시스템 작동을 위해 필요한 환경 설정 방법에 대해 기

술한다.

제5장: MSI 운영

MSI 시스템을 운영하기 위해 OSI 어플리케이션 서버 기동 및 종료 과정, 서버 관

리 방법 및 에뮬레이터 접속방법 등 실제적인 MSI 운영 및 관리 방법에 대해 기술

한다.

OpenFrame MSI 운영자 안내서 11

Page 12: OpenFrame MSI 운영자 안내서 - TmaxSoft · 2019. 4. 9. · msi 운영자 안내서는 총 5개의 장으로 구성되어 있다. 각 장의 주요 내용은 다음과 같다

안내서에 대하여

안내서 규약

표기 의미

AaBbCc123 명령어

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

참고: 참고 또는 주의사항

{ } 필수 인수값

[ ] 옵션 인수값

| 선택 인수값

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

하이퍼링크 메일계정, 웹 사이트, 다른 장 및 절 참고

이탤릭체 사용자 입력 값

underline 시스템에서 설정된 기본 값

진하게 강조

<AaBbCc123> 프로그램 소스 코드의 파일명, 디렉터리 이름

Courier New 파일, 디렉터리 이름, 환경설정 변수

[그림 1-1] 그림 이름

[표 1-1] 표 이름

[표 0-1] 안내서 규약

OpenFrame MSI 운영자 안내서 12

Page 13: OpenFrame MSI 운영자 안내서 - TmaxSoft · 2019. 4. 9. · msi 운영자 안내서는 총 5개의 장으로 구성되어 있다. 각 장의 주요 내용은 다음과 같다

안내서에 대하여

시스템 사용 환경

요구사항

Platform IBM AIX 5.x

HP-UX 11.xx

Solaris 9 (SunOS 5.9)

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

256MB 이상 메모리 공간

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

Database Tibero 3.0

Oracle 9i 또는 10g

Compiler MF-Cobol 컴파일러

[표 0-2] 시스템 사용 환경

OpenFrame MSI 운영자 안내서 13

Page 14: OpenFrame MSI 운영자 안내서 - TmaxSoft · 2019. 4. 9. · msi 운영자 안내서는 총 5개의 장으로 구성되어 있다. 각 장의 주요 내용은 다음과 같다

안내서에 대하여

관련 안내서

제품 안내서

OpenFrame OSI 운영자 안내서

마이그레이션 안내서

유틸리티 참조 안내서

툴 참조 안내서

[표 0-3] OpenFrame 관련 안내서

제품 안내서

Tmax Administration Guide

[표 0-4] Tmax 관련 안내서

제품 안내서

MainFrame IMS Application Programming: Transaction Manager

[표 0-5] MainFrame 관련 안내서

OpenFrame MSI 운영자 안내서 14

Page 15: OpenFrame MSI 운영자 안내서 - TmaxSoft · 2019. 4. 9. · msi 운영자 안내서는 총 5개의 장으로 구성되어 있다. 각 장의 주요 내용은 다음과 같다

제1장 MSI 개요

제1장

1.1

MSI 개요

개요

IBM Mainframe 상에서 운영 중인 온라인 시스템을 제공하기 위해 OpenFrame에서는

OSC, OSI 등의 온라인 서버 타입을 지원한다. 온라인 시스템을 제공하기 위한 서버

타입을 통칭하여 OpenFrame/Online이라고 한다. OpenFrame/Online은 서버 타입

(OSC 또는 OSI)에 따라 각기 다른 독특한 내부 구조를 갖고 있지만, 매핑 지원 기능이

나, 엔진 역할을 담당하는 Online Core는 OpenFrame/Online 서버 타입에 공통적으로

존재하는 구조이다([그림 1-1] 참고).

본 안내서에서 다루는 MSI(Mapping Support type I)는 OpenFrame/Online 서비스 중

OSI(Online Server type I)에 대한 매핑 기능을 지원하는 시스템이다. 여기서 매핑 기

능이란 포맷(format)을 사용하여 포맷 안에 정의되어 있는 필드들과 어플리케이션 데

이터들 간의 관계를 맺어주는 것을 의미한다.

다음은 OSI 시스템 내부 구조 및 MSI를 보여주는 OSI 시스템 아키텍처이다.

[그림 1-1] OSI 시스템 아키텍처

OpenFrame MSI 운영자 안내서 15

Page 16: OpenFrame MSI 운영자 안내서 - TmaxSoft · 2019. 4. 9. · msi 운영자 안내서는 총 5개의 장으로 구성되어 있다. 각 장의 주요 내용은 다음과 같다

제1장 MSI 개요

1.2 구조

MSI 시스템은 [그림 1-2]와 같이 포맷 파일을 컴파일하는 툴(msimapc), 컴파일된 결

과물이 저장되는 저장소(시스템이 사용하는 physical map, 어플리케이션이 사

용하는 symbolic map), 저장소를 참조하여 TN3270 에뮬레이터와 OSI 어플리케이

션 서버 간의 데이터를 변환하는 게이트웨이(MSI Gateway)로 구성된다. Physical

map 은 OSI 시스템 내부에서 사용하기 위한 맵 바이너리 파일이고, Symbolic map 은

사용자들이 다양한 언어(C, COBOL, PL/1 등)로 어플리케이션을 프로그래밍할 때 맵

필드의 정보를 알기 위해 사용하는 맵 정보 파일이다.

MSI 게이트웨이([그림 1-2] 참고)는 포맷 컴파일 툴을 통해 컴파일된 바이너리 파일을

가지고 EBCDIC 데이터로 통신하는 TN3270 에뮬레이터와 ASCII 데이터로 통신하는

OSI 어플리케이션 서버 간의 데이터를 변환하여 서로 다른 코드로 프로그래밍된 데이

터가 문제 없이 전달될 수 있게 한다.

[그림 1-2] OSI 어플리케이션과 에뮬레이터와의 통신을 나타내는 MSI 시스템

[그림 1-2]의 데이터 흐름을 세부적으로 기술하면 다음과 같다.

1. 구문에 맞게 포맷을 작성하거나 또는 IBM Mainframe 시스템을 통해 작성된 포맷

의 코드를 전환(OpenFrame 시스템에서 사용할 수 있도록 EBCDIC으로 된 포맷

을 ASCII로 전환해야 함)한다.

OpenFrame MSI 운영자 안내서 16

Page 17: OpenFrame MSI 운영자 안내서 - TmaxSoft · 2019. 4. 9. · msi 운영자 안내서는 총 5개의 장으로 구성되어 있다. 각 장의 주요 내용은 다음과 같다

제1장 MSI 개요

2. 1번 절차에서 작성된 포맷을 msimapc 툴을 사용하여 컴파일한다.

Physical map 과 symbolic map 이 각각 생성되는데, physical map 은

DOF, DIF, MOD, MID 총 네 개의 파일이 생성된다.

- Physical map: IBM Mainframe의 physical map과 동일한 개념의 바이너

리 파일로서 포맷에서 정의된 화면 정보를 저장하고 있는 맵 정보 파일

- Symbolic map: IBM Mainframe의 symbolic map과 동일한 개념의 텍스트

파일로서 어플리케이션 프로그램에서 사용하는 맵 정보 파일

3. 포맷 컴파일을 통해 생성된 symbolic map 을 사용하여 어플리케이션 프로그

램을 작성한 후 OSI 시스템에 트랜잭션으로 등록한다.

4. TN3270 에뮬레이터로 3번 절차에서 작성한 포맷에서 /FORMAT 또는 /FOR 명령

어를 사용하여 MOD 명칭을 입력하여 실행하고자 하는 트랜잭션의 화면을 에뮬

레이터에 나타나게 하거나, 이미 에뮬레이터 화면에 트랜잭션이 화면이 있다면

알맞은 값을 입력한다.

5. MSI 게이트웨이에서 입력받은 요청을 OSI 어플리케이션 서버로 전송한다.

6. OSI 어플리케이션 서버는 MSI 게이트웨이에서 전달받은 트랜잭션(입력받은 화

면에 대한 MOD에 트랜잭션 정보를 담고 있다.)을 실행하여, MSI 게이트웨이로

트랜잭션에 관련된 포맷 MOD 명칭과 사용자 데이터를 반환한다.

7. MSI 게이트웨이는 OSI 어플리케이션 서버로부터 전달받은 MOD 명칭을 통해

physical map을 읽어들여 화면에 출력될 포맷 정보를 알아낸 후 사용자 데이터와

포맷 정보를 조합하여 TN3270 에뮬레이터로 전송한다.

1.3 OSI 화면 구성

OSI 시스템은 IBM Persional Communication을 기본 에뮬레이터로 사용한다.

TN3270 에뮬레이터는 가로 80, 세로 24(80*24)의 1,920개의 필드를 화면에 나타낼

수 있다. 사용자는 포맷 코드를 통해 원하는 필드에 원하는 값 또는 옵션 등을 지정하

는 등 다양한 속성을 표현할 수 있다

다음은 TN3270 에뮬레이터 화면(예제로 구성한 프로그램은 OpenFrame 환경이 올바

르게 구축되어 사용자 프로그램 기동에 문제가 없는지 검증하기 위해 개발된 프로그

램의 시작 화면)을 보여준다.

OpenFrame MSI 운영자 안내서 17

Page 18: OpenFrame MSI 운영자 안내서 - TmaxSoft · 2019. 4. 9. · msi 운영자 안내서는 총 5개의 장으로 구성되어 있다. 각 장의 주요 내용은 다음과 같다

제1장 MSI 개요

[그림 1-3] TN3270 에뮬레이터 예제 화면

OpenFrame MSI 운영자 안내서 18

Page 19: OpenFrame MSI 운영자 안내서 - TmaxSoft · 2019. 4. 9. · msi 운영자 안내서는 총 5개의 장으로 구성되어 있다. 각 장의 주요 내용은 다음과 같다

제2장 게이트웨이

제2장

2.1

2.2

게이트웨이

개요

OSI 어플리케이션 서버는 TN3270 에뮬레이터와 데이터 통신할 때 어플리케이션 서

버의 로직에 맞게 프로그래밍된 데이터를 사용한다. TN3270 에뮬레이터는 화면에 데

이터를 표시하기 위해서는 에뮬레이터에서 맞게 프로그래밍된 데이터를 사용한다.

MSI는 어플리케이션 서버의 로직에 맞게 프로그래밍된 데이터를 TN3270 에뮬레이

터가 이해할 수 있는 데이타로 변환을 한다. 즉, MSI는 OSI의 어플리케이션 서버 로직

과는 별개로 TN3270 에뮬레이터 화면에 프로그래밍된 데이터를 어떻게 나타낼 것인

지를 처리한다. MSI는 이와 같이 서로 다른 방식으로 동작하는 두 매체 사이에서 중개

자 역할을 수행한다.

인터페이스

MSI 게이트웨이는 TN3270 에뮬레이터와 OSI 어플리케이션 서버 간의 중개자 역할

을 담당한다.

TN3270 에뮬레이터는 TCP/IP 프로토콜을 사용하여 OSI에 접속을 시도한다. 이 때

에뮬레이터에서는 OSI 어플리케이션 서버에 접속하기 위해 협상 절차(negotiation

step)라고 하는 특징적인 절차를 시도한다.

참고: 자세한 내용은 ”3270 Data Stream Programmer's Reference”와 ”RFC1647 문서”를 참고

한다.

2.3 데이터 흐름

OSI 시스템 내에서 MSI 게이트웨이를 인터페이스로하여 OSI 어플리케이션 서버와

TN3270 에뮬레이터와 간에 데이터가 전송되는데, 데이터 흐름은 다음과 같은 단계로

정리할 수 있다.

MSI 게이트웨이와 TN3270 에뮬레이터

MSI 게이트웨이 내부

MSI 게이트웨이와 OSI 서버

OpenFrame MSI 운영자 안내서 19

Page 20: OpenFrame MSI 운영자 안내서 - TmaxSoft · 2019. 4. 9. · msi 운영자 안내서는 총 5개의 장으로 구성되어 있다. 각 장의 주요 내용은 다음과 같다

제2장 게이트웨이

게이트웨이와 에뮬레이터

TN3270 에뮬레이터는 MSI 게이트웨이에 접속하기 위해 접속 절차를 거치게 된다. 정

상적인 접속 절차 후 TN3270 에뮬레이터는 MSI 게이트웨이에 접속하게 되고, 그 후

3270 데이터 스트림을 형성하여 TN3270 에뮬레이터와 MSI 게이트웨이는 데이터를

주고 받게 된다.

[그림 2-1] 게이트웨이와 에뮬레이터 사이의 데이터 흐름

TN3270 에뮬레이터와 MSI 게이트웨이 간의 데이터 흐름은 다음과 같다.

MSI 게이트웨이에 접속에 성공하면 에뮬레이터는 접속 상태로 무한 대기된다.

사용자가 에뮬레이터에 값을 입력하면 지정된 데이터 스트림을 형성하여 게이트

웨이에 보낸다. 또는 OSI 어플리케이션 서버로부터 게이트웨이에 응답 또는 요청

이 오면 게이트웨이는 에뮬레이터로 데이터를 전달한다.

게이트웨이 내부 흐름

게이트웨이 내부에서는 에뮬레이터로부터 받은 데이터를 일정한 규칙에 의해 필드별

로 나눈 다음 포맷 파일과 매칭시켜 OSI 어플리케이션 서버로 보낼 데이터를 만든다.

이 때 게이트웨이에서는 MSI 포맷 컴파일러로 데이터를 컴파일하여 생성된 바이너리

(physical map)를 참조하여 포맷 파일을 처리한다. 포맷에 정의되어 있는 각 필드와

속성에 맞게 데이터를 매핑하여 데이터 스트림을 작성한다.

OpenFrame MSI 운영자 안내서 20

Page 21: OpenFrame MSI 운영자 안내서 - TmaxSoft · 2019. 4. 9. · msi 운영자 안내서는 총 5개의 장으로 구성되어 있다. 각 장의 주요 내용은 다음과 같다

제2장 게이트웨이

[그림 2-2] 게이트웨이 내부의 데이터 흐름

[그림 2-2]에서 physical map 파일에는 화면에 나타나는 필드 정보가 저장된다. 그

리고 OSI 어플리케이션 서버에서 MSI 게이트웨이로 전송된 데이터는 physical

map 파일에 저장된 정보를 참조하여 포맷 필드 길이를 가지고 적절하게 분리하여

TN3270 에뮬레이터로 보낼 데이터를 만들게 된다([그림 2-3] 참고).

[그림 2-3] 서버 데이터를 physical map 필드에 매핑

또한 OSI 어플리케이션 서버의 데이터를 에뮬레이터로 보내는 과정의 역방향인

TN3270 에뮬레이터의 정보를 OSI 어플리케이션 서버로 전송할 때도 MSI 게이트웨

이를 거치게 된다. 이 때 TN3270 에뮬레이터로부터 MSI 게이트웨이로 전송된 데이터

를 포맷 정보를 참조하여 OSI 어플리케이션 서버로 보낼 데이터를 만들 수 있다.

OpenFrame MSI 운영자 안내서 21

Page 22: OpenFrame MSI 운영자 안내서 - TmaxSoft · 2019. 4. 9. · msi 운영자 안내서는 총 5개의 장으로 구성되어 있다. 각 장의 주요 내용은 다음과 같다

제2장 게이트웨이

게이트웨이와 서버

MSI 게이트웨이와 OSI 어플리케이션 서버 간에는 약속된 데이터 구조체(Structure)가

존재한다. [그림 2-4]에서 데이터 구조체에는 실제 TN3270 에뮬레이터 화면에 나타나

는 데이터와 OpenFrame에서 내부적으로 사용하는 시스템 데이터의 구조가 저장된

다.

[그림 2-4] 게이트웨이와 어플리케이션 서버 사이의 데이터 흐름

2.4 데이터 변환

IBM Mainframe의 리호스팅 솔루션인 OpenFrame은 기본적으로 IBM Mainframe과

전혀 다른 코드 체계를 기반으로 하는 시스템이다.

IBM Mainframe 시스템의 코드 기반은 EBCDIC이다. 기존에 IBM에서 개발되어 사용

되어온 에뮬레이터 기종인 TN3270 에뮬레이터의 기반 역시 EBCDIC 코드이다.

하지만 IBM Mainframe을 오픈 환경으로 전환하는 솔루션인 OpenFrame의 기반 시스

템인 UNIX 시스템은 ASCII 코드를 기반으로 하는 시스템이다.

따라서 UNIX 시스템에서 운영되는 OpenFrame 시스템을 기동시키려면 EDBCID 코

드로 작성된 데이터를 ASCII 코드로 변환하는 절차가 필요하다.

이와 같이 서로 다른 코드를 기반으로 작성된 TN3270 에뮬레이터와 UNIX 시스템 기

반의 OSI 어플리케이션 서버 간의 원활한 통신을 위해 MSI 게이트웨이는 두 매체 중

간에서 상대 매체가 이해할 수 있는 언어로 코드 변환 역할을 수행한다.

이 때 OpenFrame에서는 CPM(Code Page Manager)이라는 툴을 사용하여 에뮬레이

OpenFrame MSI 운영자 안내서 22

Page 23: OpenFrame MSI 운영자 안내서 - TmaxSoft · 2019. 4. 9. · msi 운영자 안내서는 총 5개의 장으로 구성되어 있다. 각 장의 주요 내용은 다음과 같다

제2장 게이트웨이

터와 서버 간의 코드 변환을 수행한다. MSI 게이트웨이는 코드 변환 툴인 CPM을 통

해 TN3270 에뮬레이터와 OSI 어플리케이션 서버 간의 데이터 변환을 수행한다.

각 나라별 코드는 유니코드라는 표준 코드에 매핑된다. 유니코드는 서로 다른 코드를

변환할 수 있는데 CPM은 유니코드를 기반으로 개발되었다.

참고: CPM 설정 방법에 대한 자세한 내용은 “4.5 CPM설정” 절을 참고한다.

2.5 게이트웨이의 에뮬레이터 관리

MSI 게이트웨이는 지정된 LU(Logical Unit) 를 사용하는데, 관리자가 작성한 에뮬레이

터에 관한 정보를 MSI 게이트웨이가 기동될 때 읽어들여 그 정보를 가지고 있다.

MSI 게이트웨이에 접속하는 TN3270 에뮬레이터는 설정 파일에서 지정된 개수만큼

가능하고, 지정된 LU로 접속하는 에뮬레이터는 ATI(Active Terminal Information)라는

저장소에서 관리된다.

ATI는 OSI 시스템이 기동될 때 osi.conf 설정 파일에 지정된 옵션을 읽어들여 생성

되며, 초기 정보가 ATI 에 저장된다.

참고: 게이트웨이 설정 파일에 명시된 옵션을 읽어들이는 방법은 “4.4 기동 스크립트 파일 설정”

절을 참고한다.

TN3270 에뮬레이터에서 접속 절차를 거쳐 MSI 게이트웨이에 접속을 시도하면, 각 에

뮬레이터에 대한 정보는 ATI에 할당된 공간에 저장된다.

MSI 게이트웨이는 현재 접속되어 있는 에뮬레이터 정보를 ATI를 통해 알 수 있다. 또

한 OSI 시스템과 데이터를 주고 받을 때나 동시에 여러 개의 에뮬레이터에서 작업 요

청을 받게 되더라도 ATI 정보를 확인하여 해당 에뮬레이터로 요청에 대한 응답을 보낼

수 있으며, 대화 모드(Conversation Mode)로 진행되는 모든 트랜잭션에 대한 처리도

가능하다.

OpenFrame MSI 운영자 안내서 23

Page 24: OpenFrame MSI 운영자 안내서 - TmaxSoft · 2019. 4. 9. · msi 운영자 안내서는 총 5개의 장으로 구성되어 있다. 각 장의 주요 내용은 다음과 같다
Page 25: OpenFrame MSI 운영자 안내서 - TmaxSoft · 2019. 4. 9. · msi 운영자 안내서는 총 5개의 장으로 구성되어 있다. 각 장의 주요 내용은 다음과 같다

제3장 포맷

제3장

3.1

3.2

포맷

개요

포맷이란 어플리케이션 서버가 사용하는 화면에 대한 정의이다. 본 장에서는 시스템

운영 또는 관리자가 MSI 시스템의 이해를 위해 포맷 작성 규칙과 포맷 구조에 대해 기

술한다.

포맷 작성 규칙

기본적으로 포맷 파일은 다음과 같은 구문(syntax)으로 구성된다.

label operation operand comments

레이블(label)

레이블을 항상 첫 번째 열에서 시작(단, 레이블 사용이 필수는 아님)해야 하며 레

이블과 명령어(operation) 사이에는 하나 이상의 공백이 있어야 한다. 레이블에는

8바이트까지의 문자열(영문 대문자, 숫자)을 사용할 수 있는데, 첫 번째 문자는

반드시 알파벳이어야 한다. “FMT” 명령어 앞에 사용되는 레이블에는 6바이트까

지의 문자열까지만 가능하다.

명령어(operation)

포맷의 명령어는 열 번째 열부터 시작되어야 한다.

키워드(operand)

16번 째 열부터는 각 명령어의 키워드가 시작되는 곳이다. 키워드(operand)는 중

복적으로 여러 개를 사용할 수 있다. 입력 값에 대한 길이 제한은 없으나, 각 피연

산자에 대한 속성 값에는 245바이트까지 가능하다. 다음 행으로 연속되는 경우에

도 16번 째 열에서 시작되어야 한다.

주석(comments)

주석을 추가하려면 피연산자(operand)에 사용된 마지막 파라미터와 하나 이상의

공백을 사이에 두고 입력이 시작되어야 한다. 또는 첫 번째 열에 별표(*)를 입력하

여 주석을 처리할 수 있다. 주석 추가 시 연속되는 행은 72번 째 열에 공백이 아닌

OpenFrame MSI 운영자 안내서 25

Page 26: OpenFrame MSI 운영자 안내서 - TmaxSoft · 2019. 4. 9. · msi 운영자 안내서는 총 5개의 장으로 구성되어 있다. 각 장의 주요 내용은 다음과 같다

제3장 포맷

문자를 입력함으로써 처리한다. 주석 길이에 대한 제한은 없으며, 주석이 연속되

어 다음 행까지 연결되는 경우 다음 행에서 시작되는 주석 위치에 대한 제한도 없

다.

다음은 포맷 파일에 대한 예제이다. 작성한 코드가 실제로 화면에 나타나는 모습을 확

인하려면 “3.5 포맷 컴파일” 절의 예제를 참고한다.

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

* FORMAT SET FOR MSI LOGO SCREEN. *

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

MSILOGO FMT

DEV TYPE=(3270,2), X

FEAT=IGNORE, X

DSCA=X'00A0'

DIV TYPE=INOUT

DPAGE CURSOR=((20,44)), X

FILL=PT

DFLD '*** WELCOME TO OPENFRAME IMS ONLINE ***', X

POS=(2,2), X

ATTR=(HI,PROT), X

EATTR=(HBLINK,YELLOW)

DFLD ' ***** /****** /*******/** /**/*******/****** /*** X

/**/**/**/*******', X

POS=(5,3), X

ATTR=(HI,PROT)

DFLD '/*******/*******/*******/*** /**/*******/******* /*****X

/********/*******', X

OpenFrame MSI 운영자 안내서 26

Page 27: OpenFrame MSI 운영자 안내서 - TmaxSoft · 2019. 4. 9. · msi 운영자 안내서는 총 5개의 장으로 구성되어 있다. 각 장의 주요 내용은 다음과 같다

제3장 포맷

POS=(6,3), X

ATTR=(HI,PROT)

DFLD '/**///**/**///**/**//////*** /**/**//////**///**/**///*X

*/********/**/////', X

POS=(7,3), X

ATTR=(HI,PROT)

DFLD '/** /**/** /**/** /****/**/** /** /**/** /*X

*/**/**/**/**', X

POS=(8,3), X

ATTR=(HI,PROT)

DFLD '/** /**/*******/*******/*******/*******/*******/******X

*/**/**/**/*******', X

POS=(9,3), X

ATTR=(HI,PROT)

DFLD '/** /**/******//*******/*******/*******/******//******X

*/**/**/**/*******', X

POS=(10,3), X

ATTR=(HI,PROT)

DFLD '/** /**/**//// /**//////**/****/**//////**///**/**///*X

*/**/**/**/**/////', X

POS=(11,3), X

ATTR=(HI,PROT)

DFLD '/** /**/** /** /** /***/** /** /**/** /*X

*/**/**/**/** ', X

POS=(12,3), X

OpenFrame MSI 운영자 안내서 27

Page 28: OpenFrame MSI 운영자 안내서 - TmaxSoft · 2019. 4. 9. · msi 운영자 안내서는 총 5개의 장으로 구성되어 있다. 각 장의 주요 내용은 다음과 같다

제3장 포맷

ATTR=(HI,PROT)

DFLD '/*******/** /*******/** /***/** /** /**/** /*X

*/**/**/**/*******', X

POS=(13,3), X

ATTR=(HI,PROT)

DFLD '//*****//** /*******/** //**/** /** /**/** /*X

*/**/**/**/*******', X

POS=(14,3), X

ATTR=(HI,PROT)

DFLD ' ////// /// /////////// ////// /// ////// //X

//////////////////', X

POS=(15,3), X

ATTR=(HI,PROT)

DFLD 'Copyright 2000-2006 Tmax Soft Co.,Ltd.', X

POS=(17,38), X

ATTR=(HI,PROT)

DFLD 'INPUT START MOD : ', X

POS=(21,24), X

ATTR=(HI,PROT)

MODNAME DFLD POS=(20,44), X

LTH=6, X

ATTR=ALPHA

FMTEND

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

MSILOGOI MSG TYPE=INPUT, X

OpenFrame MSI 운영자 안내서 28

Page 29: OpenFrame MSI 운영자 안내서 - TmaxSoft · 2019. 4. 9. · msi 운영자 안내서는 총 5개의 장으로 구성되어 있다. 각 장의 주요 내용은 다음과 같다

제3장 포맷

SOR=(MSILOGO,IGNORE), X

NXT=MSILOGOO

SEG

MFLD 'TGCM ', X

LTH=8

MFLD MODNAME, X

LTH=6, X

JUST=R, X

FILL=C'0'

MSGEND

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

MSILOGOO MSG TYPE=OUTPUT, X

SOR=(MSILOGO,IGNORE), X

NXT=MSILOGOI

SEG

MSGEND

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

END

OpenFrame MSI 운영자 안내서 29

Page 30: OpenFrame MSI 운영자 안내서 - TmaxSoft · 2019. 4. 9. · msi 운영자 안내서는 총 5개의 장으로 구성되어 있다. 각 장의 주요 내용은 다음과 같다

제3장 포맷

3.3 포맷 구조

화면에 출력되는 필드를 정의하는 포맷은 [그림 3-1]과 같이 DIF, DOF, MID, MOD의 4

개의 구조체에 정의한다.

각 구조체가 의미하는 전체 명칭과 설명은 다음과 같다.

[그림 3-1] MSI 포맷 구조

DIF: Device Input Format

DIF는 사용자가 사용하는 에뮬레이터로부터 입력을 받는 필드에 대한 정보를 갖

고 있는 정보체이다. 위 “3.2 포맷 작성 규칙” 절의 예제에서 보면 “DFLD” 명령어

에 앞에 레이블(label)이 있는 필드들이 DIF에 들어가게 된다.

DOF: Device Output Format

DOF는 어플리케이션 서버로부터 데이터를 받아서 사용자의 에뮬레이터에 출력

하는 정보를 갖고 있는 정보체이다. DFLD 명령어로 정의되는 모든 부분이(DIF

정의부분 포함)이 DOF에 저장될 정보이다.

DIF(Device Input Format)와 DOF(Device Output Format)는 “3.2 포맷 작성 규

칙” 절의 포맷 파일 예제에서 확인할 수 있듯이 “FMT”로 시작을 정의하고

“FMTEND”로 끝을 정의한다.

MID: Message Input Descriptor

MID는 DIF로부터 전달받은 메시지를 어플리케이션에 전달해주는 역할을 한다.

이때 MID와 DIF 사이에는 위 포맷처럼 각 필드 간의 매핑이 이루어져야 정확한

메시지가 전달될 수 있다.

OpenFrame MSI 운영자 안내서 30

Page 31: OpenFrame MSI 운영자 안내서 - TmaxSoft · 2019. 4. 9. · msi 운영자 안내서는 총 5개의 장으로 구성되어 있다. 각 장의 주요 내용은 다음과 같다

제3장 포맷

MOD: Message Output Descriptor

MOD는 어플리케이션으로부터 처리된 결과를 저장하는 구조체로서 MOD는 사

용자의 에뮬레이터 종류에 따라 적절한 DOF를 호출하여 메시지를 전달하게 된

다.

MID(Message Input Descriptor)와 MOD(Message Output Descriptor)는 “3.2 포

맷 작성 규칙” 절의 포맷 파일 예제에서 확인할 수 있듯이 “MSG”로 시작을 정의

하고 “MSGEND”로 끝을 정의한다.

3.4

3.5

포맷 동작 구조

사용자 에뮬레이터로부터 입력받은 정보가 DIF에 저장된 후 MID는 DIF에 저장된 정

보를 전달받아서 어플리케이션 서버가 요구하는 데이터 형태로 만들어서 OSI 데이터

를 어플리케이션 서버로 전달한다.

어플리케이션에서 처리된 데이터는 에뮬레이터로 다시 전송되어 화면에 출력되어야

하는데, 어플리케이션 서버로부터 받은 OSI 데이터가 MOD에 전달되며, MOD는 사용

자 에뮬레이터에 적절한 DOF에 데이터를 전달해준다.

3270 에뮬레이터 종류에는 한 라인에 80개의 문자가 출력되는 모델 또는 132개의 문

자가 출력되는 모델 등 다양한 모델이 존재한다. 앞에서 언급한 네 가지의 정보체를

구성하여 동작하는 MSI 게이트웨이는 어플리케이션 서버에서 처리된 결과가 어떤 종

류의 에뮬레이터 화면에 출력되는지 상관없이 데이터를 에뮬레이터로 반환한다. 이

때, MOD 및 MID가 데이터가 출력되는 화면에 적합한 DOF 및 DIF를 선택하여 화면에

출력할 수 있도록 하는 것이다.

포맷 컴파일

포맷 파일을 문법에 맞게 작성한 후 MSI 컴파일 툴을 사용하여 컴파일하면 바이너리

인 physical map 파일과 어플리케이션용 symbolic map 파일이 생성된다.

바이너리 파일은 MSI 게이트웨이 또는 다른 모듈에서 내부적인 작업 수행을 위해 사

용되는 파일이다.

어플리케이션용 symbolic map은 텍스트 파일로 OSI 어플리케이션 서버에서 화면 필

OpenFrame MSI 운영자 안내서 31

Page 32: OpenFrame MSI 운영자 안내서 - TmaxSoft · 2019. 4. 9. · msi 운영자 안내서는 총 5개의 장으로 구성되어 있다. 각 장의 주요 내용은 다음과 같다

제3장 포맷

드에 데이터를 보내거나 받을 수 있도록 정의한 각각의 프로그래밍 언어 문법에 맞는

형식의 변수 선언문이다.

참고: msimapc 툴을 사용하여 해당 파일의 포맷을 컴파일할 수 있다. 컴파일 툴에 대한 자세

한 내용은 “Appendix.A 포맷 컴파일 툴”을 참고한다.

다음은 msimapc 툴을 사용하여 MSILOGO.fmt 파일을 컴파일한 예제이다.

[of1a@tmaxs4:format]$ msimapc -p MSILOGO.fmt

>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>

* INPUT FORMAT : MSILOGO.fmt

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

* preview : ---------------------------------------------------------------(BEGIN)-

FORMAT : [MSILOGO]

123456789+123456789+123456789+123456789+123456789+123456789+123456789+123456789+

------------------------------------------------------------------------------->S

01|

02|@*** WELCOME TO OPENFRAME IMS ONLINE ***

03|

04|

05| @ ***** /****** /*******/** /**/*******/****** /*** /**/**/**/*******

06| @/*******/*******/*******/*** /**/*******/******* /***** /********/*******

07| @/**///**/**///**/**//////*** /**/**//////**///**/**///**/********/**/////

08| @/** /**/** /**/** /****/**/** /** /**/** /**/**/**/**/**

09| @/** /**/*******/*******/*******/*******/*******/*******/**/**/**/*******

10| @/** /**/******//*******/*******/*******/******//*******/**/**/**/*******

11| @/** /**/**//// /**//////**/****/**//////**///**/**///**/**/**/**/**/////

OpenFrame MSI 운영자 안내서 32

Page 33: OpenFrame MSI 운영자 안내서 - TmaxSoft · 2019. 4. 9. · msi 운영자 안내서는 총 5개의 장으로 구성되어 있다. 각 장의 주요 내용은 다음과 같다

제3장 포맷

12| @/** /**/** /** /** /***/** /** /**/** /**/**/**/**/**

13| @/*******/** /*******/** /***/** /** /**/** /**/**/**/**/*******

14| @//*****//** /*******/** //**/** /** /**/** /**/**/**/**/*******

15| @ ////// /// /////////// ////// /// ////// ////////////////////

16|

17| @Copyright 2000-2006 Tmax Soft Co.,Ltd.

18|

19|

20| @______

21| @INPUT START MOD :

22|

23|

24|

-------------------------------------------------------------------------------<E

* ---------------------------------------------------------------------------(END)-

* COBOL SYMBOL FILE.

- [/user/of1a/openframe/tmax/mfs/copybook/MSILOGO.cpy] CREATED.

* BINARY IMAGE.

- [/user/of1a/openframe/tmax/mfs/binary/02mSILOGO.dif] CREATED.

- [/user/of1a/openframe/tmax/mfs/binary/02MSILOGO.dof] CREATED.

- [/user/of1a/openframe/tmax/mfs/binary/MSILOGOI.mid] CREATED.

- [/user/of1a/openframe/tmax/mfs/binary/MSILOGOO.mod] CREATED.

<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<

OpenFrame MSI 운영자 안내서 33

Page 34: OpenFrame MSI 운영자 안내서 - TmaxSoft · 2019. 4. 9. · msi 운영자 안내서는 총 5개의 장으로 구성되어 있다. 각 장의 주요 내용은 다음과 같다
Page 35: OpenFrame MSI 운영자 안내서 - TmaxSoft · 2019. 4. 9. · msi 운영자 안내서는 총 5개의 장으로 구성되어 있다. 각 장의 주요 내용은 다음과 같다

제4장 시스템 설정

제4장

4.1

4.2

시스템 설정

개요

MSI 시스템을 기동하여 운영하기 위해서는 다음의 사항이 설정되어 있어야 한다.

프로파일(Profile)

Tmax 환경

기동 스크립트 파일

CPM (Code Page Manager)

OSD (Online Sysmtem Definition)

MSI 설정 파일

MSI 게이트웨이 또는 MSI 관련 툴이 제대로 작동하도록 하려면 다음과 같이 프로파

일에 환경 변수를 설정해야 한다.

msi.conf 파일 설정

$OPENFRAME_HOME/config 디렉터리 아래에 msi.conf 파일을 생성하여 다음

과 같은 내용을 설정해야한다.

- 사용자가 사용하는 프로그래밍 언어에 맞는 symbolic map 경로

- physical map 파일이 위치하는 경로

다음은 msi.conf 파일 예제이다.

[DIRECTORY]

HTML=

TEXT=

C=

PLI=/home/of1a/openframe/msi/plicopybook

OpenFrame MSI 운영자 안내서 35

Page 36: OpenFrame MSI 운영자 안내서 - TmaxSoft · 2019. 4. 9. · msi 운영자 안내서는 총 5개의 장으로 구성되어 있다. 각 장의 주요 내용은 다음과 같다

제4장 시스템 설정

COBOL=/home/of1a/openframe/msi/cobolcopybook

FORMAT=/home/of1a/openframe/msi/binary

4.3 Tmax 환경 설정

OpenFrame 시스템은 TP-Monitor인 Tmax가 엔진 기능을 담당한다. 따라서

OpenFrame을 기반으로 작성된 프로그램이 제대로 동작하기 위해서는 기본적으로

Tmax용 설정 파일이 존재해야 하며, MSI 게이트웨이는 Tmax 서버 중 하나로 등록되

어 있어야 한다.

Tmax 환경 설정을 위해서는 Tmax 노드에 MSI 게이트웨이 서버를 등록해야 하는데,

이를 위해서는 우선 서버 바이너리가 필요하다. Tmax 설정 파일에서 서버 바이너리

를 등록하려면 다음과 같은 절차를 수행한다.

APPDIR로 설정된 디렉터리 안에 MSI 게이트웨이 바이너리(msigw)를 복사한다.

둘 이상의 게이트웨이를 운영하기 원하는 경우 Tmax 설정 파일에서 “TARGET”

옵션을 지정하여 원하는 개수대로 서버를 등록한다.

참고: Tmax 환경 설정과 서버 등록 에 대한 자세한 내용은 Tmax 안내서 중 ”Tmax

Administration Guide”를 참고한다.

게이트웨이 서버 등록은 Tmax 서버 등록 절차와 동일하다.

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

# OpenFrame Mapping Supports #

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

msigw_1 SVGNAME = svgotpn,

MIN=1,

MAX=1,

CPC=10,

OpenFrame MSI 운영자 안내서 36

Page 37: OpenFrame MSI 운영자 안내서 - TmaxSoft · 2019. 4. 9. · msi 운영자 안내서는 총 5개의 장으로 구성되어 있다. 각 장의 주요 내용은 다음과 같다

제4장 시스템 설정

SVRTYPE=CUSTOM_GATEWAY,

TARGET=msigw,

CLOPT= “-o $(SVR).log -e $(SVR).err”

msigw_2 SVGNAME = svgotpn,

MIN=1,

MAX=1,

CPC=10,

SVRTYPE=CUSTOM_GATEWAY,

TARGET=msigw,

CLOPT= “-o $(SVR).log -e $(SVR).err”

4.4 기동 스크립트 파일 설정

OSI에서는 ofboot 또는 ofdown 툴을 사용하여 시스템을 기동 또는 종료할 수 있다.

시스템 기동 시에는 ofboot라는 툴을 사용하는데, 툴을 실행하면 다음과 같은 프로

세스가 진행된다.

1. ofboot.pre 스크립트에 기술된 작업이 수행된다. 이 때 MSI 게이트웨이가 관

리하는 에뮬레이터 정보를 저장하는 공유 메모리(ATI)가 생성된다.

2. Tmax가 기동된다.

3. Tmax가 기동된 이후에는 ofboot.post 스크립트에 기술된 작업이 수행된다.

종료 시에는 ofdown이라는 툴을 사용하는데, 툴을 사용하면 다음과 같이 프로세스가

진행된다.

1. ofdown.pre 스크립트에 기술된 작업이 수행된다.

2. Tmax가 종료된다.

OpenFrame MSI 운영자 안내서 37

Page 38: OpenFrame MSI 운영자 안내서 - TmaxSoft · 2019. 4. 9. · msi 운영자 안내서는 총 5개의 장으로 구성되어 있다. 각 장의 주요 내용은 다음과 같다

제4장 시스템 설정

3. Tmax가 종료된 이후에는 ofdown.post 스크립트에 기술된 작업이 수행된다.

이 때 MSI 게이트웨이가 관리하는 에뮬레이터 정보를 저장하는 공유 메모리(ATI)

가 삭제된다.

위에서 언급한 시스템 기동 또는 종료 과정 2번에서 MSI 게이트웨이를 위한 ATI는 자

동으로 생성 또는 삭제되는 것이 아니다. ATI를 생성 또는 삭제하려면 ofboot.pre

또는 ofdown.post 파일에 ofadmin 툴을 실행하도록 스크립트를 추가해야 한다.

참고: ofboot 및 ofdown 툴을 사용하여 OSI 시스템을 기동 및 종료시키는 방법에 대한 자세

한 내용은 OpenFrame 안내서 중 “OSI 운영자 안내서”를 참고한다.

osi.conf 설정 파일에 명시되어 있는 게이트웨이 옵션들을 읽어 공유 메모리를 생

성하도록 하려면 ofboot.pre 파일에 다음과 같은 형식의 시놉시스를 입력한다.

ofadmin –create OSI

다음은 ofboot.pre 스크립트 파일 예제이다.

ofadmin -create OSI

ofadmin -loglvl OSI:T

osi.conf 설정 파일에는 다음과 같은 옵션을 설정한다.

항목 설정 정보

SHMKEY ATI 공유 메모리 키 설정 (16진수)

MAX_CHANNEL 동시 접속 가능한 최대 에뮬레이터 개수 설정

GATEWAY_COUNT OSI 시스템에 사용되는 MSI 게이트웨이 서버 개수 설정

GATEWAY_INDEX 게이트웨이의 인덱스 번호 설정

GATEWAY_LANG 게이트웨이에서 사용하는 언어 지정 (KR, JP. US 지원)

GATEWAY_PORT

게이트웨이에서 에뮬레이터로 연결되는 접속 포트 번호 설정

[표 4-1] MSIGW의 [OSI_ATI]

OpenFrame MSI 운영자 안내서 38

Page 39: OpenFrame MSI 운영자 안내서 - TmaxSoft · 2019. 4. 9. · msi 운영자 안내서는 총 5개의 장으로 구성되어 있다. 각 장의 주요 내용은 다음과 같다

제4장 시스템 설정

다음은 16200 공유 메모리에 동시 접속 가능한 최대 에뮬레이터 개수는 1,024개로 설

정한다. 시스템에 사용되는 게이트웨이 개수 및 인덱스는 1로, 게이트웨이에 사용되

는 언어는 한국어, 포트 번호는 14200으로 설정한 예제이다.

[OSI_ATI]

SHMKEY=16200

MAX_CHANNEL=1024

GATEWAY_COUNT=1

GATEWAY_INDEX=1

GATEWAY_LANG=KR

GATEWAY_PORT=14200

4.5 CPM 설정

CPM(Code Page Manager)은 서로 다른 코드 페이지를 사용하는 시스템(예: IBM

Mainframe의 EBCDIC 코드, OpenFrame의 ASCII 코드) 간의 데이터를 변환 및 관리

하는 툴이다.

CPM의 구조는 국제 표준 코드 집합인 유니코드에 대응되는 서로 다른 코드 집합을

유니코드를 매개체로 해서 EBCDIC 코드와 ASCII 코드를 매핑시킨다.

예를 들어, ASCII 코드 “0x7F”은 유니코드 “007F”에 매핑되고 EBCDIC 코드 “0x07”이

유니코드 “007F”에 매핑되는데, 이렇게 CPM은 유니코드를 매개체로 하여 “0x7F”

“0x07”로 코드를 매핑시킨 정보를 담고 있다.

다음은 CPM에서 코드 변환을 위해 제공하는 툴이다.

cpmmgr

*.cpm 파일을 읽어들여 현재 매핑된 정보 또는 코드 변환 테스트, 새로운 코드

추가 및 삭제 등 *.cpm 파일을 관리한다.

OpenFrame MSI 운영자 안내서 39

Page 40: OpenFrame MSI 운영자 안내서 - TmaxSoft · 2019. 4. 9. · msi 운영자 안내서는 총 5개의 장으로 구성되어 있다. 각 장의 주요 내용은 다음과 같다

제4장 시스템 설정

다음과 같은 방법으로 CPM을 설정한다.

1. $OPENFRAME_HOME/cpm 디렉터리를 생성한다. 단, OpenFrame 시스템을 설치

할 때 CPM 값을 설정했다면 해당 디렉터리가 이미 생성되어 있을 수도 있다.

2. $OPENFRAME_HOME/cpm 디렉터리에 .cpm 파일을 위치시킨다.

언어별로 ASCII와 EBCDIC으로 변환하는 파일이 한 쌍으로 존재해야 한다. 예를

들어, 일본어를 지원하는 시스템의 경우 EBCASCJP.cpm ASCEBCJP.cpm 파일

이 존재해야 한다.

참고: MSI 시스템에서는 한국어(KR), 일본어(JP), 영어(US) 코드를 지원한다. 지원되는 세 언어

를 모두 사용하는 시스템의 경우에는 EBCASCJP.cpm, ASCEBCJP.cpm,

EBCASCKR.cpm, ASCEBCKR.cpm, EBCASCUS.cpm, ASCEBCUS.cpm의 총 6개의 파

일이 존재해야 한다.

4.6 OSD 설정

MSI 게이트웨이는 지정된 에뮬레이터를 사용할 수 있도록 리소스를 관리한다. OSI에

는 ATI(Active Terminal Information)라고 불리는 현재 접속 중인 에뮬레이터 정보를 저

장하여 관리하는 영역이 존재하는데, 이 영역에서 MSI 게이트웨이에 접속하고 있는

에뮬레이터에 대한 정보를 관리한다. 이와 같이 ATI에서 관리하는 에뮬레이터의 정보

는 OSD(Online System Definition)이라는 OSI 시스템 리소스를 통해 가져올 수 있다.

OSD는 시스템에서 필요로 하는 리소스에 대한 정보를 저장해 놓은 데이터 셋이다.

MSI 게이트웨이에서 관리하는 에뮬레이터 정보는 OSD에 저장된다. 실제로 MSI 게이

트웨이에 접속한 에뮬레이터가 OSD에 등록된 에뮬레이터일 경우 MSI 게이트웨이는

ATI 에 그 접속한 에뮬레이터 정보를 저장하여 관리한다.

OSD 정보를 입력하려면 osdgen 툴을 사용하여 매크로로 정의된 텍스트 형태의 파

일을 실행시킨다. 다음은 lct.dat 파일(MSI 게이트웨이서 관리할 에뮬레이터에 대

한 리소스를 정의한 파일) 예제이다.

TERMINAL NAME=TERMD13Y,TYPE=3270-A2,SIZE=(24,80),LTERM=N041E14, X

OPTIONS=(TRSOSI,NOSIGNON,MFS)

OpenFrame MSI 운영자 안내서 40

Page 41: OpenFrame MSI 운영자 안내서 - TmaxSoft · 2019. 4. 9. · msi 운영자 안내서는 총 5개의 장으로 구성되어 있다. 각 장의 주요 내용은 다음과 같다

제4장 시스템 설정

TERMINAL NAME=TERMD13P,TYPE=3270-A2,SIZE=(24,80),LTERM=N041E16, X

OPTIONS=(TRSOSI,NOSIGNON,MFS)

TERMINAL NAME=TERMD13Z,TYPE=3270-A2,SIZE=(24,80),LTERM=N041E18, X

OPTIONS=(TRSOSI,NOSIGNON,MFS)

osdgen 툴을 사용하여 리소스 정의 파일 명칭과 osi.conf 설정 파일에서 설정한

OSD 데이터셋 명칭은 다음 예제와 같은 형태로 입력한다.

osdgen osires.dat OPNFRAME.ONLINE.OSDILIB

osdgen 툴을 사용한 후에는 데이터가 정상적으로 데이터 셋에 저장되었는 지 반드시

확인해야 한다. 데이터가 정상적으로 데이터 셋에 저장되었는지는 dsview 툴을 통해

확인할 수 있다.

참고: osdgen 및 dsview 툴 등 OpenFrame에서 사용되는 툴에 대한 자세한 사용법은

OpenFrame 안내서 중 “툴 참조 안내서”를 참고한다.

OpenFrame MSI 운영자 안내서 41

Page 42: OpenFrame MSI 운영자 안내서 - TmaxSoft · 2019. 4. 9. · msi 운영자 안내서는 총 5개의 장으로 구성되어 있다. 각 장의 주요 내용은 다음과 같다
Page 43: OpenFrame MSI 운영자 안내서 - TmaxSoft · 2019. 4. 9. · msi 운영자 안내서는 총 5개의 장으로 구성되어 있다. 각 장의 주요 내용은 다음과 같다

제5장 MSI 운영

제5장

5.1

5.2

MSI 운영

개요

본 장에서는 MSI 시스템을 기동 및 종료 방법, MSI 서버가 문제 없이 기동되었는지 확

인하는 방법 및 MSI에 접속하는 방법 등에 대해 기술한다.

서버 기동 및 종료

“제4장 시스템 설정”에서 기술된 MSI 게이트웨이에 대한 설정을 모두 완료한 후 OSI

어플리케이션 서버를 기동시키면 엔진과 함께 MSI 게이트웨이가 기동된다. OSI 엔진

이 기동된 상태에서 게이트웨이만 개별적으로 기동하고 싶다면 다음과 같은 형식으로

tmboot 명령을 실행한다.

참고: OSI 어플리케이션 서버 기동에 대한 자세한 내용은 OpenFrame 안내서 중 ”OSI 운영자

안내서”를 참고한다.

다음은 개별적으로 게이트웨이를 기동시키는 명령에 대한 시놉시스이다.

tmboot -s gatewayserver

게이트웨이 서버 종료 역시 OSI 엔진이 종료될 때 같이 종료되는데, 개별적으로 MSI

게이트웨이를 종료하려면 다음과 같은 형식으로 tmdown 명령을 실행한다.

다음은 개별적으로 게이트웨이를 종료시키는 명령에 대한 시놉시스이다.

tmdown -s gatewayserver

MSI 게이트웨이가 기동되면 Tmax 관리 명령어인 tmadmin을 사용하여 정상적으로

기동되었는지 확인한다.

완료 상태(RDY)가 아닌 경우에는 MSI 게이트웨이 로그 파일을 참조하여 에러 원인을

파악하여 문제점을 수정한 후에 다시 기동시킨다.

OpenFrame MSI 운영자 안내서 43

Page 44: OpenFrame MSI 운영자 안내서 - TmaxSoft · 2019. 4. 9. · msi 운영자 안내서는 총 5개의 장으로 구성되어 있다. 각 장의 주요 내용은 다음과 같다

제5장 MSI 운영

다음은 개별적으로 “msigw_1” 게이트웨이 서버를 기동시켰을 때의 기동 화면 예시이

다.

[of1a@tmaxs4:of1a]$ tmboot -s msigw_1

TMBOOT for node(OF1A) is starting:

Welcome to Tmax demo system: it will expire 2007/8/21

Today: 2007/5/25

TMBOOT: SVR(svrname: msigw_1, execname: msigw) is starting: Fri May

25 18:50:52 2007

다음은 개별적으로 “msigw_1” 게이트웨이 서버를 종료시켰을 때의 종료 화면 예시이

다.

[of1a@tmaxs4:of1a]$ tmdown -s msigw_1

TMDOWN for node(OF1A) is starting:

TMDOWN: SERVER(msigw_1:37) downed: Fri May 25 18:50:38 2007

5.3 서버 관리

MSI 서버는 tmadmin 명령어를 사용하여 서버 기동 상태를 확인하고 서버 상태에 문

제가 있는 경우 해당 로그를 참조하여 문제 원인을 파악하는 방법으로 관리할 수 있다.

다음은 서버 기동 여부를 알려주는 예시 화면이다. 예시 화면에서 서버 상태(status)가

RDY로 되어 있는 것을 통해 MSI 서버(msigw_1)가 문제 없이 기동되었음을 확인할

수 있다.

$$38 OF1A (tmadm): si

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

clh svrname (svri) status count qcount

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

0 ofrsasvr ( 4) RDY 14 0

OpenFrame MSI 운영자 안내서 44

Page 45: OpenFrame MSI 운영자 안내서 - TmaxSoft · 2019. 4. 9. · msi 운영자 안내서는 총 5개의 장으로 구성되어 있다. 각 장의 주요 내용은 다음과 같다

제5장 MSI 운영

0 MSCGW001 ( 5) RDY 0 0

0 msigw_1 ( 6) RDY 0 0

0 MSCGW002 ( 7) RDY 7 0

0 oscsteda ( 8) RDY 0 0

0 oscstedf ( 9) RDY 0 0

0 oscstebr ( 10) RDY 0 0

0 oscstesn ( 11) RDY 0 0

0 oscstemt ( 12) RDY 0 0

0 otpadmin ( 13) RDY 0 0

0 oscolsvr ( 14) RDY 0 0

0 osctlsvr ( 15) RDY 0 0

0 oscncsvr ( 16) RDY 0 0

0 osicrmgr ( 17) RDY 0 0

0 osimsmgr ( 18) RDY 0 0

0 oscmssvr ( 19) RDY 0 0

0 osimqsch ( 20) RDY 5 0

0 osimqmgr ( 21) RDY 0 0

0 oscmschd ( 22) RDY 0 0

0 oscmscnv ( 23) RDY 0 0

0 osisecur ( 24) RDY 0 0

0 CICS0001 ( 25) RDY 0 0

0 CICS0001_M ( 26) NRDY 0 0

0 CICS0002 ( 27) RDY 0 0

0 CICS0002_M ( 28) NRDY 0 0

0 OSCOIVP1 ( 29) RDY 7 0

OpenFrame MSI 운영자 안내서 45

Page 46: OpenFrame MSI 운영자 안내서 - TmaxSoft · 2019. 4. 9. · msi 운영자 안내서는 총 5개의 장으로 구성되어 있다. 각 장의 주요 내용은 다음과 같다

제5장 MSI 운영

0 MPP00001 ( 30) RDY 0 0

0 IFP00001 ( 31) RDY 0 0

5.4 에뮬레이터의 접속 및 종료

IBM PCOM(Personal Communication)을 기본 에뮬레이터로 설정한 OSI 시스템은

PCOM에 기본적인 설정을 등록하면 접속이 가능하다.

PCOM 에뮬레이터에 접속하여 접속 관련 항목을 설정하는 절차는 다음과 같다.

1. PCOM 메뉴에서 통신 구성을 클릭한다. 다음과 같이 통신 사용자 정의 상자가

나타난다.

[그림 5-1] 에뮬레이터 접속 설정 1

OpenFrame MSI 운영자 안내서 46

Page 47: OpenFrame MSI 운영자 안내서 - TmaxSoft · 2019. 4. 9. · msi 운영자 안내서는 총 5개의 장으로 구성되어 있다. 각 장의 주요 내용은 다음과 같다

제5장 MSI 운영

2. 아래 화면에서 링크 매개변수를 클릭한다. [그림 5-2]와 같이 Telnet3270 설정 상

자가 나타난다.

[그림 5-2] 에뮬레이터 접속 설정 2

3. 아래 화면과 같이 IP 주소, LU 또는 풀 이름, 포트 번호 등을 입력한다.

[그림 5-3] 에뮬레이터 접속 설정 3

OpenFrame MSI 운영자 안내서 47

Page 48: OpenFrame MSI 운영자 안내서 - TmaxSoft · 2019. 4. 9. · msi 운영자 안내서는 총 5개의 장으로 구성되어 있다. 각 장의 주요 내용은 다음과 같다

제5장 MSI 운영

4. 접속을 시도하여 아래와 같은 화면이 나타나는지 확인한다.

[그림 5-4] 예제 화면

5. 원하는 작업이 완료된 후 PCOM 메뉴의 접속 종료를 클릭하면 게이트웨이와 에

뮬레이터 간의 접속이 종료된다.

OpenFrame MSI 운영자 안내서 48

Page 49: OpenFrame MSI 운영자 안내서 - TmaxSoft · 2019. 4. 9. · msi 운영자 안내서는 총 5개의 장으로 구성되어 있다. 각 장의 주요 내용은 다음과 같다

Appendix. A:포맷 컴파일 툴

Appendix. A 포맷 컴파일 툴

A.1 msimapc

msimapc 툴은 포맷 파일을 작성한 후 physical map 파일과 symbolic map 파

일이 생성할 때 사용된다. physical map 파일은 MSI 게이트웨이 등의 OSI 모듈에

서 내부적인 작업 처리에 사용된다. symbolic map은 텍스트 파일로 COBOL 어플

리케이션에서 포맷 필드 대응에 사용된다.

다음은 msimapc 툴 사용에 대한 시놉시스이다.

Usage: msimapc [options1] <file>

| msimapc [options2] <dir> <file>

<file> Specify format file

<dir> Specify output directory

Options1:

-d display input map

-p preview format

-h help

Options2:

-o set ouput directory for OpenStudio

옵션별 사용 방법은 다음과 같다.

-h

도움말 화면을 표시한다.

-d

컴파일하고자 하는 소스의 전처리 과정을 출력한다. 전처리 과정을 보면서 컴파

일을 수행하기 때문에 에러 발생 시 에러 탐지가 용이하다.

OpenFrame MSI 운영자 안내서 49

Page 50: OpenFrame MSI 운영자 안내서 - TmaxSoft · 2019. 4. 9. · msi 운영자 안내서는 총 5개의 장으로 구성되어 있다. 각 장의 주요 내용은 다음과 같다

Appendix. A:포맷 컴파일 툴

-o DIR

OpenStudio에서 사용하는 옵션으로 physical map 파일과 symbolic map

이 생성되는 디렉터리를 강제로 지정한다.

-p 1

에뮬레이터에 나오는 화면을 미리 보여준다.

OpenFrame MSI 운영자 안내서 50