OpenFrame OSI 환경설정

본 장에서는 OpenFrame OSI의 운영에 필요로 하는 설정 항목에 대해 설명한다.

1. 개요

OpenFrame OSI(이하 OSI)의 운영에 관련된 사항은 openframe_osi.conf에 각 'SECTION'의 'KEY'에 설정한 후 ofconfig 툴을 이용하여 시스템 설정을 저장한다.

기본값이 '(NONE)'인 'KEY'가 일부 존재하며 그러한 'KEY'의 'VALUE'를 '(NONE)'으로 지정했을 경우의 동작에 대해서는 해당 항목의 비고에 기재되어 있다.

다음은 각 서브젝트의 섹션에 대한 설명이다. 각 섹션별 키의 상세 입력 값에 대한 설명은 해당 절을 참고한다.

  • osi

    OSI 시스템의 모든 모듈에서 공통으로 참조하는 환결설정 파일로, OSI에서 지원하는 모든 서버 타입에 공통으로 적용할 항목을 설정한다.

    섹션 설명

    GENERAL

    OSI 시스템 서버 혹은 사용자 서버와 관련된 일반적인 동작을 설정한다.

    CRC

    OSI 커맨드를 실행할 때 커맨드가 실행된 Control Region을 특정 문자(CRC : Command Recognition Character)와 매핑하는 설정이다.

    DEFAULT_IMSID

    OSI 사용자 서버를 기동하는 JCL에서 IMSID를 기술하지 않은 경우에 사용되는 기본 IMSID와 RESLIB를 매핑하는 설정이다.

  • osi.{IMSID}

    OSI 시스템에서 IMSID별로 적용할 항목을 설정한다. 사용 중인 시스템 서버의 ID가 IMSA라면 서브젝트명은 osi.IMSA가 된다.

    섹션 설명

    GENERAL

    OSI 시스템에서의 일반적인 동작을 설정한다.

    LIBRARY

    OSI 시스템이 동작하는 데 필요한 각종 정보들이 저장되어 있는 라이브러리의 위치를 설정한다.

    CPM

    OSI 시스템에서 EBCDIC 코드와 ASCII 코드 간에 코드변환이 필요한 경우 사용할 CPM 데이터 파일을 설정한다.

    SECURITY

    OSI 시스템에서 적용할 Security의 사용 여부를 설정한다.

    USER

    OSI 시스템에서 사용자가 지정할 수 있는 정보를 설정한다.

    PRINTER

    OSI 시스템에서 사용할 Master Printer를 설정한다.

    SCREEN

    OSI 시스템에서 사용할 맵의 사이즈를 설정한다.

    MQ

    OSI 시스템에서 사용할 IBM MQ에 대한 정보를 설정한다.

    USER_PROGRAM

    OSI 사용자 서버를 기동할 때 실행되는 사용자 프로그램을 설정한다.

  • osi.{osiotmasvrname}

    OSI와 IBM MQ 제품 간의 OTMA 기능을 제공하는 osiotmasvr의 각 서버별로 적용할 항목을 설정한다. 서버의 이름을 IMSAOTMA라고 한 경우 서브젝트명은 osi.IMSAOTMA가 되며, osi.IMSAOTMA로 설정된 항목들은 IMSAOTMA 서버에서만 적용된다.

    섹션 설명

    GENERAL

    osiotmasvr의 일반적인 동작을 설정한다.

    MQ

    osiotmasvr에서 IBM MQ 정보를 설정한다.

  • ssm.{IMSID}{SSM}

    OSI에서 IMS 시스템별로 MultipleRM을 사용하기 위해 Tmax XA 서버에 적용하는 항목을 설정한다.

    섹션 설명

    GENERAL

    XA 연결과 관련된 일반적인 정보를 설정한다.

2. osi

OSI 시스템의 모든 모듈에서 공통으로 참조하는 환결설정 파일로, OSI에서 지원하는 모든 서버 타입에 공통으로 적용할 항목을 설정한다.

2.1. GENERAL

OSI 시스템 서버 혹은 사용자 서버와 관련된 일반적인 동작을 설정한다.

2.1.1. LOG_LEVEL

시스템에서 출력하는 로그의 레벨을 설정한다. 멀티노드 환경에서 모든 노드의 설정이 일치해야 한다.

항목 설명

파라미터 타입

String

기본값

M

범위

M,D,E,W

