anylink admin 안내서 - tmaxsoft본 안내서는 tmax anylink® (이하 anylink)의 관리...

AnyLink

Admin 안내서

AnyLink v4.0

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

Copyright Notice

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

대한민국 경기도 성남시 분당구 서현동 272-6 우)463-824

Restricted Rights Legend

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

of Computer 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 AnyLink®) 사용설명서의 내용과 프로그램은 저작권법, 컴퓨터프로그램보호법 및 국제 조약

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

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

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

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

Trademarks

Tmax ProBus®, JEUS® and Tmax AnyLink® are a registered trademark of TmaxSoft Co., Ltd. Other products,

titles or services may be registered trademarks of their respective companies.

Tmax ProBus®, JEUS® and Tmax AnyLink®는 TmaxSoft Co., Ltd.의 등록 상표입니다. 기타 모든 제품들과 회사

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

Open Source Software Notice

This product includes open source software developed and/or licensed by "OpenSSL," "RSA Data Security, Inc.,"

"Apache Foundation," and "Jean-loup Gailly and Mark Adler." Information about the aforementioned and the related

open source software can be found in the "${INSTALL_PATH}/license/oss_licenses" directory.

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

해 개발 또는 라이선스된 오픈 소스 소프트웨어를 포함합니다. 관련 상세 정보는 제품의 디렉터리 “${IN

STALL_PATH}/license/oss_licenses”에 기재된 사항을 참고해 주십시오.

안내서 정보

안내서 제목: AnyLink Admin 안내서

발행일: 2012-11-09

소프트웨어 버전: AnyLink v4.0

안내서 버전: v2.1.1

내용 목차

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

제1장 AnyLink Admin 개요 ........................................................................................................ 1

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

1.2. Admin의 기능 ............................................................................................................... 2

제2장 Admin 구동 ...................................................................................................................... 3

2.1. 구동 스크립트 설명 ....................................................................................................... 3

2.1.1. 국제화 .............................................................................................................. 4

2.2. 환경설정 파일 .............................................................................................................. 4

2.2.1. 화면 설정 .......................................................................................................... 5

2.2.2. 모니터링 설정 ................................................................................................... 5

2.2.3. 커스텀 로그 조회 설정 ........................................................................................ 6

2.2.4. 기타 설정 .......................................................................................................... 6

2.3. 로그인 및 종료 ............................................................................................................. 6

2.3.1. 사용자 역할에 따른 로그인 ................................................................................. 7

2.3.2. 자동 로그인 ....................................................................................................... 7

2.3.3. 기타 로그인 기능 ............................................................................................... 8

2.3.4. 종료 .................................................................................................................. 9

2.4. Admin 구성 ................................................................................................................ 10

2.4.1. 전체 화면 구성 ................................................................................................. 10

2.4.2. Admin 구조 ..................................................................................................... 12

제3장 로그 조회 ........................................................................................................................ 15

3.1. 온라인 로그 조회 ........................................................................................................ 15

3.1.1. 마스터 로그 조회 ............................................................................................. 15

3.1.2. 커스텀 로그 조회 ............................................................................................. 20

3.1.3. 에러 로그 조회 ................................................................................................. 22

3.2. 배치 로그 조회 ........................................................................................................... 25

3.2.1. 배치 전문 로그 조회 ......................................................................................... 25

3.2.2. 배치 파일 레코드 조회 ...................................................................................... 27

3.3. 스케쥴러 로그 조회 ..................................................................................................... 30

3.4. 배치 파일 목록 조회 .................................................................................................... 32

3.5. 2PC 미완료 거래 조회 ................................................................................................. 35

3.5.1. 라이브러리 및 JEUS 서버 정보 설정 ................................................................. 35

제4장 전문 발송 ........................................................................................................................ 37

4.1. 운영 전문 ................................................................................................................... 37

4.1.1. 운영 전문 등록 ................................................................................................. 37

4.1.2. 스케쥴 변경 ..................................................................................................... 40

4.2. 배치 전문 발송 ........................................................................................................... 44

4.2.1. 배치 전문 작성 ................................................................................................. 44

4.2.2. 스케쥴 변경 ..................................................................................................... 45

AnyLink iii

제5장 통계 조회 ........................................................................................................................ 49

5.1. 날짜별 통계 조회 ........................................................................................................ 49

5.2. 항목별 통계 조회 ........................................................................................................ 51

5.3. 집계 데몬 스케쥴 설정 ................................................................................................ 52

제6장 시스템 컴포넌트 관리 ...................................................................................................... 55

6.1. 시스템 컴포넌트 브라우저 ........................................................................................... 55

6.1.1. 상태 보기 ........................................................................................................ 55

6.1.2. 통지(Notification) ............................................................................................. 56

6.1.3. 복제(Cloning) .................................................................................................. 56

6.2. 노드(Node) ................................................................................................................ 57

6.2.1. 노드 추가 ........................................................................................................ 57

6.2.2. 노드 수정 및 삭제 ............................................................................................ 59

6.2.3. 노드 모니터링 .................................................................................................. 60

6.3. 게이트웨이(Gateway) ................................................................................................. 61

6.3.1. 게이트웨이 추가 .............................................................................................. 61

6.3.2. MQ 게이트웨이 추가 ........................................................................................ 67

6.3.3. 기타 게이트웨이 추가 ....................................................................................... 67

6.3.4. 게이트웨이 수정 및 삭제 .................................................................................. 68

6.3.5. 게이트웨이 모니터링 ........................................................................................ 69

6.4. 회선(Line) .................................................................................................................. 70

6.4.1. TCP/IP, X.25 회선 추가 및 기관-업무 회선 연결 .................................................. 70

6.4.2. MQ 게이트웨이 회선 추가 ................................................................................ 76

6.4.3. URL 추가 ........................................................................................................ 77

6.4.4. 회선 수정 및 삭제 ............................................................................................ 79

6.4.5. 회선/URL 중지 및 재개 ..................................................................................... 79

6.4.6. 회선 접근 제어 ................................................................................................. 80

6.4.7. 기관-업무 보기 ................................................................................................ 81

6.4.8. 회선 모니터링 .................................................................................................. 82

6.4.9. X.25 회선 상태 통지 ......................................................................................... 83

6.5. Mapper ...................................................................................................................... 83

6.5.1. Mapper 추가 .................................................................................................... 83

6.5.2. Mapper 수정 및 삭제 ........................................................................................ 87

6.5.3. Mapper 모니터링 ............................................................................................. 88

제7장 도구 ................................................................................................................................ 91

7.1. 기관-업무 회선 연결 .................................................................................................... 91

7.1.1. 기관-업무 회선 브라우저 .................................................................................. 91

7.1.2. 연결 추가 및 삭제 ............................................................................................ 92

7.2. 업무/거래 제어 ........................................................................................................... 92

7.2.1. 업무/거래 선택 ................................................................................................. 92

7.2.2. 중단 조건 입력 및 실행 ..................................................................................... 94

7.3. 사용자 관리 ................................................................................................................ 94

7.3.1. 사용자 추가 ..................................................................................................... 95

iv AnyLink Admin 안내서

7.3.2. 사용자 정보 수정 및 삭제 ................................................................................. 96

7.3.3. 역할 관리 ........................................................................................................ 96

7.4. 로그인 이력 조회 ........................................................................................................ 98

7.5. 변경 이력 조회 .......................................................................................................... 100

7.6. 시스템 속성 관리 ...................................................................................................... 101

7.6.1. 시스템 속성 ................................................................................................... 101

7.6.2. 추가, 수정 및 삭제 .......................................................................................... 104

7.7. 통신망 상태 조회 ...................................................................................................... 105

7.7.1. 통신망 상태 수정 ........................................................................................... 106

7.8. 게이트웨이 및 회선 검색 ........................................................................................... 107

7.9. 채번 조회 ................................................................................................................. 108

7.10. 결번 조회 ............................................................................................................... 109

Appendix A. 오류 메시지 및 조치 방법 .................................................................................... 113

Appendix B. 기관-업무의 Inbound URL 공유 .......................................................................... 117

색인 .......................................................................................................................................... 121

AnyLink v

그림 목차

[그림 1.1] AnyLink 구성 ............................................................................................................... 1

[그림 2.1] 로그인 ......................................................................................................................... 7

[그림 2.2] 시스템 속성 관리 ......................................................................................................... 8

[그림 2.3] 3DES 암호화 ............................................................................................................... 8

[그림 2.4] 로그인 최대 오류 횟수 초과 .......................................................................................... 9

[그림 2.5] 사용자 암호 변경 주기 설정 .......................................................................................... 9

[그림 2.6] 전체 화면 구성 ........................................................................................................... 10

[그림 2.7] 타이틀 바 .................................................................................................................. 12

[그림 2.8] Admin-스튜디오-서버 관계도 ...................................................................................... 12

[그림 3.1] 온라인 마스터 로그 조회 ............................................................................................. 15

[그림 3.2] 상세 조회 - 스트림 전문 .............................................................................................. 18

[그림 3.3] 상세 조회 - VO 및 XML 전문 ....................................................................................... 19

[그림 3.4] 상세 조회 – Bypass 매핑 ............................................................................................ 20

[그림 3.5] 온라인 커스텀 로그 조회 ............................................................................................. 21

[그림 3.6] 에러 로그 조회 ........................................................................................................... 23

[그림 3.7] 에러 로그 상세 조회 (1) .............................................................................................. 24

[그림 3.8] 에러 로그 상세 조회 (2) .............................................................................................. 24

[그림 3.9] 배치 로그 조회 ........................................................................................................... 25

[그림 3.10] 배치파일 레코드 조회 ............................................................................................... 28

[그림 3.11] 배치파일 레코드 조회 - 전체 ..................................................................................... 29

[그림 3.12] 스케쥴러 로그 조회 .................................................................................................. 30

[그림 3.13] 배치파일 목록 조회 .................................................................................................. 32

[그림 3.14] 배치 파일 상세 조회 ................................................................................................. 33

[그림 3.15] 배치 파일 상태 이력 보기 .......................................................................................... 34

[그림 3.16] 2PC 미완료 거래 조회 .............................................................................................. 35

[그림 4.1] 운영전문 발송 ............................................................................................................ 38

[그림 4.2] 운영 전문 스케쥴 변경 ................................................................................................ 40

[그림 4.3] 기관 구분 – 식별자 정의 및 값 입력 ............................................................................. 41

[그림 4.4] 기관 구분 표시 ........................................................................................................... 41

[그림 4.5] 필드값 보기 ............................................................................................................... 42

[그림 4.6] 필드값 변경 ............................................................................................................... 43

[그림 4.7] 배치전문 발송 ............................................................................................................ 44

[그림 4.8] 배치전문 스케쥴 변경 ................................................................................................. 46

[그림 5.1] 날짜별 통계 조회 ........................................................................................................ 49

[그림 5.2] 에러코드 확인 ............................................................................................................ 49

[그림 5.3] Excel에 붙여넣기 ....................................................................................................... 51

[그림 5.4] 항목별 통계 조회 ........................................................................................................ 51

[그림 5.5] 집계 데몬 스케쥴 설정 ................................................................................................ 53

[그림 6.1] 컴포넌트 트리 ............................................................................................................ 55

[그림 6.2] Tmax 서버 다운 통지 .................................................................................................. 56

AnyLink vii

[그림 6.3] 정보 복제 .................................................................................................................. 57

[그림 6.4] 노드 추가 .................................................................................................................. 58

[그림 6.5] 노드 수정 및 삭제 ....................................................................................................... 59

[그림 6.6] 노드 모니터링 ............................................................................................................ 60

[그림 6.7] 게이트웨이 추가 ........................................................................................................ 61

[그림 6.8] MQ 게이트웨이 추가 .................................................................................................. 67

[그림 6.9] 게이트웨이 수정 및 삭제 ............................................................................................. 68

[그림 6.10] 게이트웨이 모니터링 ................................................................................................ 69

[그림 6.11] 회선 추가 후 재기동 메시지 ...................................................................................... 70

[그림 6.12] 회선 추가 및 기관-업무 회선 연결 .............................................................................. 71

[그림 6.13] IMS Connect 항목 .................................................................................................... 75

[그림 6.14] MQ 게이트웨이 회선 추가 ......................................................................................... 76

[그림 6.15] URL 추가 ................................................................................................................. 77

[그림 6.16] 회선 수정 및 삭제 ..................................................................................................... 79

[그림 6.17] 회선 중지 및 재개 ..................................................................................................... 80

[그림 6.18] 회선 접근 제어 ......................................................................................................... 80

[그림 6.19] 접근 제어 회선 추가 ................................................................................................. 81

[그림 6.20] 기관-업무 보기 ......................................................................................................... 81

[그림 6.21] 회선 모니터링 .......................................................................................................... 82

[그림 6.22] X.25 회선 상태 통지 ................................................................................................. 83

[그림 6.23] Mapper 추가 ............................................................................................................ 84

[그림 6.24] Mapper 수정 및 삭제 ................................................................................................ 87

[그림 6.25] Mapper 상태 모니터링 .............................................................................................. 88

[그림 6.26] Mapper Thread 모니터링 .......................................................................................... 89

[그림 7.1] 기관-업무 회선 브라우저 ............................................................................................ 91

[그림 7.2] 회선 연결 추가 ........................................................................................................... 92

[그림 7.3] 업무/거래 제어 ........................................................................................................... 93

[그림 7.4] 업무/거래 제어 – 중단 조건 입력 ................................................................................. 94

[그림 7.5] 사용자 추가 ............................................................................................................... 95

[그림 7.6] 사용자 정보 수정 ........................................................................................................ 96

[그림 7.7] 역할 관리 .................................................................................................................. 97

[그림 7.8] 역할 추가 .................................................................................................................. 97

[그림 7.9] 로그인 이력 조회 ........................................................................................................ 99

[그림 7.10] 변경 이력 조회 ....................................................................................................... 100

[그림 7.11] 시스템 속성 추가 .................................................................................................... 104

[그림 7.12] 통신망 상태 조회 .................................................................................................... 105

[그림 7.13] 통신망 상태 수정 .................................................................................................... 107

[그림 7.14] 게이트웨이 검색 ..................................................................................................... 107

[그림 7.15] 회선 검색 ............................................................................................................... 108

[그림 7.16] 채번 조회 ............................................................................................................... 108

[그림 7.17] 결번 조회 ............................................................................................................... 110

[그림 B.1] 회선 등록 (1) ........................................................................................................... 118

[그림 B.2] 회선 등록 (2) ........................................................................................................... 118

viii AnyLink Admin 안내서

[그림 B.3] 기관-업무 설정 (1) .................................................................................................... 119

[그림 B.4] 기관-업무 설정 (2) .................................................................................................... 120

AnyLink ix

안내서에 대하여

안내서의 대상

본 안내서는 Tmax AnyLink® (이하 AnyLink)의 관리 모듈(이하 Admin)에 대해서 다루고 있다.

따라서 일반 사용자가 아닌, 게이트웨이, 회선 등을 모니터링하거나 운영전문을 발송하는 등의 역할을 담

당하는 시스템 관리자를 대상으로 한다.

안내서의 전제 조건

본 안내서를 이해하기 위해서는 JEUS와 Tmax에 대한 기본적인 이해가 필요하다.

참고

JEUS와 Tmax에 대한 기본적인 이해를 위해 JEUS 매뉴얼과 Tmax 매뉴얼을 참고한다.

안내서에 대하여 xi

안내서 구성

본 안내서는 총 7개의 장과 2개의 Appendix로 구성되어 있다.

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

● 제1장: AnyLink Admin 개요

AnyLink Admin의 구성 및 기능에 대해 설명한다.

● 제2장: Admin 구동

AnyLink Admin을 구동하기 위한 설정과 Admin의 구성 및 구조에 대해 설명한다.

● 제3장: 로그 조회

AnyLink Admin의 로그 조회 기능에 대해 설명한다.

● 제4장: 전문 발송

AnyLink Admin의 전문 발송 메뉴에 대해 설명한다.

● 제5장: 통계 조회

AnyLink Admin의 통계 조회 메뉴에 대해 설명한다.

● 제6장: 시스템 컴포넌트 관리

AnyLink Admin의 각 시스템 컴포넌트별 등록 및 관리 방법에 대해 설명한다.

● 제7장: 도구

AnyLink Admin의 도구 메뉴에 대해 설명한다.

● Appendix.A: 오류 메시지 및 조치 방법

Admin을 사용할 때 발생할 수 있는 에러 메시지와 그 해결 정보를 설명한다.

● Appendix.B: 기관-업무의 Inbound URL 공유

기관-업무의 Inbound URL을 공유하는 방법에 대해 설명한다.

xii AnyLink Admin 안내서

안내서 규약

의미표기

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

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

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

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

강조진하게

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

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

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

메뉴의 진행 순서>

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

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

참고 또는 주의사항참고

그림 이름[그림 1.1]

표 이름[표 1.1]

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

안내서에 대하여 xiii

시스템 사용 환경

요구 사항

Microsoft Windows 2000/XP/2003/NT/VistaPlatform

Solaris

HP-UX

AIX

Linux

512MB 이상 메모리 공간 권장Hardware

500MB 이상 하드디스크 공간 필요

5.0 Update 4(JDK 1.5.0_12) 이상JDK

Oracle 9i 또는 10gDatabase

Tibero

DB2

xiv AnyLink Admin 안내서

관련 안내서

설명안내서

AnyLink 배치 게이트웨이 대한 소개와 배치 스타일에 따른 스튜디오와

Admin을 사용한 등록 방법에 대해 설명한 안내서이다.

AnyLink

배치 안내서

AnyLink 서버 컴포넌트의 각 기능 및 사용 방법에 대해 설명한 안내서이

다.

AnyLink

서버 안내서

AnyLink 스튜디오의 구성 및 기능에 대해 설명하고, 사용 방법에 대해

설명한 안내서이다.

AnyLink

스튜디오 안내서

AnyLink Online 게이트웨이의 구조 및 용도에 대해 설명하고, 각 게이트

웨이별 설정 방법에 대해 설명한 안내서이다.

AnyLink

Online 게이트웨이 안내서

참고자료

● JEUS 매뉴얼

● Tmax 매뉴얼

안내서에 대하여 xv

연락처

Korea

TmaxSoft Co., Ltd

272-6, 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

xvi AnyLink Admin 안내서

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

안내서에 대하여 xvii

http://www.tmaxchina.com.cn

제1장 AnyLink Admin 개요

본 장에서는 Admin의 구성 및 기능에 대해 설명한다.

1.1. 개요AnyLink는 다양한 대내외 채널을 통해 전달되는 정보를 프로토콜, 전문 및 코드변환을 통해 하나로 통합

함으로써 대외 연계 및 내부 시스템간 연동을 지원하는 채널 통합 솔루션이다. AnyLink는 채널을 담당하

는 게이트웨이, 데이터베이스 접근을 위한 ADM과 컴포넌트 관리를 위한 AMM 등의 서버/서비스, 전문 및

코드변환을 수행하는 Mapper 그리고 툴(Studio와 Admin)로 구성된다.

[그림 1.1] AnyLink 구성

AnyLink Admin(Administrator, 이하 Admin)은 AnyLink를 구성하는 툴 중 AnyLink 시스템의 전반적인 관리

및 운영을 위한 목적으로 시스템 관리자에 의해 사용되는 GUI 콘솔로서 일반 업무 개발자들이 사용하는

AnyLink Studio와 구분된다. Admin은 AnyLink 구성요소 중 게이트웨이, Mapper를 관리하게 되며 ADM,

AMM, 스케쥴러 서비스를 이용해 정보 설정, 상태 통지 및 모니터링, 전문 발송 등의 기능을 수행한다.

제1장 AnyLink Admin 개요 1

1.2. Admin의 기능시스템 관리자는 Admin을 통해 시스템 컴포넌트의 관리/모니터링 및 로그/통계 조회 등의 관리 업무를 주

로 수행한다.

Admin에서는 다음과 같은 기능을 제공한다.

● 로그 조회

AnyLink에서 처리된 온라인/배치 거래에 대한 목록 및 상세 조회와 스케쥴러 수행 결과를 조회한다. 로

그 조회 기능에 대한 자세한 내용은 “제3장 로그 조회”를 참고한다.

● 전문 발송

대외기관과의 거래를 위한 운영전문 등록 및 스케쥴에 의해 전문을 발송한다. 전문 발송 기능에 대한 자

세한 내용은 “제4장 전문 발송”을 참고한다.

● 통계 조회

AnyLink에서 처리된 거래에 대한 날짜별/항목별 통계를 조회한다. 통계 조회 기능에 대한 자세한 내용

은 “제5장 통계 조회”를 참고한다.

● 시스템 컴포넌트 관리 및 모니터링

노드(서버), 게이트웨이/회선, Mapper의 관리 및 실시간 모니터링이 가능하고, 그 결과를 통지한다. 시

스템 컴포넌트 관리 및 모니터링 기능에 대한 자세한 내용은 “제6장 시스템 컴포넌트 관리”를 참고한다.

● 기타 관리

사용자 관리, 시스템 속성 관리, 변경이력 조회 등의 기능을 제공한다.

2 AnyLink Admin 안내서

제2장 Admin 구동

본 장에서는 Admin을 구동하기 위한 설정과 Admin의 구성 및 구조에 대해 설명한다.

2.1. 구동 스크립트 설명Admin 구동은 설치 후 bin 디렉터리의 aladmin.bat 파일을 통해 가능하다.

중요한 환경변수(구동 스크립트의 환경변수)는 다음과 같다.

설명환경변수

JDK 홈 디렉터리이다.JAVA_HOME

JDK 1.6 이상의 버전이 필요하다.

Admin 홈 디렉터리이다.AL_ADMIN_HOME

$AL_ADMIN_HOME/logs 디렉터리에 로그 파일이 생성된다. 로그 파일

명은 aladmin.log이며 하루 단위로 Archiving된다.

예 : aladmin.log.2006-01-10

Admin이 WebT를 통해 접속할 Tmax 서버의 IP 주소이다.ALSERVER_IP

anylink.m 파일의 TPORTNO 항목과 동일하다.

Admin이 WebT를 통해 접속할 Tmax 서버의 포트 번호이다.ALSERVER_PORT

anylink.m 파일의 TPORTNO 항목과 동일하다.

백업 Tmax 서버의 IP 주소이다.ALBACKUP_IP

백업 Tmax 서버의 포트 번호이다.ALBACKUP_PORT

IP 노출에 대한 보안 요건 혹은 IP 일괄 변경의 편의를 위해 IP를 구동 스

크립트에 설정하는 대신 DNS(DNS 서버 혹은 hosts 파일)로부터 얻을 수

있다.

ALSERVER_HOSTNAME

다음과 같이 ALSERVER_HOSTNAME 속성에 서버 호스트명을 설정한

다. 단, ALSERVER_IP 속성이 있으면 IP가 우선적으로 적용된다.

예: -DALSERVER_HOSTNAME=ibm5l

데이터소스를 얻기 위한 InitialContext 팩토리 클래스이다. (jeus.jn

di.JEUSContextFactory)

INITIAL_CONTEXT_FACTO

RY

Admin은 WebT를 통해 Tmax 서버와 연결되지 않으면 구동되지 않는다. 단, Tmax 서버와 연결된 상태에

서 연결이 끊어진 경우 1분마다 서버 재접속을 시도하게 된다. 이 동안은 정보 디플로이를 감지할 수 없어

제2장 Admin 구동 3

로컬 캐시 및 UI(Admin의 System Tree Browser 등) 갱신이 되지 않고, 게이트웨이나 회선 등의 상태를 파

악할 수 없다. 재접속 시도 중 서버가 재구동되면 WebT 이벤트 연결을 다시 맺게 되고 이후 디플로이 및

디플로이된 정보 혹은 시스템 상태에 대한 통지를 받는 것이 가능하다.

WebT 연결을 위한 IP 주소 및 포트 번호를 찾는 순서는 다음과 같다.

1. webt.properties

Admin을 구동할 때 –classpath 옵션에 설정한 클래스패스에 위치하고 'anylink' 그룹이 등록되어 있으

면 된다.

2. 시스템 속성

구동시 -D 옵션으로 설정되는 값으로, 다음과 같다. WebtEventConnection 연결을 위해서도 사용되므

로 반드시 설정되어야 한다.

● -DALSERVER_IP

● -DALSERVER_PORT

● -DALBACKUP_IP

● -DALBACKUP_PORT

3. webt.properties 파일이 존재하지 않고 시스템 속성이 설정되지 않은 경우 IP는 localhost, 포트는 '8811'로

설정된다.

2.1.1. 국제화

Admin 및 스튜디오의 경우 국제화(il8n;internationalization)를 지원하도록 UI 및 메시지가 구성되어 있다.

현재 지원하는 언어는 한국어 및 영어로서 툴을 구동하는 사용자 PC의 locale에 따라 해당 언어로 표시된

다. 강제로 locale 설정을 원할 경우에는 user.country 및 user.language 시스템 속성을 이용할 수 있다.

다음은 영어로 설정하는 예이다.

java –Duser.language=en –Duser.country=US …

anylink.admin. console.Main

2.2. 환경설정 파일환경 설정 파일은 aladmin.properties로서 구동 스크립트의 AL_ADMIN_HOME 속성에 정의된 디렉터리

에 위치한다.

환경 설정 파일에서 정의되는 속성은 다음과 같다.

#------------------------------

# aladmin.properties

#------------------------------

# Install Date : Thu Apr 22 14:19:57 GMT 2010


# 로그 조회: Rows per page

LogView.online.pageSize = 20

# 로그 조회: Screen size of page navigator

LogView.online.screenSize = 10

# 이름 표시 우선 순위

display.codeFirst = true

# 회선 모니터링 Chart Max (Total)

monitoring.gauge.total.max = 10000000

# 회선 모니터링 Chart Max (Day)

monitoring.gauge.day.max = 5000000

# 회선 모니터링 갱신 주기 (초)

monitoring.refresh.interval = 10

# 로그 조회: Custom log table information

LogView.custom.table.info = AL_EBR0_EBR1_1:ALHDRSNDDATE(전문고유번호)

# WebtEventConnection Queue Size

webt.event.queue.size = 10

2.2.1. 화면 설정

화면과 관련된 설정 항목은 다음과 같다.

설명항목

온라인 로그를 조회할 때 페이지당 표시할 레코드 개수를 설정한다.LogView.online.pageSize

(기본값: 20)

온라인 로그를 조회할 때 페이지 navigation 부분에 표시할 번호 개수를

설정한다. (기본값: 10)

LogView.online.screenSize

콤보박스나 로그 조회에 표시되는 기관, 업무, 종별, 거래코드 및 이름

표시에 대한 옵션으로서 'true'인 경우 '코드 (이름)', 'false'인 경우 '이름

(코드)' 형태로 표시한다. (기본값: true)

display.codeFirst

2.2.2. 모니터링 설정

모니터링과 관련된 설정 항목은 다음과 같다.

설명항목

회선 모니터링 차트의 전체 최댓값을 설정한다.monitoring.gauge.total.max

회선 모니터링 차트의 당일 최댓값을 설정한다.monitoring.gauge.day.max


설명항목

모니터링 정보 자동 갱신을 위한 주기를 설정한다. (단위: 초)monitoring.refresh.interval

노드, 게이트웨이, 회선 및 Mapper의 [제어 & 모니터링] 탭에서 적용되

며 AMM을 주기적으로 호출(polling)하여 모니터링 정보를 자동으로 갱

신한다.

2.2.3. 커스텀 로그 조회 설정

커스텀 로그 조회 설정 항목은 다음과 같다.

설명항목

커스텀 로그 조회(Property) 기능을 사용하기 위해서 "Table명:필드명

(한글명 또는 설명)" 형식으로 설정한다.

LogView.custom.table.info

– Table명 : 사용자가 추가한 커스텀 로그 Table명

– 필드명 : 전문의 필드 중 사용자가 검색할 때 사용할 필드명

– 예 : <Table명1>:<필드명1(한글명)>,<필드명2(한글명)>!<Table명2>:<

필드명1(한글명)>,<필드명2(한글명)>

사용자가 추가한 커스텀 로그 Table이 여러 개일 경우에는 속성을 입력

할 때 '!'를 구분자로 사용하고, 필드는 콤마(',')를 구분자로 사용한다

'한글명' 혹은 '설명'을 필드명 뒤에 괄호로 묶어서 사용한다. '한글명'은

없어도 상관없지만 '필드명'은 반드시 있어야 한다.

2.2.4. 기타 설정

기타 설정 항목은 다음과 같다.

설명항목

서버로부터의 통지를 받기 위한 WebtEventConnection의 큐 크기를 설

정한다. (기본값: 10)

webt.event.queue.size

tmdown –g 등의 명령으로 이벤트가 동시에 많이 오는 경우 큐 크기가

충분하지 않으면 이벤트 누락이 발생할 수 있으므로 서버 환경에 따라

적절히 설정한다.

2.3. 로그인 및 종료본 절에서는 Admin의 로그인 및 종료 방법에 대해 설명한다.


2.3.1. 사용자 역할에 따른 로그인

Admin은 로그인한 사용자 역할에 따라 접근 가능한 메뉴를 제어함으로써 권한을 관리하고 있다.

Admin 구동 후 다음과 같은 로그인 대화상자가 표시되면 '사용자'를 콤보박스에서 선택하고, '암호'를 입

력한다.

[그림 2.1] 로그인

로그인 가능한 사용자 정보는 다음과 같다.

권한초기 암호사용자(역할)

관리자 권한을 갖고, 모든 메뉴에 접근이 가능하다.user_rootroot

시스템 관리자 권한을 갖고, 시스템 컴포넌트 관리, 로그 및 통계 조

회, 전문 발송, 통신망 상태 조회 메뉴만 접근이 가능하다.

user_sysmgrsysmgr

로그 및 통계 조회 메뉴만 접근이 가능하다.user_guestguest

참고

서버 DB로 gdbm을 사용할 때는 로그인 사용자로 'root'만이 사용되며, 암호는 변경에 관계없이 항상

'user_root'를 사용함에 유의한다. 온라인 로그 조회, 통계 조회, 변경이력 조회, 채번 조회, 결번 조회

기능을 사용할 수 없다.

2.3.2. 자동 로그인

로그인 대화상자를 거치지 않고 시스템 속성으로부터 직접 로그인 정보를 받는 기능이다.

테스트용, 혹은 별도의 launcher를 이용한 툴 구동의 경우에 유용하게 사용될 수 있으며, 다음과 같이 설

정한다.

java ... -DALLogin.user = root -DALLogin.passwd = 1 anylink.admin.console.Main

설명항목

사용자 ID를 설정한다.ALLogin.user

사용자 암호를 설정한다.ALLogin.passwd


2.3.3. 기타 로그인 기능

본 절에서는 3DES 암호화, 로그인 최대 오류 횟수 지정, 사용자 암호 변경 주기 설정, 사용자 관리 메뉴 제

어 등의 기타 로그인과 관련된 기능에 대해 설명한다.

다음은 시스템 속성 관리 화면이다. Admin의 [Tools] 메뉴를 통해 접근할 수 있다.

[그림 2.2] 시스템 속성 관리

3DES 암호화

Base64 인코딩 외 3DES 암호화를 지원한다(JCE 1.2.2 이용).

암호화 알고리즘은 '시스템 속성'의 'tool.login.encryption_type'에 '3des' 혹은 'base64'를 설정함으로써

가능하다(지정하지 않을 경우 Base64 인코딩 사용).

암호화 알고리즘을 변경할 경우 현재 로그인 사용자의 암호도 선택된 알고리즘으로 Encryption된다.

[그림 2.3] 3DES 암호화


로그인 최대 오류 횟수 지정

로그인 에러에 대한 최대오류 횟수 설정을 통해 오류 횟수를 초과할 경우 사용자 Lock을 설정할 수 있다.

최대 오류 횟수는 시스템 속성의 'tool.login.max_retry_cnt'로 설정하며, 오류 횟수는 각 사용자에 대해

툴이 구동된 동안 누적된다. Lock이 설정된 사용자는 시스템 관리자에게 초기화(암호 재설정)를 요청해야

한다.

로그인 최대 오류 횟수 초과의 경우 다음과 같은 에러 메시지 화면이 나타난다.

[그림 2.4] 로그인 최대 오류 횟수 초과

사용자 암호 변경 주기 설정

사용자의 최종 암호 변경일이 설정된 주기보다 오래된 경우 경고하는 기능이다.

사용자 암호 변경 주기를 설정하려면 시스템 속성의 'tool.login.pwd_change_interval'에 변경 주기(일)

를 설정한다.

[그림 2.5] 사용자 암호 변경 주기 설정

사용자 관리 메뉴 제어

별도의 사용자 관리 툴을 이용하는 경우 Admin의 사용자 관리 메뉴를 disable 시킬 수 있는 기능이다. 단,

'root' 사용자에는 영향을 주지 않는다.

'시스템 속성'의 'tool.admin.menu.disabled'에 '32768'을 설정한다.

2.3.4. 종료

Admin을 종료하려면 [파일] > [종료] 메뉴를 선택한다.


2.4. Admin 구성본 절에서는 Admin의 화면 구성과 구조에 대해 설명한다.

2.4.1. 전체 화면 구성

다음은 Admin 메인 화면이다.

[그림 2.6] 전체 화면 구성

Admin 화면은 시스템 브라우저, 기관-업무 회선 브라우저, 워크스페이스(workspace), 이벤트 브라우저의

4부분으로 구성된다.

● 시스템 브라우저(1)

시스템 컴포넌트인 노드, 게이트웨이, 회선, Mapper를 계층적으로 표시하는 브라우저로서 이를 통해

각 컴포넌트의 현재 상태를 실시간으로 확인할 수 있고 팝업 메뉴로써 컴포넌트 추가도 가능하다.

● 기관-업무 회선 브라우저(2)

대외기관에서 전문이 특정 회선을 통해 들어왔을 때 해당 회선과 연결된 기관-업무 정보를 알아야 게이

트웨이에서 전문 처리가 가능하다. 이를 위해 회선 추가 시 혹은 [Tools] > [기관-업무 회선] 메뉴를 통

해 기관-업무와 회선을 연결하게 되며 이 브라우저를 통해 연결 정보를 확인할 수 있다. 노드는 "코드[이

름]" 형태로 정렬되어 표시된다.


● 워크스페이스(Work Space)(3)

메뉴를 선택하거나 시스템 브라우저에서 노드를 선택한 경우 주윈도우가 표시되는 영역이다.

● Event Browser(4)

게이트웨이/회선 다운(down) 및 스케쥴 작업 실패 현황을 보여주는 브라우저이다. 게이트웨이 다운은

서버 관리자가 게이트웨이 서버를 내리거나 재부팅한 경우 발생하고, 회선 다운은 물리적으로 네트워

크 연결이 끊어진 경우 혹은 회선 정보 수정 시 세션 수를 줄이거나 IP주소나 포트 번호를 변경할 때 발

생한다. 스케쥴 작업 실패는 등록된 스케쥴에 따라 스케쥴러가 운영 혹은 배치전문 발송 수행 시 에러가

발생한 경우이다.

Event Browser의 각 아이콘에 대한 설명은 다음과 같다.

설명항목

Event Browser를 열고 닫을 수 있다.,

메시지(이벤트) 전체를 삭제한다.

이벤트 발생을 표시한다.

이벤트 삭제를 표시한다.

각 이벤트를 삭제한다.

이벤트 상세 정보를 표시한다.

다음은 스케쥴 작업 실패에 대한 상세 보기의 예이다.

● 타이틀 바와 상태 바

타이틀 바와 상태 바에는 서버 접속 정보가 표시된다. 타이틀 바에는 아래와 같이 Admin 타이틀과 Admin

이 접속한 Tmax 서버의 IP 및 포트 정보가 표시된다.


[그림 2.7] 타이틀 바

상태 바의 오른쪽에는 서버 연결 상태 아이콘이 표시되며 툴팁으로 서버 접속 정보를 표시한다.

– 서버와 연결된 상태

– 서버와 연결이 끊긴 상태

– 서버 접속 정보

2.4.2. Admin 구조

Admin은 Tmax 서버(Tmax에 구동된 AnyLink 서버 및 서비스)와 연결되어 동작한다.

Admin과 스튜디오, 서버의 관계를 나타내면 다음과 같다.

[그림 2.8] Admin-스튜디오-서버 관계도


로그 및 통계 조회를 제외한 데이터베이스 접근(데이터의 추가, 수정, 삭제, 조회)은 ADM(AnyLink Deploy

Manager)을 이용하고, 서버 컴포넌트 상태 정보는 AMM(AnyLink Monitoring Manager)으로부터 얻는다.

● Data Gateway

WebT를 통해 ADM과 연결한다.

로컬 파일 시스템을 유지하지 않기 때문에 시스템 컴포넌트의 추가, 수정, 삭제는 수행 즉시 서버 데이

터베이스에 반영된다. 사용자가 UI에 정보를 입력한 후 추가, 수정 등을 수행하면 Data Gateway는 ADM

서비스 호출을 통해 데이터베이스에 해당 정보를 반영한다.

● Event Listener

AMM으로부터 데이터 변경 및 시스템 컴포넌트 상태에 대한 통지(notification)를 받는 것으로 디플로이

이벤트에 대한 통지는 'alinkdeploy' 사용자 채널로, 컴포넌트 상태 이벤트에 대한 통지는 'alinkadmin' 사

용자 채널로 받는다.

통지를 받으면 캐시를 업데이트하고 UI에 반영(시스템 컴포넌트 브라우저에서의 실시간 컴포넌트 상태

표시나 스케쥴러를 통해 수행된 작업 실패에 대한 통지)한다.

● Cache

데이터 캐시로, Admin을 구동할 때 기관, 업무, 시스템 컴포넌트 정보 등을 ADM으로부터 로컬 캐시에

보관하고 Event Listener로부터 업데이트된다.

로그 및 통계 정보와 같은 실시간 조회성의 정보가 아닌 기관, 업무, 시스템 컴포넌트 정보 등은 데이터

캐시로부터 읽어 UI에 표시된다.

● User Interface

사용자에게 정보를 표시하거나 입력을 받는 인터페이스로, 데이터베이스의 해당 컬럼 크기 및 유형에

맞는 입력을 위해 최대 길이 및 숫자 체크(numeric 정보에 대해서는 숫자 이외의 값은 입력되지 않도록

함)를 지원한다.


제3장 로그 조회

본 장에서는 AnyLink Admin의 로그 조회 기능에 대해 설명한다.

3.1. 온라인 로그 조회일반적인 온라인 거래의 경우 'Gateway 요청입력', 'Mapper 요청입력', '매핑 후 Mapper 요청출력', 'Gateway

요청 출력' , 'Gateway 응답 입력' , 'Mapper 응답입력', 'Mapper 응답출력', 'Gateway 응답출력'의 여덟 구

간에서 마스터 로그가 기록된다(스튜디오의 'DB 로깅' 플래그 설정이 된 경우).

마스터 로그는 시간, 기관/업무/종별/거래코드 등의 정보 및 전문 데이터와 에러코드를 갖기 때문에 시간,

기관/업무/종별/거래코드로서 검색이 가능하고 전문 상세를 볼 수 있다. 전문 필드의 특정 값으로 검색을

원할 때는 커스텀 로그를 사용할 수 있다.

3.1.1. 마스터 로그 조회

스튜디오의 ‘DB 로깅’ 플래그 설정이 된 경우 전문이 들어와서(요청입력) 매핑이 되고(요청출력) 비즈니스

서비스를 호출한 후(응답입력) 매핑되어 응답으로 보내지는(응답출력) 각 과정에서 마스터 로그가 파일

및 데이터베이스에 기록된다. 데이터베이스에 기록된 마스터 로그를 볼 수 있는 화면이다.

[로그 조회] > [온라인 전문 로그] 메뉴를 선택(혹은 <CTRL> + 1 단축키 사용)한 후 검색 조건을 입력하고

[조회] 버튼을 클릭한다. 콤보박스를 통해 조회할 페이지를 지정하고 [조회] 버튼을 클릭하거나 하단의 페

이지 내비게이션 패널을 통해 원하는 페이지로의 이동도 가능하다.

다음은 온라인전문 로그의 [마스터 로그 조회] 탭 화면이다.

[그림 3.1] 온라인 마스터 로그 조회

제3장 로그 조회 15

● 검색 조건

[마스터 로그 조회] 탭 화면에서 검색 조건 영역의 입력 항목은 다음과 같다.

설명항목

조회할 기관명을 선택한다.기관

기관을 선택하면 해당 기관의 모든 온라인 업무가 자동으로 콤보박스에 표시되며,

기관을 선택하지 않고 업무만으로 조회할 수도 있다.

조회할 업무명을 선택한다.업무

조회할 종별코드를 선택한다.종별코드

콤보박스에 직접 거래코드를 입력하여 조회 가능하다.거래코드

데이터를 조회할 시작 일자이다.시작 일자

[Set] 버튼을 클릭한 후 캘린더를 통해 입력할 수 있다.

[하루 전], [일주일 전], [한달 전] 버튼을 이용하여 현재로부터 하루, 일주일, 한달

전 일자를 자동 입력할 수도 있다.

데이터를 조회할 종료 일자로, '시작 일자' 입력과 동일하게 입력한다.종료 일자

조회할 구간을 선택한다.구간

– 전체

– Gateway 요청입력

– Gateway 응답입력

– Mapper 요청입력

– Mapper 응답입력

– Mapper 요청출력

– Mapper 응답출력

– Gateway 요청출력

– Gateway 응답출력

종료 조건을 선택한다.종료 조건

– 전체

– 완료

– 미완료(단방향 포함)

– 오류

– 미완료(단방향 포함)+오류

● 마스터 로그 목록

검색 조건을 입력하고 [조회] 버튼을 클릭하면 조건에 맞는 마스터 로그가 조회된다. 조회 결과의 각 컬

럼에 대한 설명은 다음과 같다.


설명컬럼명

로그 기록 일시로, '연/월/일 시:분:초,milliseconds' 형태로 표시된다.처리 일시

처리 일시 컬럼에 마우스를 대면 log_id를 툴팁으로 확인할 수 있다.

log_id는 요청출력 ~ 응답입력까지 하나의 트랜잭션에 대해 동일한 ID로, '일자(8)

시간(6)마이크로초(6)프로세스 ID(6)노드 ID(2)'의 28자리로 구성된다.

조회된 로그의 기관코드를 나타낸다.기관코드

조회된 로그의 업무코드를 나타낸다.업무코드

조회된 로그의 종별코드를 나타낸다.종별코드

조회된 로그의 거래구분코드를 나타낸다.거래구분코드

처리구간을 나타낸다.처리구간

E(External), A(AnyLink), I(Internal)로 다음과 같이 표시된다.

– : Gateway 요청 입력 (변환 전)

– : Mapper 요청 입력 (변환 전)

– : Mapper 요청 출력 (변환 후)

– : Gateway 요청 출력 (변환 후)

– : Gateway 응답 입력 (변환 전)

– : Mapper 응답 입력 (변환 전)

– : Mapper 읍답 출력 (변환 후)

– : Gateway 응답 출력 (변환 후)

에러코드를 나타내며. 각 에러코드의 의미는" AnyLink 서버 안내서"를 참조한다.Error Code

거래 시작 후 소요된 누적시간을 나타낸다(단위: milliseconds).처리 시간 (ms)

예를 들어, 대외계로부터의 거래에 대해 '응답 (변환 전)' 처리 구간의 처리시간은

거래가 Mapper로 들어와 요청 매핑을 거친 후 비즈니스 서비스가 호출되어 응답

을 받은 때까지의 시간을 의미한다.

2PC(phase-commit) 거래에 대한 XID(transaction id)를 나타낸다.XID

2PC 거래에 대한 트랜잭션 상태를 나타낸다.TX 상태

– prepare : Prepare 트랜잭션의 상태

– commit : 2-phase commit 트랜잭션의 상태

– rollback : Rollback 트랜잭션의 상태

– commit : 1-phase commit 트랜잭션의 상태

– unregister message : Unregister reply 트랜잭션의 상태

– unregister message : Unregister error reply 트랜잭션의 상태


설명컬럼명

게이트웨이의 세션 개수에 따른 INDEX(1번 세션을 0으로 표기, 세션이 없을 경우

에는 -1 표기)

SESSION INDEX

상세 조회

목록에서 해당 항목의 '처리구간' 컬럼을 클릭하면 전문 데이터를 조회할 수 있다. 단, bypass 거래에 대해

서는 헥사 덤프(hexa dump) 형태로만 조회가 가능한데, 이는 bypass 거래가 전문 등록 없이 특정 매핑 클

래스('__BY_PASS__')로만 수행되어 전문 필드별 파싱이 불가능하기 때문이다.

● Stream 전문

Stream 전문의 경우 다음과 같이 헤더/바디로 구분되어 각 필드 정보 및 값을 표시한다.

값은 좌측 정렬로 표시되며, 회색 영역으로 값의 길이(끝)를 알 수 있다. 필드의 식별자가 'PASSWORD',

즉 암호 타입인 경우 값 대신 애스터리스크(*) 형태로 표시된다.

[그림 3.2] 상세 조회 - 스트림 전문


● XML/VO 전문

XML/VO 전문의 경우 전체 데이터를 표시(VO는 XML 형태로 변환)한다.

[그림 3.3] 상세 조회 - VO 및 XML 전문

● Bypass 매핑

매핑 없이 출력으로 그대로 넘기는 bypass 매핑의 경우 전문 정보 없이도 매핑 클래스('__BY_PASS__')

만 등록하면 수행되므로 상세 조회 시 전문 데이터를 파싱해서 보여줄 수가 없다.

따라서 bypass 매핑으로 수행된 경우 다음과 같은 Byte Stream 형태로 표시되며 [hex]버튼을 통해 헥

사 덤프(hexa dump) 형태로만 조회할 수 있다.


[그림 3.4] 상세 조회 – Bypass 매핑

3.1.2. 커스텀 로그 조회

전문의 특정 필드 별 검색을 위해 스튜디오 기관-업무 정보의 '헤더 검색항목'에 설정된 전문 공통부 필드

에 한해서 데이터베이스에 별도의 로그를 기록하게 되는데, 이를 커스텀 로그(custom log)라 한다.

[커스텀 로그 조회] 탭 화면은 이러한 커스텀 로그를 조회할 수 있는 화면으로 다음의 3가지가 전제되어야

한다.

● '헤더 검색항목' 설정

스튜디오 기관-업무 정보의 '헤더 검색항목' 설정을 통해 커스텀 로그를 남길 필드를 지정해야 한다.

참고

자세한 내용은 " AnyLink 스튜디오 안내서"의 '헤더 검색항목 설정' 부분을 참조한다.