비고

  • M : Message

  • D : Debug

  • E : Error

  • W : Warning

2.2. CRC

OSI 커맨드를 실행할 때 커맨드가 실행된 Control Region을 특정 문자(CRC : Command Recognition Character)와 매핑하는 설정이다. 이 설정을 하면 imscmd 툴이나 JCL을 통한 커맨드를 실행할 때 커맨드의 맨 앞에 CRC 값을 줌으로써 실행될 Region을 결정할 수 있다. 각각의 CRC는 겹치지 않도록 설정해야 한다.

2.2.1. CRC

커맨드를 실핼할 때 커맨드를 수행할 Region을 식별하기 위한 문자를 KEY로 설정한다. VALUE에는 해당 CRC를 가진 커맨드가 수행될 Control Region의 이름을 설정한다. 멀티노드 환경에서 모든 노드의 설정이 일치해야 한다.

항목 설명

파라미터 타입

String

기본값

(NONE)

범위

비고

KEY는 1byte의 문자, VALUE는 4bytes까지의 문자만 허용한다. VALUE를 (NONE)으로 지정한 경우에는 IMS Control Region을 공백으로 처리한다.

다음은 '/' 문자를 IMSA라는 Control Region의 CRC로 설정하는 예제이다.

$ ofconfig list -s osi -sec CRC -n NODE1
===================================================================================
  SUBJECT   |     SECTION      |         KEY         |            VALUE
===================================================================================
    osi     |       CRC        |          /          |            IMSA
===================================================================================

2.3. DEFAULT_IMSID

OSI 사용자 서버(Dependent Region)를 기동하는 JCL에서 파라미터로 IMSID를 기술하지 않은 경우에 사용되는 기본 IMSID와 RESLIB를 매핑하는 설정이다. JCL의 DFSRESLB DD로 지정된 데이터셋 이름으로 설정 파일을 읽고, 기동할 서버의 IMSID를 결정하게 된다.

2.3.1. {dataset}

RESLIB으로 사용하는 데이터셋 이름을 설정한다. 이는 JCL에서 DFSRESLB DD로 정의되어 있다. VALUE에는 기본 IMSID를 지정한다. 멀티노드 환경에서 모든 노드의 설정이 일치해야 한다.

항목 설명

파라미터 타입

String

기본값

(NONE)

범위

비고

VALUE는 4bytes까지의 문자만 허용한다. VALUE를 (NONE)으로 지정한 경우에는 기본 IMSID를 공백으로 처리한다.

다음은 IMS.RESLIB이라는 RESLIB에 기본 IMSID를 IMSA로 설정하는 예제이다.

$ ofconfig list -s osi -sec DEFAULT_IMSID -n NODE1
===================================================================================
  SUBJECT   |     SECTION      |         KEY         |            VALUE
===================================================================================
    osi     |  DEFAULT_IMSID   |      IMS.RESLIB     |            IMSA
===================================================================================

3. osi.{IMSID}

OSI 시스템에서 IMSID별로 적용할 항목을 설정한다. 사용 중인 시스템 서버의 ID가 IMSA라면 서브젝트명은 osi.IMSA가 된다.

3.1. GENERAL

OSI 시스템에서의 일반적인 동작을 설정한다.

3.1.1. LOG_LEVEL

시스템에서 출력하는 로그의 레벨을 설정한다.

항목 설명

파라미터 타입

String

기본값

M

범위

M,D,E,W

비고

  • E : Error

  • W : Warning

  • M : Message

  • D : Debug

3.1.2. SCHEDULE_RECOVER_MAXCNT

트랜잭션이 실행에 실패하는 경우 재실행하는 횟수를 설정한다. 멀티노드 환경에서 모든 노드의 설정이 일치해야 한다.

항목 설명

파라미터 타입

Number

기본값

5

범위

1~10

비고

3.1.3. DR_SKIP_ALLOC_HIDB

Dependent Region에서 데이터셋 할당 과정을 생략할 것인지 설정한다. 멀티노드 환경에서 모든 노드의 설정이 일치해야 당한다.

항목 설명

파라미터 타입

String

기본값

NO

범위

YES,NO

비고

다음은 IMSA라는 시스템의 로그 레벨을 Message로 설정하고 트랜잭션 재실행 횟수를 5회로 설정하고 DR에서 Dataset allocation을 생략하도록 설정하는 예제이다.