● 테이블 생성

커스텀 로그는 기관-업무별로 별도의 테이블에 저장된다. 따라서 위에서 설정한 정보에 따라 새로운 테

이블이 생성되어야 한다.

스튜디오의 [도구] > [DDL 생성] 메뉴를 통해 테이블에 대한 SQL 스크립트를 작성한 후 해당 스크립트

를 수행하여 직접 데이터베이스에 생성해야 하는 방식이다.

참고

자세한 내용은 " AnyLink 스튜디오 안내서"를 참조한다.

● 'DB 로깅' 플래그 설정

스튜디오의 기관-업무 혹은 거래 정보에서 'DB 로깅' 플래그가 'Yes'로 설정되어 있어야 한다.

커스텀 로그를 조회하려면 [로그 조회] > [온라인 전문 로그] 메뉴를 선택한 후 [커스텀 로그 조회] 탭에서

검색 조건을 입력하고 [조회] 버튼을 클릭한다.

기관 및 업무를 콤보박스에서 선택하면 기관-업무의 헤더 검색항목 설정에 따라 필드 검색을 위한 추가적

인 검색 조건(필드 타입이 숫자일 경우 범위 검색을, 문자열일 경우 일치 검색을 위한 텍스트박스)이 표시


된다. 콤보박스를 통해 조회할 페이지를 지정하고 [조회] 버튼을 클릭하거나 하단의 페이지 navigation 패

널을 통해 원하는 페이지로의 이동도 가능하다.

[그림 3.5] 온라인 커스텀 로그 조회

● 검색 조건

[커스텀 로그 조회] 탭 화면에서 검색 조건 영역의 입력 항목은 다음과 같다.

설명항목


기관을 선택하면 해당 기관의 모든 온라인 업무가 자동으로 콤보박스에 표시된다.

기관을 선택하면 스튜디오의 '헤더 검색항목' 설정에 따라 필드값 검색을 위한 추

가 검색 필드가 표시된다. 필드 타입이 숫자일 경우 범위 검색을 위한 값을 입력하

고 문자열일 경우 일치 검색을 위한 값을 입력한다.


'업무' 항목을 선택하면 '헤더 검색항목' 설정에 따라 필드 값 검색을 위한 추가 검

색 필드가 표시된다. 필드 타입이 숫자일 경우 범위 검색을 위한 값을 입력하고 문

자열일 경우 일치 검색을 위한 값을 입력한다.

조회할 종별코드를 선택한다.종별코드

조회할 거래구분코드를 선택한다.거래코드

데이터를 조회할 시작 일자이다.시작일자,

[Set]버튼을 클릭한 후 캘린더를 통해 입력할 수 있다.종료일자


전 일자를 자동 입력할 수 있다.


설명항목

종료 조건을 선택한다.종료 조건

– 전체

– 완료

– 미완료(단방향 포함)

– 오류

– 미완료(단방향 포함)+오류

조회할 부분(구간)을 선택한다.외부헤더 검색,

내부헤더 – 외부헤더 : 대외기관과의 연결 부분 즉, 요청입력과 응답출력을 의미

– 내부헤더 : 요청출력과 응답입력을 의미

트랜잭션이란 요청 입력, 요청 출력, 응답 입력, 응답 출력이라는 거래 일련의 흐

름을 하나로 본 것이다.

트랜잭션 단위

트랜잭션 단위로 조회하고 싶은 경우 체크박스를 선택하면 검색 조건에 해당하는

전문과 같은 트랜잭션에 속한 전문들까지 선택된다.

● 로그 목록

검색 조건을 입력하고 [조회] 버튼을 클릭하면 조건에 맞는 커스텀 로그가 조회된다. 조회 결과의 각 컬

럼에 대한 설명은 “3.1.1. 마스터 로그 조회”의 항목 설명을 참조한다.

3.1.3. 에러 로그 조회

게이트웨이 및 Mapper에서 로깅하는 에러 정보(기존의 파일 로깅을 데이터베이스에 기록)에 대한 조회가

가능하다.

마스터 로그 및 커스텀 로그와 마찬가지로 JDBC로 직접 데이터베이스 연결하기 때문에 aladmin.properties

파일의 데이터베이스 연결 속성을 확인한 후 [로그 조회] > [온라인전문 로그] > [에러 로그 조회] 탭을 선

택한다.


[그림 3.6] 에러 로그 조회

● 검색 조건

[에러 로그 조회] 탭 화면에서 검색 조건 영역의 입력 항목은 다음과 같다.

설명항목

데이터를 조회할 시작 일자이다.시작 일자

[Set] 버튼을 클릭한 후 캘린더를 통해 입력할 수 있다.

데이터를 조회할 종료 일자이다. '시작 일자' 입력과 동일하게 입력한다.종료 일자

에러 코드를 입력한다.Error Code

게이트웨이 혹은 Mapper명을 입력한다(like 검색 지원).서버명

● 로그 목록

검색 조건을 입력하고 [조회] 버튼을 클릭하면 에러 로그가 조회된다. 조회 결과의 각 컬럼에 대한 설명

은 다음과 같다.

설명컬럼명

로그 기록 일시로, '연/월/일 시:분:초,milliseconds' 형태로 표시된다.처리 일시

에러 코드이다. JavaMapper의 경우 AnyLinkException에 정의된 값이고, CMapper

및 게이트웨이는 해당 매뉴얼을 참조한다.

Error Code

– 0 : 정상

– 1 이상 : 에러

서버(게이트웨이/Mapper)가 실행되는 노드명이 표시된다.노드명

대내외 구분을 나타낸다.대내외구분


설명컬럼명

– External : External 게이트웨이

– Internal : Internal 게이트웨이

– CMapper : CMapper

– JMapper : JavaMapper

게이트웨이 혹은 Mapper명을 나타낸다.서버명

거래마다 고유의 LogID가 부여되며, 거래추적에 사용된다.Log ID

상세 조회

목록에서 상세 조회할 항목을 클릭하면 다음과 같은 전문 상세보기 화면이 나타나고, 상세 조회가 가능하

다.

[그림 3.7] 에러 로그 상세 조회 (1)

[hex] 버튼을 통해 헥사 덤프 형태로 조회가 가능하며, [file]버튼을 통해 데이터를 파일에 기록할 수 있다.

파일 기록 기능은 데이터에 null byte(0x00)이 포함된 경우 클립보드에 복사는 되나 붙여넣기할 때 NULL

byte에서 잘리는 문제가 있어 이를 위해 별도의 파일에 데이터를 기록하게 한 것으로, 파일은 <AL_AD

MIN_HOME>/<Log ID>로 저장된다.

[그림 3.8] 에러 로그 상세 조회 (2)


3.2. 배치 로그 조회스튜디오에 등록된 배치 업무는 배치 게이트웨이, SOAP/ebXML 배치 등을 통해 수행되며 배치 수행의 결

과, 즉, 파일 송수신의 결과가 데이터베이스에 기록되는데, 그 결과를 조회할 수 있다.

3.2.1. 배치 전문 로그 조회

배치 전문의 로그를 조회하려면 [로그 조회] > [배치전문 로그] 메뉴를 선택하거나 <Ctrl>+2를 눌러 [배치

전문 로그 조회] 탭 화면에서 검색 조건을 입력하고 [조회] 버튼을 클릭한다.

[그림 3.9] 배치 로그 조회

● 검색 조건

[배치전문 로그 조회] 탭 화면에서 검색 조건 영역의 입력 항목은 다음과 같다.

설명항목


기관을 선택하면 해당 기관의 모든 배치 업무가 자동으로 콤보박스에 표시되며,

기관을 선택하지 않고 업무만으로 조회할 수도 있다.

'전체'로 선택한 경우 기관에 관계없이 모든 배치 로그의 조회가 가능하다.


'전체'로 선택한 경우 업무에 관계없이 모든 배치 로그의 조회가 가능하다.

송/수신 구분을 선택한다.송/수신 구분

– 전체

– 송신 : 파일을 송신한다.

– 수신 : 파일을 수신한다.


설명항목

– 연속 송신 : 파일 전송이 중간에 끊겼을 경우 이어서 전송하는 기능으로, 현재는

구현되어 있지 않다.

– 연속 수신 : 파일 전송이 중간에 끊겼을 경우 이어받는 기능으로, 현재는 구현되

어 있지 않다.

– 대표파일명 송신 : 대표파일 타입으로 송신한다.

– 대표파일명 수신 : 대표파일 타입으로 수신한다.

– 테스트 전문 송신 : 세션이 끊어 지는 것을 방지하기 위한 polling 전문을 송신한

다.

– 개시 전문 송신 : 개시 전문을 송신한다.

– 종료 전문 송신 : 종료 전문을 송신한다.

– 재개시 전문 송신 : 재개시 전문을 송신한다.

처리 구분을 선택한다.처리 구분

– 전체 :

– Pre-Processing : 전처리

– Processing : 처리 중

– Done : 처리완료

– Failed : 처리 실패

– Post-Processing : 후처리

데이터를 조회할 시작 일자와 종료 일자이다.시작 일자

[Set]버튼을 클릭한 후 캘린더를 통해 입력할 수 있다.



● 로그 목록

검색 조건을 입력하고 [조회] 버튼을 클릭하면 배치 전문 로그가 조회된다. 조회 결과의 각 컬럼에 대한

설명은 다음과 같다.

설명컬럼명

조회된 로그의 기관 코드를 표시한다.기관코드

조회된 로그의 업무 코드를 표시한다.업무코드

조회된 로그의 파일 코드를 표시한다.파일코드

조회된 로그의 파일명을 표시한다.파일명

처리 상태를 다음과 같이 아이콘으로 나타낸다.처리 구분

– : 전처리


설명컬럼명

– : 처리 중

– : 처리 완료

– : 처리 실패

– : 후처리

파일 송수신 구분으로, '송신', '수신'의 값을 갖는다.송수신 구분

해당 배치 작업의 개시 전문을 발송한 개시 주체에 대한 구분으로 '대내'(스케쥴러),

'대외'의 값을 갖는다.

개시 구분

배치 수행 시작 일자를 'yyyyMMdd' 형태로 표시한다.시작 일자

배치 수행 시작시간을 'hhmmssSSS' 형태로 표시한다.시작 시간

배치 수행 종료시간을 'hhmmssSSS' 형태로 표시한다.종료 시간

물리적인 파일 송수신 일자가 아닌 실제 거래 일자를 표시한다.파일기준 일자

예를 들어 10월 1일 지로 입금에 대한 파일을 10월 3일에 받은 경우 10월 1일이

실제 거래 일자로서 송수신 일자에서 파일 일자 변동분을 뺀 값이다.

레코드 개수를 '처리된 레코드의 개수 / 레코드의 총 개수 (진행률 %)'의 형태로 표

시한다.

레코드 개수

에러 코드를 표시한다. 각 에러 코드의 의미는 " AnyLink 배치 안내서"를 참조한다.Fail Code

3.2.2. 배치 파일 레코드 조회

배치 전문 로그 중 처리 완료된 배치 파일의 내용을 헤더/데이터/트레일러 별 레코드 단위로 조회할 수 있

다(EBCDIC 데이터의 ASCII 형태 보기도 지원).

● 배치 파일 다운로드

배치 전문 로그 조회 테이블에서 처리 완료된 배치 파일의 '파일명' 컬럼을 클릭하면 서버에서 배치 파

일을 다운로드되어서 다음의 디렉터리에 저장된다.

<AL_ADMIN_HOME>/batfile/<기관코드>/<업무코드>/<파일코드>

● 헤더/바디/트레일러 레코드 조회

다운로드된 파일은 배치 파일의 레코드 크기에 따라 헤더, 바디, 트레일러 레코드 단위로 구분해서 조회

된다. 헤더, 바디, 트레일러 정보는 파일 중 해당하는 내용의 표시부와 매핑 클래스 정보에 따른 전문 형

태 표시부로 구성되며, 바디의 경우 개별 레코드가 하나의 온라인 거래에 해당하므로 아래 navigation

패널을 이용해 해당 거래로 이동한다. 단, 레코드 크기가 없는 경우에는 전체로만 조회 가능하다.


– 배치파일 레코드 조회

[그림 3.10] 배치파일 레코드 조회


● 전체 조회

파일 전체 내용을 조회할 수 있다.

[그림 3.11] 배치파일 레코드 조회 - 전체


3.3. 스케쥴러 로그 조회Admin의 [전문 발송] 메뉴를 통해 전문을 즉시 발송(수동처리)하거나 스케쥴 등록에 의해 주기적으로 발

송하는 경우, Admin의 역할은 데이터베이스에 스케쥴 JOB 정보를 기록하는 것까지이다.

등록된 스케쥴에 따라 실제로 전문을 발송하는 역할은 C 스케쥴러가 담당하며 데이터베이스에 JOB 정보

가 등록되면, 즉시 발송 처리하거나 설정된 주기에 따라 전문을 발송하고 수행 결과를 데이터베이스에 기

록한다. 스케쥴러 로그 조회를 통해 해당 스케쥴러의 수행 결과를 확인할 수 있다.

참고

스케쥴러 로그 조회를 통해서도 배치 관련 로그를 조회할 수 있지만 에러코드 등의 보다 상세한 조회

를 위해서는 배치 로그 조회를 이용해야 한다. 예를 들어 여러 개의 파일을 송신하는 경우 스케쥴러

로그 조회에서는 한 건만 조회되지만 배치 로그 조회를 통해 여러 개의 파일에 대한 조회가 모두 가

능하다.

스케쥴러 로그를 조회하려면 [로그 조회] > [스케쥴러 로그] 메뉴를 선택하거나 <Ctrl>+3 단축키를 눌러,

[스케쥴러 로그 조회] 탭 화면에서 검색 조건을 입력하고 [조회] 버튼을 클릭한다.

[그림 3.12] 스케쥴러 로그 조회

● 검색 조건

[스케줄러 로그 조회] 탭 화면에서 검색 조건 영역의 입력 항목은 다음과 같다.

설명항목


기관을 선택하면 해당 기관의 모든 업무가 자동으로 콤보박스에 표시된다. 기관을

'전체'로 선택한 경우 기관에 관계없이 모든 배치 로그의 조회가 가능하다.


업무를 '전체'로 선택한 경우 업무에 관계없이 모든 배치 로그의 조회가 가능하다.


설명항목

조회할 스케쥴 타입을 선택한다.스케쥴 타입

– 전체

– 운영전문 주기 발송 : 스케쥴 등록(주기적 발송)된 운영 전문만 검색

– 배치전문 주기 발송 : 스케쥴 등록(주기적 발송)된 배치 전문만 검색

– 운영전문 즉시 발송 : 즉시 발송된 운영 전문만 검색

– 배치전문 즉시 발송 : 즉시 발송된 배치 전문만 검색

전문 타입을 선택한다.전문 타입

'전체', '개시', '종료예고', '종료', '장애', '장애회복', '회선시험', '배치' 중 선택한다.

작업 수행의 시작일로서 [Set]버튼 클릭한 후 캘린더를 통해 입력할 수 있다.시작 일자



● 목록 조회

검색 조건을 입력하고 [조회] 버튼을 클릭하면 스케쥴 로그가 조회된다. 조회 결과의 각 컬럼에 대한 설

명은 다음과 같다.

설명컬럼명

조회된 기관 코드를 표시한다.기관코드

조회된 업무 코드를 표시한다.업무코드

조회된 로그의 스케쥴 타입을 '전체', '운영전문 주기 발송', '배치전문 주기 발송',

'운영전문 즉시 발송' 혹은 '배치전문 즉시발송'으로 표시한다.

스케쥴 타입

운영 전문의 타입으로 '개시', '종료예고', '종료', '장애', '장애회복', '회선시험' 혹은

'배치'의 값을 갖는다.

운영전문 타입

작업 수행 시작 일자를 'yyyyMMdd' 형태로 표시한다.시작 일자

작업 수행 시작시간을 'hhmmssSSS' 형태로 표시한다.시작 시간

작업 수행 종료시간을 'hhmmssSSS' 형태로 표시한다.종료 시간

처리 상태를 다음과 같이 아이콘으로 나타낸다.처리 구분

– : 처리 중

– : 처리 완료

– : 처리 실패

에러 코드를 표시한다.Fail Code

현재 재시도 횟수를 표시한다.Retry Cnt


3.4. 배치 파일 목록 조회배치 파일(작업)의 목록을 조회할 수 있다. 파일 코드, 설명 등의 마스터 정보 외에 배치 로그와 연계하여

송수신 상태 및 이력 파악이 가능하다.

배치 파일 목록을 조회하려면 [로그 조회] > [배치파일 목록] 메뉴를 선택하거나 <Ctrl>+B 단축키를 눌러,

[배치파일] 탭 화면에서 검색 조건을 입력하고 [조회] 버튼을 클릭한다.

[그림 3.13] 배치파일 목록 조회

● 검색 조건

[배치파일] 탭 화면에서 검색 조건 영역의 입력 항목은 다음과 같다.

설명항목


기관을 선택하면 해당 기관의 모든 업무가 자동으로 콤보박스에 표시된다. '전

체'로 선택한 경우 기관에 관계없이 모든 배치 파일의 조회가 가능하다.


'전체'로 선택한 경우 업무에 관계없이 모든 배치 파일의 조회가 가능하다.

● 목록 조회

검색 조건을 입력하고 [조회] 버튼을 클릭하면 파일 목록이 조회된다. 조회 결과의 각 컬럼에 대한 설명

은 다음과 같다.


설명컬럼명

조회된 배치 파일의 기관 코드를 표시한다.기관코드

조회된 배치 파일의 업무 코드를 표시한다.업무코드

조회된 파일의 코드를 '전체', '개시', '종료예고', '종료', '장애', '장애회복', '회선시

험', '배치'로 표시한다.

파일코드

조회된 파일의 설명을 '전체', '개시', '종료예고', '종료', '장애', '장애회복', '회선시

험', '배치'로 표시한다.

파일설명

송수신할 데이터 파일명을 표시한다.데이터 파일 목록

파일의 송수신 상태를 표시한다.상태

배치 로그에 기록된 것 중 해당 파일이 생성된 파일 기준일자와 파일 일자 변동

분에 따른 최신 상태를 나타낸다. 즉, 현재 날짜에서 파일 일자 변동분을 뺀 날짜

를 로그의 거래 일자와 비교하여 해당일에 파일이 송수신되었는지를 표시한다.

상세 조회 및 상태 이력 조회

목록에서 하나의 레코드(배치 파일)를 클릭하면 다음과 같이 해당 배치 파일에 대한 상세 정보를 조회할

수 있다.

[그림 3.14] 배치 파일 상세 조회


'상태' 컬럼을 클릭하면 다음과 같이 배치파일 상태 이력 보기 화면이 나타나면서 상태 이력(일자, 시간, 상

태, 종별/거래코드)을 확인할 수 있다. 상태 이력은 통신망 상태 로그에 쌓인 해당 배치 거래의 상태('개시',

'종료' 등 배치거래 유형)를 표시하는 것으로, 기관-업무 정보의 'Flow 체크 유무'가 'Yes'로 설정되어 있어

야 한다.

[그림 3.15] 배치 파일 상태 이력 보기


3.5. 2PC 미완료 거래 조회JEUS 서버의 2PC 미완료 거래에 대한 조회가 가능하다. JEUS WebAdmin의 '트랜잭션 모니터링'으로 확

인할 수 있는 미완료(pending) 트랜잭션 정보를 Admin에서도 제공한다.

2PC 미완료 거래를 조회하려면 [로그 조회] > [2PC 미완료 거래] 메뉴를 선택한 후 [2PC 미완료 거래] 탭

화면에서 [조회] 버튼을 클릭한다.

[그림 3.16] 2PC 미완료 거래 조회

조회 결과의 각 컬럼에 대한 설명은 다음과 같다.

설명컬럼명

JEUS TM에서 사용하는 트랜잭션의 GTID(hex string)가 표시된다.GTID (Global Transaction ID)

로컬 트랜잭션 ID가 표시된다.LTID (Local Transaction ID)

JEUS 외부 TM에서 전달된 XID(Tmax의 xid)가 표시된다.외부 XID

현재 트랜잭션에 대한 처리 decision ('commit', 'rollback', 'read only',

'done' 등)이 표시된다.

Decision

TM(Transaction Manager) 정보가 표시된다.Root TM

3.5.1. 라이브러리 및 JEUS 서버 정보 설정

2PC 미완료 거래를 조회하려면 다음의 정보를 설정해야 한다.

● JEUS/JMX 라이브러리 및 클래스패스 설정

● JEUS 서버 정보 설정


참고

클라이언트인 AnyLink Admin에서도 연결하는 JEUS 서버와 동일한 버전의 라이브러리를 사용해야

하며 JEUS v5.0 Fix#14 이후 버전의 사용을 권장한다.

JEUS/JMX 라이브러리 및 클래스패스 설정

미완료 트랜잭션 정보는 JMX(Java Management Extensions)를 이용해 JEUS 서버의 JTAResourceMBean

을 호출하여 얻게 된다.

필요한 라이브러리는 다음과 같이 Admin을 구동할 때 aladmin.bat 파일의 클래스패스에 설정되어야 한다.

set JMX_RT_CLASSPATH =lib\jeusutil.jar:lib\jmxremote.jar;lib\jaxb-api.jar;

lib\jeusjaxb.jar;lib\jmxtools.jar;lib\jaxb-libs.jar;lib\jaxb-impl.jar

set JMX_CLASSPATH = lib\jmxri.jar;lib\jeus.jar;%JMX_RT_CLASSPATH%

java... -classpath

%JMX_CLASSPATH%... anylink.admin.console.Main

JEUS 서버 정보 설정

Admin을 구동할 때 시스템 속성으로 JEUS 서버 연결 정보를 설정해야 한다.

-Djava.naming.factrory.url.pkgs = "jeus.jndi.jns.url"

-Djava.naming.factory.initial= "jeus.jndi.JEUSContextFactory"

-Djava.naming.provider.url = <JEUS 서버 IP>;<port>

-Djava.naming.security.principal= 사용자(선택값)

-Djava.naming.security.credentials= 사용자 암호(선택 값)

필요한 라이브러리는 다음과 같이 Admin을 구동할 때 aladmin.bat 파일의 클래스패스에 설정되어야 한다.

set INITIAL_CONTEXT_FACTORY = jeus.jndi.JEUSContextFactory

set PROVIDER_URL = <JEUS IP>:<port>

java ... –classpath %JMX_CLASSPATH%...

-Djava.naming.factorory.url.pkgs = jeus.jndi.jns.url

-Djava.naming.factory.initial = %INITIAL_CONTEXT_FACTORY%

-Djava.naming.provider.url = %PROVIDER_URL%

-Djava.naming.security.principal = administrator –Djava.naming.security.credentials

= 1111111 anylink.admin.console.Main


제4장 전문 발송

본 장에서는 업무 개시를 알리는 개시 전문을 대외 기관으로 특정 시간에 매일 보내거나 회선 시험의 목적

으로 테스트 전문을 보내고 싶은 경우 등 전문 발송을 위한 기능인 전문 발송 메뉴에 대해 설명한다.

4.1. 운영 전문업무 개시를 알리는 개시전문을 대외기관으로 특정 시간에 매일 보내거나 회선 시험의 목적으로 테스트

전문을 보내고 싶은 경우 등 전문 발송을 위한 기능으로 [전문 발송] 메뉴를 선택한다.