$ ofconfig list -s osi.IMSA -sec GENERAL -n NODE1
===================================================================================
  SUBJECT   |     SECTION      |         KEY              |         VALUE
===================================================================================
  osi.IMSA  |     GENERAL      |      LOG_LEVEL           |           M
            |                  |  SCHEDULE_RECOVER_MAXCNT |           5
            |                  |   DR_SKIP_ALLOC_HIDB     |         YES
===================================================================================

3.2. LIBRARY

OSI 시스템이 동작하는 데 필요한 각종 정보들이 저장되어 있는 Staging Library의 위치를 설정한다. Staging Library는 관리자가 운용 데이터를 추가, 변경하는데 사용된다. 시스템을 운용할 때에는 이 내용이 복사되어 있는 Active Library를 읽어서 사용한다. 자세한 내용은 OpenFrame OSI "툴 참조 안내서"의 "dfsuocu0"과 OpenFrame OSI "명령어 참조 안내서"의 "MODIFY"를 참고한다.

3.2.1. MODBLKS

OSI에서 지원하는 각종 리소스의 설정이 저장된 Staging Library 데이터셋의 DSN을 설정한다. 멀티노드 환경에서 모든 노드의 설정이 일치해야 한다.

항목 설명

파라미터 타입

String

기본값

(NONE)

범위

비고

현재 버전에서는 데이터셋이 아닌 메타 테이블에 저장되어 관리된다. VALUE를 (NONE)으로 지정한 경우에는 데이터셋의 DSN을 공백으로 처리한다.

3.2.2. IMSACB

ACB가 저장된 Staging Library 데이터셋의 DSN을 설정한다. 멀티노드 환경에서 모든 노드의 설정이 일치해야 한다.

항목 설명

파라미터 타입

String

기본값

(NONE)

범위

비고

현재 버전에서는 데이터셋이 아닌 메타 테이블에 저장되어 관리된다. VALUE를 (NONE)으로 지정한 경우에는 데이터셋의 DSN을 공백으로 처리한다.

3.2.3. FORMAT

MFS가 저장된 Staging Library 데이터셋의 DSN를 설정한다. 멀티노드 환경에서 모든 노드의 설정이 일치해야 한다.

항목 설명

파라미터 타입

String

기본값

(NONE)

범위

비고

VALUE를 (NONE)으로 지정한 경우에는 데이터셋의 DSN을 공백으로 처리한다.

다음은 IMSA라는 시스템에서 MODBLKS를 OSI.IMSQ.DEFLIB으로, IMSACB를 IMS.ACBLIB으로, FORMAT을 OSI.IMSA.MFSLIB으로 설정하는 예제이다.

$ ofconfig list -s osi.IMSA -sec LIBRARY -n NODE1
===================================================================================
  SUBJECT   |     SECTION      |         KEY         |            VALUE
===================================================================================
  osi.IMSA  |     LIBRARY      |       FORMAT        |       OSI.IMSA.MFSLIB
            |                  |       IMSACB        |          IMS.ACBLIB
            |                  |       MODBLKS       |       OSI.IMSA.DEFLIB
===================================================================================

3.3. CPM

OSI 시스템에서 EBCDIC 코드와 ASCII 코드 간에 코드변환이 필요한 경우 사용할 CPM 데이터 파일을 설정한다.

3.3.1. 3270_CCSID

TN3270 에뮬레이터에서 사용할 CCSID 번호를 설정한다. 최대 2개의 CCSID를 설정할 수 있다. 멀티노드 환경에서 모든 노드의 설정이 일치해야 한다.

항목 설명

파라미터 타입

String

기본값

(NONE)

범위

비고

다음은 대표적으로 사용되는 CCSID이다.

  • 37 : COM EUROPE EBCDIC

  • 290 : JAPANESE EBCDIC

  • 300 : JAPAN DB EBCDIC

  • 437 : USA PC-DATA

  • 933 : KOREAN MIX EBCDIC

  • 943 : JAPAN OPEN

  • 949 : KOREA KS PC-DATA

VALUE를 (NONE)으로 지정한 경우에는 CCSID를 공백으로 처리한다.

3.3.2. REGION_CCSID

OSI 시스템내의 MFS 모듈에서 사용할 CCSID 번호를 설정한다. 최대 1개의 CCSID를 설정할 수 있다. 멀티노드 환경에서 모든 노드의 설정이 일치해야 한다.

항목 설명

파라미터 타입

String

기본값

(NONE)

범위

비고

VALUE를 (NONE)으로 지정한 경우에는 CCSID를 공백으로 처리한다.

3.3.3. EBCDIC_TO_ASCII

EBCDIC 코드를 ASCII 코드로 변환할 때 사용할 CPM 데이터 파일을 설정한다. 멀티노드 환경에서 모든 노드의 설정이 일치해야 한다.

항목 설명

파라미터 타입

String

기본값

(NONE)

범위

비고

OSI에서는 REGION_CCSID가 설정되어 있으면 EBCDIC_TO_ASCII 설정은 무시된다. 따라서 EBCDIC_TO_ASCII 설정을 사용할 경우에는 REGION_CCSID를 사용하면 안된다.

VALUE를 (NONE)으로 지정한 경우에는 CPM 데이터 파일 이름을 공백으로 처리한다.

3.3.4. ASCII_TO_EBCDIC

ASCII 코드를 EBCDIC 코드로 변환할 때 사용할 CPM 데이터 파일을 설정한다. 멀티노드 환경에서 모든 노드의 설정이 일치해야 한다.

항목 설명

파라미터 타입

String

기본값

(NONE)

범위

비고

OSI에서는 REGION_CCSID가 설정된 경우 ASCII_TO_EBCDIC 설정은 무시된다. 따라서 ASCII_TO_EBCDIC 설정을 사용할 경우에는 REGION_CCSID를 사용하면 안된다.

VALUE를 (NONE)으로 지정한 경우에는 CPM 데이터 파일 이름을 공백으로 처리한다.

3.3.5. CONVERT_TO_SPACE

화면에 출력할 때 공백(X'40')으로 변환할 Non-display 문자를 설정한다. 멀티노드 환경에서 모든 노드의 설정이 일치해야 한다.

항목 설명

파라미터 타입

String

기본값

(NONE)

범위

비고

설정 값은 ASCII code를 기준으로 X’hh’나 C’c' 형태로 작성한다. 콤마(,)를 구분자로 사용하여 두개 이상의 값을 설정할 수 있다.

다음은 IMSA라는 시스템에서 한국어를 지원하는 CPM 데이터 파일인 EBCASCKR.cpm, ASCEBCKR.cpm 을 사용하고 공백으로 변환할 문자를 X'00’으로 설정하는 예제이다.

$ ofconfig list -s osi.IMSA -sec CPM -n NODE1
===================================================================================
  SUBJECT   |     SECTION      |         KEY         |            VALUE
===================================================================================
  osi.IMSA  |       CPM        |   ASCII_TO_EBCDIC   |         ASCEBCKR.cpm
            |                  |   EBCDIC_TO_ASCII   |         EBCASCKR.cpm
            |                  |   CONVERT_TO_SPACE  |            X'00'
===================================================================================

3.4. SECURITY

OSI 시스템에서 적용할 Security의 사용 여부를 설정한다. 이 설정은 터미널 사용자에게만 적용된다.

3.4.1. TYPE

Security 유형을 설정한다. 멀티노드 환경에서 모든 노드의 설정이 일치해야 한다.

항목 설명

파라미터 타입

String

기본값

(NONE)

범위

TACF

비고

현재 버전에서는 TACF만 지원한다.

VALUE를 (NONE)으로 지정한 경우에는 해당 옵션을 설정하지 않은 것과 동일하게 처리한다.

TYPE을 TACF로 설정하고 hidb 서브젝트에서 HIDB_DEFAULT 섹션의 IGNORE_AUTH_CHECK 키의 값을 YES로 하면, DL/I를 수행하는 중에 오동작이 발생할 수 있다. TACF로 설정하는 경우에는 반드시 IGNORE_AUTH_CHECK 설정도 NO로 해야 한다.

3.4.2. TACF_USERID

TACF를 설정하는 경우 IO-PCB에 입력될 USERID를 user-id로 할지, group-id로 할지 설정한다. 멀티노드 환경에서 모든 노드의 설정이 일치해야 한다.

항목 설명

파라미터 타입

String

기본값

USER

범위

USER, GROUP, NODEFGRP

비고

  • USER : SIGN ON할 때 입력한 userid가 반영

  • GROUP : SIGN ON할 때 입력한 groupid가 반영되고, 입력하지 않은 경우에는 default groupid로 반영

  • NODEFGRP : SIGN ON할 때 입력한 groupid가 반영되고, 입력하지 않은 경우에는 userid로 반영