단발성 즉시 발송이나 스케쥴(시작 시간 및 주기)에 의한 발송이 가능하며 발송된 전문 템플릿을 재사용

하는 것도 가능하다.

운영 전문은 실제 거래 데이터가 아닌 개시, 종료, 장애회복 등 시스템 운영 및 관리를 위한 목적의 전문이

며, 다음과 같이 6가지 타입이 있다.

설명타입

업무 개시를 알리는 전문으로 대개 개시 전문 이후에만 통상 전문이 올 수 있다.개시

종료 예고 전문이다.종료예고

업무 종료를 알리는 전문으로 대개 종료 전문 이후에는 통상전문이 올 수 없다.종료

시스템/회선 장애를 알리는 전문으로 장애회복 전문이 와야만 이후 처리가 가능하다.장애

장애 회복을 알리는 전문으로 대개 장애 이전의 상태로 복구한다.장애회복

테스트 전문으로 언제나 올 수 있다.회선시험

4.1.1. 운영 전문 등록

운영 전문을 등록하려면 [전문 발송] > [운영전문] 메뉴를 선택하거나 <Ctrl>+4 단축키를 누르고, [등록]

탭 화면에서 진행한다.

제4장 전문 발송 37

[그림 4.1] 운영전문 발송

운영 전문의 [등록] 탭의 각 영역에 대한 설명은 다음과 같다.

● 검색 조건 설정(1)

운영전문 작성을 위해서는 일단 해당 기관/업무/종별/거래에 대한 전문 템플릿을 선택해야 한다.

검색 조건의 콤보박스를 통해 해당 '기관', '업무', '종별코드', '거래코드'를 선택한 후 [조회] 버튼을 클릭

한다. [조회] 버튼 클릭해야만 [즉시 발송] 및 [주기 발송] 버튼이 활성화된다.

운영 전문을 위한 템플릿이므로 '기관', '업무'의 종별을 선택하면, 운영 전문에 대한 '종별코드'만 콤보

박스에 표시됨에 주의해야 한다. 따라서 해당 업무에 대한 종별을 디플로이했는데도 표시되지 않는다

면 스튜디오의 종별 일반정보에서 '전문 유형'이 '운영전문'으로 설정되어 있는지 확인한다.

그러면 스튜디오에서 정의된 해당 거래 전문 템플릿(필드명, 한글필드명, 데이터 타입, 길이)이 공통부

(Header)와 상세부(Body)로 나뉘어 화면의 아래에 표시되며, 스튜디오에서 설정한 해당 거래의 '거래

유형'이 '운영전문 타입'으로 자동 설정된다.

● 정보 입력(2)

– Callback

전문 발송 후 Callback으로 호출될 Tmax 서비스명을 설정한다.

– Retry Count

전문 발송에 실패한 경우 재시도 횟수를 설정한다. 재시도 실패의 경우 스케쥴러로부터 실패 통지를

받아 알려준다.


– Retry Time

전문 발송에 실패한 경우 재시도 간격을 설정한다.(단위: 초)

– 서버그룹 호출 여부

서버 그룹의 호출 여부를 설정한다.

설명설정값

모든 서버 그룹(Tmax SVRGROUP)에 속한 Mapper 및 게이트웨이를 호출한다.YES

기존과 같이 해당 기관-업무의 Mapper 및 게이트웨이를 한 번만 호출한다.No

● 필드 값 입력(3)

선택된 전문 템플릿에 값을 입력한다.

컬럼을 더블 클릭하여 해당 필드의 값을 입력할 수 있다. 값 입력 후 <Enter> 키를 누르거나, 포커스를

이동해야 반영된다.

● 전문 발송(4)

ASCII 이외에 EBCDIC도 지원하여 운영전문 거래의 변환 유형이 EBCDIC인 경우(E→A, E→E)에는 사

용자 입력 값을 EBCDIC 변환하여 발송한다.

– 즉시 발송

스케쥴 이외의 시간에 수동 처리하고 싶은 경우 등 1회에 한하여 발송되는 것으로 [즉시 발송] 버튼을

클릭한다.

– 스케쥴 등록

스케쥴에 의해 주기적으로 발송해야 하는 경우 [스케쥴 등록] 버튼을 클릭한다.


위와 같이 시작 일자를 선택한 후 시작 시간 및 주기(interval)를 입력하면 되고 주기는 다음과 같다.

설명항목

설정된 '시작 시간'으로부터 일/시/분에 입력된 만큼의 주기를 갖는다.Custom

설정된 '시작 시간'으로부터 매일 수행한다.매일

설정된 '시작 시간'으로부터 매주 수행한다.매주

설정된 '시작 시간'으로부터 매월 수행한다.매월

4.1.2. 스케쥴 변경

[전문 발송] > [운영전문] 메뉴의 [스케쥴 변경] 탭에서 이미 등록된 스케쥴의 시간 및 주기를 수정하거나,

이미 발송된 전문을 재발송할 수 있다.

[그림 4.2] 운영 전문 스케쥴 변경

운영전문의 [스케쥴 변경] 탭의 각 영역에 대한 설명은 다음과 같다.


검색 조건의 콤보박스를 통해 '기관', '업무', '스케쥴 타입', '운영전문 타입' 조건을 선택한 후 [조회] 버

튼을 클릭하면 스케쥴 목록이 조회된다.

● 스케쥴 목록(2)

조회된 스케쥴 목록의 각 컬럼에 대한 설명은 다음과 같다.

– 기관코드

조회된 스케쥴의 기관 코드를 표시한다.


– 업무코드

조회된 스케쥴의 업무 코드를 표시한다.

– 기관 구분

VAN사의 경우 같은 기관 코드를 사용하는 대신 업체 번호로 구분한다. 이를 위해 전문 중 'OTHER_IN

ST_CODE' 식별자를 갖는 필드 값을 '기관구분' 컬럼에 표시한다.

[그림 4.3] 기관 구분 – 식별자 정의 및 값 입력

[그림 4.4] 기관 구분 표시


– 스케쥴 타입

'운영전문 발송' 혹은 '운영전문 수동처리'로 스케쥴 타입이 표시된다.

– 운영전문 타입

발송된 운영 전문의 타입이 표시된다.

– 유형

스케줄 타입이 표시된다(즉시발송, 주기발송).

– 주기(초)

주기적으로 전문을 발송하는 간격(초)을 표시한다. '스케쥴 타입'이 '운영전문 발송'의 경우 'Custom',

'매일', '매주' 혹은 '매월'로 표시되고, '스케쥴 타입'이 '운영전문 수동처리'의 경우에 주기는 0으로 표

시된다.

– 시작 일시

전문 발송 시작 일시가 표시된다.

– 상태

운영전문의 상태가 수행( ), 미수행( )으로 표시된다.

스케쥴 목록을 통해 주기, 시작 일시, 상태 등의 스케쥴 정보를 파악한 후 변경할 대상을 선택한다. 해당

행을 더블 클릭하면 필드 값 보기 대화상자를 통해 전문 데이터를 볼 수 있다.

[그림 4.5] 필드값 보기


● 스케쥴 변경 수행 버튼(3, 4)

– [중지] 버튼

버튼을 클릭하면 선택된 스케쥴을 일시 중지한다.

– [시작] 버튼

버튼을 클릭하면 스케쥴을 시작할 수 있다(일시 중지된 스케쥴 포함).

– [삭제] 버튼

버튼을 클릭하면 선택된 스케쥴을 삭제할 수 있다.

– [즉시 발송]

기존에 발송된 전문을 재발송하고 싶은 경우 [즉시 발송] 버튼을 클릭한다. 그러면 다음과 같은 필드

값 변경 대화상자가 표시되고 기존의 발송값을 확인할 수 있다. 여기서 Callback이나 필드값을 수정

하고 [OK] 버튼을 클릭한다.

[그림 4.6] 필드값 변경

– [스케쥴 수정]

스케쥴에 의해 주기적으로 발송해야 하는 경우 [스케쥴 수정] 버튼을 클릭한다.


4.2. 배치 전문 발송일괄전송 파일 송수신을 위한 스케쥴로, 배치 게이트웨이를 호출하여 파일 송수신을 시작한다.

4.2.1. 배치 전문 작성

배치 전문의 작성은 [전문 발송] > [배치전문] 메뉴를 선택하거나 <Ctrl>+5를 누른 후 [조회/발송] 탭에서

수행한다.

[그림 4.7] 배치전문 발송

배치 전문의 [조회/발송] 탭의 각 영역에 대한 설명은 다음과 같다.


배치전문 작성을 위해서는 일단 해당 기관/배치업무에 대한 전문 템플릿을 선택해야 한다.

검색 조건의 콤보박스를 통해 해당 '기관', '업무'를 선택하고 '파일 구분'에서 '파일명' 혹은 '대표 파일

명'을 선택한다. 대표 파일이란 여러 파일의 묶음을 나타내는 파일코드로서 개시 후 여러 개의 파일을

연속해서 보낼 경우에 사용된다. '파일명' 콤보박스에서 하나의 파일 혹은 대표 파일을 선택한 후 [조회]

버튼을 클릭하면 스튜디오에서 정의된 해당 거래 전문 템플릿(필드 명, 한글필드 명, 데이터 타입, 길이)

이 조회된다. [조회] 버튼을 클릭해야만 [즉시 발송] 및 [주기 발송] 버튼이 활성화된다.

전문 템플릿은 해당 배치업무의 '개별업무 개시코드' 정보에서 종별 및 거래코드를 얻어 배치거래를 찾

고 해당 거래의 매핑 클래스와 연관된 입력전문이 표시되는 것으로 '외부전문' 라디오 버튼을 선택한 후

조회할 경우 배치거래의 외부 매핑 클래스를, '내부전문' 라디오 버튼을 선택한 경우 내부 매핑 클래스

를 참조한다.


● 정보 입력(2)

설명항목

송/수신 구분을 설정한다.송/수신 구분

'송신', '수신', '연속 송신', '연속 수신' 중 선택한다. 자세한 내용은 “3.2.1. 배치 전문

로그 조회” 중 '송/수신 구분' 항목 설명을 참조한다.

전문 발송에 실패한 경우의 재시도 횟수를 설정한다.Retry Count

재시도에 실패한 경우 스케쥴러로부터 실패 통지가 오고 이를 대화상자로 알려준

다.

전문 발송에 실패한 경우의 재시도 간격을 설정한다.(단위: 초)Retry Time

재시도에 실패한 경우 스케쥴러로부터 실패 통지가 오고 이를 대화상자로 알려준

다.

서버 그룹의 호출 여부를 설정한다.서버그룹 호출 여부

– No : 기존과 같이 해당 기관-업무의 Mapper 및 게이트웨이를 한 번만 호출한다.

– Yes : 모든 서버그룹(Tmax SVRGROUP)에 속한 Mapper 및 게이트웨이 호출이

가능하다.

● 필드값 입력(3)

선택된 전문 템플릿에 값을 입력한다.

컬럼을 더블 클릭하여 해당 필드의 값을 입력할 수 있다. 값 입력 후 <Enter> 키 입력 혹은 포커스를 이

동해야 반영된다.

● 전문 발송(4)

설명항목

스케쥴 이외의 시간에 수동 처리하고 싶은 경우 등 1회에 한하여 발송되는 것으로

[즉시 발송] 버튼을 클릭한다.

즉시 발송

스케쥴에 의해 주기적으로 발송해야 하는 경우 [주기 발송] 버튼을 클릭한다.스케쥴 등록

4.2.2. 스케쥴 변경

[전문 발송] > [배치전문] 메뉴의 [스케쥴 변경] 탭에서 이미 등록된 스케쥴의 시간 및 주기를 수정하거나,

이미 발송된 전문을 재발송할 수 있다.


[그림 4.8] 배치전문 스케쥴 변경

배치전문의 [스케쥴 변경] 탭의 각 영역에 대한 설명은 다음과 같다.


검색 조건의 콤보박스를 통해 '기관', '업무' 및 '스케쥴 타입'을 선택한 후 [조회] 버튼을 클릭하면 스케

쥴 목록이 조회된다.

스케쥴 목록을 통해 주기, 시작 일시, 상태 등의 스케쥴 정보를 파악한 후 변경할 대상을 선택하여 더블

클릭하면 나타나는 필드값 보기 대화상자에서 전문 데이터를 확인할 수 있다. ([그림 4.5] 참조)

● 스케쥴 목록(2)

설명컬럼명

조회된 배치전문의 기관 코드가 표시된다.기관코드

조회된 배치전문의 업무 코드가 표시된다.업무코드

조회된 배치전문의 파일 코드가 표시된다.파일코드(업무구분명)

조회된 배치전문의 파일명이 표시된다.파일명

스케쥴 타입이 '배치 발송' 혹은 '배치 수동처리'로 표시된다.스케쥴 타입

'스케쥴 타입'이 '배치 발송'일 경우 'Custom', '매일', '매주' 혹은 '매월'로 표시

된다.

유형

주기적으로 전문을 발송하는 간격을 표시한다.(단위: 초)주기(초)

'스케쥴 타입'이 '배치 수동처리'일 경우 주기는 0이다.

전문 발송 시작일시를 나타낸다.시작 일시


설명컬럼명

배치전문의 수행 상태를 다음과 같이 아이콘으로 나타낸다.상태

– : 수행

– : 미수행

● 스케쥴 변경 수행 버튼(3, 4)

설명버튼

버튼을 클릭하면 선택된 스케쥴을 일시 중지한다.[중지]

버튼을 클릭하면 스케쥴을 시작할 수 있다(일시 중지된 스케쥴 포함).[시작]

버튼을 클릭하면 선택된 스케쥴을 삭제한다.[삭제]

기존에 발송된 전문을 재발송하고 싶은 경우 [즉시 발송] 버튼을 클릭한다.

그러면 필드값 변경 대화상자가 표시되고 기존의 발송 값을 확인할 수 있는

데 여기서 필드값을 수정 입력하고 [OK] 버튼을 클릭한다.

[즉시 발송]

스케쥴에 의해 주기적으로 발송해야 하는 경우 [스케쥴 수정 ] 버튼을 클릭한

다.

[스케쥴 수정]


제5장 통계 조회

통계 마스터 로그에 대한 통계를 확인할 수 있는 기능으로, 집계 데몬이 수집한 통계 데이터를 날짜별 혹

은 항목별 다양한 조건에 의해 검색할 수 있다. 본 장에서는 통계 조회 메뉴에 대해 설명한다.

5.1. 날짜별 통계 조회통계 조회를 날짜별(시간별, 일별, 월별, 연간)로 할 수 있는 기능으로 [통계 조회] > [날짜별 조회] 메뉴를

선택하거나 <Ctrl>+6 단축키를 이용한다.

검색 조건을 입력하고 [조회] 버튼을 클릭하면 다음과 같이 성공 건수, 오류 건수 및 합계의 통계 데이터를

조회할 수 있다.

[그림 5.1] 날짜별 통계 조회

또한, 해당 항목의 '오류 건수' 컬럼을 클릭하면 다음과 같이 에러코드 및 발생 건수를 확인할 수 있다.

[그림 5.2] 에러코드 확인

제5장 통계 조회 49

● 검색 조건

날짜별 통계를 조회할 때 입력해야 하는 검색 조건의 항목은 다음과 같다.

설명항목

조회할 기관명을 선택한다.대외기관


기관을 선택하면 해당 기관의 모든 온라인업무가 자동으로 콤보박스에 표시된

다.

조회할 전문종별 코드를 선택한다.전문종별코드

조회할 거래구분 코드를 선택한다.거래구분코드

조회할 시간 범위에 따라 항목을 선택하여 값을 설정한다.날짜/시간 조건

– 시간별 : '년', '월', '일'을 선택하면 해당 일자의 통계를 시간별로 조회한다.

– 일별(주간) : '년', '월', '주'를 선택하면 해당 주의 통계를 일별로 조회한다.

– 일별(월간) : '년', '월'을 선택하면 해당 월의 통계를 일별로 조회한다.

– 월별 : '년'을 선택하면 해당 연도의 통계를 월별로 조회한다.

– 연간 : 선택한 연도 사이의 통계를 연별로 조회한다.

● 목록 조회

검색 조건을 입력하고 [조회] 버튼을 클릭하면 통계가 조회된다. 조회 결과의 각 컬럼에 대한 설명은 다

음과 같다.

설명컬럼명

해당 시간에 에러 없이 정상적으로 처리된 건수를 표시한다.성공 건수

해당 시간에 에러로 처리된 건수를 표시한다.오류 건수

해당 시간의 총 건수(성공 건수 + 오류 건수)를 표시한다.계

해당 시간에 처리된 작업에 평균적으로 소요된 시간을 표시한다.평균 처리 시간 (ms)

(단위: milliseconds)


조회된 통계 데이터는 [엑셀 저장] 버튼을 이용해 Excel 파일에 저장할 수 있다.

[그림 5.3] Excel에 붙여넣기

5.2. 항목별 통계 조회통계 조회를 항목별(기관, 업무, 종별, 거래별)로 할 수 있는 기능으로 [통계 조회] > [항목별 조회] 메뉴를

선택하거나 <Ctrl>+7 단축키를 이용한다.

검색 조건을 입력하고 [조회] 버튼을 클릭하면 다음과 같이 성공 및 오류 건수와 평균 처리시간을 조회한

다. 해당 항목의 '오류 건수' 컬럼을 클릭하면 에러코드 및 발생 건수를 확인할 수 있다.

[그림 5.4] 항목별 통계 조회


● 검색 조건

항목별 통계를 조회할 때 입력해야 하는 검색 조건의 항목은 다음과 같다.

설명항목

조회할 기관명을 선택한다.대외기관


기관을 선택하면 해당 기관의 모든 온라인 업무가 자동으로 콤보박스에 표시된

다.

조회할 전문종별 코드를 선택한다.전문종별코드

조회할 거래구분 코드를 선택한다.거래구분코드

데이터를 조회하려는 시작 일자를 입력한다. [Set] 버튼을 클릭하여 캘린더를 통

해 입력할 수 있다.

시작 일자

데이터를 조회하려는 종료 일자를 입력한다. [Set] 버튼을 클릭하여 캘린더를 통

해 입력할 수 있다.

종료 일자

조회하려는 항목을 선택한다.항목

– 대외기관 : 대외 기관별 통계를 조회한다.

– 업무 : 업무별 통계를 조회한다.

– 전문종별코드 : 전문종별 코드별 통계를 조회한다.

– 거래구분코드 : 거래구분 코드별 통계를 조회한다.

● 조회 결과

조회 결과의 각 컬럼에 대한 설명은 다음과 같다.

설명컬럼명

해당 시간에 에러 없이 정상적으로 처리된 건수를 표시한다.성공 건수

해당 시간에 에러로 처리된 건수를 표시한다.오류 건수

해당 시간의 총 건수(성공 건수 + 오류 건수)를 표시한다.계

해당 시간에 처리된 작업에 평균적으로 소요된 시간을 표시한다.평균 처리 시간 (ms)

(단위: milliseconds)

5.3. 집계 데몬 스케쥴 설정통계 데이터는 마스터 로그에 대한 Full Scan을 필요로 하기 때문에 조회 시간도 오래 걸리고 운영 시스템

에 영향을 줄 수 있으므로 실시간으로 조회할 수가 없다. 별도의 집계 데몬이 하루에 한 번 주기적으로 수

행되어, 마스터 로그를 분석하고 통계 데이터를 별도의 테이블에 기록하면 Admin이 이 테이블로부터 조


회하는 구조를 갖고 있다. 따라서 통계 조회에서는 오늘 이전의 데이터까지에 대한 통계만 확인할 수 있

다.

집계 데몬 설정은 이 집계 데몬을 언제 수행할 것인지 설정하는 기능으로 [통계 조회] > [집계 데몬 스케쥴

설정] 메뉴를 선택하거나 <Ctrl>+8 단축키를 사용한다.

집계 대몬 수행을 시작하는 시간과 종료하는 시간을 설정할 수 있으며, 특정 요일에만 수행할 수 있도록

설정할 수 있다.

[그림 5.5] 집계 데몬 스케쥴 설정


제6장 시스템 컴포넌트 관리

Admin의 중요 기능 중 하나는 AnyLink 시스템과 관련된 컴포넌트들을 등록 및 관리하고 그 상태를 모니

터링하는 것이다. 또한, 각 컴포넌트 상태에 대한 통지를 aladmin.log 파일에 기록한다.

본 장에서는 각 시스템 컴포넌트별 등록 및 관리 방법에 대해 설명한다.

6.1. 시스템 컴포넌트 브라우저시스템 컴포넌트 브라우저는 시스템 컴포넌트인 노드, 게이트웨이, 회선, Mapper를 계층적으로 표시하는

브라우저이다. 이를 통해 각 컴포넌트의 현재 상태를 실시간으로 확인할 수 있고 컨텍스트 메뉴를 이용하

여 컴포넌트 추가도 가능하다.

[Tools] > [System Browser] 메뉴를 통해 표시 여부를 제어할 수 있다.

6.1.1. 상태 보기

Admin은 구동할 때 데이터베이스에서 시스템 정보를 얻어 시스템 브라우저에 컴포넌트 트리를 구축하고

AMM에 컴포넌트 상태 정보를 요청한다.

AMM으로부터 받은 컴포넌트의 상태 정보는 다음과 같이 아이콘으로 표시된다.

[그림 6.1] 컴포넌트 트리

제6장 시스템 컴포넌트 관리 55

각 상태 아이콘에 대한 설명은 다음과 같다.

OFFON항목

노드

게이트웨이

회선

Mapper(Java)

Mapper(C)

6.1.2. 통지(Notification)

Admin은 AMM으로부터 시스템 컴포넌트 상태에 대한 통지를 받아 브라우저에 반영한다.

컴포넌트 상태를 변경할 경우 AMM이 해당 정보를 브로드캐스팅(Broadcasting)하면 Admin은

WebtEventConnection 연결을 통해 통지를 받는 구조로 Admin 콘솔을 통해 통지 정보를 확인할 수도 있

다.

다음은 스케쥴러를 다운할 경우의 콘솔 출력이다.

Notification event msg_type/alh_etc: 401/416

AL_SCHD_DOWN_NOTIFY

Tmax 서버가 다운된 경우에는 다음과 같은 경고 메시지가 나타난다.

[그림 6.2] Tmax 서버 다운 통지

6.1.3. 복제(Cloning)

노드, 게이트웨이, 회선/URL, Mapper 정보에 대한 복제 기능이다. 컨텍스트 메뉴(복사/붙여넣기) 혹은 단

축키(<Ctrl>+C/<Ctrl>+V)를 이용하여 수행하며 특정 부분만 상이한 정보를 생성할 경우에 유용하게 사용

될 수 있다.


복제 방법은 다음과 같다.

[그림 6.3] 정보 복제

1. 복사

복사할 노드를 선택한 후 <Ctrl>+C를 누르거나, 컨텍스트 메뉴의 [복사]를 선택한다.

2. 붙여넣기

붙여넣을 노드를 선택한 후 <Ctrl>+V를 누르거나, 컨텍스트 메뉴의 [붙여넣기]를 선택한다. 붙여넣기는

위에서 복사한 노드의 상위 노드에서만 가능하다.

회선 복제의 경우 붙여넣기할 때 다음과 같은 대화상자가 표시되는데, [예]를 선택하여 기관-업무 회선

연결도 함께 복제가 가능하다. 즉, 복제한 회선(A)이 기관 X-업무 Y에 할당되어 있었다면 이로부터 복

제된 회선(B)을 기관 X-업무 Y에 자동으로 할당해 줄 수 있다.

3. 정보 입력

새로 복제된 시스템 컴포넌트의 정보를 입력한다.

주의

게이트웨이 정보인 경우 노드에 대해서만 붙여넣기가 가능함에 주의한다.

6.2. 노드(Node)노드는 AnyLink 서버가 설치된 물리적인 머신을 의미한다.

6.2.1. 노드 추가

시스템 브라우저에서 'AnyLink' 루트 노드를 선택한 후 컨텍스트 메뉴의 [노드 추가] 메뉴를 선택하거나,

오른쪽 화면에서 [노드 추가] 버튼을 클릭한다.


이미 존재하는 노드는 추가할 수 없으며, 노드 추가 후에는 서버(Tmax)를 재기동해야 해당 정보가 반영되

고 노드 간 연결이 가능하다.

다음은 노드 추가 화면이다.

[그림 6.4] 노드 추가

각 입력 항목에 대한 설명은 다음과 같다.

설명항목

노드명을 입력한다. 해당 머신의 uname -n 값과 동일해야 한다.이름

(최대 32자리)(필수 입력 항목)

멀티 노드 환경에서 AMM 간 통신할 때 사용될 IP 주소이다.(필수 입력 항목)IP 주소

멀티 노드 환경에서 AMM 간 통신할 때 사용될 포트 번호이다.포트 번호

TMAXPORT(tmconfig의 TPORTNO) 및 시스템 컴포넌트들이 AMM에 연결하는

포트(TMAXPORT+10)와 다른 값으로 설정해야 정상적으로 Listen할 수 있다.

(최대 5자리 정수)(필수 입력 항목)

AMM에서 사용하는 공유메모리 키이다. Tmax의 공유 메모리 키와 다른 값으로

설정해야 한다. (최대 5자리 정수)(필수 입력 항목)

공유메모리 키

멀티 노드 환경에서 타 노드의 해당 노드 연결에 대한 재시도 간격을 최대 3자리

정수로 설정한다. (단위: 초)

재시도 간격

JavaMapper에서 사용하는 클래스 패스이다. 스튜디오에서 디플로이된 클래스

는 이 경로 아래에 패키지 구조를 따라 생성된다.

Classpath (Java)


설명항목


C Mapper에서 사용하는 Include 파일 경로이다. 스튜디오에서 디플로이할 때 C

Mapper는 이 경로 아래에 공유 라이브러리를 생성한다.

Include 경로 (C)


C Mapper에서 사용하는 라이브러리의 경로이다. 스튜디오에서 디플로이할 때

C Mapper는 이 경로 아래에 공유 라이브러리를 생성한다.

라이브러리 경로 (C)


로그 디렉터리를 설정한다. (최대 256자리)로그 파일 경로

6.2.2. 노드 수정 및 삭제

추가한 노드를 수정하거나 삭제할 수 있다. 노드를 수정하려면 시스템 브라우저에서 수정할 노드를 선택

하고 오른쪽 화면에서 정보를 수정 입력한 후 [노드 수정] 버튼을 클릭한다. 노드 정보의 수정은 실시간 적

용이 불가능하고 서버를 재기동해야 반영된다.

노드를 삭제하려면 삭제할 노드를 선택하고 [노드 삭제] 버튼을 클릭한다. 단, 노드에 연결된 게이트웨이

가 있을 경우 삭제할 수 없으므로 먼저 게이트웨이를 삭제해야 한다.

[그림 6.5] 노드 수정 및 삭제


6.2.3. 노드 모니터링

[제어 & 모니터링] 탭 화면에서 노드에 대한 모니터링 정보를 확인할 수 있다.

상단의 '스케쥴러 상태'에서 스케쥴러의 구동 상태를 표시('RUNNING' 혹은 'NOT RUNNING')하고 하단

테이블을 통해 노드에 속하는 모든 게이트웨이와 회선 상태를 확인할 수 있다. 또한, 게이트웨이명 혹은

회선명을 더블클릭하면 해당 게이트웨이 혹은 회선의 모니터링 페이지로 바로 이동할 수 있다.

[그림 6.6] 노드 모니터링

각 컬럼에 대한 설명은 다음과 같다.

설명컬럼명

게이트웨이명을 나타낸다.Gateway

게이트웨이 서비스명을 나타낸다.서비스명

게이트웨이 상태를 아이콘으로 표시한다.상태

게이트웨이 타입을 '온라인 G/W' 혹은 '배치 G/W'와 같이 나타낸다.타입

회선명을 표시한다.회선

상태를 아이콘으로 표시한다.상태


6.3. 게이트웨이(Gateway)게이트웨이는 원격 노드(타 시스템 혹은 대외계)와 Mapper 간의 인터페이스를 담당하며 TCP/IP, X.25,

HTTP, Serial 등 다양한 프로토콜을 지원한다.

6.3.1. 게이트웨이 추가

게이트웨이를 추가하려면 추가할 노드를 선택하고 컨텍스트 메뉴에서 [Gateway 추가] 메뉴를 선택하거

나 오른쪽 화면에서 [Gateway 추가] 버튼을 클릭한다.단, 이미 존재하는 게이트웨이는 추가할 수 없으며,

게이트웨이 추가 후에는 서버(Tmax)를 재기동해야 그 정보가 반영된다. 게이트웨이는 Tmax 서버이기 때

문에 물론 tmconfig에도 반영되어야 한다.

참고

게이트웨이에 대한 설명은 "AnyLink Online 게이트웨이 안내서"를 참고하고, FTP 서버, E-mail 게이

트웨이 등 프로토콜 특화적인 설정은 "AnyLink 배치 안내서"를 참조한다.

다음은 Gateway 추가 화면이다.

[그림 6.7] 게이트웨이 추가



● 이름 (최대 16자리)

게이트웨이명을 설정한다. Tmax 서버에 등록된 바이너리명과 일치해야 한다.

● 서비스명 (최대 16자리)

게이트웨이의 Tmax 서비스명을 설정한다.

● 백업 서비스명 (최대 16자리)

게이트웨이에서 대외계로 전문을 보낼 때 가용 회선이 없는 경우 백업 게이트웨이를 통해(tpforward) 전

송함으로써 데이터 전달에 대한 보장이 가능하다. 해당 백업 게이트웨이의 Tmax 서비스명을 설정한다.

● 프로토콜

추가할 게이트웨이의 프로토콜을 선택한다.

설명설정값

TCP/IP 통신을 위한 게이트웨이이다.TCP/IP

X.25 프로토콜을 지원하는 게이트웨이이다.X.25

HTTP 프로토콜을 지원하는 게이트웨이이다.HTTP

IBM의 SNA(System Network Architecture)를 적용한 게이트웨이이다.SNA

Serial port를 통해 데이터를 주고받기 위한 게이트웨이 이다.(4.0.0이상 버전

에서는 지원하지 않음)

Serial

E-mail 송수신이 가능한 게이트웨이이다.E-mail

DNS 서버와 TCP/IP 통신을 하기위한 게이트웨이이다.TCP/IP with DNS

SSL 보안 프로토콜이 적용된 게이트웨이이다.SSL

IBM 메인프레임의 middleware인 IMS와 TCP/IP 통신을 하기위한 게이트웨

이이다.

TCP/IP with IMS connect

IBM 메인프레임의 middleware인 CICS와 TCP/IP 통신을 하기위한 게이트웨

이이다.

TCP/IP with CICS con

nect

IBM MQ Series의 Queue를 회선 개념으로 생각하여 만든 게이트웨이이다.MQ Series

● Type

추가할 게이트웨이의 타입을 선택한다.

설명설정값

스튜디오에서 등록된 온라인 거래를 타 시스템으로 송수신하기 위한 게이트

웨이이다.

온라인

배치 게이트웨이이다. 파일 송수신을 위한 프로토콜이 구현된 Multi Thread

형태의 게이트웨이이다.

배치

HTTP 게이트웨이이다.HTTP


설명설정값

E-mail 게이트웨이이다. 'Server' 모드 회선만 추가할 수 있다.E-mail

단순한 요청/응답 구조를 갖는 온라인 게이트웨이에 반해 배치처럼 자주 맺

고 끊는 흐름이 있는 경우의 성능 향상이나 사용자 임의 프로토콜의 추가를

위해 사용하는 게이트웨이이다.

온라인 Thread

요청을 받는 Llistener와 Listener로부터 전달된 요청을 실제로 처리하는 핸들

러(handler)로 이루어지며 여기서 등록되는 것은 Listener이다.

FTP를 통한 파일 송수신이 가능한 게이트웨이로서 'Server' 모드 회선만 추

가할 수 있다. FTP 서버 게이트웨이에 대한 설명은 "AnyLink 배치 안내서"를

참조한다.

FTP Server

● 대내외구분

External 게이트웨이와 Internal 게이트웨이는 전문의 파싱(기관/업무/종별/거래코드를 찾아 Mapper로

전달하는) 방식에서 차이를 갖는다.

대외 기관과 연결할 때 사용되는 External 게이트웨이는 종별코드/거래코드를 갖는 대외 기관 전문 구

조에 따라 전문이 들어오면 업무 정보로부터 종별 코드 및 거래구분 코드를 찾는다. 반면 대내 시스템과

연결되는 Internal 게이트웨이는 파싱 방식이 위와 다르게 되는데, 이는 대내 전문이 대외 기관 전문과

달리 12자리 거래코드 혹은 여러 코드를 조합해서 나타내는 등의 다양한 구조를 가질 수 있기 때문이다.

설명설정값

해당 업무의 종별 코드 위치 정보로 종별 코드를 찾아낸 후 종별 코드 정보에

서 거래 코드를 찾는 방식이다. (대외 파싱)

External

해당 업무의 거래 코드 키 정보 1, 2, 3으로부터 거래 코드를 찾아낸 후 종별

코드를 찾는 방식이다. (대내 파싱)

Internal

● 기관코드/업무코드

게이트웨이가 특정 기관-업무에만 종속된 경우 해당 기관을 선택한다.

● 기관-업무 유일키 offset(최대 4자리 정수)

여러 기관-업무가 회선을 공유할 때 기관-업무 유일키 정보를 찾기 위한 오프셋을 설정한다.

● 기관-업무 유일키 length (최대 2자리 정수)

여러 기관-업무가 회선을 공유할 때 기관-업무 유일키 정보를 찾기 위한 길이를 설정한다.

● 메시지 길이 지정

TCP/IP 통신에서 메시지 길이를 지정하는 방식을 설정한다.

설명항목

메시지 길이가 헤더(TCP/IP 통신헤더 혹은 공통헤더)에 지정된 경우에 일반

적인 TCP/IP 통신에서는 전문의 길이를 통신헤더에 담아 전문에 붙여서 보

통신헤더


설명항목

내주기 때문에 통신헤더를 읽고 get_msg_length 함수를 통해 나머지 전문의

길이를 읽어내는 방식이다.

메시지 길이가 거래와 상관없이 고정된 경우, 즉 모든 전문의 길이가 동일하

다면 통신헤더 없이 고정길이만큼만 한 번에 읽어낸다.

고정길이

특정 문자 단위로 끊어서 읽는 경우에, 통신헤더가 별도로 없으며 게이트웨

이는 사용자가 get_end_msg 함수로써 지정한 길이만큼 읽어낸다.

END 문자

● 통신헤더 타입

'메시지 길이 지정'이 '통신헤더'일 때의 타입을 설정한다.

설명항목

TCP/IP 통신헤더에 메시지 길이가 지정된 경우로서 통신헤더는 Mapper로

전달되지 않는다.

통신헤더

전문 공통헤더에 메시지 길이가 지정된 경우로서 공통헤더까지 그대로

Mapper로 전달된다.

공통헤더

● 통신헤더 길이(최대 4자리 정수)

'메시지 길이 지정'이 '통신헤더'일 때 사용되는 헤더의 길이로, '통신헤더 타입'이 '통신헤더'이면 TCP/IP

통신헤더 길이, '공통헤더'이면 전문 공통부의 길이이다.

● 메시지 고정길이 (최대 5자리 정수)

'메시지 길이 지정'이 '고정길이'일 때 사용되는 전체 메시지 길이로, 헤더에서 메시지 길이를 얻을 필요

없이 무조건 고정길이만큼 읽는다.

● 장애처리 방식

TCP/IP 통신 장애가 발생한 경우를 감지하고 자동 복구할 수 있는 방식을 설정한다.

설명항목

테스트 전문을 주고받으면서 상대 기관에서 응답이 오지 않을 경우 에러를

감지한다. 게이트웨이에서 지원되는 기능은 아니고, 정의된 테스트 전문을

스케쥴러를 통해 발송하는 방식이다.

테스트 전문 송수신

통신헤더를 이용해 주기적으로 데이터를 보내는 것으로, 테스트 전문 송수신

과 달리 상대 기관이 응답을 주지 않으므로 FIN 패킷을 받기 위해서만 사용

된다.

Health 데이터 송신

회선의 세션 개수를 초과해 새로운 요청이 들어온 경우 가장 오랫동안 사용

되지 않던 기존 세션을 끊고 해당 요청을 받아들이는 방식이다.

New Session Accept

정해진 시간 동안 세션이 사용되지 않으면 해당 세션을 끊는다.Session Timeout

통신 장비로부터 장애 정보를 받는 것으로 현재 지원되지 않는다.SNMP Trap


설명항목

회선에 설정된 최대 세션 개수만큼 모두 연결이 되어 있는 경우, 새로운 세션

이 접속시도를 하게 되면 가장 오래도록 사용하지 않은 세션을 끊고 새로운

New Session Accept/ses

sion Timeout

세션을 받아들이게 된다. 또한 설정된 세션 Timeout 시간을 초과한 경우 그

세션을 끊도록 한다.

기존의 New session accept 방식과 Session timeout 방식을 동시에 사용할

수 있도록 하는 장애처리 방식이다. 해당 회선이 서버모드일 때만 가능하다.

(3.2.5 이상 지원)

Session timeout 시간동안 어떠한 전문 메시지도 해당 세션으로 송수신되지

않을 경우check message를 상대 기관으로 송신한다.

Session Timeout(send

check message)

(3.2.4 이상 지원)

회선이 self-session 방식으로 응답을 보내야 하는 경우 session timeout 시간

이 지났다 하더라도 거래 timeout 시간 동안 session을 끊지 않고 유지하도록

하는 장애 처리 방식이다. 거래 timeout 이후 해당 세션을 끊도록 한다.

Session timeout(R/R)

(3.2.4 이상 지원)

Async 통신 방식의 회선에서 요청전문에 대한 응답전문이 일정 횟수만큼 그

회선으로 되돌아오지 않았을 때를 장애로 판단하고 그 회선을 blocking한다.

장애회선 block 및 자동

복구

추가적인 요청전문은 연결된 다른 회선으로 우회하여 들어가게 하며 blocking

된 회선은 다시 통신이 가능한 상태로 복구한다.

(3.2.5 이상 지원)

00시00분00초부터 Session Timeout에 설정된 시간이 경과했음에도 불구하

고 거래가 없는 회선을 모두 찾아 연결을 끊도록 하는 방식이다.

Session Timeout(after

midnight)

(3.2.5 이상 지원)

Session timeout(after midnight)과 New Session Accept를 동시에 수행할 수

있는 방식이다. 즉, 00시00분00초 부터 Session Timeout에 설정된 시간이 경

Session close from new

session accept

과했음에도 불구하고 거래가 없는 회선을 모두 찾아 연결을 끊거나 회선에

설정된 최대 세션 개수가 모두 채워진 상태에서 새로운 세션이 연결을 시도

하면 때 현재 연결된 세션 중 가장 오랫동안 거래가 없는 세션을 끊어주고 새

로운 세션을 연결하도록 한다. 해당 회선이 서버모드일 때만 가능하다.

(3.2.5 이상 지원)

● Thread G/W 핸들러 수

Thread Listener로부터의 요청을 처리하는 핸들러(handler)의 개수이다. (최대 2자리 정수)

Handshaking 등 blocking I/O 작업을 처리해야 하는 경우의 성능 보장을 위한 것으로 서버의 MIN/MAX

설정값과 동일해야 한다.


● BCD type

이 값을 'Yes'로 하면 '0200'코드가 '0x20' '0x00'으로 들어오는 경우를 처리한다.

● SSL(Secure Socket Layer) 항목

버튼을 클릭하면 다음과 같은 SSL 관련 항목을 볼 수 있다.

각 항목에 대한 설명은 다음과 같다.

설명항목

인증서 검증 여부를 '검증하지 않음', '인증서 있을 경우 검증', '검증 필수'

중에서 선택한다.

인증서 검증 수준

해당 머신에 대한 인증서(certificate) 파일의 절대 경로를 설정한다. (최대

256자리)

인증서

인증서 비밀번호를 설정한다. (최대 32자리)인증서 비밀번호

발급 기관(CA)에 대한 인증서 파일의 절대 경로를 설정한다. 인증서 발급

기관에 대한 신뢰도 확보를 위해 필요하다.(최대 256자리)

인증서 발급기관의 인증서

개인 키(private key) 파일의 절대 경로를 설정한다. (최대 256자리)개인키

Ephemeral keying이란 세션 키의 동적인 변경을 통해 보안성을 강화한

통신 기법이다.

Ephemeral keying 사용 여부

사용하기 위해서는 'Yes'를 선택한다.

Ephemeral keying을 위해 사용되는 파라미터 파일의 절대 경로를 설정한

다. (최대 256자리)

Ephemeral keying 파일 경로


6.3.2. MQ 게이트웨이 추가

EAI에서 MQ Series 연동을 위해 사용되는 TMAX UCS 서버 형태의 MQ Series 어댑터에 대한 설정이다.

게이트웨이를 추가할 때 '프로토콜' 항목을 'MQ Series'로 설정하면 MQ 게이트웨이를 추가할 수 있다.

[그림 6.8] MQ 게이트웨이 추가

각 입력 항목을 다음과 같이 설정한다. 그 외의 항목에 대한 설정은 “6.3.1. 게이트웨이 추가”와 동일하다.

설명항목

'MQ Series'로 선택한다.프로토콜

'프로토콜' 항목을 'MQ Series'로 선택한 경우에만 설정하는 항목으로, MQ

Manager 이름을 설정한다.

MQ Manager명

6.3.3. 기타 게이트웨이 추가

그 외에 추가할 수 있는 게이트웨이는 다음과 같다.

● TCP/IP with CICS connect

IBM 메인프레임의 미들웨어인 CICS와 TCP/IP 통신을 수행하기 위한 것으로 호스트 송신의 경우에 50

Byte CICS 요청 헤더를 붙인다는 점을 제외하면 TCP 게이트웨이와 동일하다.

● TCP/IP with IMS connect

● TCP/IP with DNS

참고

기타 프로토콜에 대한 게이트웨이의 설명은 "AnyLink Online 게이트웨이 안내서"를 참조한다.


6.3.4. 게이트웨이 수정 및 삭제

추가한 게이트웨이를 수정하거나 삭제할 수 있다.

게이트웨이를 수정하려면 시스템 브라우저에서 수정할 게이트웨이를 선택하고 오른쪽 화면에서 정보를

수정 입력한 후 [Gateway 수정] 버튼을 클릭한다.

게이트웨이 삭제는 [Gateway 삭제] 버튼을 클릭한다. 단, 게이트웨이에 연결된 회선이 있을 경우 삭제할

수 없으므로 먼저 회선을 삭제해야 한다.

[그림 6.9] 게이트웨이 수정 및 삭제


6.3.5. 게이트웨이 모니터링

시스템 브라우저에서 모니터링할 게이트웨이를 선택하고, 오른쪽 화면에서 [제어 & 모니터링] 탭으로 이

동하면 게이트웨이에 대한 모니터링 정보를 확인할 수 있다.

화면 왼쪽의 테이블을 통해 게이트웨이에 속하는 모든 회선 상태를 확인할 수 있고, 오른쪽 테이블에는 처

리 건수 등 해당 게이트웨이에 대한 모니터링 상세 정보가 표시된다. 단, 게이트웨이 프로토콜이 Serial인

경우 서버에서 해당 정보가 제공되지 않기 때문에 탭 자체가 표시되지 않으며 HTTP인 경우에는 회선의

상태를 제외한 모니터링 정보만 제공된다.

[그림 6.10] 게이트웨이 모니터링

[제어 & 모니터링] 탭 화면의 각 테이블별 컬럼에 대한 설명은 다음과 같다.

● 회선 상태 조회/서비스 상태 조회

설명컬럼명

회선명이나 게이트웨이 서비스명을 표시한다.회선/서비스명

회선이나 게이트웨이에 대한 상태를 아이콘으로 표시한다.상태

● 모니터링 요소 (전체 / 당일)

당일 정보는 조회 당일에 처리된 건수를 나타내는데, 당일을 판단하는 시점이 해당 일에 처음 거래가 들

어온 시점의 정보이다. 예를 들어, 18일 새벽 1시에 조회를 하는데 18일 자정과 1시 사이에 들어온 거래


가 없을 경우 당일 정보는 그 전날인 17일의 정보가 된다. 18일에 처음 거래가 들어온 시점에서 당일 정

보는 초기화된다.

다음은 각 모니터링 요소에 대한 설명이다.

설명모니터링 요소

Active 세션의 수를 표시한다.Active session #

서버 구동 시점부터의 총 처리 건수를 표시한다.총 처리 건수

대외로부터의(소켓을 통해 받은) 총 요청 건수를 표시한다.대외 총 요청 건수

Mapper로부터의 총 요청 건수를 표시한다.대내 총 요청 건수

대외 총 요청 중 타임아웃(응답을 못 밭은) 건수를 표시한다.대외 timeout 총 건수

대내 총 요청 중 타임아웃 건수를 표시한다.대내 timeout 총 건수

대외 총 요청 중 에러 건수를 표시한다.대외 미전송 총 건수

대내 총 요청 중 에러 건수를 표시한다.대내 미전송 총 건수

참고

회선명을 더블클릭하면 해당 회선의 모니터링 페이지로 바로 이동할 수 있으며 위 모니터링 정보는

배치 게이트웨이에서는 제공되지 않음에 주의한다.

6.4. 회선(Line)본 절에서는 회선별 추가, 수정 및 삭제 방법과 모니터링 기능에 대해 설명한다.

6.4.1. TCP/IP, X.25 회선 추가 및 기관-업무 회선 연결

게이트웨이 프로토콜이 TCP/IP 혹은 X.25일 때의 회선을 추가하려면, 시스템 브라우저에서 회선을 추가

할 게이트웨이를 선택한 후 컨텍스트 메뉴에서 [회선/URL 추가] 메뉴를 선택하거나, 오른쪽 화면에서 [회

선 추가] 버튼을 클릭한다.

단, 이미 존재하는 회선은 추가할 수 없으며 다운된 게이트웨이에 회선을 추가할 경우, 정상적인 회선 사

용을 위해서는 서버를 재기동해야 한다.

[그림 6.11] 회선 추가 후 재기동 메시지


회선 추가 화면에서 회선 정보를 입력한 후 [OK] 버튼을 클릭하면 추가된 회선을 어느 기관-업무에 연결

할 것인지를 설정하는 회선 연결 추가 대화상자가 나타난다. 회선과 연결할 기관 및 업무를 선택한 후 [OK]

버튼을 클릭하면 회선 추가가 완료된다.

회선 연결 추가 대화상자에서 표시되는 기관 및 업무 코드는 업무 개발자들이 스튜디오에서 등록 후 디플