다음은 IMSA라는 시스템에서 TACF Security를 사용하고 IO-PCB에 group-id를 적용하는 예제이다.

$ ofconfig list -s osi.IMSA -sec SECURITY -n NODE1
===================================================================================
  SUBJECT   |     SECTION      |         KEY         |            VALUE
===================================================================================
  osi.IMSA  |     SECURITY     |     TACF_USERID     |            GROUP
            |                  |         TYPE        |            TACF
===================================================================================

3.5. USER

OSI 시스템에서 사용자가 지정할 수 있는 정보를 설정한다.

3.5.1. LOGON_MOD

OSI 시스템에 로그온이 되었을 경우 처음으로 화면에 출력되는 MOD 이름을 설정한다. 멀티노드 환경에서 모든 노드의 설정이 일치해야 한다.

항목 설명

파라미터 타입

String

기본값

OSILOGOO

범위

CLEAR, OSILOGOO, 그 외의 사용자 MOD

비고

  • CLEAR : 트랜잭션을 입력할 빈화면이 출력

  • OSILOGOO : OpenFrame 기본 화면(기본값)

  • MOD : 그 외의 사용자

3.5.2. LOGON_UC

사용자 로그인 화면에서 소문자 입력을 대문자로 변환해 줄 것인지 설정한다. 멀티노드 환경에서 모든 노드의 설정이 일치해야 한다.

항목 설명

파라미터 타입

Y_N

기본값

NO

범위

YES,NO

비고

  • YES : 대문자 변환

  • NO : 소문자 입력(기본값)

다음은 IMSA라는 시스템에서 OSILOGOO(기본 MOD)라는 MOD를 첫 화면으로 설정하고 로그인 화면을 대문자로 변환하도록 설정하는 예제이다.

$ ofconfig list -s osi.IMSA -sec USER -n NODE1
===================================================================================
  SUBJECT   |     SECTION      |         KEY         |            VALUE
===================================================================================
  osi.IMSA  |       USER       |      LOGON_MOD      |           OSILOGOO
            |                  |      LOGON_UC       |             YES
===================================================================================

3.6. PRINTER

프로그램에서 사용할 Master Printer를 설정한다.

3.6.1. MASTER_NAME

사용할 Master Printer의 이름을 입력한다.(8자 이내) 멀티노드 환경에서 모든 노드의 설정이 일치해야 한다.

항목 설명

파라미터 타입

String

기본값

(NONE)

범위

VALUE를 (NONE)으로 지정한 경우에는 Master Printer의 이름을 공백으로 처리한다.

비고

3.6.2. BUF_SIZE

프린터로 출력될 내용의 Buffer size를 입력한다. Buffer size를 초과하는 경우 Buffer에 있는 내용을 Master printer로 보내서 출력한다. 멀티노드 환경에서 모든 노드의 설정이 일치해야 한다.

항목 설명

파라미터 타입

Number

기본값

0 (단위 : byte)

범위

0~2147483647

비고

다음은 IMSA라는 시스템에서 Master Printer를 MASTPRNT로 설정하고 출력될 데이터를 1000bytes로 설정한 예제이다.

$ ofconfig list -s osi.IMSA -sec PRINTER -n NODE1
===================================================================================
  SUBJECT   |     SECTION      |         KEY         |            VALUE
===================================================================================
  osi.IMSA  |     PRINTER      |       BUF_SIZE      |             1000
            |                  |     MASTER_NAME     |           MASTPRNT
===================================================================================

3.7. SCREEN

OSI 시스템에서 사용할 3270 화면 사이즈를 설정한다.

3.7.1. 3270_TYPE

사용할 3270 화면 사이즈를 지정한다. 멀티노드 환경에서 모든 노드의 설정이 일치해야 한다.

항목 설명

파라미터 타입

String

기본값

3270-A2

범위

3270-A2, 3270-A3, 3270-A7

비고

  • 3270-A2 : 24*80 화면

  • 3270-A3 : 32*80 화면

  • 3270-A7 : 27*132 화면

다음은 IMSA라는 시스템에서 사용하는 화면 사이즈를 3270-A7(27*132)으로 설정하는 예제이다.