로이한 기관 및 기관-업무 정보이다. Admin을 사용하는 시스템 관리자는 물리적인 회선을 기관-업무에 할

당하는 역할을 담당하므로 업무 개발자들이 등록한 기관 및 기관-업무 정보를 모두 볼 수 있다. 단, 게이트

웨이의 'Type'이 '온라인 Thread'인 경우 게이트웨이가 아닌 사용자가 직접 작성한 핸들러에서 파싱을 담

당하게 되므로 기관-업무 연결은 생략된다.

참고

머신별 X.25 회선 설정은 "AnyLink Online 게이트웨이 안내서"를 참조한다.

[그림 6.12] 회선 추가 및 기관-업무 회선 연결



● 회선 이름 (최대 16자리)

회선을 대표하는 심볼명(고유명칭)을 설정한다.

● 회선명/IP 주소

설명구분

모드에 따라 IP 주소를 입력한다.TCP/IP

– Server 모드의 경우 : 노드 IP를 설정한다.

– Client 모드의 경우 : 연결할 IP를 설정한다.

최대 128자리로 회선명을 설정한다. HP 머신의 경우 X.25 카드명을 입력한다.X.25

● LU 이름/포트 번호

설명구분

모드에 따라 포트 번호를 입력한다.TCP/IP

– Server 모드의 경우 : Listen할 포트 번호를 설정한다.

– Client 모드의 경우 : 연결할 포트를 설정한다.

최대 16자리로 LU명을 설정한다. NCR과 DEC 머신에서 사용하는 것으로, LCN(LU)

별로 로컬명을 별도로 입력한다.

X.25

● X.25 회선번호 (최대 5자리 정수)

IBM과 SUN 머신에서 사용하는 것으로, LCN(LU)가 공유하는 링크(Link) 번호이다.

● X.25 장치명 (최대 32자리)

IBM과 Sun 머신에서 사용하는 것으로, X.25 게이트웨이의 디바이스명을 설정한다.

● X.25 LU 번호 (최대 3자리 정수)

HP, IBM, Sun 머신에서 사용하는 것으로, 하나의 물리적인 링크를 논리적인 LU로 분할하여 사용할 때

LU의 시작 번호를 입력한다.

● 세션 수 (최대 3자리 정수)

Server 모드일 때는 최대 수용할 세션의 수, Client 모드일 때는 연결할 세션의 수를 입력한다. 단, 배치

게이트웨이에 속하는 회선의 경우 그 세션의 합이 30을 넘을 수 없고, 넘을 경우 다음과 같이 오류 메시

지가 출력된다.


● TCP/IP C/S 구분

다음 설정값 중 하나를 선택한다.

설명설정값

서비스를 수행하기 위해 특정 포트에서 Listen한다. 따라서 한 노드에 동일한

포트의 Server 모드 회선을 2개 이상 등록할 수 없다.

Server

서비스를 요청하기 위해 특정 IP 및 포트로 연결한다.Client

필요할 경우에만 연결하고 응답을 받은 후 연결을 끊는 방식으로 게이트웨이

를 구동할 때 연결을 맺어 계속 유지되는 'Client'와 구별되며 동기 통신만 가

능하다.

Client(수시)

MegaBox 네트워크 장비에서의 XOT(X.25 over TCP) 구현한다.Client(MegaBox XOT)

XOT란 대외기관과 장비간은 X.25, AnyLink 게이트웨이와 장비 간은 TCP를

사용하는 구조로써 기존 X.25 망을 계속 사용할 수 있도록 하는 것이다. 게이

트웨이에서는 MegaBox 장비가 X.25를 TCP/IP로 변환할 때 붙이는 6 Byte

헤더를 버리고 파싱을 수행한다.

'Client'와 유사하나 게이트웨이가 구동할 때가 아닌 최초 전문 요청의 경우에

연결이 맺어진다는 점이 다르다.

Client(on demand)

요청할 서비스가 있을 때 연결을 맺어 요청을 보내고 회선을 끊는다.Client(수시 Oneway)

Anylink가 설치된 장비가 TCP/IP 통신 프로토콜을 이용하는 장비인 경우,

X.25 통신 프로토콜을 이용하는 외부 리모트 노드인 Megabox 장비와 통신

이 가능하도록 하는 회선이다.

Client(MegaBox EOR)

Client(Megabox XOT)와는 달리 주고받는 전문 메시지의 끝에 특수한 End

문자를 추가한다.

일반적인 Client 회선은 연결이 끊어지면 설정된 재접속 간격 이후 다시 연결

을 시도한다.

Client(즉시연결복원)

하지만 Client(즉시연결복원) 회선은 연결이 끊어지자 마자 바로 연결 시도를

한 번 한다. 단 한번의 연결 시도에서 연결이 맺어지지 않으면 일반 Client 회

선과 같이 재접속 간격 이후 다시 연결 시도를 한다.

X.25 장비와 연결 시 상대 기관으로부터 들어오는 데이터에 Connection 정보

가 들어있는 data가 공통부 앞에 들어있을 경우 이 Connection data를 읽어

들이지 않고 Skip하는 기능이다.

Client(MegaBox EOR

Conn. Skip)

Megabox EOR 방식을 지원하는 Server 회선이다.Server(MegaBox EOR)

● 처리 방식

게이트웨이를 기준으로 한 회선 방향성(데이터 흐름)에 대해 설정한다.

설명항목

송수신 모두 가능하다.ANY_CHANNEL


설명항목

송신만 가능하다.OUT_CHANNEL

수신만 가능하다.IN_CHANNEL

● 재접속 간격 (최대 3자리 정수)

'Client' 모드일 때, 세션이 끊어지고 난 후 재접속하는 주기를 설정한다. (단위: 초)

● nsdu (최대 4자리 정수)

X.25 게이트웨이와 원격 노드 간 송수신하는 가장 큰 메시지의 크기를 나타낸다.

● nidu (최대 4자리 정수)

IBM과 Sun 머신에서만 사용하는 것으로, X.25 게이트웨이와 원격 노드 간 한 번에 송수신할 수 있는 메

시지의 크기를 설정한다.

nsdu로 정의한 전체 메시지를 nidu에서 지정한 크기 단위로 송수신한다.

● 회선 재사용 여부

비동기(asynchronous) 통신 여부를 설정한다.

설명항목

특정 세션으로 요청을 보낸 후 응답이 오기 전에는 요청을 보낼 수 있다.Yes

'Client(수신)' 타입일 경우에는 무조건 'No'로 고정된다.No

● 출력 회선 이름(최대 16자리)

요청이 이 회선으로 들어왔을 때 응답을 보낼 회선의 심볼명을 설정한다. 스튜디오의 기관-업무 정보 중

대외송신 방식이 'Selection'일 때 사용된다.

● 물리 회선 정보 (최대 20자리)

해당 회선에 문제가 생겼을 때 연락처나 기타 용도로 쓸 수 있는 공간이다.

● Session Timeout (최대 3자리 정수)

정해진 시간(초) 동안 세션이 사용되지 않으면 해당 세션을 끊는 것으로 게이트웨이의 장애처리 방식이

'Session Timeout'인 경우에만 사용된다.

● Real/Backup 구분

Active-Standby 개념으로서 평소에는 'Real'로 설정된 회선을 사용하다가 해당 회선에 문제가 발생한 경

우에만 'Backup'으로 설정된 회선을 사용한다.

게이트웨이는 기관-업무 회선 연결 정보로부터 사용 가능한 Real 및 백업(Backup) 회선을 찾게 되며 백

업 게이트웨이(서비스명)와 마찬가지로 데이터 전달 보장을 위한 것이다.


● IMS Connect 항목

IMS Connect는 SNA 대신 TCP/IP를 이용한 호스트 통신 방식을 제공하는 데몬으로서 IMS Connect 게

이트웨이('TCP/IP with IMS connect' 프로토콜을 갖는 온라인 게이트웨이)를 통해 클라이언트 모드로

접속할 수 있다.

호스트 기준으로 Inbound 전문은 'OUT_CHANNEL'로, Outbound 전문은 'IN_CHANNEL'로 나뉘어 전

송되는 비동기 구조이므로 회선을 등록할 때 'OUT_CHANNEL' 및 'IN_CHANNEL' 짝을 이루어 등록해

야 한다.

버튼을 클릭하면 다음과 같은 IMS Connect 관련 항목이 나타난다.

[그림 6.13] IMS Connect 항목

설명항목

LTERM 필드를 채우기 위한 값으로 HOST로부터 할당받는다.Logical Terminal

(최대 8자리)

resume-Tpipt session의 start/stop command 전송 시 사용되는 Tmember

이름이다.(최대 8자리)

IMS CONNECT member

IRM 헤더의 Datastore ID를 채울 때 사용한다.(최대 8자리)Data Store Name

send-only session의 경우 데이터 송신 시, resume-Tpipe session의 경우

"Cancel Timer", "Resume Tpipe","ACK"를 보낼 때 사용한다.(최대 8자리)

Client ID for Data

'IN_CHANNEL'일 경우 등록해야 하는 클라이언트 ID를 입력한다.(8자리)Client ID for IMS Command'


6.4.2. MQ 게이트웨이 회선 추가

MQ 게이트웨이의 회선 추가 화면은 다음과 같다.

[그림 6.14] MQ 게이트웨이 회선 추가

설명항목

회선에 할당된 queue이름을 할당한다.Queue 이름

1세션 수

ClientTCP/IP C/S 구분

'IN_CHANNEL'은 Get Queue, 'OUT_CHANNEL'은 Put Queue를 의미한다.처리 방식

Get Queue의 polling 주기를 설정한다. (단위: 초)재접속 간격

Get Queue의 경우 타임아웃 시간을 설정한다. (단위: 초)Timeout for Get Queue


6.4.3. URL 추가

게이트웨이 프로토콜이 'HTTP'일 경우 URL을 추가한다.

HTTP 프로토콜 기반인 SOAP, ebXML 등의 지원을 위해서 추가되어야 하는 URL 정보를 입력한다. 시스

템 브라우저에서 URL을 추가할 게이트웨이를 선택하고 컨텍스트 메뉴에서 [회선/URL 추가] 메뉴를 선택

하거나 오른쪽 화면에서 [URL 추가] 버튼이나 [회선 추가] 버튼을 클릭한다. 단, 이미 존재하는 URL은 추

가할 수 없는데 Inbound의 경우 URL, 타입, 노드명, 게이트웨이명이 동일할 때 같은 것으로 간주하고,

Outbound의 경우에는 위 4개 조건 이외에 기관 및 업무코드까지 동일할 때 같은 것으로 판단한다.

다음은 URL 추가 화면이다.

[그림 6.15] URL 추가


● URL (최대 128자리)

URL이 입력된다.


● 타입

설명설정값

지정된 포트에서 Listen하는 것으로 이상 없이 Listen될 경우 HTTP 게이트웨이가

정상적인 RDY 상태로 된다. 'URL' 항목의 입력할 때 'http://'로 시작할 수 없다.

Inbound

지정된 IP 주소 및 포트로 연결한다.Outbound

● IP 주소 / 포트번호

'타입'이 'Inbound'일 때는 Listen할 포트, 'Outbound'일 때는 연결할 IP주소 및 포트를 설정한다.

예를 들어, 타입이 'Inbound'이고 클라이언트에서 'http://192.168. 1.10:8989/<context>'로 호출하는 경

우(192.168.1.10은 HTTP 게이트웨이의 IP 주소) 위 그림과 같이 '포트번호'는 '8989', 'URL'은 클라이언

트의 호출값 '192.168.1.10:8989/<context>'로 등록되어야 한다. 단, Java Mapper에는 해당 컨텍스트

(context)에 대한 환경(WEBMain.xml, jeus-web-dd_<context>.xml, web.xml 등)이 설정되어 있어야 한

다.

● 세션 수 (최대 3자리 정수)

'타입'이 'Inbound'일 때는 최대 수용할 세션의 수, 'Outbound'일 때는 연결할 세션의 수를 입력한다.

● 기관 / 업무

해당 URL과 연결된 기관-업무를 선택한다. HTTP 게이트웨이는 URL 요청을 받으면 해당 URL의 기관-

업무 정보를 찾고 이에 따라 서비스를 호출하기 때문에 반드시 입력해야 한다.

'Inbound' 모드에서 여러 기관-업무가 하나의 URL을 공유할 수도 있으며 이를 위한 설정은 “Appendix B. 기

관-업무의 Inbound URL 공유”를 참조한다.

기관 및 업무코드는 업무 개발자들이 스튜디오에서 등록한 후 디플로이한 기관 및 기관-업무 정보이다.

Admin을 사용하는 시스템 관리자는 물리적인 회선을 기관-업무에 할당하는 역할을 담당하므로 업무 개

발자들이 등록한 기관 및 기관-업무 정보를 모두 확인할 수 있다.

● 기관코드 필드명 (최대 128자리)

기관 코드를 찾기 위한 XML Element명으로 현재는 구현되어 있지 않다.

● 서버명 (최대 256자리)

가상 호스트(virtual host) 지원을 위한 호스트명(HTTP 1.1)을 입력한다.

가상 호스트란 한 서버에서 여러 웹 사이트를 서비스하는 것이다. 예를 들어, 사용자가 'www.tmax.co.kr'

혹은 'www.tmax.com'으로 요청하면 브라우저는 HTTP 헤더의 'Host' 필드에 호스트명을 설정하게 되고,

이를 받은 서버에서는 이 호스트명에 따라 별도의 서비스를 수행(Callback 함수 호출)하게 된다.

현재는 구현되어 있지 않다.

● Parameter (최대 256자리)

SOAP, ebXML 배치에서 사용되는 파라미터를 입력한다.

입력은 fromID=inst1, toID=inst2와 같이 name=value 형태로 입력하되 콤마( , )로 구분한다.


ValueName구분

SOAPAction 값이다.soapactionSOAP

CPA 문서 ID이다.cpaIDebXML

CPA 문서에 기술된 From Party ID이다.fromID

CPA 문서에 기술된 To Party ID이다.toID

● 사용자명(최대 32자리) / 암호 (최대 64자리)

WebDAV 배치의 사용자 정보로서 암호는 Base64 인코딩으로 저장된다.

6.4.4. 회선 수정 및 삭제

수정할 회선 및 URL을 시스템 브라우저에서 선택하고 오른쪽 화면에서 정보를 수정 입력한 후 [회선 수

정] 버튼을 클릭한다.

URL의 경우 유일 키에 포함되는 기관 및 업무 정보는 수정이 불가능하다.

회선 및 URL 삭제는 [회선 삭제]버튼을 클릭한다. 단, 회선에 연결된 기관-업무가 있을 경우 삭제할 수 없

으므로 먼저 기관-업무를 삭제하도록 한다.

[그림 6.16] 회선 수정 및 삭제

6.4.5. 회선/URL 중지 및 재개

회선 및 URL의 중지 및 재개를 위해서는 해당 회선 및 URL을 선택하고 컨텍스트 메뉴에서 [중지] 혹은

[재개] 메뉴를 선택한다.

활성화된 회선을 중지하면 'Client' 모드 회선인 경우에는 연결을 끊고, 'Server' 모드 회선인 경우에는 Listen

포트를 닫은 후 연결된 회선을 끊는다. URL을 중지하면 해당 URL을 사용하지 못하게 된다. 회선이 중지

되면 다음과 같이 회선이 중지된 아이콘이 표시된다. URL도 마찬가지이다.


회선 중지는 '재접속 간격'이 0보다 큰 'Client' 및 'Server' 모드 회선 모두에 대해 가능하다. 중지된 회선 및

URL에 대해서는 재개가 가능하다.

[그림 6.17] 회선 중지 및 재개

6.4.6. 회선 접근 제어

회선에 연결하려는 클라이언트의 IP에 따른 접근 제한 및 허용 기능으로, 해당 회선을 선택하고 컨텍스트

메뉴에서 [회선 접근 제어] 메뉴를 선택한다. 단, 'Server' 모드 회선이나 'Inbound' 타입 URL일 경우에만

메뉴 선택이 가능하다.

IP 오른쪽의 리스트는 IP를 추가할 때 함께 등록된 Client ID를 나타낸다.

[그림 6.18] 회선 접근 제어

다음은 회선 접근 제어 화면의 각 선택 항목에 대한 설명이다.

설명항목

Client IPs에 표시된 IP에 관계없이 접근을 허용하는 경우 선택한다.모두 허용

Client IPs에 표시된 IP에 대해 접근을 허용하는 경우 선택한다.등록된 회선만 허용

Client IPs에 표시된 IP에 대해 접근을 제한하는 경우 선택한다.등록된 회선만 차단


회선 접근 제어 화면의 [추가] 및 [삭제] 버튼을 통해 해당 회선에 대한 접근을 제한 혹은 허용하고자 하는

IP를 추가 및 삭제할 수 있다.

다음은 [추가] 버튼을 클릭하여 Client IPs를 추가하는 화면이다.

[그림 6.19] 접근 제어 회선 추가

Client IPs 화면의 입력 항목에 대한 설명이다.

설명항목

접근을 제어할 IP 주소 혹은 (DNS에 등록된) 호스트명을 입력한다.IP 주소

Thread 게이트웨이가 Client-dedication 모드로 동작할 경우 특정 클라이언트를 지

칭하기 위한 ID를 입력한다.

Client ID

6.4.7. 기관-업무 보기

해당 회선과 연결된 기관-업무 목록을 조회하려면 시스템 브라우저에서 회선 노드를 선택하고 컨텍스트

메뉴에서 [기관-업무 보기] 메뉴를 선택하면 다음과 같이 해당 회선과 연결된 기관 및 업무코드를 확인할

수 있다.

[그림 6.20] 기관-업무 보기


6.4.8. 회선 모니터링

[제어 & 모니터링] 탭을 클릭하면 처리 건수 등 해당 회선에 대한 모니터링 정보를 확인할 수 있다. 단,

TCP/IP 회선만 모니터링이 가능하다.

다음 화면의 '모니터링 요소(전체 / 당일)' 컬럼에 대한 설명은 게이트웨이 모니터링 요소와 동일하므로 자

세한 설명은 “6.3.5. 게이트웨이 모니터링”을 참고한다.

[그림 6.21] 회선 모니터링


6.4.9. X.25 회선 상태 통지

X.25 회선에 리셋(RESET) 데이터가 발생한 경우 Event Browser를 통해 해당 상황을 확인할 수 있다.

[그림 6.22] X.25 회선 상태 통지

진단 코드(diagnostic code) 및 사유 코드(cause code)에 의한 필터링을 지원한다. 필터링이란 리셋 데이

터에 대한 이벤트가 발생한 경우 해당 사유 코드나 진단 코드가 둘 중 하나라도 파일 내에 설정된 경우에

만 Event Browser에 표시하는 기능이다. 구동 스크립트의 'AL_ADMIN_HOME' 속성에 정의된 디렉터리

에 위치하는 x25.properties 파일에 의해 설정된다.

예를 들어 파일 내용이 다음과 같을 경우 서버로부터 사유 코드가 1이고, 진단 코드가 40인 X.25 이벤트

통지가 오면 파일에 설정된 사유 코드 값이므로 해당 메시지와 함께 Event Browser에 표시된다.

# Cause Codes

cause_code.values = 1,3

cause_code.values.1 = Out of order (PVC only)

cause_code.values.3 = Remote procedure error

# Diagnostic Codes

diag_code.values = 38,39

diag_code.values.38 = Packet too short

diag_code.values.39 = Packet too long

위 예에서는 X.25 회선이 다운되었을 때 그 사유 코드가 1이나 3, 혹은 그 진단 코드가 38이나 39일 경우

에만 Event Browser에 표시되고 나머지는 무시된다. 단, 해당 파일이 없으면 모두 표시된다.

6.5. Mapper전문 변환을 수행하는 엔진을 Mapper라 하며 현재 C Mapper와 Java Mapper 두 가지가 있다.

게이트웨이는 요청 전문을 받으면 파싱하여 전문과 관련된 기관-업무를 찾고 해당 기관-업무 정보의

'Mapper 서비스명'에 설정된 서비스를 호출하여 전문 변환을 위임한다.

6.5.1. Mapper 추가

시스템 브라우저에서 'Mapper' 노드를 선택하고 컨텍스트 메뉴에서 [Mapper 추가] 메뉴를 선택하거나 오

른쪽 화면에서 [Mapper 추가] 버튼을 클릭한다. 단, 이미 존재하는 Mapper는 추가할 수 없으며, Mapper

추가 후에는 서버(Tmax)를 재기동해야 해당 정보가 반영된다. Mapper는 Tmax 서버이기 때문에 물론

tmconfig에도 반영되어야 한다.


다음은 Mapper 추가 화면이다.

[그림 6.23] Mapper 추가

다음은 Mapper 추가 화면의 각 입력 항목에 대한 설명이다.

설명항목

Mapper의 종류에 따라 다음과 같이 Mapper명을 입력한다. (최대 32자리)(필

수 입력 항목)

노드명_컨테이너명

– Java Mapper : 'tmaxs1_container1' 같이 <노드명>_<컨테이너명> 형태로

입력한다.

– C Mapper : 'tmaxs1_C Mapperd000' 같이 <노드명>_<서버명><seq> 형태

로 입력한다. <서버명>은 tmconfig의 SERVER 절에 등록된 Tmax 서버명

이고, <seq>는 세 자리로 000부터 시작하여 tmconfig에 설정된 MIN 개수

만큼 등록한다.

'Java' 혹은 'C'로 선택한다. (필수 입력 항목)타입

AnyLink 헤더 없이 Mapper를 호출할 경우 입력해야 한다.기관코드 / 업무코드

Java Mapper의 경우 AnyLink 헤더 없는 호출을 지원하지 않으므로 기관 및

업무코드를 선택할 수 없다.

Mapper의 Tmax 서비스명을 입력한다. (최대 16자리) (필수 입력 항목)서비스명


설명항목

스튜디오에서 기관-업무 정보의 'Mapper 서비스명'과 비교하여 해당 업무의

C 혹은 Java 여부를 판단하고 그에 맞는 컨텍스트 메뉴를 제공한다.

C Mapper의 처리 건수로서 유량 제어를 위한 값이다. (최대 2,147,483,647)최대 처리 건수

유량 제어란 C Mapper에서 비즈니스 서비스 호출 후 응답받지 못하고 내부

큐(queue)에 쌓인 건수가 이 값을 초과하는 시점부터 CLH로부터 요청을 받

지 않다가, 서비스로부터 응답을 받아 큐 건수가 최대 처리 건수 이하로 내려

가게 되면 요청을 받는 기능이다.

Java Mapper는 동기(sync; 매핑이 완료될 때까지 세션 유지) 방식이므로 처

리 건수가 CPC 개수를 초과하면 자동으로 블럭되지만, C Mapper는 비동기

(CLH로부터 요청을 받은 후 바로 세션을 풂) 방식이므로 내부 큐에 의한 별

도의 제어가 필요한 것이다.

Mapper 프로세스 단위당(C Mapperd_000, C Mapperd_001, ...) 적용된다.

여러 기관-업무가 회선을 공유할 때 기관-업무 유일키 정보를 찾기 위한 오프

셋을 설정한다.

기관-업무 유일키 offset

여러 기관-업무가 회선을 공유할 때 기관-업무 유일키 정보를 찾기 위한 길이

를 설정한다.

기관-업무 유일키 length

여러 기관-업무가 회선을 공유할 때 기관-업무 유일키를 가진 필드명을 입력

한다.

기관-업무 유일키 필드명

서버 환경 설정

Admin에서 추가된 Mapper의 활성화를 위해서는 서버 환경 설정이 추가적으로 필요하다.

서버 환경 설정 과정은 다음과 같이 JavaMapper와 CMapper로 나누어 설명한다.

● JavaMapper

Mapper가 있는 상태('tmaxh2_container1'으로 가정)에서 Admin에 JavaMapper를 추가('tmaxh2_contain

er2'로 가정)한다.

1. JEUSMain.xml에서 컨테이너 및 서블릿 엔진을 추가한다. 컨테이너명은 Admin에서 추가한 이름(<

노드명>_<컨테이너명>) 중 컨테이너명과 동일해야 한다.

<engine-container>

<name>container2</name>

<command-option>

-d64 -DALSERVER_IP=x.x.x.x -DALSERVER_PORT=xxx </command-option>

<engine-command>

<type>servlet</type>

<name>engine2</name>

<startup-mode>xml</startup-mode>

</engine-command>


--생략--

</engine-container>

2. 추가된 서블릿 엔진의 WEBMain.xml에서 TmaxListener를 추가한다.

<tmax-listener>

<listener-id>alinkjmapp</listener-id>

<dispatcher-config-class>

anylink.engine.AnyLinkDispatcherConfig</dispatcher-config-class>

<server-name>alinkjmapp</server-name>

<tmax-address>x.x.x.x</tmax-address>

<port>xxx</port>

--생략--

</tmax-listener>

3. Anylink 컨텍스트를 추가한다.

4. 서버의 설정 파일(tmconfig 즉, anylink.m) 중 SERVER 절의 JavaMapper에 대한 MIN 개수를 2로 수

정한다.

alinkjmapp SVGNAME = svg1,

MIN = 2, MAX = 2,

CPC = 10,

SVRTYPE = EXT SVR

5. 다음의 순서로 설정 파일을 컴파일한다.

a. cfl –i anylink.m

b. gst

6. 서버 및 JEUS를 재구동한다.

7. Admin 재구동하여 추가된 Mapper가 활성화됨을 확인한다.

참고

보다 자세한 설정은 “AnyLink 서버 안내서”의 “제2장 환경설정” 및 “AnyLink 서버 안내서”의 “3.2.

JMapper 구동”을 참조한다.

● CMapper

Mapper가 있는 상태('tmaxh2_C Mapperd000'으로 가정)에서 Admin에 CMapper를 추가('tmaxh2_C

Mapperd001'으로 가정)한다.

끝 3자리가 서버의 개수(000부터 시작)를 의미하므로 이는 CMapper를 2개 사용한다는 의미가 되고 서

버 환경 설정도 이에 맞게 조정해야 한다.

1. 서버의 설정 파일(tmconfig 즉, anylink.m) 중 SERVER 절의 CMapper에 대한 MIN 개수를 2로 수정

한다.


cmapperd SVGNAME = svg1,

MIN = 2, MAX = 2,

CPC = 10, RESTART = N,

SVRTYPE = CUSTOM_GATEWAY,

CLOPT = "-o $(SVR).$(CDATE).log -e $(SVR).$(CDAT E).log

2. 다음의 순서로 설정 파일을 컴파일한다.

a. cfl –i anylink.m

b. gst

3. 서버를 재구동한다.

4. Admin을 재구동하여 추가된 Mapper가 활성화됨을 확인한다.

참고

보다 자세한 설정은 “AnyLink 서버 안내서”의 “제2장 환경설정” 및 “AnyLink 서버 안내서”의 “3.1. C

엔진 구동”을 참조한다.

6.5.2. Mapper 수정 및 삭제

추가한 Mapper를 수정 및 삭제할 수 있다.

수정할 Mapper를 시스템 브라우저에서 선택하고, 오른쪽 화면에서 정보를 수정 입력한 후 [Mapper 수정]

버튼을 클릭한다. Mapper 정보의 수정은 실시간 적용이 불가능하므로 서버를 재기동해야 반영된다.

Mapper를 삭제하려면 [Mapper 삭제] 버튼을 클릭한다.

[그림 6.24] Mapper 수정 및 삭제


6.5.3. Mapper 모니터링

Mapper 모니터링에는 2가지가 있다.

● Mapper 상태 모니터링

Mapper 노드에서 확인할 수 있으며, 등록된 모든 Mapper의 현재 상태를 반영한다.

● Mapper Thread 모니터링

해당 Java Mapper를 선택했을 때 현재 처리되고 있는 Thread 정보를 확인할 수 있다.

Mapper 상태 모니터링

'Mapper' 노드의 [제어 & 모니터링] 탭 화면에서 등록된 모든 Mapper의 현재 상태를 확인할 수 있다.

[그림 6.25] Mapper 상태 모니터링


설명컬럼명

Mapper 명을 표시한다.Mapper

Mapper 서비스명을 표시한다.서비스명

Mapper의 상태를 아이콘으로 표시한다.상태

– : 구동 중

– : 미구동


Mapper Thread 모니터링

해당 Java Mapper 노드의 [제어 & 모니터링] 탭 화면에서 현재 처리되고 있는 Thread 정보를 확인할 수

있다.

[그림 6.26] Mapper Thread 모니터링


설명컬럼명

현재 수행 중인 Thread ID를 표시한다.쓰레드 ID

현재 처리 중인 전문의 기관 코드를 표시한다.기관코드

현재 처리 중인 전문의 업무 코드를 표시한다.업무코드

현재 처리 중인 전문의 종별 코드를 표시한다.종별코드

현재 처리 중인 전문의 거래구분 코드를 표시한다.거래구분코드

비즈니스 서비스 타입(스튜디오 거래 파라미터 정보의 '서비스 유형')을 표시

한다.

서비스 구분

서비스 명 혹은 Java 클래스명을 표시한다.서비스명

Thread 수행 시간을 표시한다. (단위: milliseconds)처리 시간 (ms)


제7장 도구

본 장에서는 도구 메뉴에 대해 설명한다.

7.1. 기관-업무 회선 연결대외 기관에서 전문이 특정 회선을 통해 들어왔을 때 해당 회선과 연결된 기관-업무 정보를 알아야 게이트

웨이에서 전문 처리가 가능하기 때문에 회선을 특정 기관-업무와 연결해 주는 기능이 필요하다.

Admin에서는 회선을 추가할 때 기관-업무와 연결하는 것 외에 별도의 메뉴를 제공하여 지원하고 있다. 추

가할 때 또는 [Tools] > [기관-업무 회선] 메뉴를 통해 기관-업무와 회선을 연결하게 되며, 브라우저를 통

해 연결 정보를 확인할 수 있다.

7.1.1. 기관-업무 회선 브라우저

기관-업무 회선 브라우저는 현재 기관-업무 회선 연결 상태를 확인할 수 있는 브라우저이다. [Tools] >

[Line Browser] 메뉴를 통해 표시 여부를 제어할 수 있다.

컨텍스트 메뉴의 [회선 정보 추가]를 통해 회선을 추가하거나, [회선 정보 보기] 메뉴를 통해 연결된 회선

정보(회선과 연결된 기관의 담당자 정보)를 확인할 수 있다.

[그림 7.1] 기관-업무 회선 브라우저

제7장 도구 91

7.1.2. 연결 추가 및 삭제

연결 추가는 브라우저의 업무 노드( )를 선택하고 컨텍스트 메뉴의 [회선 연결 추가] 메뉴를 선택하거

나 [Tools] > [기관-업무 회선] 메뉴를 선택(또는 <Ctrl>+L 단축키)하여 실행할 수 있다.

회선 연결 추가 대화상자에서 '기관코드', '업무코드' 및 연결할 '회선'을 콤보박스에서 선택하고, [OK] 버

튼을 클릭하면 브라우저 트리에 추가된다. 대화상자에서 표시되는 기관 및 업무코드는 업무 개발자들이

스튜디오에서 등록한 후 디플로이한 기관 및 기관-업무 정보이다.

Admin을 사용하는 시스템 관리자는 물리적인 회선을 기관-업무에 할당하는 역할을 담당하므로 업무 개발

자들이 등록한 기관 및 기관-업무 정보를 모두 확인할 수 있다.

[그림 7.2] 회선 연결 추가

연결 삭제는 브라우저의 회선 노드를 선택하고 컨텍스트 메뉴에서 [회선 연결 삭제] 메뉴를 선택한다.

7.2. 업무/거래 제어전문 필드의 특정 값에 따라 업무 및 거래를 중지 및 재개할 수 있는 기능으로 [Tools] > [업무/거래 제어]

메뉴를 선택하거나 혹은 <Ctrl>+T 단축키를 사용한다.

7.2.1. 업무/거래 선택

중지 및 재개시킬 업무나 거래를 선택한다.

업무 단위로 중지 및 재개할 경우에는 '기관'을 선택한 후 [조회] 버튼을 클릭하면 화면 아래 테이블에 업

무 목록이 표시된다. 개별 거래 단위할 경우에는 '업무' 및 '종별코드'를 선택한 후 [조회] 버튼을 클릭하면

화면 아래 테이블에 거래 목록이 표시된다.


업무 혹은 거래 목록이 표시되면 현재 상태 확인 후 중지 및 재개할 대상을 선택한다.

[그림 7.3] 업무/거래 제어

다음은 검색 조건의 각 항목에 대한 설명이다.

설명항목

조회할 기관을 선택한다.기관

업무 코드 선택 후 조회하면 해당 업무만 표시된다.업무

조회할 종별 코드를 선택한다.종별코드

거래구분 코드 선택 후 조회하면 해당 거래만 표시된다.거래구분코드

현재 상태가 아이콘으로 표시된다.현재 상태

– : 거래 재개(허용) 상태

– : 거래 중지 상태

제7장 도구 93

7.2.2. 중단 조건 입력 및 실행

업무 혹은 거래 선택 후 중단 조건을 입력해야 한다. 중단 조건이란 업무 혹은 거래의 중지 및 재개에 대한

기준이 되는 입력 전문의 특정 필드값을 의미하는 것이다. 즉, 오프셋 및 길이 혹은 필드명에 의해 지정된

필드의 값이 입력 값에 해당하는 경우 중지 및 재개 대상이 된다.

전문에 관계없이 무조건 중지 및 재개하고자 하는 경우에는 중단 조건 체크박스를 해제한 후 중지 및 재개

하면 된다. 중지는 중단 조건 입력 후 [중지] 버튼을 클릭하여 실행한다. 중지된 상태에서는 중단 조건에

해당하는 거래에 대해 Mapper가 에러를 발생하며 이를 해제하고자 할 경우에는 [재개] 버튼을 클릭한다.

[그림 7.4] 업무/거래 제어 – 중단 조건 입력

다음은 중단 조건의 각 항목에 대한 설명이다.

설명항목

필드에 대한 위치와 길이(Stream 전문)를 설정한다.서비스 중단 필드 offset/length

필드명(XML/VO 전문)을 설정한다.서비스 중단 필드명

중지/재개 대상이 되는 범위 값을 설정한다.서비스 중단 필드값

예를 들어 '2222'와 '3333'을 입력하고 거래를 중지시킨 경우, 거래가

들어왔을 때 입력 전문 중 서비스 중단 필드의 값이 '222244'라면 범위

내의 값이므로 거래는 수행되지 않고 에러가 발생한다. 단, 'Numeric'

체크박스를 선택하고 중지시킨 경우라면 '2222', '3333', '222244'를 숫

자로 인식하게 되므로 범위(2222 ~ 3333)에 포함되지 않아 거래가 정

상 수행된다.

7.3. 사용자 관리스튜디오 및 Admin 사용자를 관리할 수 있는 기능이다.

사용자의 추가, 삭제 및 정보 수정이 가능하며 Admin 사용자의 경우는 관리자(root), 시스템 매니저(sysmgr),

게스트(guest)라는 기본 역할 외 추가적인 역할 관리가 가능하다. 사용자 정보는 “2.3.1. 사용자 역할에 따

른 로그인”의 사용자 정보 표를 참조한다.


7.3.1. 사용자 추가

사용자를 추가하려면 [Tools] > [사용자 관리] 메뉴를 선택하거나 혹은 <Ctrl>+U 단축키를 사용한다. 사용

자 관리 화면에서 [추가] 버튼을 클릭한 후 나타나는 사용자 추가/수정 대화상자에서 사용자 정보를 입력

한다.

[그림 7.5] 사용자 추가

다음은 각 입력 항목에 대한 설명이다.

설명항목

사용자 ID를 입력한다. (최대 28자리)ID

사용자명을 입력한다. (최대 12자리)이름

사용자 암호를 입력한다. (최대 15자리)암호

해당 사용자가 가질 역할(role)을 선택한다.역할

스튜디오 사용자를 추가할 경우에는 'User'를 선택한다.

Admin 사용자를 추가할 경우에는 역할 관리를 통해 추가된 역할 중 하나를 선택한다.

E-mail 주소를 입력한다. (최대 64자리)E-mail

제7장 도구 95

설명항목

전화번호(숫자와 '-'만 입력 가능)를 입력한다. (최대 32자리)전화번호

7.3.2. 사용자 정보 수정 및 삭제

사용자 정보를 수정하려면 사용자 관리 화면에서 해당 사용자를 선택하고 [수정] 버튼을 클릭한다. 사용

자 추가/수정 대화상자에서 수정할 값을 입력한 후 [OK] 버튼을 클릭한다.

[그림 7.6] 사용자 정보 수정

사용자 정보를 삭제려면 사용자 관리 화면에서 해당 사용자를 선택하고 [삭제] 버튼을 클릭한다. 단, Admin

사용자('root', 'sysmgr', 'guest')는 시스템에서 예약된 것이므로 삭제하거나 '역할'을 변경할 수 없다.

7.3.3. 역할 관리

Admin 사용자의 권한 관리를 위한 것으로 역할에 따라 Admin 메뉴에 대한 접근 권한을 부여하는 것이다.

즉, 특정 메뉴에 대한 접근 권한만을 갖는 역할을 추가하고 사용자에 역할을 할당함으로써 해당 사용자가

로그인할 경우 사용할 수 있는 메뉴를 제한할 수 있다. [Tools] > [사용자 관리] > [역할 관리] 메뉴를 선택

한다.


[그림 7.7] 역할 관리

역할 추가 및 삭제

역할을 추가하려면 역할 관리 대화상자에서 [추가] 버튼을 클릭한 후 '역할'을 입력하고 [확인] 버튼을 클

릭한다.

[그림 7.8] 역할 추가

역할 삭제는 '역할' 콤보박스에서 해당 역할을 선택하고 [삭제] 버튼을 클릭한다. 단, 삭제하려는 역할을

갖는 사용자가 있는 경우에는 삭제가 불가능하므로 먼저 해당 사용자를 삭제해야 한다.

제7장 도구 97

메뉴 접근 권한 설정

'역할' 콤보박스에서 선택한 후 접근 권한을 설정한다. 접근 권한 설정은 Admin에서 제공하는 각 메뉴 중

해당 역할의 사용자가 사용 가능한 메뉴에 대해 체크박스를 선택한 후 [OK] 버튼을 클릭한다.

Admin 메뉴 이외의 설정 가능한 권한은 다음과 같다.

● 모니터링 only

시스템 컴포넌트의 모니터링만 가능하다. 해당 사용자는 시스템 컴포넌트의 추가, 수정 등을 할 수 없기

때문에, 시스템 컴포넌트 관련 화면 중 [제어 & 모니터링] 탭 화면만 사용 가능하다.

설명항목

FTP 서버 게이트웨이를 통해 파일을 송신하거나 수신할 수 있다. 파일 송신 혹

은 수신이 가능하도록 역할을 설정한 후 해당 역할의 사용자로 FTP 서버에 로그

인하여 FTP 작업이 가능하다.

FTP 송신 / FTP 수신

FTP 서버 게이트웨이에 대한 설명은 "AnyLink 배치 안내서"를 참조한다.

● Studio

스튜디오 관련 권한으로서 'Studio' 체크박스를 선택한 경우에만 적용된다.

스튜디오 권한관 Admin 메뉴 관련 권한은 별개이므로 'Studio' 체크박스를 선택한 경우 Admin 메뉴 관

련 권한은 초기화된다.

설명항목

스튜디오 사용자별 디플로이 여부를 제어할 수 있다. '디플로이' 체크박스가 해

제된 역할을 갖는 스튜디오 사용자가 스튜디오에 로그인하면 컨텍스트 메뉴의

[디플로이] 메뉴 및 툴바의 [전체 디플로이] 메뉴가 비활성화된다.

디플로이

역할 할당 및 로그인

사용자 추가 혹은 수정의 경우 역할 관리에서 추가된 역할을 할당한 후 Admin을 구동하여 해당 사용자로

로그인하면, 사용자의 역할에 허용된 메뉴만 사용 가능하고 나머지는 비활성화됨을 확인할 수 있다.

7.4. 로그인 이력 조회스튜디오나 Admin 사용자의 로그인 이력에 대한 조회 기능으로, 사용자의 로그인 시각, 접속 IP, 정상 로

그인 여부 및 에러 상황을 파악할 수 있다.

로그인 이력 조회를 위해서는 [Tools] > [로그인 이력 조회] 메뉴를 선택하면 다음과 같은 로그인 이력 조

회 화면이 나타나고, 검색 조건을 입력한 후 [조회] 버튼을 클릭하면 화면 아래에 로그인 이력 정보가 조회

된다.


[그림 7.9] 로그인 이력 조회

● 검색 조건

로그인 이력 조회를 위해 입력해야 하는 검색 조건은 다음과 같다.

설명항목

이력을 조회할 사용자를 콤보박스에서 선택한다.사용자 ID

변경 이력을 조회할 시작 일자(From)와 종료 일자(To)를 설정한다.Form/To

[Set] 버튼 클릭한 후 캘린더를 통해 입력할 수 있다.

● 로그인 이력 정보

검색 조건을 입력한 후 [조회] 버튼을 클릭하면 로그인 이력 정보가 조회된다. 다음은 조회된 정보의 각

컬럼에 대한 설명이다.

설명컬럼명

로그인 사용자 ID이다.사용자 ID

로그인 일자 및 시각이다.일자

접속 IP 주소이다.IP 주소

정상 로그인 유무 및 에러 상황을 나타낸다. 각 상황별로 표기되고 다음과 같

은 의미를 갖는다.

정상 로그인 유무

– Y : 정상 로그인된 경우

– No User : 해당 사용자가 없는 경우

– Locked User : 로그인 최대오류 횟수 초과로 Lock이 설정된 사용자인 경우

– No Password : 암호가 없는 경우

– No Studio User : 스튜디오 사용자가 아닌 경우

– No Admin User : Admin 사용자가 아닌 경우

– Password mismatch : 암호 불일치한 경우

스튜디오 혹은 Admin 사용자를 구분한다.Client

– Admin : Admin 로그인

제7장 도구 99

설명컬럼명

– Studio : 스튜디오 로그인

7.5. 변경 이력 조회스튜디오나 Admin 사용자가 데이터베이스에 디플로이(추가, 수정 및 삭제)한 이력을 나타낸다.

특히, 스튜디오의 경우 전문 데이터 등이 로컬에도 보관되어 있으므로 각 사용자별 변경 이력이 관리되지

않으면 이전 사용자의 변경 내용을 덮어쓰는 등 사용자 간 정보 충돌을 피할 수 없다. 따라서 사용자별 변

경 이력을 남기고 디플로이할 때 원격 데이터와의 충돌 여부를 감지하는 기능과 조회 기능이 필요하게 되

는데, Admin에서는 변경 이력의 조회 기능을 제공하고 있다.

변경 이력을 조회하려면 [Tools] > [변경이력 조회] 메뉴를 선택하거나 <Ctrl>+H 단축키를 사용한다.

변경이력 조회 화면에서 검색 조건을 입력한 후 [조회] 버튼을 클릭하면 다음과 같이 변경 일시, 사용자 ID,

Action 및 변경 테이블 정보를 조회할 수 있다.

[그림 7.10] 변경 이력 조회


● 검색 조건

변경 이력 조회를 위해 입력해야 하는 검색 조건은 다음과 같다.

설명항목

변경 이력을 조회할 사용자를 선택한다.사용자 ID

변경 이력을 조회할 테이블을 선택한다.테이블(대상)

변경 이력을 조회할 시작 일자(From)와 종료 일자(To)를 설정한다.Form/To

[Set] 버튼을 클릭하여 캘린더를 통해 입력할 수 있다.

● 이력 정보

검색 조건을 입력한 후 [조회] 버튼을 클릭하면 변경 이력 정보가 조회된다. 다음은 조회된 정보의 각 컬

럼에 대한 설명이다.

설명컬럼명

데이터가 변경된 일자 및 시각이다.일시

데이터를 변경한 사용자 ID이다.사용자 ID

데이터의 '추가', '수정' 혹은 '삭제' 정보이다.Action

변경된 테이블명이다.테이블(대상)

변경된 데이터의 primary key(':'로 구분)이다.Primary Key

7.6. 시스템 속성 관리로그 레벨 등 시스템 전체와 관련된 환경 속성을 추가, 수정 및 삭제하는 등을 관리할 수 있다. 파일이 아

닌 데이터베이스로서 관리하기 때문에 멀티 노드 환경에서도 속성의 공유 및 실시간 반영이 가능하다.

7.6.1. 시스템 속성

미리 정의된 시스템 속성은 다음과 같다.

● 로그 관련 속성

<nodename> 노드에 구동된 JavaMapper의 로그 관련 속성을 설정한다.

설명속성명

로그 파일 경로를 설정한다. 설정하지 않을 경우

$JEUS_HOME/logs/anylink/anylink.log로 설정된다.

<nodename>.log.file

예) /user2/logs/anylink.log

필수 항목으로 로그 레벨을 설정한다.<nodename>.log.level

제7장 도구 101

설명속성명

다음의 값을 가질 수 있으며 이 순서대로 로그가 적게 남는다.

– fatal

– error

– warn

– info

– debug : 모든 로그가 출력된다. (기본값)

비즈니스로부터의 응답 데이터에 대한 헥사 로그의 출력 크기를 설정한

다. 설정하지 않을 경우 응답 데이터 크기만큼 그대로 출력된다.

<nodename>.log.hex.size

전문 로깅 파일의 크기가 설정된 Byte 단위를 넘을 경우 Rotation한다.log.file.size

설정하지 않으면 일(day) 단위로 Rotation된다.

ex.) j.<이름>.20060804.000.log,

j.<이름>.20060804.001.log, ...

'true'로 설정한 경우 Sync 모드(Mapper에서 직접 파일 로깅 수행)로 데

이터베이스 로깅을 수행하지 않는다.

log.file.sync

● cache 관련 속성

JavaMapper는 ADM으로부터 얻은 데이터를 memory cache에 보관한다. 따라서 시간이 경과함에 따라

캐시 크기가 무한정 커질 수 있기 때문에 주기적으로 cache를 줄이게 되는데, 그 기준값이 되는 크기를

설정한다.

설명속성명

종별 정보 cache의 최대 크기를 설정한다.MAX_SIZE_KINDMAP

종별 정보 cache의 최대 크기를 설정한다.MAX_SIZE_KIND

거래 정보 cache의 최대 크기를 설정한다.MAX_SIZE_TX

거래 파라미터 정보 cache의 최대 크기를 설정한다.MAX_SIZE_TXPARAMETER

전문 정보 cache의 최대 크기를 설정한다.MAX_SIZE_MSG