$ ofconfig list -s osi.IMSA -sec SCREEN -n NODE1
===================================================================================
  SUBJECT   |     SECTION      |         KEY         |            VALUE
===================================================================================
  osi.IMSA  |      SCREEN      |      3270_TYPE      |           3270-A7
===================================================================================

3.8. MQ

OSI 시스템에서 사용할 IBM MQ에 대한 정보를 설정한다.

3.8.1. USE_MQ

IBM MQ 제품의 사용 여부를 설정한다. YES로 설정한 경우에는 MPP Region에서 Output Message 송신시 Input Message의 MQMD에 명시된 ReplyToQMgr의 ReplyToQ로 MQPUT을 요청한다. 멀티노드 환경에서 모든 노드의 설정이 일치해야 한다.

항목 설명

파라미터 타입

Y_N

기본값

NO

범위

YES,NO

비고

  • YES : IBM MQ를 사용한다.

  • NO : IBM MQ를 사용하지 않는다.

3.8.2. QMGR_NAME

OTMA 기능을 위해 MQCONN을 할 IBM MQ 제품의 Queue Manager 이름을 설정한다. 멀티노드 환경에서 모든 노드의 설정이 일치해야 한다.

항목 설명

파라미터 타입

String

기본값

(NONE)

범위

비고

VALUE를 (NONE)으로 지정한 경우에는 Queue Manager의 이름을 공백으로 처리한다.

3.8.3. MQ_LIB_PATH

OSI에서 IBM MQ에 대한 MQI(MQ Interface)를 사용하기 위한 MQ library path를 지정한다.

항목 설명

파라미터 타입

String

기본값

(NONE)

범위

비고

VALUE를 (NONE)으로 지정한 경우에는 MQ library path를 공백으로 처리한다.

다음은 IMSA라는 시스템에서 IBM MQ를 사용하고, Queue Manager는 QMA1으로, MQ 라이브러리 경로는 /opt/mqm/lib64/libmqm.so로 설정한 예제이다.

$ ofconfig list -s osi.IMSA -sec MQ -n NODE1
===================================================================================
  SUBJECT   |     SECTION      |         KEY         |            VALUE
===================================================================================
  osi.IMSA  |        MQ        |      QMGR_NAME      |             QMA1
            |                  |     MQ_LIB_PATH     |   /opt/mqm/lib64/libmqm.so
            |                  |        USE_MQ       |             YES
===================================================================================

3.9. USER_PROGRAM

OSI 사용자 서버를 기동할 때 실행되는 사용자 프로그램을 설정한다.

3.9.1. PGM_NAME

사용자 프로그램 이름을 지정한다.

항목 설명

파라미터 타입

String

기본값

(NONE)

범위

비고

사용자 프로그램은 STEPLIB, JOBLIB, LD_LIBRARY_PATH 순서로 검색한다. 프로그램을 찾지 못하더라도 에러가 발생하지는 않는다.

VALUE를 (NONE)으로 지정한 경우에는 해당 옵션을 설정하지 않은 것과 동일하게 처리한다.

다음은 IMSA 시스템에서 사용자 서버를 기동할 때 사용자 프로그램 TEST01을 실행하도록 설정하는 예제이다.

$ ofconfig list -s osi.IMSA -sec USER_PROGRAM -n NODE1
===================================================================================
  SUBJECT   |     SECTION      |         KEY         |            VALUE
===================================================================================
  osi.IMSA  |   USER_PROGRAM   |       PGM_NAME      |            TEST01
===================================================================================

4. osi.{osiotmasvrname}

OSI와 IBM MQ 제품 간의 OTMA 기능을 제공하는 osiotmasvr의 각 서버별로 적용할 항목을 설정한다. 서버의 이름을 IMSAOTMA라고 한 경우 서브젝트명은 osi.IMSAOTMA가 되며, osi.IMSAOTMA로 설정된 항목들은 IMSAOTMA 서버에서만 적용된다.

4.1. GENERAL

4.1.1. IMSID

OTMA Message를 송신할 스케줄 서버(osisschd)가 속한 IMSID를 설정한다. 멀티노드 환경에서 모든 노드의 설정이 일치해야 한다.

항목 설명

파라미터 타입

String

기본값

(NONE)

범위

비고

VALUE를 (NONE)으로 지정한 경우에는 IMSID를 공백으로 처리한다.

4.2. MQ

OSI 시스템에서 IBM MQ 정보를 설정한다.