거래 매핑 정보 cache의 최대 크기를 설정한다.MAX_SIZE_TXMAP

변환 규칙 정보 cache의 최대 크기를 설정한다.MAX_SIZE_CODE

전문 고유번호 정보 cache의 최대 크기를 설정한다.MAX_SIZE_TXUID

URL 정보 cache의 최대 크기를 설정한다.MAX_SIZE_URL

● 매핑 관련 속성

설명속성명

매핑 코드를 수행할 때 디버그 로그 출력 여부를 설정한다.(기본값: false)conversion.debug


설명속성명

XML 전문을 매핑할 때 Child Element가 모두 NULL인 Parent Element

의 생성 여부를 설정한다.(기본값: false)

xml.array.nulltag

예를 들어, <parent><child/></parent> 구조에서 Child Element가 NULL

인 경우 Parent Element는 생성되지 않는데, 이를 <parent/> 형태로 생

성하기 위해서는 속성값을 true로 설정해야 한다.

중복 거래가 발생했을 때 '응답 전송'의 경우 이전 거래에서 cache된 응

답 전문을 재전송하게 되는데, 재전송 전에 데이터를 가공할 필요가 있

을 수 있다. 이때 적용할 사용자 클래스를 설정한다.

duplication.userclass.<기관코

드>.<업무코드>.<거래코드>

numeric 타입 필드에 대한 유효성 검사 여부를 설정한다.valid.num

– true : 숫자가 아닌 값이 들어오면 NumberFormatException이 발생한

다.

– false : 유효성 검사를 하지 않는다.(기본값)

전문이나 매핑 코드(*.java)를 컴파일할 경우에 상세 디버그 로그 출력

여부를 설정한다.(기본값: false)

compile.debug

javac –verbose 옵션에 해당한다.

전문이나 매핑 코드(*.java)를 컴파일할 경우에 사용될 메모리의 초기값

(initial Java heap size)을 설정한다.(기본값: 8MB)

compile.Xms

javac –J-Xms 옵션에 해당한다.

전문이나 매핑 코드(*.java)를 컴파일할 경우에 사용될 메모리(heap)의

최댓값(maximum Java heap size)을 설정한다.(기본값: 256MB)

compile.Xmx

javac –J-Xmx 옵션에 해당한다.

● 사용자/로그인 관련 속성

설명속성명

사용자 암호에 대한 암호화 알고리즘을 '3des' 혹은 'base64'로 설정한

다.(기본값: base64)

tool.login.encryption_type

로그인 에러에 대한 최대오류 횟수로, 초과할 경우 해당 사용자는 Lock

이 설정된다.

tool.login.max_retry_cnt

사용자 암호 변경 주기를 설정한다.(단위: 일(day))tool.login.pwd_change_interval

Admin 메뉴 제어를 설정한다.tool.admin.menu.disabled

제7장 도구 103

● 기타 속성

설명속성명

Java Mapper는 주기적으로 컨테이너 정보를 AMM에 보내 Mapper 상

태를 통지한다. 해당 정보를 보내는 주기를 설정한다.

amm.reconnect.time

(기본값: 1000(1초), 단위: milliseconds)

7.6.2. 추가, 수정 및 삭제

시스템 관련 환경 속성을 추가, 수정 및 삭제하려면 [Tools] > [시스템 속성 관리] 메뉴를 선택하거나

<Ctrl>+R 단축키를 사용한다.

시스템 속성의 추가는 시스템 속성 관리 화면에서 [추가] 버튼을 클릭한 후 시스템 속성 추가/수정 대화상

자에서 '속성명'(최대 128자리)과 '값'(최대 256자리)을 입력한다.

시스템의 수정은 시스템 속성 관리 화면에서 해당 속성을 선택하고 [수정] 버튼을 클릭한 후 수정할 값을

입력한다. 삭제하려면 해당 속성을 선택하고 [삭제] 버튼을 클릭한다.

[그림 7.11] 시스템 속성 추가


7.7. 통신망 상태 조회통신망 상태란 물리적인 회선 상태를 의미하는 것이 아니고 온라인 및 배치 전문의 흐름 정보, 즉 스튜디

오 업무 프로토콜 정보에서 정의된 전문 흐름 규칙을 의미하고, 현재 어느 단계까지 진행되었는지를 조회

할 수 있다.

참고

프로토콜 정보에 대한 자세한 내용은 “AnyLink 스튜디오 안내서”의 “4.1.5. 프로토콜 정보 설정”를 참

조한다.

통신망 상태를 조회하려면 [Tools] > [통신망 상태 조회] 메뉴를 선택하거나 <Ctrl>+P 단축키를 이용하면

통신망 산태 조회 화면이 나타난다. 검색 조건으로 '기관', '업무', '일자'를 입력하고 [조회] 버튼을 클릭한

다.

[그림 7.12] 통신망 상태 조회

제7장 도구 105

● 검색 조건

통신망 상태 조회를 위해 입력해야 하는 검색 조건은 다음과 같다.

설명항목

조회할 기관명을 선택한다. 기관명만 선택하고 조회하면 해당 기관 모든 업무의

통신망 상태 정보를 조회할 수 있다.

기관

조회할 업무명을 선택한다. 기관을 선택하면 해당 기관의 모든 업무가 자동으로

콤보박스에 표시된다.

업무

검색할 상태 변경 일자로, [Set] 버튼 클릭 후 캘린더를 통해 입력할 수 있다.일자

● 상태 정보

검색 조건을 입력한 후 [조회] 버튼을 클릭하면 통신망 상태 정보가 조회된다. 다음은 조회된 정보의 각

컬럼에 대한 설명이다.

설명컬럼명

조회된 정보의 기관 코드를 표시한다.기관코드

조회된 정보의 업무 코드를 표시한다.업무코드

상태 변경 일자 및 시각을 표시한다.일자

상태 변경 시각을 나타낸다.시각

현재 흐름 상태(종별/거래코드)를 나타낸다.현재 상태

예를 들어, 이 값이 '0800/100'이라면 개시전문을 받은 것이므로 업무가 개시되어

통상 전문 처리가 가능한 상태임을 알 수 있다.

종별/거래 코드 형태가 아닌 'E'는 에러를 의미한다.

'개시', '종료' 등 해당 거래 유형을 표시한다.거래 유형

7.7.1. 통신망 상태 수정

통신망 조회는 주로 조회를 위한 목적으로 사용되지만, 통신망 상태를 강제로 수정해야 하는 경우가 발생

한다. 예를 들어 대외 기관에 장애가 발생한 경우 장애 전문을 보내 줄 수 없는 상황이라면, 장애 상태로

자동 변경할 수가 없게 된다는 것이다.

통신망 상태를 수정하려면 통신망 산태 조회 화면에서 해당 기관-업무를 선택하고 [수정] 버튼을 클릭하

면 통신망 상태 수정 대화상자가 나타난다. 해당 화면에서 수정할 상태(종별/거래코드)를 입력한 후 [수정]

버튼을 클릭한다.


[그림 7.13] 통신망 상태 수정

7.8. 게이트웨이 및 회선 검색각 기관, 업무별 사용하고 있는 게이트웨이와 회선을 기관, 업무별로 검색할 수 있는 화면이다.

다음 그림과 같이 게이트웨이 설정화면의 '기관코드', '업무코드' 항목에 설정된 값을 기준으로 해당 게이

트웨이를 검색한다.

[그림 7.14] 게이트웨이 검색

또한 각 기관, 업무가 설정된 특정 게이트웨이를 게이트웨이 이름으로 검색이 가능하다. 회선 검색은 아래

그림과 같이 기관코드 업무코드가 설정된 게이트웨이에 연결된 모든 회선을 검색한다.

게이트웨이 검색과는 달리 회선은 회선 이름과 더불어 회선 설정화면에 등록된 물리회선 정보를 이용하

여 회선 검색이 가능하다. 게이트웨이와 회선의 검색결과를 보여주는 상태 정보 영역에서 게이트웨이와

회선이 연결된 '노드명', '기관코드', '업무코드', 'G/W 이름', '회선 이름'을 확인할 수 있으며, 각 게이트웨

이와 회선의 연결 상태 또한 확인할 수 있다. 이는 [조회] 버튼을 클릭한 시점의 게이트웨이와 회선의 연결

상태이다.

제7장 도구 107

[그림 7.15] 회선 검색

7.9. 채번 조회전문 추적번호(msg_uid)는 대외 기관과 비동기 통신을 할 경우 요청 전문에 대한 응답 전문을 찾기 위해

사용되는 값이고, 전문 고유번호(tx_uid)는 거래 고유번호로서 중복 체크 및 결번 체크에 사용되는 값이다.

스튜디오의 설정(기관-업무 정보의 '전문추적번호 채번 여부' 혹은 '전문고유번호 채번 여부')에 따라 요청

매핑 직후 메모리 혹은 데이터베이스에서 전문 추적번호와 전문 고유번호를 채번한다. 채번 조회는 이러

한 채번 상황을 조회할 수 있는 기능이다.

채번 상황을 조회하려면 [Tools] > [채번 조회] 메뉴를 선택한 후 검색 조건으로 '기관', '업무'를 입력하고

[조회] 버튼을 클릭한다.

[그림 7.16] 채번 조회


● 검색 조건

채번 조회를 위해 입력해야 하는 검색 조건은 다음과 같다.

설명항목

조회할 기관명을 선택한다. 기관명만 선택하고 조회하면 해당 기관 모든 업

무의 채번 정보를 조회할 수 있다.

기관

조회할 업무명을 선택한다. 기관을 선택하면 해당 기관의 모든 업무가 자동

으로 콤보박스에 표시된다.

업무

● 항목 설명

검색 조건을 입력한 후 [조회] 버튼을 클릭하면 채번 정보가 조회된다. 다음은 조회된 정보의 각 컬럼에

대한 설명이다.

설명컬럼명

조회된 정보의 기관 코드를 나타낸다.기관코드

조회된 정보의 업무 코드를 나타낸다.업무코드

채번 일자(yyyyMMdd)를 표시한다.일자

현재까지 채번된 전문 추적번호의 최댓값(최종값)을 표시한다.전문추적번호

현재까지 채번된 전문 고유번호의 최댓값(최종값)을 표시한다.전문고유번호

현재까지 수신된 전문 고유번호의 최종값으로 결번을 체크할 때 사용(들어온

값이 수신 최종전문고유번호+1보다 크면 결번)된다.

수신 최종전문고유번호

7.10. 결번 조회요청 전문의 전문 고유번호가 순차적으로 들어올 경우 중간에 누락된 번호를 결번이라 한다. 예를 들어 1,

2, 4 순서로 전문이 들어온 경우 3이 결번이 된다.

스튜디오의 설정(기관-업무 정보의 '결번 체크 여부')에 따라 요청 전문의 전문 고유번호 결번이 발생하면

이를 데이터베이스에 기록한다.

전문이 1, 2 순서로 들어온 상태에서 4가 들어온 경우 이 값이 '수신 최종전문 고유번호'+1 보다 크면 (4 >

2+1) 결번이 발생한다. 이후 들어온 3은 수신 최종전문 고유번호보다 작으므로 (3 < 4) 결번이 들어온 것

으로 인지하여 결번 목록에서 삭제한다.

수신 최종전문 고유번호 (채번)결번 목록입력 전문 고유번호

01

12

234

43

제7장 도구 109

결번 조회는 이러한 결번 상황을 조회할 수 있는 기능이다. 결번을 조회하려면 [Tools] > [결번 조회] 메뉴

를 선택한 후 검색 조건으로 '기관', '업무'를 입력하고 [조회] 버튼을 클릭한다.

[그림 7.17] 결번 조회

● 검색 조건

결번 조회를 위해 입력해야 하는 검색 조건은 다음과 같다.

설명항목

조회할 기관명을 선택한다. 기관명만 선택하고 조회하면 해당 기관 모든 업무의

채번 정보를 조회할 수 있다.

기관

조회할 업무명을 선택한다. 기관을 선택하면 해당 기관의 모든 업무가 자동으로

콤보박스에 표시된다.

업무

● 결변 정보

검색 조건을 입력한 후 [조회] 버튼을 클릭하면 결번 정보가 조회된다. 다음은 조회된 정보의 각 컬럼에

대한 설명이다.


설명컬럼명

조회된 정보의 기관 코드를 나타낸다.기관코드

조회된 정보의 업무 코드를 나타낸다.업무코드

처리 일자(yyyyMMdd)를 표시한다.처리 일자

현재까지의 결번 목록을 표시한다.전문고유번호

제7장 도구 111

Appendix A. 오류 메시지 및 조치 방법

본 부록에서는 Admin을 사용할 때 발생할 수 있는 에러 메시지와 그 해결 정보를 설명한다.

일반 에러, 시스템 브라우저 에러, 스케쥴러 에러 메시지와 해결 방법에 대해 설명한다.

일반 에러

일반 에러의 각 에러 메시지에 대한 설명과 해결 방법은 다음과 같다.

● 항목을 선택하세요.

목록에서 Action(추가, 수정, 삭제 등)의 대상이 될 항목을 선택하지 않은 경우에 발생한

다.

설명

특정 항목 선택한 후 Action을 취한다.해결 방법

● 종료 일자는 시작 일자보다 작을 수 없습니다.

특정 기간에 대한 데이터를 조회할 때 종료 일자가 시작 일자보다 작은 경우에 발생한다.설명

종료 일자를 시작 일자보다 크게 설정한 후 다시 조회한다.해결 방법

● 시스템 공유 메모리 최대치에 도달하여 더 이상 데이터를 추가할 수 없습니다. 시스템 관리자에게 문의

하십시오.

서버 공유 메모리의 최대 설정치(시스템을 구동할 때 데이터베이스 데이터의 3배수)에

도달하여 데이터를 추가할 수 없는 경우에 발생한다.

설명

서버를 재구동해야 한다.해결 방법

● 디플로이 정보에 대한 WebT 이벤트 연결이 끊어졌습니다.

Admin이 연결된 서버가 다운된 경우에 발생한다.설명

서버가 재구동된 후 Admin을 재구동해야 한다.해결 방법

● 컴포넌트 상태 정보에 대한 WebT 이벤트 연결이 끊어졌습니다.

Admin이 연결된 서버가 다운된 경우에 발생한다.설명

서버가 재구동된 후 Admin을 재구동해야 한다.해결 방법

Appendix A. 오류 메시지 및 조치 방법 113

시스템 브라우저 에러

시스템 브라우저 에러의 각 에러 메시지에 대한 설명과 해결 방법은 다음과 같다.

● Gateway와 연결되어 있어 삭제할 수 없습니다. 먼저 Gateway를 삭제하세요.

노드를 삭제할 때 노드에 속한 게이트웨이가 존재하는 경우에 발생한다.설명

해당 노드의 모든 하위 게이트웨이를 먼저 삭제한 후 노드를 삭제한다.해결 방법

● 회선과 연결되어 있어 삭제할 수 없습니다. 먼저 회선을 삭제하세요.

게이트웨이를 삭제할 때 게이트웨이에 속한 회선이 존재하는 경우에 발생한다.설명

해당 게이트웨이의 모든 하위 회선을 먼저 삭제한 후 게이트웨이를 삭제한다.해결 방법

● 기관(<기관코드>)-업무(<업무코드>)와 연결되어 있어 삭제할 수 없습니다.

회선을 삭제할 때 회선과 연결된 기관-업무가 존재하는 경우에 발생한다.설명

회선과 연결된 기관 및 업무를 삭제한 후 회선을 삭제한다.해결 방법

스케쥴러 에러

스케쥴러 에러의 각 에러 메시지에 대한 설명과 해결 방법은 다음과 같다.

● 고정길이 스트림 형태의 전문이 아닙니다.

운영 전문 발송은 Stream 전문에 대해서만 가능한데, 다른 형태의 전문(XML, VO 등)을

선택한 경우에 발생한다.

설명

고정 길이 Stream 형태의 운영 전문을 선택한다.해결 방법

● 스케쥴러 job 수행에 실패하였습니다.

스케쥴러가 해당 시간에 수행될 job 수행 도중 에러가 발생한 경우에 발생한다.설명

스케쥴러의 서버 로그를 확인해야 한다.해결 방법

● 주기 발송된 것은 즉시 발송할 수 없습니다.

주기 발송된 스케쥴을 즉시 발송으로 재발송하려는 경우에 발생한다.설명

주기 발송된 스케쥴은 주기만 변경해서 재발송할 수 있다.해결 방법

● 즉시 발송된 것은 주기 발송될 수 없습니다.

즉시 발송된 스케쥴을 주기 발송으로 재발송하려는 경우에 발생한다.설명


즉시 발송된 스케쥴은 즉시 발송으로만 재발송할 수 있다.해결 방법

● 즉시 발송된 것은 중지/시작할 수 없습니다.

즉시 발송된 스케쥴을 중지 혹은 시작하려는 경우에 발생한다.설명

즉시 발송된 스케쥴에는 중지 및 시작의 개념이 없다. 중지 및 시작은 주기 발송된 스케

쥴(주기적으로 수행되어야 하는 성격)에만 의미를 갖는다.

해결 방법

Appendix A. 오류 메시지 및 조치 방법 115

Appendix B. 기관-업무의 Inbound URL 공유

본 부록에서는 기관-업무의 Inbound URL을 공유하는 방법에 대해 설명한다.

XML 및 HTTP 게이트웨이를 사용하는 경우에도 기존 TCP/IP 게이트웨이에서처럼 기관-업무 유일 키를

활용하여 하나의 Inbound URL을 여러 기관-업무가 공유할 수 있다.

다음은 그 과정에 대한 설명과 예제이다.

1. Java Mapper를 이용하여 컨텍스트(context) 및 서블릿을 설정한다.

URL에 등록할 컨텍스트로서 JEUS 서버에 등록되어야 하며, 해당 컨텍스트는 AnyLinkSoapReceiver

서블릿과 연결되어야 한다.

● WEBMain.xml

<context>

<context-name>soaptest</context-name>

<context-path>/soaptest</context-path>

</context>

● web.xml

<web-app>

<servlet>

<servlet-name>AnyLinkSoapReceiver</servlet-name>

<servlet-class>anylink.engine.servlet.AnyLinkSoapReceiver</servlet-class>

</servlet>

<servlet-mapping>

<servlet-name>AnyLinkSoapReceiver</servlet-name>

<url-pattern>/receiver</url-pattern>

</servlet-mapping>

</web-app>>

2. Admin을 이용하여 회선을 등록한다.

기관-업무가 공유할 URL은 AnyLinkSoapReceiver 서블릿과 연계, 즉 위에서 등록한 컨텍스트를 포함

해야 한다.

● 다음과 같이 Inbound URL을 등록하고 기관-업무를 할당한다.

Appendix B. 기관-업무의 Inbound URL 공유 117

[그림 B.1] 회선 등록 (1)

설명항목

192.168.1.48:22333/soaptest/receiverURL

A001기관

B002업무

● 다음과 같이 동일한 Inbound URL을 등록하고 기관-업무를 할당한다.

[그림 B.2] 회선 등록 (2)


설명항목

192.168.1.48:22333/soaptest/receiverURL

A002기관

B002업무

3. 스튜디오를 이용하여 기관-업무를 설정한다.

기관-업무가 하나의 URL을 공유하는 경우, 들어오는 전문의 특정 값에 의해서만 구분이 가능하기 때문

에 값을 어느 태그에서 읽을 것인지와, 해당 기관-업무에 대한 유일한 값을 설정해야 한다.

태그는 '유일키명'에 지정하며 XPath 형식을 따르고, 유일값은 '요청 TXID'에 설정한다.

● 기관(A001)-업무(B002)에 대한 정보를 설정한다.

[그림 B.3] 기관-업무 설정 (1)

설명항목

URL1요청 TXID

/Bancassurance/BusinessArea/LK_INPRD_TP유일키명

Appendix B. 기관-업무의 Inbound URL 공유 119

● 기관(A002)-업무(B002)에 대한 정보를 다음과 같이 설정한다.

[그림 B.4] 기관-업무 설정 (2)

설명항목

URL2요청 TXID

/Bancassurance/BusinessArea/LK_INPRD_TP유일키명

4. SOAP을 이용하여 XML을 송신한다.

위에서 설정한 /Bancassurance/BusinessArea/LK_INPRD_TP 태그의 값이 해당 기관-업무에 대한 유

일 키로, 다음의 예제에서는 유일 키가 'URL2'이므로, 이 전문을 서블릿이 받으면 'URL2'를 요청 TXID

로 갖는 기관-업무를 찾아 거래를 수행하게 된다.

<?xml version="1.0" encoding="euc-kr"?>

<Bancassurance xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

<HeaderArea>

<HDR_BAK_CLS>01</HDR_BAK_CLS>

</HeaderArea>

<BusinessArea>

<LK_INPRD_TP>URL2</LK_INPRD_TP>

<LK_INPRD_REAL>22</LK_INPRD_REAL>

</BusinessArea>

</Bancassurance>


색인

Symbols3DES 암호화, 8

AALLogin.passwd, 7

ALLogin.user, 7

CCache, 13

DData Gateway, 13

EEvent Browser, 11

Event Listener, 13

MMegaBox XOT, 73

UUser Interface, 13

XXOT, 73

ㄱ

기관-업무 회선 브라우저, 10

기타 환경 설정

webt.event.queue.size, 6

ㅁ

모니터링 설정

monitoring.gauge.day.max, 5

monitoring.gauge.total.max, 5

monitoring.refresh.interval, 6

ㅅ

스케쥴러 에러, 114

시스템 기타 속성

amm.reconnect.time, 104

시스템 로그 관련 속성

<nodename>.log.file, 101

<nodename>.log.hex.size, 102

<nodename>.log.level, 101

log.file.size, 102

log.file.sync, 102

시스템 매핑 관련 속성

compile.debug, 103

compile.Xms, 103

compile.Xmx, 103

conversion.debug, 102

duplication.userclass.<기관코드>.<업무코드>.<거래

코드>, 103

valid.num, 103

xml.array.nulltag, 103

시스템 브라우저, 10

시스템 브라우저 에러, 114

시스템 사용자/로그인 관련 속성

tool.admin.menu.disabled, 103

tool.login.encryption_type, 103

tool.login.max_retry_cnt, 103

tool.login.pwd_change_interval, 103

시스템 캐시 관련 속성

MAX_SIZE_CODE, 102

MAX_SIZE_KIND, 102

MAX_SIZE_KINDMAP, 102

MAX_SIZE_MSG, 102

MAX_SIZE_TX, 102

MAX_SIZE_TXMAP, 102

MAX_SIZE_TXPARAMETER, 102

MAX_SIZE_TXUID, 102

MAX_SIZE_URL, 102

시스템 컴포넌트 브라우저, 55

색인 121

ㅇ

워크스페이스(Work Space), 11

유량 제어, 85

일반 에러, 113

ㅋ

커스텀 로그 조회 설정

LogView.custom.table.info, 6

ㅌ

타이틀 바, 11

ㅎ

화면 설정

display.codeFirst, 5

LogView.online.pageSize, 5

LogView.online.screenSize, 5

환경변수

AL_ADMIN_HOME, 3

ALBACKUP_IP, 3

ALBACKUP_PORT, 3

ALSERVER_HOSTNAME, 3

ALSERVER_IP, 3

ALSERVER_PORT, 3

INITIAL_CONTEXT_FACTORY, 3

JAVA_HOME, 3


anylink admin 안내서 - tmaxsoft본 안내서는 tmax anylink® (이하 anylink)의 관리...

Documents