4.2.1. Q_NAME

MQGET을 요청할 대상이 되는 Queue 이름을 지정한다. 멀티노드 환경에서 모든 노드의 설정이 일치해야 한다.

항목 설명

파라미터 타입

String

기본값

(NONE)

범위

비고

VALUE를 (NONE)으로 지정한 경우에는 Initiation Queue의 이름을 공백으로 처리한다.

4.2.2. TIMEOUT

MQGET API의 timeout 값을 설정한다. 멀티노드 환경에서 모든 노드의 설정이 일치해야 한다.

항목 설명

파라미터 타입

String

기본값

10000 (단위 : ms)

범위

비고

다음은 IMSAOTMA라는 OTMA 서버가 QMA1의 A.QUEUE라는 Queue를 10초 주기로 모니터링하면서, OTMA Message를 IMSA라는 IMSID로 전달하도록 설정하는 예제이다.

$ ofconfig list -s osi.IMS -sec MQ -k QMGR_NAME -n NODE1
===================================================================================
  SUBJECT   |     SECTION      |         KEY         |            VALUE
===================================================================================
  osi.IMSA  |        MQ        |      QMGR_NAME      |             QMA1

$ ofconfig list -s osi.IMSAOTMA -n NODE1
===================================================================================
  SUBJECT   |     SECTION      |         KEY         |            VALUE
===================================================================================
osi.IMSAOTMA|     GENERAL      |        IMSID        |             IMSA
            |----------------------------------------------------------------------
            |        MQ        |       Q_NAME        |           A.QUEUE
            |                  |       TIMEOUT       |            10000
===================================================================================

OTMA는 Queue Manager를 통해서 Queue로부터 Input Message를 GET하게 된다. 이때, Input Message는 MQ 섹션의 IMSID 키의 VALUE 항목에 기술된 imsid에 속한 스케줄 서버로 전송된다. Input Message를 받은 스케줄 서버는 Message에 서술된 목적지에 따라 스케줄링을 수행하게 된다.

5. ssm.{IMSID}{SSM}

OSI에서 IMS 시스템별로 MultipleRM을 사용하기 위해 Tmax XA 서버에 적용하는 항목을 설정한다. 서브젝트명에서 {IMSID}는 XA 서버가 속한 IMS 시스템 이름을, {SSM}은 OSI 사용자 서버(Dependent Region)에서 사용할 Subsystem ID를 가리킨다. OSI 사용자 서버에서는 기동 JCL내의 EXEC parameter에 명시된 SSM 이름으로 해당하는 설정 항목들을 읽는다.

5.1. GENERAL

XA 연결과 관련된 일반적인 정보를 설정한다.

5.1.1. DLI_CONN_ID

DLI 함수를 수행하는 데이터베이스에 연결할 conn_id를 설정한다. Tmax 설정파일의 SVRGROUP 설정에서 OPENINFO에 기술한 conn_id와 동일해야 한다. 멀티노드 환경에서 모든 노드의 설정이 일치해야 한다.

항목 설명

파라미터 타입

String

기본값

(NONE)

범위

비고

VALUE를 (NONE)으로 지정한 경우에는 conn_id 값을 공백으로 처리한다.

5.1.2. PRELOAD

XA 모드에서 데이터베이스가 제공하는 xa-switch 라이브러리 파일에 대한 경로를 지정한다. 멀티노드 환경에서 모든 노드의 설정이 일치해야 한다.

항목 설명

파라미터 타입

String

기본값

(NONE)

범위

비고

VALUE를 (NONE)으로 지정한 경우에는 라이브러리의 경로를 공백으로 처리한다.

다음은 IMSID가 IMSA이고 SSM이 DB2T인 시스템에서 DLI_CONN_ID는 DLI로, PRELOAD는 ${TB_HOME}/client/lib/libtbxa.so:${DB2_HOME}/lib/libdb2.so으로 설정하는 예제이다.

$ ofconfig list -s ssm.IMSADB2T -sec GENERAL -n NODE1
===================================================================================
  SUBJECT   |     SECTION      |         KEY         |            VALUE
===================================================================================
ssm.IMSADB2T|     GENERAL      |     DLI_CONN_ID     |             DLI
            |                  |       PRELOAD       | ${TB_HOME}/client/lib/libtb
                                                       xa.so:${DB2_HOME}/lib/libdb2.so
===================================================================================