OpenFrame OSC 시스템 툴

본 장에서는 OpenFrame OSC 시스템에서 사용하는 툴 프로그램 사용법에 대해 기술한다.

1. 개요

다음은 OpenFrame OSC(이하 OSC) 시스템의 운영 편의를 위한 프로그램 목록이다.

프로그램명	설명
excicblpp	EXCI(external CICS Interface)를 지원하기 위한 전처리 툴이다.
mscadjust	Map 마이그레이션 과정 중에 발생하는 2Byte 문자 변환 오류를 보정한다.
mscasmc	Map에 있는 덤프용 어셈블러 매크로 명령어를 제거한다.
mscmapc	Map 소스 코드를 컴파일하여 Symbolic Map과 Physical Map 파일을 생성한다.
mscmapupdate	OSC Region이 사용하는 Map 정보를 동적으로 관리한다.
oscadmin	OSC Region을 관리한다.
oscappbuild	OSC 애플리케이션을 자동으로 생성한다.
oscboot	OSC 시스템 또는 특정 Region을 기동한다.
oscbuild	OSC 애플리케이션 서버를 자동으로 생성한다.
osccblpp	OSC COBOL 애플리케이션 프로그램 소스 내에 존재하는 EXEC CICS 명령어를 전처리한다.
osccheck	OSC Region을 위한 설정 파일이나 공유 메모리의 정보를 체크한다.
osccobprep	OSC 시스템을 위한 COBOL 문법을 전처리한다.
osccprep	OSC 시스템에서 사용하는 C 문법과 EXEC CICS 명령어를 전처리한다.
oscdct2rd	CICS에서 사용하는 DCT 매크로를 OSC 시스템에서 사용할 수 있는 형식의 TDQUEUE 정의 매크로 파일로 변환한다.
oscdown	OSC 시스템 또는 특정 Region을 종료한다.
oscinit	OSC를 설치 및 제거할 때 필요한 시스템 테이블을 삭제/제거하는 툴이다.
oscjct2rd	CICS에서 사용하는 JCT 매크로를 OSC 시스템에서 사용할 수 있는 형식의 JOURNALMODEL 정의 매크로 파일로 변환한다.
osclogrpt	트랜잭션의 통계 정보를 조회한다.
oscplipp	OSC PLI 애플리케이션 프로그램 소스 내에 존재하는 EXEC CICS 명령어를 전처리하여 결과물을 산출한다.
oscpltc	PLT 매크로를 컴파일한다.
oscresp	OSC Region에서 사용자 애플리케이션 수행 중에 애플리케이션에서 사용하고 있는 EXEC CICS 구문의 수행 결과로 RESP, RESP2 값이 설정되었을 경우 해당 값이 어떤 의미인지 조회할 수 있도록 제공되는 툴이다.
oscrtsddump	RTSD에 저장된 리소스 정의 정보를 매크로 형태의 파일로 저장한다.
oscrtsdupdate	리소스 정의가 선언되어 있는 매크로 파일을 읽어서 운영 중인 OSC Region의 RTSD에 업데이트한다.
oscruntran	특정 트랜잭션을 사용자가 직접 실행시킨다.
oscscview	START 혹은 DELAY 명령어에 의하여 혹은 TDQ ATI 기능에 의하여 OSC 시스템에서 스케줄링되고 있는 아이템들을 보여주는 툴이다.
oscsddump	OSC SD 테이블에 저장된 Online 리소스 정의들을 매크로 형태의 파일로 저장한다.
oscsdgen	매크로 형식의 리소스 정의가 정의되어 있는 텍스트 파일을 읽어서 지정된 OSC SD 테이블에 저장하는 역할을 수행한다.
osctdlinit	OSC Region 별로 TDL 공유 메모리 및 동적 모듈을 초기화한다.
osctdlrm	OSC Region 별로 TDL 공유 메모리를 제거하기 위한 툴이다.
osctdlupdate	OSC Region에 지정한 동적 모듈을 업데이트한다.
osctsqcheck	TSQ 메모리 영역 내부에서 사용되는 Lock 정보를 모니터링하고 비정상적으로 사용되는 Lock을 해제하는 기능을 제공한다.
osctxadm	현재 Region 중에 실행되고 있는 트랜잭션의 상태를 조회한다.
oscxltc	XLT 매크로를 컴파일한다.

프로그램명

설명

excicblpp

EXCI(external CICS Interface)를 지원하기 위한 전처리 툴이다.

mscadjust

Map 마이그레이션 과정 중에 발생하는 2Byte 문자 변환 오류를 보정한다.

mscasmc

Map에 있는 덤프용 어셈블러 매크로 명령어를 제거한다.

mscmapc

Map 소스 코드를 컴파일하여 Symbolic Map과 Physical Map 파일을 생성한다.

mscmapupdate

OSC Region이 사용하는 Map 정보를 동적으로 관리한다.

oscadmin

OSC Region을 관리한다.

oscappbuild

OSC 애플리케이션을 자동으로 생성한다.

oscboot

OSC 시스템 또는 특정 Region을 기동한다.

oscbuild

OSC 애플리케이션 서버를 자동으로 생성한다.

osccblpp

OSC COBOL 애플리케이션 프로그램 소스 내에 존재하는 EXEC CICS 명령어를 전처리한다.

osccheck

OSC Region을 위한 설정 파일이나 공유 메모리의 정보를 체크한다.

osccobprep

OSC 시스템을 위한 COBOL 문법을 전처리한다.

osccprep

OSC 시스템에서 사용하는 C 문법과 EXEC CICS 명령어를 전처리한다.

oscdct2rd

CICS에서 사용하는 DCT 매크로를 OSC 시스템에서 사용할 수 있는 형식의 TDQUEUE 정의 매크로 파일로 변환한다.

oscdown

OSC 시스템 또는 특정 Region을 종료한다.

oscinit

OSC를 설치 및 제거할 때 필요한 시스템 테이블을 삭제/제거하는 툴이다.

oscjct2rd

CICS에서 사용하는 JCT 매크로를 OSC 시스템에서 사용할 수 있는 형식의 JOURNALMODEL 정의 매크로 파일로 변환한다.

osclogrpt

트랜잭션의 통계 정보를 조회한다.

oscplipp

OSC PLI 애플리케이션 프로그램 소스 내에 존재하는 EXEC CICS 명령어를 전처리하여 결과물을 산출한다.

oscpltc

PLT 매크로를 컴파일한다.

oscresp

OSC Region에서 사용자 애플리케이션 수행 중에 애플리케이션에서 사용하고 있는 EXEC CICS 구문의 수행 결과로 RESP, RESP2 값이 설정되었을 경우 해당 값이 어떤 의미인지 조회할 수 있도록 제공되는 툴이다.

oscrtsddump

RTSD에 저장된 리소스 정의 정보를 매크로 형태의 파일로 저장한다.

oscrtsdupdate

리소스 정의가 선언되어 있는 매크로 파일을 읽어서 운영 중인 OSC Region의 RTSD에 업데이트한다.

oscruntran

특정 트랜잭션을 사용자가 직접 실행시킨다.

oscscview

START 혹은 DELAY 명령어에 의하여 혹은 TDQ ATI 기능에 의하여 OSC 시스템에서 스케줄링되고 있는 아이템들을 보여주는 툴이다.

oscsddump

OSC SD 테이블에 저장된 Online 리소스 정의들을 매크로 형태의 파일로 저장한다.

oscsdgen

매크로 형식의 리소스 정의가 정의되어 있는 텍스트 파일을 읽어서 지정된 OSC SD 테이블에 저장하는 역할을 수행한다.

osctdlinit

OSC Region 별로 TDL 공유 메모리 및 동적 모듈을 초기화한다.

osctdlrm

OSC Region 별로 TDL 공유 메모리를 제거하기 위한 툴이다.

osctdlupdate

OSC Region에 지정한 동적 모듈을 업데이트한다.

osctsqcheck

TSQ 메모리 영역 내부에서 사용되는 Lock 정보를 모니터링하고 비정상적으로 사용되는 Lock을 해제하는 기능을 제공한다.

osctxadm

현재 Region 중에 실행되고 있는 트랜잭션의 상태를 조회한다.

oscxltc

XLT 매크로를 컴파일한다.

2. excicblpp

excicblpp는 EXCI(External CICS Interface)를 지원하기 위한 전처리 툴이다. 배치 등 OSC 외부의 COBOL 프로그램에서 특정 Region의 프로그램을 DPL 방식으로 실행할수 있도록 전처리를 수행한다.

사용법

excicblpp를 실행하는 방법은 다음과 같다.

Usage: excicblpp [options] <file> ...
[options]
  -o <output> Set <output> as output file name (stronger than -p)
  -p <prefix> Set <prefix> as output file prefix
  -V          Preprocess in verbose mode
  -h          Display this information
  -v          Display version information

[options]

옵션	설명
[-o output]	출력 파일의 이름을 지정한다.
[-p prefix]	출력 파일 이름의 prefix를 지정한다.
[-V]	Verbose mode로 실행한다.
[-h]	프로그램 사용을 위한 자세한 사용법을 출력한다.
[-v]	excicblpp의 버전 정보를 출력한다.

옵션

설명

[-o output]

출력 파일의 이름을 지정한다.

[-p prefix]

출력 파일 이름의 prefix를 지정한다.

[-V]

Verbose mode로 실행한다.

[-h]

프로그램 사용을 위한 자세한 사용법을 출력한다.

[-v]

excicblpp의 버전 정보를 출력한다.

입력 항목

옵션 설명

file

전처리할 COBOL 프로그램 소스 파일을 지정한다. COBOL 프로그램 소스 파일은 한 번에 여러 모듈을 지정할 수 있다.

옵션	설명
file	전처리할 COBOL 프로그램 소스 파일을 지정한다. COBOL 프로그램 소스 파일은 한 번에 여러 모듈을 지정할 수 있다.

사용예제

다음은 SAMPLE00.cob 파일을 Verbose mode로 전처리하여 excicblpp_SAMPLE00.cob 파일을 생성하는 예제이다.

$ excicblpp -V SAMPLE00.cob

위의 명령어를 실행한 후 다음과 같은 메시지가 출력되면서 전처리가 된다.

EXCICBLPP : input file(SAMPLE00.cob)
EXCICBLPP : output file(excicblpp_SAMPLE00.cob)

3. mscadjust

mscadjust는 Map 마이그레이션 과정 중에 발생하는 2Byte 문자 변환 오류를 보정하기 위해 만들어진 툴이다.

EBCDIC으로 작성된 호스트 Map 파일에 1Byte 문자 외에 한국어나 일본어 등의 2Byte 데이터가 섞여있고 Map의 필드 정의에 programmed symbol 관련 항목(PS=X’F8’ 등)이 설정된 경우, dsmigin 툴에서는 PS와 같은 BMS Map 매크로의 문법을 인식할 수 없기 때문에 해당 필드를 2Byte 문자로 적절하게 변환할 수 없다.

mscadjust가 동작하려면 EBCDIC 코드로 이루어진 원본 Map 파일과 문법 인식을 위해 사용되는 Map Source Code의 2가지 파일이 입력으로 주어져야 한다. 또한 Map Source Code는 ASCII로 변환된 후 mscasmc 툴로 전처리해야 한다.

mscadjust는 2가지 파일을 이용해서 dsmigin 툴에서 제대로 변환되지 않았을 가능성이 있는 필드들을 찾아서 1Byte 변환 결과와 2Byte 변환 결과를 사용자에게 보여주고, 사용자는 해당 필드를 2Byte 코드 또는 1Byte 코드로 인식해서 변환하도록 선택할 수 있다.

사용법

mscadjust를 실행하는 방법은 다음과 같다.

Usage: mscadjust [options] ebcdic_file ascii_file
     | mscadjust -o output_file ebcdic_file ascii_file
     | mscadjust [-h | -v]

[options]

옵션	설명
[-s]	변환할 때 자동으로 할지 사용자가 확인하면서 할지를 정한다.
[-d]	보정하고자 하는 파일을 보여준다.
[-o]	결과 파일을 사용자가 지정한다.
[-h]	프로그램 사용을 위한 자세한 사용법을 출력한다.
[-v]	mscadjust의 버전 정보를 출력한다.

옵션

설명

[-s]

변환할 때 자동으로 할지 사용자가 확인하면서 할지를 정한다.

[-d]

보정하고자 하는 파일을 보여준다.

[-o]

결과 파일을 사용자가 지정한다.

[-h]

프로그램 사용을 위한 자세한 사용법을 출력한다.

[-v]

mscadjust의 버전 정보를 출력한다.

입력 항목

옵션	설명
ebcdic_file	EBCDIC 코드로 이루어진 원본 Map 파일을 사용자가 지정한다.
ascii_file	dsmigin로 변환된 ASCII 코드로 이루어진 Map 파일을 사용자가 지정한다.
output_file	보정된 결과를 저장할 출력 파일을 사용자가 지정한다.

옵션

설명

ebcdic_file

EBCDIC 코드로 이루어진 원본 Map 파일을 사용자가 지정한다.

ascii_file

dsmigin로 변환된 ASCII 코드로 이루어진 Map 파일을 사용자가 지정한다.

output_file

보정된 결과를 저장할 출력 파일을 사용자가 지정한다.

사용예제

다음은 mscadjust 툴을 사용하여 SAMPLE00라는 EBCDIC으로 된 원본 Map Source Code와 SAMPLE00.map.atm라는 mscasmc로 전처리된 ASCII Map Source Code를 보정하여 SAMPLE00.adj라는 Map Source Code를 생성하는 예제이다.

$ mscadjust -o SAMPLE00.adj SAMPLE00 SAMPLE00.map.atm

[MSCADJUST] input ascii code map : SAMPLE00.map.atm
[MSCADJUST] input ebcdic code map : SAMPLE00


* before: [.*.*    ...|D..  ....X  .(...7.....)    *.*      ]

* after: [＊＊　　外注訂正　店指定　（入力画面）　　＊＊　　　]

* do you want to change? (Yes:(Enter/Y/y), No:(N/n))Y

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

* before: [....]

* after: [法人]

* do you want to change? (Yes:(Enter/Y/y), No:(N/n))

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

* before: [...>]

 * after: [店№]

 * do you want to change? (Yes:(Enter/Y/y), No:(N/n))

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

 * before: [  .    .....    .R(..>  ]

 * after: [　区　　発注日　　伝票№　]

 * do you want to change? (Yes:(Enter/Y/y), No:(N/n))

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

 * before: [  .....      ......3    ]

 * after: [　取引先　　　取引先名　　]

 * do you want to change? (Yes:(Enter/Y/y), No:(N/n))

$

4. mscasmc

mscasmc는 맵에 있는 덤프용 어셈블러 매크로 명령어를 전처리하는 툴이다. 실제로 화면에 영향을 미치고 맵을 정의하는 부분 외에 덤프용으로 쓰여지는 매크로들이 있는데, 가령 PRINT ON, NOGEN, TITLE 같은 매크로들은 mscasmc 툴을 사용하여 전처리를 한다.

사용법

mscasmc를 실행하는 방법은 다음과 같다.

Usage: mscasmc [options] file
     | mscasmc -o output_file file

[options]

옵션	설명
[-d]	컴파일 대상 파일의 전처리 과정을 출력하면서 컴파일하므로 해당 소스가 처리되는 방법 및 에러 발생 위치를 바로 확인할 수 있다.
[-h]	프로그램 사용을 위한 자세한 사용법을 출력한다.
[-v]	mscasmc의 버전 정보를 출력한다.

옵션

설명

[-d]

컴파일 대상 파일의 전처리 과정을 출력하면서 컴파일하므로 해당 소스가 처리되는 방법 및 에러 발생 위치를 바로 확인할 수 있다.

[-h]

프로그램 사용을 위한 자세한 사용법을 출력한다.

[-v]

mscasmc의 버전 정보를 출력한다.

입력 항목

항목 설명

file

전처리하려는 맵 파일의 이름을 지정한다.

-o output_file

전처리된 결과를 저장할 출력 파일을 사용자가 지정한다.

항목	설명
file	전처리하려는 맵 파일의 이름을 지정한다.
-o output_file	전처리된 결과를 저장할 출력 파일을 사용자가 지정한다.

사용예제

다음은 SCSOW03.map 파일의 덤프용 어셈블러 매크로 명령어를 전처리하는 예이다.

$ mscasmc SCSOW03.map

위의 명령어를 실행한 후 다음과 같은 메시지가 출력되면서 컴파일이 된다.

MSCASMC : input map : SCSOW03.map
MSCASMC : file[SCSOW03.map.atm] create ok.

5. mscmapc

mscmapc 툴은 Map Source Code를 컴파일하여 Symbolic Map과 Physical Map 파일을 생성하는 툴이다.

Symbolic Map은 애플리케이션에서 사용하는 데이터의 구조가 정의되어 있는 COBOL Copybook 파일이고, Physical Map은 맵을 구성하는 각 필드들의 속성과 데이터 변환에 필요한 정보들을 저장하고 있는 바이너리 파일이다.

사용법

mscmapc를 실행하는 방법은 다음과 같다.

Usage: mscmapc [options1] file
     | mscmapc [options2] dir file

옵션	설명
[-d]	컴파일할 소스의 전처리 과정을 출력한다. 전처리 과정을 보면서 컴파일을 수행하기 때문에 에러가 발생할 경우 에러 탐지가 용이하다.
[-o dir]	Symbolic Map과 Physical Map이 생성되는 디렉터리를 지정한다.
[-p 1\|2]	에뮬레이터에 나오는 화면을 미리 보여준다. 1 : 2Byte 문자가 존재하지 않는 경우 2 : 2Byte 문자가 존재하는 경우
[-r region]	Symbolic Map과 Physical Map을 생성할 Region 이름을 지정한다. 지정된 Region의 osc.{servername} 서브젝트, GENERAL 섹션의 MAPDIR 키의 VALUE 항목에 설정된 디렉터리 하위에는 Physical, Symbolic 디렉터리가 생성되어 있어야 정상 동작한다.
[-s file]	Symbolic Map 파일을 생성할 때 지정된 파일 이름으로 생성한다.
[-h]	프로그램 사용을 위한 자세한 사용법을 출력한다.
[-v]	mscmapc의 버전 정보를 출력한다.

옵션

설명

[-d]

컴파일할 소스의 전처리 과정을 출력한다. 전처리 과정을 보면서 컴파일을 수행하기 때문에 에러가 발생할 경우 에러 탐지가 용이하다.

[-o dir]

Symbolic Map과 Physical Map이 생성되는 디렉터리를 지정한다.

[-p 1|2]

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

1 : 2Byte 문자가 존재하지 않는 경우
2 : 2Byte 문자가 존재하는 경우

[-r region]

Symbolic Map과 Physical Map을 생성할 Region 이름을 지정한다.

지정된 Region의 osc.{servername} 서브젝트, GENERAL 섹션의 MAPDIR 키의 VALUE 항목에 설정된 디렉터리 하위에는 Physical, Symbolic 디렉터리가 생성되어 있어야 정상 동작한다.

[-s file]

Symbolic Map 파일을 생성할 때 지정된 파일 이름으로 생성한다.

[-h]

프로그램 사용을 위한 자세한 사용법을 출력한다.

[-v]

mscmapc의 버전 정보를 출력한다.

사용예제

다음은 CESN.map 파일을 컴파일한 후 Symbolic Map과 Physical Map 파일을 현재 디렉터리에 생성하는 예이다.

$ mscmapc CESN.map

>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
 * input map : CESN.map

 * Copybook :
   [./CESN.cpy] create.
 *  binary image :
   [./CESN.phm] create.
<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<

2개의 파일이 정상적으로 만들어졌다는 메시지를 통해 성공적으로 컴파일이 완료된 것을 확인할 수 있다.

다음은 -o 옵션을 사용하여 CESN.map 파일을 컴파일한 후 Symbolic Map과 Physical Map 파일을 지정한 디렉터리에 생성하는 예이다.

$ mscmapc -o $OPENFRAME_HOME/osc/map CESN.map

>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
 * input map : CESN.map

 * Copybook :
   [/home/oframe/OpenFrame/osc/map/CESN.cpy] create.
 *  binary image :
   [/home/oframe/OpenFrame/osc/map/CESN.phm] create.
<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<

다음은 -r 옵션을 사용하여 CESN.map 파일을 컴파일한 후 Symbolic Map과 Physical Map 파일을 Region 디렉터리에 생성하는 예이다.

$ mscmapc -r OSC00001 CESN.map

>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
 * input map : CESN.map

 * Copybook :
   [/home/oframe/OpenFrame/osc/region/OSC00001/map/symbolic/CESN.cpy] create.
 *  binary image
   [/home/oframe/OpenFrame/osc/region/OSC00001/map/physical/CESN.phm] create.
<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<

6. mscmapupdate

mscmapupdate는 OSC Region이 사용하는 맵 셋의 정보를 동적으로 관리하는 툴로서, 사용자가 업무 진행 중에 맵 정보를 변경하여 바로 반영하거나 추가 로딩할 수 있다. 그 외에 현재 메모리에 저장된 맵 셋의 조회, 삭제 기능을 제공한다. 멀티 클러스터링 환경에서도 동적 관리가 가능하다.

사용법

mscmapupdate을 실행하는 방법은 다음과 같다.

Usage:  mscmapupdate [options]
 |  mscmapupdate region
 |  mscmapupdate region -f filename
 |  mscmapupdate region -l mapset [-n]
 |  mscmapupdate region -r mapset [-n]

[options]

옵션	설명
[-h]	프로그램 사용을 위한 자세한 사용법을 출력한다.
[-v]	mscmapupdate의 버전 정보를 출력한다.
[-n]	맵 셋을 업데이트하는 경우 동일한 Region이 기동하고 있는 모든 노드에 반영한다.

옵션

설명

[-h]

프로그램 사용을 위한 자세한 사용법을 출력한다.

[-v]

mscmapupdate의 버전 정보를 출력한다.

[-n]

맵 셋을 업데이트하는 경우 동일한 Region이 기동하고 있는 모든 노드에 반영한다.

입력 항목

항목	설명
region	OSC Region에 등록된 맵 셋 정보를 출력한다.
-f filename	업데이트할 Physical Map 파일명을 지정하여 OSC Region 메모리에 로드한다. 기존에 동일한 맵 셋이 로드되어 있다면 새로운 데이터로 업데이트한다.
-l mapset	업데이트할 맵 셋 이름을 지정하여 OSC Region 메모리에 로드한다. 기존에 동일한 맵 셋이 로드되어 있다면 새로운 데이터로 업데이트한다.
-r mapset	OSC Region에서 해당 맵 셋을 삭제한다.

항목

설명

region

OSC Region에 등록된 맵 셋 정보를 출력한다.

-f filename

업데이트할 Physical Map 파일명을 지정하여 OSC Region 메모리에 로드한다. 기존에 동일한 맵 셋이 로드되어 있다면 새로운 데이터로 업데이트한다.

-l mapset

업데이트할 맵 셋 이름을 지정하여 OSC Region 메모리에 로드한다. 기존에 동일한 맵 셋이 로드되어 있다면 새로운 데이터로 업데이트한다.

-r mapset

OSC Region에서 해당 맵 셋을 삭제한다.

사용예제

다음은 OSC00001 Region에 등록된 맵 셋의 정보를 출력하는 예이다.

$  mscmapupdate OSC00001
* loaded mapset list
0001 : mapset[CESN]
0002 : mapset[OIVPMS1]

다음은 OSC00001 Region에 OIVPMS1 맵 셋을 업데이트하는 예이다. 맵을 삭제하는 경우 -r 옵션을 사용하여 동일하게 지정한다.

$  mscmapupdate OSC00001 -l OIVPMS1

다음은 OSC00001 Region이 기동된 모든 노드에 OIVPMS1 맵 셋을 업데이트하는 예이다. 맵을 삭제하는 경우 -r 옵션을 사용하여 동일하게 지정한다.

$  mscmapupdate OSC00001 -l OIVPMS1 -n

7. oscadmin

oscadmin은 OSC Region을 관리하는 툴이다.

사용법

oscadmin을 실행하는 방법은 다음과 같다.

Usage: oscadmin [options]
Options:
    -l <region>                 Display current log level
                                  <region>   OSC region name
    -l <region>:{E|I|D|T}       Set log level
                                  E: Error log level
                                  I: Information log level
                                  D: Debug log level
    -c <region>[:<svgname>]     Create Tmax Config file about Region & TRANCLASS
                                   <svgname>: specify SVGNAME of SERVER config
    -d <region>:{TSQ|TDQ}       Display TSQ or TDQ list
    -d <region>:{TSQ|TDQ}:QNAME Remove QUEUE Item
                                   TSQ QNAME: must be specified with Hex value
    -h                          Display this information
    -v                          Display version information

[options]

옵션	설명
[-l region]	OSC Region의 로그 레벨을 조회한다.
[-l region:{E\|I\|D\|T}]	OSC Region의 로그 레벨을 다음의 중 하나로 수정한다. E(Error Level) : 에러가 발생했을 경우의 로그 정보만 기록한다. I(Information Level) : 에러 레벨보다 더 자세한 경고나 알림 메시지까지 로그에 기록한다. D(Debug Level) : 시스템의 버그 상황을 추적하기 위해서 도움이 되는 자세한 로그 정보를 기록한다. T(Test Level) : 주고받는 데이터의 정보를 자세하게 기록한다.
[-c region:<svgname>]	OSC Region에 정의된 TRANCLASS 정보로 Tmax configuration을 출력한다.
-d <region>:{TSQ\|TDQ}	OSC Region에서 사용 중인 TSQ, TDQ 리스트를 조회한다. TSQ : TSQ 리스트를 조회한다. TDQ : TDQ 리스트를 조회한다.
-d <region>:{TSQ\|TDQ}:QNAME	OSC Region에서 사용 중인 TSQ, TDQ를 삭제한다. TSQ:QNAME : 지정한 TSQ를 삭제한다. 단, TSQ를 지정할 땐 TSQ 리스트를 조회하는 경우 출력된 HEX value의 TSQ NAME을 사용한다. TDQ:QNAME : 지정한 TDQ를 삭제한다.
[-h]	프로그램 사용을 위한 자세한 사용법을 출력한다.
[-v]	oscadmin의 버전 정보를 출력한다.

옵션

설명

[-l region]

OSC Region의 로그 레벨을 조회한다.

[-l region:{E|I|D|T}]

OSC Region의 로그 레벨을 다음의 중 하나로 수정한다.

E(Error Level) : 에러가 발생했을 경우의 로그 정보만 기록한다.
I(Information Level) : 에러 레벨보다 더 자세한 경고나 알림 메시지까지 로그에 기록한다.
D(Debug Level) : 시스템의 버그 상황을 추적하기 위해서 도움이 되는 자세한 로그 정보를 기록한다.
T(Test Level) : 주고받는 데이터의 정보를 자세하게 기록한다.

[-c region:<svgname>]

OSC Region에 정의된 TRANCLASS 정보로 Tmax configuration을 출력한다.

-d <region>:{TSQ|TDQ}

OSC Region에서 사용 중인 TSQ, TDQ 리스트를 조회한다.

TSQ : TSQ 리스트를 조회한다.
TDQ : TDQ 리스트를 조회한다.

-d <region>:{TSQ|TDQ}:QNAME

OSC Region에서 사용 중인 TSQ, TDQ를 삭제한다.

TSQ:QNAME : 지정한 TSQ를 삭제한다. 단, TSQ를 지정할 땐 TSQ 리스트를 조회하는 경우 출력된 HEX value의 TSQ NAME을 사용한다.
TDQ:QNAME : 지정한 TDQ를 삭제한다.

[-h]

프로그램 사용을 위한 자세한 사용법을 출력한다.

[-v]

oscadmin의 버전 정보를 출력한다.

사용예제

다음은 OSC00001 Region의 로그 레벨을 I로 설정하는 예이다.

$ oscadmin -l OSC00001:I

8. oscappbuild

oscappbuild는 OSC 애플리케이션을 자동으로 생성하는 툴이다. 현재 PL/I 언어만 지원한다.

사용법

oscappbuild를 실행하는 방법은 다음과 같다.

Usage : oscappbuild -x bit -l lang [-m] [-V] [-p program]
                    [-r region] file
      | oscappbuild [-h | -v]

항목	설명
-x bit	생성하려는 프로그램 바이너리의 비트를 지정한다. 현재 32만 지원한다.
-l lang	프로그램 소스의 프로그래밍 언어를 지정한다. 현재 PLI만 지원한다.
[-m]	MF-COBOL과 연계하여 프로그램을 동작하는 경우 지정한다.
[-V]	Verbose mode로 실행한다.
[-p program]	생성하려는 프로그램 바이너리 이름을 지정한다.
[-r region]	생성하여 배포하려는 Region 이름을 지정한다.
file	'.pli’의 확장자로 끝나는 PL/I 소스 파일 이름을 지정한다.
[-h]	프로그램 사용을 위한 자세한 사용법을 출력한다.
[-v]	oscappbuild의 버전 정보를 출력한다.

항목

설명

-x bit

생성하려는 프로그램 바이너리의 비트를 지정한다. 현재 32만 지원한다.

-l lang

프로그램 소스의 프로그래밍 언어를 지정한다. 현재 PLI만 지원한다.

[-m]

MF-COBOL과 연계하여 프로그램을 동작하는 경우 지정한다.

[-V]

Verbose mode로 실행한다.

[-p program]

생성하려는 프로그램 바이너리 이름을 지정한다.

[-r region]

생성하여 배포하려는 Region 이름을 지정한다.

file

'.pli’의 확장자로 끝나는 PL/I 소스 파일 이름을 지정한다.

[-h]

프로그램 사용을 위한 자세한 사용법을 출력한다.

[-v]

oscappbuild의 버전 정보를 출력한다.

사용예제

다음은 pg00.pli이라는 PL/I 언어로 작성된 프로그램 소스를 생성하는 예이다. 결과물로 pg00.so이라는 프로그램 바이너리가 생성된다.

$ oscappbuild -x 32 -l PLI pg00.pli

9. oscboot

oscboot는 OpenFrame 시스템 전체, OSC 시스템 전체 또는 특정 Region을 기동하는 툴이다.

oscboot는 시스템을 기동하기 전/후에 사용자가 필요한 작업을 수행할 수 있도록 oscboot.pre 및 oscboot.post 스크립트를 실행한다. oscboot.pre 및 oscboot.post 스크립트는 Tmax 및 OpenFrame 시스템 서버 기동에 관여하는 옵션( -N, -T, -b, -C, -B)에 대해서만 동작하며 -r 옵션과 같이 특정 Region만을 기동시킬 때는 동작하지 않는다.

OSC 기동에 대한 자세한 안내는 OpenFrame OSC "운영자 안내서"의 "OSC 기동 및 종료"를 참고한다.

사용법

oscboot을 실행하는 방법은 다음과 같다. 옵션을 지정하지 않을 경우 위에 설명한 일반적인 단계를 거쳐 OSC 시스템 서버 및 OSC Region을 기동한다.

Usage: oscboot [-N node]
          [-T | -B | -b | - C | -c | [-r region [-s | -m | -a] [-l:[E|I|D]]]
          [[-d | -D] microseconds] | [[-w] seconds] | oscboot [-h | -v]

옵션	설명
[-N node]	지정한 노드에서 명령을 실행한다. 멀티 노드를 구성하는 경우 노드별로 기동할 때 사용한다.
[-T]	OpenFrame 시스템 서버들은 기동하지 않고 Tmax 시스템 프로세스만을 실행시키는 옵션이다.
[-B]	백업 노드 옵션으로 노드 고유의 OSC 시스템 서버만 기동한다(oscdfsvr, oscncsvr, oscolsvr, oscscsvr 서비스는 기동하지 않는다).
[-b]	ofsys.seq에 기술된 OpenFrame 시스템 서버들과 Tmax를 기동한다.
[-C]	Region을 제외한 OpenFrame 시스템 서버, OSC 시스템 서버, OSC 사용자 서버를 기동한다.
[-c]	Region을 제외한 OSC 시스템 서버 및 OSC 사용자 서버를 기동한다.
[-r region]	특정 OSC Region을 기동한다.
[-s]	OSC Region을 기동할 때 Region 리소스를 생성하지 않는다. (sys/user/tsq 메모리 미할당)
[-m]	Region 리소스가 이미 있으면 삭제하고 새로 생성한다. 리전 비정상종료 후 부트시에 사용한다.
[-a]	OSC Region을 기동할 때 Region DB 테이블(리소스, 시스템 관련)은 생성하지 않는다.
[-l:{E\|I\|D\|T}]	OSC 시스템의 초기 로그 레벨을 지정하여 OSC 시스템 서버 및 OSC Region을 기동한다. 로그 레벨은 다음의 3가지 중 하나로 설정한다. E(Error Level) : 에러가 발생했을 경우의 로그 정보만 기록한다. I(Information Level) : 에러 레벨보다 더 자세한 경고나 알림 메시지까지 로그에 기록한다. D(Debug Level) : 시스템의 버그 상황을 추적하기 위해서 도움이 되는 자세한 로그 정보를 기록한다. T(Test Level) : 디버그 레벨의 로그와 입출력 변환 데이터를 함께 기록한다.
[-d microseconds]	서버 프로세스를 기동할 때 wait factor만큼의 간격을 주면서 하나씩 기동하여, 리소스 문제로 기동에 문제가 생기는 것을 방지한다.
[-D microseconds]	-d 옵션과 유사한데 시그널이 오더라도 무시하고 대기한다.
[-w seconds]	OSC Region을 기동할 때 사용자가 타임아웃을 지정할 수 있다.
[-h]	프로그램 사용을 위한 자세한 사용법을 출력한다.
[-v]	oscboot의 버전 정보를 출력한다.

옵션

설명

[-N node]

지정한 노드에서 명령을 실행한다.

멀티 노드를 구성하는 경우 노드별로 기동할 때 사용한다.

[-T]

OpenFrame 시스템 서버들은 기동하지 않고 Tmax 시스템 프로세스만을 실행시키는 옵션이다.

[-B]

백업 노드 옵션으로 노드 고유의 OSC 시스템 서버만 기동한다(oscdfsvr, oscncsvr, oscolsvr, oscscsvr 서비스는 기동하지 않는다).

[-b]

ofsys.seq에 기술된 OpenFrame 시스템 서버들과 Tmax를 기동한다.

[-C]

Region을 제외한 OpenFrame 시스템 서버, OSC 시스템 서버, OSC 사용자 서버를 기동한다.

[-c]

Region을 제외한 OSC 시스템 서버 및 OSC 사용자 서버를 기동한다.

[-r region]

특정 OSC Region을 기동한다.

[-s]

OSC Region을 기동할 때 Region 리소스를 생성하지 않는다. (sys/user/tsq 메모리 미할당)

[-m]

Region 리소스가 이미 있으면 삭제하고 새로 생성한다. 리전 비정상종료 후 부트시에 사용한다.

[-a]

OSC Region을 기동할 때 Region DB 테이블(리소스, 시스템 관련)은 생성하지 않는다.

[-l:{E|I|D|T}]

OSC 시스템의 초기 로그 레벨을 지정하여 OSC 시스템 서버 및 OSC Region을 기동한다.

로그 레벨은 다음의 3가지 중 하나로 설정한다.

E(Error Level) : 에러가 발생했을 경우의 로그 정보만 기록한다.
I(Information Level) : 에러 레벨보다 더 자세한 경고나 알림 메시지까지 로그에 기록한다.
D(Debug Level) : 시스템의 버그 상황을 추적하기 위해서 도움이 되는 자세한 로그 정보를 기록한다.
T(Test Level) : 디버그 레벨의 로그와 입출력 변환 데이터를 함께 기록한다.

[-d microseconds]

서버 프로세스를 기동할 때 wait factor만큼의 간격을 주면서 하나씩 기동하여, 리소스 문제로 기동에 문제가 생기는 것을 방지한다.

[-D microseconds]

-d 옵션과 유사한데 시그널이 오더라도 무시하고 대기한다.

[-w seconds]

OSC Region을 기동할 때 사용자가 타임아웃을 지정할 수 있다.

[-h]

프로그램 사용을 위한 자세한 사용법을 출력한다.

[-v]

oscboot의 버전 정보를 출력한다.

사용예제

다음은 OpenFrame 시스템 서버 및 OSC 시스템 서버들은 기동하지 않고 Tmax 시스템 프로세스만을 실행시키는 예이다.

$ oscboot -T

다음은 Tmax와 ofsys.seq에 기술된 OpenFrame 시스템 서버들을 기동하는 예이다.

$ oscboot -b

다음은 OSC 시스템 서버와 ofosc.seq에 기술된 OSC 사용자 서버들을 기동한 후 OSC00001 Region을 기동하는 예이다.

$ oscboot -c
$ oscboot -r OSC00001

10. oscbuild

oscbuild는 OSC 애플리케이션 서버를 자동으로 생성하는 툴이다. 운영체제 및 데이터베이스에 맞게 애플리케이션 서버를 생성할 수 있다.

사용법

oscbuild를 실행하는 방법은 다음과 같다.

Usage : oscbuild -o OS [-d DB] [-s server] [-f source_file] [-i] [-p]
                 [-g] [-c '<option_string>'] [-l '<option_string>']
                 [-b <cobol-compiler>]
      | oscbuild [-h | -v]

항목	설명
-o OS	운영체제 종류를 지정한다. 지원하는 운영체제는 다음과 같다. AIX 32bit/AIX 64bit HP 32bit/HP 64bit SUN 32bit/SUN 64bit Linux 32bit/Linux 64bit
[-d DB]	데이터베이스를 설정한다. ORACLE : ORACLE의 경우 내부적으로 ${ORACLE_HOME}/precomp/lib/env_precomp.mk에 정의된 LIBDIR64(64bit), LIBDIR32(32bit)를 이용하게 된다. 따라서 지정된 디렉터리가 없으면 에러가 발생하므로 환경에 맞게 디렉터리를 생성해야 한다. DB2 (32bit 및 64bit) : 반드시 -f 옵션을 통해서 소스 코드를 사용자가 직접 제공해주어야 한다.
[-s server]	생성될 OSC 애플리케이션 서버 바이너리 파일의 이름을 설정한다. 이 옵션을 사용하지 않을 경우 기본적으로 OSC00001이라는 이름이 사용된다.
[-f source_file]	사용자가 서버의 부팅이나 종료 과정에서 처리할 작업이 있을 경우 내부적으로 사용하는 소스 코드 파일 대신 사용자가 직접 작성한 소스 코드를 사용해서 업무 서버 파일을 생성할 수 있다.
[-i]	EXEC DLI 명령어 인터페이스가 소스에 포함된 애플리케이션 프로그램을 동작시킬 경우 이 옵션을 사용하여 생성한다. IMS 제품이 설치되어 있어야 성공적인 서버 생성이 가능하다.
[-p]	AIX에서 MF-COBOL 연계없이 PL/I 프로그램 동작하려는 경우 지정한다.
[-g]	디버깅 용도로 서버를 생성하기 위한 옵션으로 디버깅용 Tmax 서버 라이브러리가 링크된다.
[-c '<option_string>']	서버 소스를 컴파일할 때 컴파일러의 추가 옵션을 지정한다.
[-l '<option_string>']	서버 오브젝트를 링크할 때 링커의 추가 옵션을 지정한다.
[-b <cobol-compiler>]	COBOL Compiler를 지정한다. MFCOBOL : MF-COBOL 관련 라이브러리를 링크한다. OFCOBOL : OpenFrame COBOL 관련 라이브러리를 링크한다. -b 옵션을 지정하지 않을 경우 COBOL 관련 라이브러리를 링크하지 않는다.
[-h]	프로그램 사용을 위한 자세한 사용법을 출력한다.
[-v]	oscbuild의 버전 정보를 출력한다.

항목

설명

-o OS

운영체제 종류를 지정한다.

지원하는 운영체제는 다음과 같다.

AIX 32bit/AIX 64bit
HP 32bit/HP 64bit
SUN 32bit/SUN 64bit
Linux 32bit/Linux 64bit

[-d DB]

데이터베이스를 설정한다.

ORACLE : ORACLE의 경우 내부적으로 ${ORACLE_HOME}/precomp/lib/env_precomp.mk에 정의된 LIBDIR64(64bit), LIBDIR32(32bit)를 이용하게 된다. 따라서 지정된 디렉터리가 없으면 에러가 발생하므로 환경에 맞게 디렉터리를 생성해야 한다.
DB2 (32bit 및 64bit) : 반드시 -f 옵션을 통해서 소스 코드를 사용자가 직접 제공해주어야 한다.

[-s server]

생성될 OSC 애플리케이션 서버 바이너리 파일의 이름을 설정한다.

이 옵션을 사용하지 않을 경우 기본적으로 OSC00001이라는 이름이 사용된다.

[-f source_file]

사용자가 서버의 부팅이나 종료 과정에서 처리할 작업이 있을 경우 내부적으로 사용하는 소스 코드 파일 대신 사용자가 직접 작성한 소스 코드를 사용해서 업무 서버 파일을 생성할 수 있다.

[-i]

EXEC DLI 명령어 인터페이스가 소스에 포함된 애플리케이션 프로그램을 동작시킬 경우 이 옵션을 사용하여 생성한다.

IMS 제품이 설치되어 있어야 성공적인 서버 생성이 가능하다.

[-p]

AIX에서 MF-COBOL 연계없이 PL/I 프로그램 동작하려는 경우 지정한다.

[-g]

디버깅 용도로 서버를 생성하기 위한 옵션으로 디버깅용 Tmax 서버 라이브러리가 링크된다.

[-c '<option_string>']

서버 소스를 컴파일할 때 컴파일러의 추가 옵션을 지정한다.

[-l '<option_string>']

서버 오브젝트를 링크할 때 링커의 추가 옵션을 지정한다.

[-b <cobol-compiler>]

COBOL Compiler를 지정한다.

MFCOBOL : MF-COBOL 관련 라이브러리를 링크한다.
OFCOBOL : OpenFrame COBOL 관련 라이브러리를 링크한다. -b 옵션을 지정하지 않을 경우 COBOL 관련 라이브러리를 링크하지 않는다.

[-h]

프로그램 사용을 위한 자세한 사용법을 출력한다.

[-v]

oscbuild의 버전 정보를 출력한다.

DB2는 oscbuild에서 자동으로 생성하는 소스 코드를 사용할 수 없으므로 사용자가 직접 운영 환경에 따라 적절하게 작성된 소스 코드를 DB2의 전처리기를 통해 전처리한 후 oscbuild 툴에 제공해 주어야 한다. 참고로 $OPENFRAME_HOME/osc/build 디렉터리 내에 OSC00001.c 소스를 참조할 수 있다.

사용예제

다음은 Linux 64Bit 환경에서 데이터베이스를 사용하지 않는 OSC00001이라는 이름의 OSC 애플리케이션 서버 프로그램을 생성하는 예이다(다음 명령은 한 줄로 기술해서 실행한다).

$ oscbuild -o LINUX64
rm -f OSC00001.o OSC00001
cc   -c -o OSC00001.o OSC00001.c
cc  -L/home/oframe4/OpenFrame/lib -lcicsappc -lcicsbms -lcicsbts -lcicscon
-lcicsch -lcicsdlic -lcicsds -lcicsecpi -lcicsedf -lcicsenv -lcicsfc -lcicsjc
-lcicsmc -lcicsncs -lcicsracf -lcicsremote -lcicsres -lcicsrtsd -lcicssc
-lcicssp -lcicstc -lcicstdq -lcicsterm -lcicstsq -lcicseza -lcicscpt -lcicscemt
-lcics -lmemm -lspinlock -L/home/oframe4/tibero5/client/lib
-L/home/oframe4/OpenFrame/core/lib64 -lsvr -lnodb -L/opt/microfocus/cobol/lib
-lcobrts64 -lcobmisc64 -lcobcrtn64 OSC00001.o /home/oframe4/OpenFrame/core/lib64/sdl.o -o OSC00001
OSCBUILD : osc server [OSC00001] created
$

11. osccblpp

osccblpp는 OSC에서 사용하는 COBOL 애플리케이션 프로그램 소스 내에 존재하는 EXEC CICS 명령어를 전처리하는 툴이다. 특정 옵션을 지정하지 않을 경우 파일명에 "osccblpp_"이라는 접두어가 붙는 결과물이 생성된다.

사용법

osccblpp을 실행하는 방법은 다음과 같다.

Usage: osccblpp [-c] [-nl] [-ne] [-n] [-V] [-p <prefix>] <file> ...
     | osccblpp [-c] [-nl] [-ne] [-n] [-V] [-p <prefix>] [-o <output>] <file>
     | osccblpp [-h | -v]

[options]

옵션	설명
[-c]	DFHCOMMAREA를 추가하지 않는다.
[-n]	EXEC CICS 명령어를 전처리하지 않는다.
[-nl]	LINKAGE SECTION과 PROCEDURE DIVISION에서 DFHCOMMAREA DFHEIBLK를 수정하지 않는다.
[-ne]	LINKAGE SECTION에 DFHEIBLK를 추가하지 않는다.
[-o output]	출력 파일의 이름을 지정한다.
[-p prefix]	출력 파일 이름의 prefix를 지정한다.
[-V]	Verbose mode로 실행한다.
[-h]	프로그램 사용을 위한 자세한 사용법을 출력한다.
[-v]	osccblpp의 버전 정보를 출력한다.

옵션

설명

[-c]

DFHCOMMAREA를 추가하지 않는다.

[-n]

EXEC CICS 명령어를 전처리하지 않는다.

[-nl]

LINKAGE SECTION과 PROCEDURE DIVISION에서 DFHCOMMAREA DFHEIBLK를 수정하지 않는다.

[-ne]

LINKAGE SECTION에 DFHEIBLK를 추가하지 않는다.

[-o output]

출력 파일의 이름을 지정한다.

[-p prefix]

출력 파일 이름의 prefix를 지정한다.

[-V]

Verbose mode로 실행한다.

[-h]

프로그램 사용을 위한 자세한 사용법을 출력한다.

[-v]

osccblpp의 버전 정보를 출력한다.

입력 항목

항목 설명

file

전처리할 COBOL 프로그램 소스 파일을 지정한다. COBOL 프로그램 소스 파일은 한 번에 여러 모듈을 지정할 수 있다.

항목	설명
file	전처리할 COBOL 프로그램 소스 파일을 지정한다. COBOL 프로그램 소스 파일은 한 번에 여러 모듈을 지정할 수 있다.

사용예제

다음은 SAMPLE00.cob 파일을 전처리하여 osccblpp_SAMPLE00.cob이라는 파일을 생성하는 예이다.

$ osccblpp SAMPLE00.cob

12. osccheck

osccheck는 OSC Region을 위한 설정 파일이나 OSC Region이 공유 메모리에 저장하고 있는 설정 정보를 체크해서 항목들의 설정 내용을 조회하고, 설정에 오류나 빠진 항목이 없는지 확인하는 툴이다. 또한 공유 메모리가 잘못된 주소 접근 등으로 인해 손상된 것을 확인하기 위해서 공유 메모리의 바이너리 이미지를 덤프하는 기능도 제공한다.

osccheck 툴을 통해서 누락된 필수 항목, 설정 값 형식 및 범위 오류 등의 문제가 될 수 있는 설정 정보 등을 체크할 수 있고, 실제 서버에서 사용될 설정 값들이 어떻게 되는지 확인하는 것도 가능하다.

osccheck에서 제공되는 정보는 서버 부팅이 안 되는 설정 오류 레벨, 설정 오류 외에 기동 중에 문제를 초래할 수 있는 경고 레벨, 특정 시스템에서만 문제가 될 소지가 있는 정보 레벨, 그리고 모든 설정에 대한 정보를 보여주는 메시지 레벨의 4단계가 있으며, 옵션을 통해서 어느 레벨 이상의 메시지만 보여줄 것인지 설정할 수 있다.

사용법

osccheck를 실행하는 방법은 다음과 같다.

Usage: osccheck [-l<n>] -f [region]
     | osccheck [-l<n>] -s <region>
     | osccheck -d <region> [dump_file]
     | osccheck [-h | -v]

항목	설명
[-l<n>]	osccheck 툴이 출력하는 메시지의 레벨을 조정한다. n에 지정할 수 있는 레벨의 정보는 다음과 같다. 1(ERROR) : 에러를 발생시키는 문제만 출력한다. 2(WARNING) : 에러를 발생시키지는 않으나 시스템 운영 중에 문제가 될 소지가 있는 설정까지 출력한다. 3(INFO) : 특정 시스템에서는 정상이지만, 다른 시스템에서는 에러일 수 있는 내용을 추가로 출력한다. 4(MESSAGE) : 특정 파일의 특정 절의 특정 항목에 어떤 값이 설정되었는지 모두 출력한다.
-f [region]	OSC 시스템에서 사용하는 설정 파일의 설정 정보를 확인한다. Region 이름이 주어지지 않았을 때에는 공통으로 사용되는 설정 파일의 내용만 확인하고, Region 이름이 주어졌을 때에는 해당 Region에서 사용하는 설정 파일의 내용을 추가적으로 확인한다.
-s <region>	OSC 시스템 특정 Region에서 사용하는 공유 메모리에 저장된 설정 정보의 내용을 확인한다.
-d <region> [dump_file]	OSC 시스템 특정 Region에서 사용하는 공유 메모리의 바이너리 이미지를 덤프한다. 파일명을 지정하지 않을 경우 <region>.dat 파일이 생성된다.
[-h]	프로그램 사용을 위한 자세한 사용법을 출력한다.
[-v]	osccheck의 버전 정보를 출력한다.

항목

설명

[-l<n>]

osccheck 툴이 출력하는 메시지의 레벨을 조정한다.

n에 지정할 수 있는 레벨의 정보는 다음과 같다.

1(ERROR) : 에러를 발생시키는 문제만 출력한다.
2(WARNING) : 에러를 발생시키지는 않으나 시스템 운영 중에 문제가 될 소지가 있는 설정까지 출력한다.
3(INFO) : 특정 시스템에서는 정상이지만, 다른 시스템에서는 에러일 수 있는 내용을 추가로 출력한다.
4(MESSAGE) : 특정 파일의 특정 절의 특정 항목에 어떤 값이 설정되었는지 모두 출력한다.

-f [region]

OSC 시스템에서 사용하는 설정 파일의 설정 정보를 확인한다.

Region 이름이 주어지지 않았을 때에는 공통으로 사용되는 설정 파일의 내용만 확인하고, Region 이름이 주어졌을 때에는 해당 Region에서 사용하는 설정 파일의 내용을 추가적으로 확인한다.

-s <region>

OSC 시스템 특정 Region에서 사용하는 공유 메모리에 저장된 설정 정보의 내용을 확인한다.

-d <region> [dump_file]

OSC 시스템 특정 Region에서 사용하는 공유 메모리의 바이너리 이미지를 덤프한다. 파일명을 지정하지 않을 경우 <region>.dat 파일이 생성된다.

[-h]

프로그램 사용을 위한 자세한 사용법을 출력한다.

[-v]

osccheck의 버전 정보를 출력한다.

사용예제

다음은 OSC00001 서버의 설정을 체크해서 경고 레벨까지 출력하도록 하는 예이다.

$ osccheck –f OSC00001
checking file configuration : region(OSC00001)
WARNING : file(osc.conf) section(OSC) key(JOBID) - setting this field in
osc.conf is not recommanded
checking process done
$

13. osccobprep

osccobprep은 OSC에서 사용될 COBOL 프로그램 중 Mainframe 환경의 특징 등으로 인해서 UNIX의 COBOL 컴파일러가 정상적으로 처리할 수 없는 구문을 전처리하고, OSC 시스템에 맞춰 명령어를 추가하거나 디버깅 등의 특정 용도를 위한 전처리하는 툴이다. 현재는 BLL(Base Locator for Linkage) 전처리와 BMSMAPBR 전처리, EDF 전처리 기능 등을 가지고 있다.

전처리 결과물은 결과물 파일 이름 혹은 Prefix를 옵션으로 제공하지 않는 경우 해당 파일명에 "osccobprep_"이라는 Prefix가 붙는다.

BLL은 IBM의 Mainframe COBOL 컴파일러 중 OS/VS COBOL 이하의 구 버전에서 지원하는 특이한 문법 구조로 자세한 설명은 IBM의 "CICS Application Programming Guide"를 참고한다.

사용법

osccobprep을 실행하는 방법은 다음과 같다.

Usage: osccobprep [options] file

[options]

옵션	설명
[-V]	Verbose mode로 실행한다.
[-a]	BMSMAPBR에 대한 전처리를 수행한다.
[-b]	BLL에 대한 전처리를 수행한다.
[-c]	동적 CALL 기능을 사용하거나, CBLPSHPOP 기능을 사용하는 경우에 지정한다. OSC 시스템 기본 기능으로 디폴트로 사용할 것을 권장한다.
[-d]	EDF 기능을 사용하려는 경우에 사용한다.
[-f postfix]	Copybook 파일의 확장자를 설정한다. 점(.)을 사용된 경우 점을 포함해야 한다.
[-p dir]	Copybook 파일이 위치하고 있는 디렉터리 경로를 설정한다.
[-o1 prefix]	전처리 결과 파일 이름 앞에 붙일 Prefix를 지정한다.
[-o2 file]	전처리 결과 파일 이름을 지정한다. -o1 옵션과 -o2 옵션이 함께 사용될 경우 -o2 옵션이 우선한다.
[-h]	프로그램 사용을 위한 자세한 사용법을 출력한다.
[-v]	osccobprep의 버전 정보를 출력한다.

옵션

설명

[-V]

Verbose mode로 실행한다.

[-a]

BMSMAPBR에 대한 전처리를 수행한다.

[-b]

BLL에 대한 전처리를 수행한다.

[-c]

동적 CALL 기능을 사용하거나, CBLPSHPOP 기능을 사용하는 경우에 지정한다. OSC 시스템 기본 기능으로 디폴트로 사용할 것을 권장한다.

[-d]

EDF 기능을 사용하려는 경우에 사용한다.

[-f postfix]

Copybook 파일의 확장자를 설정한다. 점(.)을 사용된 경우 점을 포함해야 한다.

[-p dir]

Copybook 파일이 위치하고 있는 디렉터리 경로를 설정한다.

[-o1 prefix]

전처리 결과 파일 이름 앞에 붙일 Prefix를 지정한다.

[-o2 file]

전처리 결과 파일 이름을 지정한다.

-o1 옵션과 -o2 옵션이 함께 사용될 경우 -o2 옵션이 우선한다.

[-h]

프로그램 사용을 위한 자세한 사용법을 출력한다.

[-v]

osccobprep의 버전 정보를 출력한다.

입력 항목

항목 설명

file

전처리할 파일 이름을 지정한다.

항목	설명
file	전처리할 파일 이름을 지정한다.

사용예제

다음은 osccobprep을 사용해서 TCOB.cob 프로그램 소스 코드를 전처리하여 osccobprep_TESTCOB.cob 파일을 생성하는 예제이다. 프로그램에서 사용하는 Copybook의 확장자는 .cob, Copybook 디렉터리 경로는 "$OPENFRAME_HOME/ osc/Copybook"으로 설정했다.

$ osccobprep -b -f .cob -p $OPENFRAME_HOME/osc/Copybook TESTCOB.cob

14. osccprep

osccprep은 OSC에서 사용될 C 프로그램 중 Mainframe 환경의 특징 등으로 인해서 UNIX의 C 컴파일러가 정상적으로 처리할 수 없는 구문을 전처리하고, OSC 시스템에 맞춰 명령어를 추가하는 전처리 툴이다.

전처리 결과물은 결과물 파일 이름 혹은 Prefix를 옵션으로 제공하지 않는 경우 해당 파일명에 "oscprep_"이라는 Prefix가 붙는다. 확장자는 -o 옵션을 사용하지 않을 경우 .c로 생성된다.

전처리를 수행하면 OSC에서 제공하는 dfheiptr.h 헤더 파일을 추가하고 EXEC CICS로 시작하는 명령들을 OSC에서 제공하는 함수들로 변경하게 된다.

-o 옵션을 사용하지 않을 경우 확장자가 .c로 생성되기 때문에 프로그램에서 사용하는 입력파일의 확장자가 c이면 안된다.

사용법

osccprep을 실행하는 방법은 다음과 같다.

Usage: osccprep [-p <prefix>] [-o <output>] [-V] <file> ...
     | osccprep [-h | -v]

[options]

옵션	설명
[-p <prefix>]	전처리 결과 파일 이름 앞에 붙일 Prefix를 지정한다.
[-o <output>]	전처리 결과 파일 이름을 지정한다. -p 옵션과 함께 사용될 경우 -o 옵션이 우선한다.
[-V]	Verbose mode로 실행한다.
[-h]	프로그램 사용을 위한 자세한 사용법을 출력한다.
[-v]	osccprep의 버전 정보를 출력한다.

옵션

설명

[-p <prefix>]

전처리 결과 파일 이름 앞에 붙일 Prefix를 지정한다.

[-o <output>]

전처리 결과 파일 이름을 지정한다.

-p 옵션과 함께 사용될 경우 -o 옵션이 우선한다.

[-V]

Verbose mode로 실행한다.

[-h]

프로그램 사용을 위한 자세한 사용법을 출력한다.

[-v]

osccprep의 버전 정보를 출력한다.

입력 항목

항목 설명

file

전처리할 파일 이름을 지정한다. 확장자가 .c는 설정하면 안된다.

항목	설명
file	전처리할 파일 이름을 지정한다. 확장자가 .c는 설정하면 안된다.

사용예제

다음은 osccprep을 사용해서 TEST.ccs 프로그램 소스 코드를 전처리하여 osccprep_TEST.c 파일을 생성하는 예제이다.

$ osccobprep TEST.ccs

다음은 osccprep을 사용해서 TEST.ccs 프로그램 소스 코드를 전처리하여 TEST.c 파일을 생성하는 예제이다.

$ osccobprep -V -o TEST.c TEST.ccs

15. oscdct2rd

oscdct2rd는 CICS에서 사용하는 DCT 매크로를 OSC 시스템에서 사용할 수 있는 형식의 TDQUEUE 정의 매크로 파일로 변환하는 툴이다.

사용법

oscdct2rd를 실행하는 방법은 다음과 같다.

Usage: oscdct2rd [-g group] source target
     | oscdct2rd [-h | -v]

항목	설명
[-g group]	GROUP에 대한 매크로가 없는 DCT 파일에 정의된 모든 TDQUEUE에 대해서 그룹 이름을 지정한다. 최대 8자의 그룹 이름을 지정할 수 있다.
source	ASCII 코드로 변환된 DCT 매크로 파일을 입력한다.
target	새로 생성될 RDO 정의 파일 이름을 입력한다.
[-h]	프로그램 사용을 위한 자세한 사용법을 출력한다.
[-v]	oscdct2rd의 버전 정보를 출력한다.

항목

설명

[-g group]

GROUP에 대한 매크로가 없는 DCT 파일에 정의된 모든 TDQUEUE에 대해서 그룹 이름을 지정한다. 최대 8자의 그룹 이름을 지정할 수 있다.

source

ASCII 코드로 변환된 DCT 매크로 파일을 입력한다.

target

새로 생성될 RDO 정의 파일 이름을 입력한다.

[-h]

프로그램 사용을 위한 자세한 사용법을 출력한다.

[-v]

oscdct2rd의 버전 정보를 출력한다.

RDO의 TDQUEUE 정의에는 GROUP 정보가 필수적으로 삽입되어 있어야 한다. 그러나 DCT 형식의 매크로에는 원래 GROUP에 대한 정보가 들어있지 않다. 구버전 CICS에서 사용하는 DCT의 마이그레이션을 위해 GROUP을 지원하는 매크로를 추가적으로 지원하고 있으나, 이를 위해서는 원본 파일을 수정해야 한다.

사용예제

다음은 oscdct2rd를 사용해서 DCT.dat라는 DCT 매크로 파일에 정의된 TDQUEUE를 OSCGROUP라는 그룹 이름을 사용하도록 설정하여 TDQUEUE.dat라는 TDQUEUE 정의 파일로 변환하는 예이다.

$ oscdct2rd –g OSCGROUP DCT.dat TDQUEUE.dat

16. oscdown

oscdown은 OpenFrame 시스템 전체, OSC 시스템 전체 또는 특정 Region을 종료하는 툴이다.

oscdown은 시스템을 종료하기 전/후에 사용자가 필요한 작업을 수행할 수 있도록 oscdown.pre 및 oscdown.post 스크립트를 실행한다.

oscdown.pre 및 oscdown.post 스크립트는 Tmax 및 OpenFrame 시스템 서버 종료에 관여하는 옵션(-N, -i, -C)에 대해서만 동작하며 -r 옵션과 같이 특정 Region만을 종료시킬 때는 동작하지 않는다.

OSC 기동에 대한 자세한 안내는 OpenFrame OSC "운영자 안내서"의 "개요"를 참고한다.

사용법

oscdown을 실행하는 방법은 다음과 같다.

Usage: oscdown [-N node] [-c | -r region [-s | -a | -m] [-f:XX]] [-i] [-C]
     | oscdown [-h | -v ]

옵션	설명
[-N node]	지정한 노드에서 명령을 실행한다. 멀티노드를 구성하는 경우 노드별로 종료할 때 사용한다.
[-c]	OSC Region, OSC 사용자 서버와 OSC 시스템 서버를 종료한다.
[-r region]	특정 OSC Region을 종료한다.
[-s]	OSC Region을 종료할 때 Region 관련 모든 리소스(RTSD, 시스템 관련, Lock, Shared Memory 등)를 삭제하지 않는다.
[-a]	OSC Region을 종료할 때 Region DB 테이블(RTSD, 시스템 관련)만 삭제하지 않고 나머지 리소스(Lock, Shared Memory 등)들은 삭제한다.
[-m]	OSC 리소스를 제거한다. 단, -r 옵션과 함께 사용해야 한다.
[-f:XX]	PLTSD를 위한 SUFFIX를 지정한다. 단, -r 옵션과 함께 사용해야 한다.
[-i]	OSC 시스템을 즉시 종료한다.
[-C]	Region을 제외한 OpenFrame 시스템 서버, OSC 시스템 서버, OSC 사용자 서버를 종료한다.
[-h]	프로그램 사용을 위한 자세한 사용법을 출력한다.
[-v]	oscdown의 버전 정보를 출력한다.

옵션

설명

[-N node]

지정한 노드에서 명령을 실행한다.

멀티노드를 구성하는 경우 노드별로 종료할 때 사용한다.

[-c]

OSC Region, OSC 사용자 서버와 OSC 시스템 서버를 종료한다.

[-r region]

특정 OSC Region을 종료한다.

[-s]

OSC Region을 종료할 때 Region 관련 모든 리소스(RTSD, 시스템 관련, Lock, Shared Memory 등)를 삭제하지 않는다.

[-a]

OSC Region을 종료할 때 Region DB 테이블(RTSD, 시스템 관련)만 삭제하지 않고 나머지 리소스(Lock, Shared Memory 등)들은 삭제한다.

[-m]

OSC 리소스를 제거한다. 단, -r 옵션과 함께 사용해야 한다.

[-f:XX]

PLTSD를 위한 SUFFIX를 지정한다. 단, -r 옵션과 함께 사용해야 한다.

[-i]

OSC 시스템을 즉시 종료한다.

[-C]

Region을 제외한 OpenFrame 시스템 서버, OSC 시스템 서버, OSC 사용자 서버를 종료한다.

[-h]

프로그램 사용을 위한 자세한 사용법을 출력한다.

[-v]

oscdown의 버전 정보를 출력한다.

사용예제

다음은 OSC00001 Region을 종료하는 예로 PLTSD를 위해 S1이라는 SUFFIX를 지정한 예이다.

$ oscdown -f:S1 -r OSC00001

다음은 강제로 OSC 시스템 전체를 종료하는 예이다.

$ oscdown -i

17. oscinit

oscinit은 OSC 제품을 처음 설치할 때 필요한 시스템 테이블과 로그 테이블을 생성하거나 제거하기 위한 툴이다.

사용법

oscinit을 실행하는 방법은 다음과 같다.

Usage: oscinit create [options] | remove
Options:
    -st <tablespace>     Specify system tablespace name
    -lt <tablespace>     Specify log tablespace name

항목	설명
create	옵션으로 지정된 테이블영역에 OSC의 시스템 테이블, 로그 테이블을 생성한다. [-st <tablespace>] : OSC의 SD, RTSD와 같은 시스템 테이블을 생성하기 위한 테이블스페이스를 지정한다. [-lt <tablespace>] : OSC의 로그 테이블을 생성하기 위한 테이블스페이스를 지정한다.
remove	OSC의 시스템 테이블, 로그 테이블을 삭제한다.

항목

설명

create

옵션으로 지정된 테이블영역에 OSC의 시스템 테이블, 로그 테이블을 생성한다.

[-st <tablespace>] : OSC의 SD, RTSD와 같은 시스템 테이블을 생성하기 위한 테이블스페이스를 지정한다.
[-lt <tablespace>] : OSC의 로그 테이블을 생성하기 위한 테이블스페이스를 지정한다.

remove

OSC의 시스템 테이블, 로그 테이블을 삭제한다.

oscinit으로 테이블을 생성하기 전 $OPENFRAME_HOME/config/dbconn.conf 파일의 [SYS1_ODBC] 절의 DATABASE, USERNAME, ENPASSWD가 올바르게 설정되었는 지 확인한다. dbconn.conf의 에 대한 자세한 설명은 Openframe "Base 안내서"를 참고한다.

사용예제

다음은 시스템 테이블은 OFM_REPOSITORY 테이블스페이스에, 로그 테이블은 OFM_LOG 테이블스페이스에 생성하고 삭제하는 예제이다.

$ oscinit create -st OFM_REPOSITORY -lt OFM_LOG
$ oscinit remove

18. oscjct2rd

oscjct2rd는 구 버전의 CICS에서 사용하였던 JCT(Journal Control Table)을 OSC의 JOURNALMODEL 리소스 정의로 변환해주는 툴이다. oscjct2rd 툴을 사용할 때 JCT에는 JOURNALMODEL 리소스 정의의 GROUP에 해당하는 항목이 없으므로 [–g] 옵션을 사용하여 지정하도록 한다.

사용법

oscjct2rd를 실행하는 방법은 다음과 같다.

Usage: oscjct2rd [–g <group>] <source> <target>
     | oscjct2rd [-h | -v]

항목	설명
[-g <group>]	JOURNALMODEL 리소스 정의의 GROUP 항목에 값을 지정한다.
<source>	CICS에서 마이그레이션한 JCT가 저장된 파일을 지정한다.
<target>	새로 생성될 RDO 정의 파일 이름을 입력한다.
[-h]	프로그램 사용을 위한 자세한 사용법을 출력한다.
[-v]	oscjct2rd의 버전 정보를 출력한다.

항목

설명

[-g <group>]

JOURNALMODEL 리소스 정의의 GROUP 항목에 값을 지정한다.

<source>

CICS에서 마이그레이션한 JCT가 저장된 파일을 지정한다.

<target>

새로 생성될 RDO 정의 파일 이름을 입력한다.

[-h]

프로그램 사용을 위한 자세한 사용법을 출력한다.

[-v]

oscjct2rd의 버전 정보를 출력한다.

사용예제

다음은 JCT.dat 파일을 변환하여 JOURNALMODEL.dat 파일로 결과를 생성하는 예이다.

$ oscjct2rd –g OSCGROUP JCT.dat JOURNALMODEL.dat

19. osclogrpt

oslogrpt는 OSC에서 트랜잭션에 대한 로그를 RDB로 지정하였을때 이에 대한 통계 정보를 조회하는 툴이다. 기본적으로는 시간대별 트랜잭션의 갯수, 평균 수행시간, 평균 CPU 수행시간을 출력한다.

사용법

osclogrpt를 실행하는 방법은 다음과 같다.

Usage: oslogrpt -r <region> [options]

입력항목

항목 설명

<region>

조회 대상 Region 이름을 지정한다.

항목	설명
<region>	조회 대상 Region 이름을 지정한다.

[options]

옵션	설명
-d	조회 대상 일자를 지정한다. 미지정시에는 오늘날짜를 기준으로 조회한다.
-t	조회 대상 트랜잭션 이름을 지정한다. 미지정시에는 전체 트랜잭션을 조회한다.
-n	노드 이름을 지정한다. 미지정시에는 전체 노드를 조회한다.
-s	시간대별이 아닌 지정한 일자 전체에 대한 통계 정보를 조회한다.
-l	통계 정보가 아닌 전체 로그 정보를 조회한다.

옵션

설명

-d

조회 대상 일자를 지정한다. 미지정시에는 오늘날짜를 기준으로 조회한다.

-t

조회 대상 트랜잭션 이름을 지정한다. 미지정시에는 전체 트랜잭션을 조회한다.

-n

노드 이름을 지정한다. 미지정시에는 전체 노드를 조회한다.

-s

시간대별이 아닌 지정한 일자 전체에 대한 통계 정보를 조회한다.

-l

통계 정보가 아닌 전체 로그 정보를 조회한다.

사용예제

다음은 Region 이름이 OSC00001의 2019/05/27의 전체 노드에 대한 시간대별 통계 정보를 조회하는 예제이다.

$ osclogrpt -r OSC00001 -d 20190527

> DATE : [20190527]    REGION_NAME : [OSC00001]   NODE_NAME : [ALL]

TRANS_ID   HOUR      COUNT     AVG_SVC_TIME    AVG_CPU_TIME
-----------------------------------------------------------
CEMT         10          1         0.650000        0.004000
CEMT         11          2         0.560000        0.003500
CPLT         09          1         0.247000        0.027000
CPLT         11          3         0.111333        0.033667
OIVP         09          1        10.284000        0.043000
OIVP         11          3         9.991000        0.038000

다음은 위의 출력된 항목에 대한 설명이다.

항목	설명
DATE	트랜잭션 일자를 의미한다.
REGION_NAME	Region 이름을 의미한다.
NODE_NAME	노드 이름을 의미한다. ALL은 전체 노드를 기준으로 조회한다는 의미이다.
TRANS_ID	트랜잭션 이름을 의미한다.
HOUR	기준 시각을 의미한다. 10의 경우 10:00:00 ~ 10:59:59까지 발생한 트랜잭션을 의미한다.
COUNT	해당 시각에 발생한 트랜잭션의 갯수를 의미한다.
AVG_SVC_TIME	해당 시각에 발생한 트랜잭션의 평균 수행 시간을 의미한다.
AVG_CPU_TIME	해당 시각에 발생한 트랜잭션의 평균 CPU 수행 시간을 의미한다.

항목

설명

DATE

트랜잭션 일자를 의미한다.

REGION_NAME

Region 이름을 의미한다.

NODE_NAME

노드 이름을 의미한다. ALL은 전체 노드를 기준으로 조회한다는 의미이다.

TRANS_ID

트랜잭션 이름을 의미한다.

HOUR

기준 시각을 의미한다.

10의 경우 10:00:00 ~ 10:59:59까지 발생한 트랜잭션을 의미한다.

COUNT

해당 시각에 발생한 트랜잭션의 갯수를 의미한다.

AVG_SVC_TIME

해당 시각에 발생한 트랜잭션의 평균 수행 시간을 의미한다.

AVG_CPU_TIME

해당 시각에 발생한 트랜잭션의 평균 CPU 수행 시간을 의미한다.

다음은 Region 이름이 OSC00001의 2019/05/27일의 통계 정보를 조회하는 예제이다.

$ osclogrpt -r OSC00001 -d 20190527

> DATE : [20190527]    REGION_NAME : [OSC00001]   NODE_NAME : [ALL]

TRANS_ID         COUNT     AVG_SVC_TIME    AVG_CPU_TIME
-------------------------------------------------------
CEMT                 3         0.590000        0.003667
CPLT                 4         0.145250        0.032000
OIVP                 4        10.064250        0.039250

다음은 위의 출력된 항목에 대한 설명이다.

항목	설명
DATE	트랜잭션 일자를 의미한다.
REGION_NAME	Region 이름을 의미한다.
NODE_NAME	노드 이름을 의미한다. ALL은 전체 노드를 기준으로 조회한다는 의미이다.
TRANS_ID	트랜잭션 이름을 의미한다.
COUNT	해당 일자에 발생한 트랜잭션의 갯수를 의미한다.
AVG_SVC_TIME	해당 일자에 발생한 트랜잭션의 평균 수행 시간을 의미한다.
AVG_CPU_TIME	해당 일자에 발생한 트랜잭션의 평균 CPU 수행 시간을 의미한다.

항목

설명

DATE

트랜잭션 일자를 의미한다.

REGION_NAME

Region 이름을 의미한다.

NODE_NAME

노드 이름을 의미한다. ALL은 전체 노드를 기준으로 조회한다는 의미이다.

TRANS_ID

트랜잭션 이름을 의미한다.

COUNT

해당 일자에 발생한 트랜잭션의 갯수를 의미한다.

AVG_SVC_TIME

해당 일자에 발생한 트랜잭션의 평균 수행 시간을 의미한다.

AVG_CPU_TIME

해당 일자에 발생한 트랜잭션의 평균 CPU 수행 시간을 의미한다.

다음은 Region 이름이 OSC00001의 2019/05/27일의 전체 트랜잭션 정보를 조회하는 예제이다.

$ osclogrpt -r OSC00001 -d 20190527 -l

> DATE : [20190527]    REGION_NAME : [OSC00001]   NODE_NAME : [ALL]

TIME         NODE  SYSID TCL          SPRI      PID TRANS_ID    SVC_TIME     CPU_TIME USER_ID  IP_ADDR          NET_NAME   SYS_ERR  USR_RET
--------------------------------------------------------------------------------------------------------------------------------------------
11:10:56.427 NODE1 OSCA  TCL1           68     7793 OIVP        9.658000     0.034000          127.0.0.1        OIVP0336         0        0
12:33:59.964 NODE1 OSCA  TCL1           68     7793 OIVP       10.104000     0.015000          127.0.0.1        OIVP0337         0        0
12:34:57.808 NODE1 OSCA  TCL1           68     7793 OIVP       10.100000     0.008000          127.0.0.1        OIVP0337         0        0

다음은 위의 출력된 항목에 대한 설명이다.

항목	설명
DATE	트랜잭션 일자를 의미한다.
REGION_NAME	Region 이름을 의미한다.
NODE_NAME	노드 이름을 의미한다. ALL은 전체 노드를 기준으로 조회한다는 의미이다.
TIME	트랜잭션 수행 시각을 의미한다.
NODE	트랜잭션이 수행된 노드 이름을 의미한다.
SYSID	Region의 SYSID를 의미한다.
TCL	트랜클래스를 의미한다.
SPRI	트랜잭션이 수행된 애플리케이션 서버의 Tmax Server ID이다.
PID	트랜잭션이 수행된 애플리케이션 서버의 PID이다.
TRANS_ID	트랜잭션 이름을 의미한다.
SVC_TIME	트랜잭션이 수행한 시간을 의미한다.
CPU_TIME	트랜잭션의 수행시의 CPU 수행 시간을 의미한다.
USER_ID	트랜잭션을 수행한 사용자ID를 의미한다.
IP_ADDR	트랜잭션을 수행한 터미널의 접속 IP주소를 의미한다.
NETNAME	트랜잭션을 수행한 터미널의 NETNAME을 의미한다.
SYS_ERR	트랜잭션을 수행하는 경우 발생한 시스템 에러코드를 의미한다.
USER_RET	트랜잭션을 수행하는 경우 발생한 사용자 에러코드를 의미한다.

항목

설명

DATE

트랜잭션 일자를 의미한다.

REGION_NAME

Region 이름을 의미한다.

NODE_NAME

노드 이름을 의미한다. ALL은 전체 노드를 기준으로 조회한다는 의미이다.

TIME

트랜잭션 수행 시각을 의미한다.

NODE

트랜잭션이 수행된 노드 이름을 의미한다.

SYSID

Region의 SYSID를 의미한다.

TCL

트랜클래스를 의미한다.

SPRI

트랜잭션이 수행된 애플리케이션 서버의 Tmax Server ID이다.

PID

트랜잭션이 수행된 애플리케이션 서버의 PID이다.

TRANS_ID

트랜잭션 이름을 의미한다.

SVC_TIME

트랜잭션이 수행한 시간을 의미한다.

CPU_TIME

트랜잭션의 수행시의 CPU 수행 시간을 의미한다.

USER_ID

트랜잭션을 수행한 사용자ID를 의미한다.

IP_ADDR

트랜잭션을 수행한 터미널의 접속 IP주소를 의미한다.

NETNAME

트랜잭션을 수행한 터미널의 NETNAME을 의미한다.

SYS_ERR

트랜잭션을 수행하는 경우 발생한 시스템 에러코드를 의미한다.

USER_RET

트랜잭션을 수행하는 경우 발생한 사용자 에러코드를 의미한다.

20. oscplipp

oscplipp는 OSC PLI 애플리케이션 프로그램 소스 내에 존재하는 EXEC CICS 명령어를 전처리하여 결과물을 산출하는 툴이다. 결과물은 해당 파일명에 "oscplipp_"이라는 접두어가 붙는다.

사용법

oscplipp을 실행하는 방법은 다음과 같다.

Usage: oscplipp [options] file ...

[options]

옵션	설명
[-d]	전처리 관련 디버그 메시지를 출력한다.
[-f]	External procedure call에 대하여 FETCH 문을 추가한다.
[-l]	내부 스캐너 관련 디버그 메시지를 출력한다.
[-m]	MF-COBOL과 연계하여 동작하는 경우 지정한다.
[-o file]	결과물 파일명을 지정한다.
[-y]	구문 해석 단계에서의 디버그 메시지를 출력한다.
[-I dir]	include 파일을 찾을 디렉터리명을 지정한다.
[-V]	Verbose mode로 실행한다.
[-h]	프로그램 사용을 위한 자세한 사용법을 출력한다.
[-v]	oscplipp의 버전 정보를 출력한다.

옵션

설명

[-d]

전처리 관련 디버그 메시지를 출력한다.

[-f]

External procedure call에 대하여 FETCH 문을 추가한다.

[-l]

내부 스캐너 관련 디버그 메시지를 출력한다.

[-m]

MF-COBOL과 연계하여 동작하는 경우 지정한다.

[-o file]

결과물 파일명을 지정한다.

[-y]

구문 해석 단계에서의 디버그 메시지를 출력한다.

[-I dir]

include 파일을 찾을 디렉터리명을 지정한다.

[-V]

Verbose mode로 실행한다.

[-h]

프로그램 사용을 위한 자세한 사용법을 출력한다.

[-v]

oscplipp의 버전 정보를 출력한다.

입력항목

항목 설명

file

전처리할 PL/I 프로그램 소스 파일을 지정한다. PL/I 프로그램 소스 파일은 한 번에 여러 모듈을 지정할 수 있다.

항목	설명
file	전처리할 PL/I 프로그램 소스 파일을 지정한다. PL/I 프로그램 소스 파일은 한 번에 여러 모듈을 지정할 수 있다.

사용예제

다음은 sample00.pli 파일을 전처리하여 oscplipp_sample00.pli이라는 파일을 생성하는 예이다.

$ oscplipp sample00.pli

21. oscpltc

oscpltc는 DFHPLT 매크로를 컴파일하는 툴이다.

사용법

oscpltc을 실행하는 방법은 다음과 같다.

Usage: oscpltc [-r <region>] <source>
     | oscpltc [-h | -v]

항목	설명
[-r <region>]	PLT 매크로를 컴파일하여 배포할 Region 이름을 지정한다. 해당 Region의 디폴트 테이블 디렉터리인 $OPENFRAME_HOME/osc/region/Region이름/tbl 경로에 결과물이 저장되거나, 설정 파일에 TBLDIR 항목을 지정한 경우 해당 디렉터리에 결과물이 저장된다. 지정하지 않은 경우 현재 디렉터리에 "DFHPLT.SUFFIX이름"이라는 파일명으로 결과물이 저장된다.
<source>	PLT 매크로 파일을 지정한다.
[-h]	프로그램 사용을 위한 자세한 사용법을 출력한다.
[-v]	oscpltc의 버전 정보를 출력한다.

항목

설명

[-r <region>]

PLT 매크로를 컴파일하여 배포할 Region 이름을 지정한다.

해당 Region의 디폴트 테이블 디렉터리인 $OPENFRAME_HOME/osc/region/Region이름/tbl 경로에 결과물이 저장되거나, 설정 파일에 TBLDIR 항목을 지정한 경우 해당 디렉터리에 결과물이 저장된다.

지정하지 않은 경우 현재 디렉터리에 "DFHPLT.SUFFIX이름"이라는 파일명으로 결과물이 저장된다.

<source>

PLT 매크로 파일을 지정한다.

[-h]

프로그램 사용을 위한 자세한 사용법을 출력한다.

[-v]

oscpltc의 버전 정보를 출력한다.

사용예제

다음은 PLT.dat 파일에 들어있는 PLT 매크로 정의들을 읽어서 OSC00001 Region으로 배포하는 예이다.

$ oscpltc -r OSC00001 PLT.dat

22. oscresp

oscresp는 OSC 애플리케이션 서버에서 사용자 애플리케이션 수행 중에 애플리케이션에서 사용하고 있는 EXEC CICS 구문의 수행 결과로 RESP, RESP2 값이 설정되었을 경우 해당 값이 어떤 의미인지 조회할 수 있도록 제공되는 툴이다.

사용자는 oscresp에 EIBFN, RESP, RESP2 값을 입력하여 에러 원인에 대한 상세한 설명을 조회할 수 있고, 특정 EIBFN에 대응되는 EXEC CICS 명령어를 찾아내거나 EIBFN, RESP 값만 입력해서 가능한 RESP2 값이 어떤 것들이 있는지 확인하는 것도 가능하다.

사용법

oscresp를 실행하는 방법은 다음과 같다.

Usage: oscresp [options]
     | oscresp EIBFN [RESP [RESP2]]

[options]

옵션 설명

[?]

모든 EIBFN 목록을 출력한다.

[-h]

프로그램 사용을 위한 자세한 사용법을 출력한다.

[-v]

oscresp의 버전 정보를 출력한다.

옵션	설명
[?]	모든 EIBFN 목록을 출력한다.
[-h]	프로그램 사용을 위한 자세한 사용법을 출력한다.
[-v]	oscresp의 버전 정보를 출력한다.

입력 항목

항목	설명
EIBFN	에러가 발생한 EXEC CICS 명령어의 EIBFN 값을 입력한다. RESP, RESP2 값을 입력하지 않을 경우 해당 EIBFN이 어떤 명령어를 의미하는지 알려준다.
RESP	EIBLK에 설정된 RESP 값을 입력한다. RESP2 값이 입력되지 않았을 경우에는 가능한 모든 RESP2 값의 종류를 나열한다.
[RESP2]	EIBLK에 설정된 RESP2 값을 입력한다.

항목

설명

EIBFN

에러가 발생한 EXEC CICS 명령어의 EIBFN 값을 입력한다.

RESP, RESP2 값을 입력하지 않을 경우 해당 EIBFN이 어떤 명령어를 의미하는지 알려준다.

RESP

EIBLK에 설정된 RESP 값을 입력한다.

RESP2 값이 입력되지 않았을 경우에는 가능한 모든 RESP2 값의 종류를 나열한다.

[RESP2]

EIBLK에 설정된 RESP2 값을 입력한다.

사용예제

다음은 EXEC CICS RECEIVE MAP (EIBFN=1802)에서 RESP=10, RESP2=00 값이 설정되었을 경우 해당 에러의 내용을 조회하는 예이다.

$ oscresp 1802 10 00

EIBFN   1802    RECEIVE MAP

INVREQ occurs if a RECEIVE MAP command is issued in a nonterminal task;
these tasks do not have a TIOA or a TCTTE.
$

23. oscrtsddump

oscrtsddump는 RTSD에 저장된 리소스 정의 정보를 매크로 형태의 파일로 저장하는 툴로, 지정된 OSC Region의 리소스 정의 정보를 추출할 수 있고, 생성된 매크로 파일은 다시 oscrtsdupdate의 입력 파일로 사용할 수 있다.

사용법

oscrtsddump를 실행하는 방법은 다음과 같다.

Usage: oscrtsddump -r <region> <file>
     | oscrtsddump [options]

입력 항목

항목	설명
-r <region>	OSC Region 이름을 지정한다.
<file>	추출된 매크로 형태의 텍스트를 저장할 파일 이름을 지정한다. 기존에 있던 파일을 선택했을 경우 기존의 내용은 모두 삭제되고 새로 추출된 매크로 형태의 텍스트로 덮어쓰기 된다.

항목

설명

-r <region>

OSC Region 이름을 지정한다.

<file>

추출된 매크로 형태의 텍스트를 저장할 파일 이름을 지정한다.

기존에 있던 파일을 선택했을 경우 기존의 내용은 모두 삭제되고 새로 추출된 매크로 형태의 텍스트로 덮어쓰기 된다.

[options]

옵션 설명

[-h]

프로그램 사용을 위한 자세한 사용법을 출력한다.

[-v]

oscrtsddump의 버전 정보를 출력한다.

옵션	설명
[-h]	프로그램 사용을 위한 자세한 사용법을 출력한다.
[-v]	oscrtsddump의 버전 정보를 출력한다.

사용예제

다음은 OSC00001 Region의 RTSD에 저장된 리소스 정의를 읽어서 매크로 형태의 텍스트로 resource.dat 파일에 저장하는 예이다.

$ oscrtsddump resource.dat OSC00001

24. oscrtsdupdate

oscrtsdupdate는 리소스 정의가 선언되어 있는 매크로 파일을 읽어서 운영 중인 OSC Region의 RTSD에 업데이트하는 툴이다. 매크로 파일에 선언된 리소스 정의는 OSC Region의 RTSD에 이미 존재할 경우만 업데이트한다. 업데이트되는 리소스 정의를 확인하기 위해서는 상세 모드로 실행한다. 단, oscrtsdupdate를 통해 변경이 가능한 리소스에는 제한이 있다.

변경이 가능한 리소스 및 옵션은 아래와 같다.

리소스 이름	옵션 이름
CONNECTION	INSERVICE
FILE	DSNAME, ADD, BROWSE, DELETE, READ, UPDATE, KEYLENGTH, RECORDSIZE, MAXNUMRECS, ENABLESTATUS, OPENSTATUS, JOURNAL
PROGRAM	STATUS
TDQUEUE	TRIGGERLEVEL, ENABLESTATUS, OPENSTATUS
TERMINAL	INSERVICE, PAGESTATUS
TRANSACTION	PROGRAM, TWASIZE, RESSEC, SHUTDOWN, TRANCLASS, STATUS, TASKREQ
TRANCLASS	MAXACTIVE, PURGETHRESH

리소스 이름

옵션 이름

CONNECTION

INSERVICE

FILE

DSNAME, ADD, BROWSE, DELETE, READ, UPDATE, KEYLENGTH, RECORDSIZE, MAXNUMRECS, ENABLESTATUS, OPENSTATUS, JOURNAL

PROGRAM

STATUS

TDQUEUE

TRIGGERLEVEL, ENABLESTATUS, OPENSTATUS

TERMINAL

INSERVICE, PAGESTATUS

TRANSACTION

PROGRAM, TWASIZE, RESSEC, SHUTDOWN, TRANCLASS, STATUS, TASKREQ

TRANCLASS

MAXACTIVE, PURGETHRESH

사용법

oscrtsdupdate를 실행하는 방법은 다음과 같다.

Usage: oscrtsdupdate -r <region> <file> [options1]
     | oscrtsdupdate [options2]

입력 항목

항목 설명

-r <region>

OSC Region 이름을 지정한다.

<file>

RTSD에 업데이트하려는 리소스 정의 매크로 파일 이름을 지정한다.
[options1]

옵션 설명

[-V]

oscrtsdupdate를 상세 모드로 실행한다. 상세 모드로 실행할 경우 어떤 리소스 정의가 업데이트되는지 확인할 수 있다.
[options2]

옵션 설명

[-h]

프로그램 사용을 위한 자세한 사용법을 출력한다.

[-v]

oscrtsdupdate의 버전 정보를 출력한다.

항목	설명
-r <region>	OSC Region 이름을 지정한다.
<file>	RTSD에 업데이트하려는 리소스 정의 매크로 파일 이름을 지정한다.

옵션	설명
[-V]	oscrtsdupdate를 상세 모드로 실행한다. 상세 모드로 실행할 경우 어떤 리소스 정의가 업데이트되는지 확인할 수 있다.

옵션	설명
[-h]	프로그램 사용을 위한 자세한 사용법을 출력한다.
[-v]	oscrtsdupdate의 버전 정보를 출력한다.

사용예제

다음은 resource.dat 파일에 저장된 리소스 정의를 읽어서 OSC00001 Region의 RTSD에 업데이트하는 예이다.

$ oscrtsdupdate -r OSC00001 resource.dat

다음은 oscrtsdupdate를 상세 모드로 실행하는 예이다.

$ oscrtsdupdate -r OSC00001 resource.dat -V

25. oscruntran

oscruntran은 특정 Region의 트랜잭션을 사용자가 직접 실행시키는 툴이다.

사용법

oscruntran을 실행하는 방법은 다음과 같다.

Usage: oscruntran -r <region> -t <tran> [-n <nodename>]
     | oscruntran [-h | -v]

항목	설명
-r <region>	실행시킬 트랜잭션이 존재하는 Region을 지정한다.
-t <tran + parameter>	실행시킬 트랜잭션 명을 지정한다. tran 이후에 parameter를 지정해 RECEIVE 명령어를 사용해 parameter 값을 받아올 수 있다.
[ -n <nodename> ]	멀티노드의 경우 n 옵션을 통하여 실행시킬 nodename을 지정할 수 있다.
[-h]	프로그램 사용을 위한 자세한 사용법을 출력한다.
[-v]	oscruntran의 버전 정보를 출력한다.

항목

설명

-r <region>

실행시킬 트랜잭션이 존재하는 Region을 지정한다.

-t <tran + parameter>

실행시킬 트랜잭션 명을 지정한다. tran 이후에 parameter를 지정해 RECEIVE 명령어를 사용해 parameter 값을 받아올 수 있다.

[ -n <nodename> ]

멀티노드의 경우 n 옵션을 통하여 실행시킬 nodename을 지정할 수 있다.

[-h]

프로그램 사용을 위한 자세한 사용법을 출력한다.

[-v]

oscruntran의 버전 정보를 출력한다.

사용예제

다음은 oscruntran을 통하여 OSC00001 Region의 OIVP 트랜잭션을 실행시키는 예이다.

$ oscruntran -r OSC00001 -t OIVP

26. oscscview

oscscview은 START, DELAY 명령어에 의하여, 또는 TDQ ATI 기능에 의하여, OSC 시스템에서 스케줄링되고 있는 아이템들을 보여주는 툴이다.

확인할 수 있는 아이템들은 다음과 같다.

START 명령어의 INTERVAL, TIME, AFTER, AT 등의 옵션이 함께 사용된 트랜잭션 요청
DELAY 명령어의 REQID를 이용한 DELAY 요청
모든 TDQ ATI 요청

사용법

oscscview 실행하는 방법은 다음과 같다.

Usage: oscscview [-i <ip>] [-p <port>] [-V] [-d]
     | oscscview [-h | -v]

항목	설명
[-i <ip>]	접속할 Tmax IP를 지정한다.
[-p <port>]	접속할 Tmax port를 지정한다.
[-V]	수행과 관련된 각종 추가 실행 정보를 보여준다.
[-d]	화면에 출력하는 정보에 대한 추가 설명을 보여준다.
[-h]	프로그램 사용을 위한 자세한 사용법을 출력한다.
[-v]	oscscview의 버전 정보를 출력한다.

항목

설명

[-i <ip>]

접속할 Tmax IP를 지정한다.

[-p <port>]

접속할 Tmax port를 지정한다.

[-V]

수행과 관련된 각종 추가 실행 정보를 보여준다.

[-d]

화면에 출력하는 정보에 대한 추가 설명을 보여준다.

[-h]

프로그램 사용을 위한 자세한 사용법을 출력한다.

[-v]

oscscview의 버전 정보를 출력한다.

사용예제

다음은 OSC00001 Region에서 실행된 트랜잭션 OIBR이 스케줄링 대기 중이라는 것을 보여준다.

$ oscscview
Local time : 2009.09.30 09:54:49
Scheduling items --------------------------------------------------
No.        SERVER   REQID    DATE       TIME     TRNID TRMID USERID
1          OSC00001 DF000001 2009/09/30 09:55:02 OIBR  TTRM
-------------------------------------------------------------------

27. oscsddump

oscsddump는 OSC SD 테이블에 들어있는 OSC 리소스 정의들을 매크로 형태의 파일로 저장하는 툴이다. 지정된 OSC Region에서 사용하는 SD 테이블에 정의되어 있는 리소스의 정의들을 모두 또는 특정 종류의 리소스 정의들을 선택해서 추출할 수 있다. 생성된 매크로 파일은 다시 oscsdgen의 입력 파일로 사용할 수 있다.

사용법

oscsddump를 실행하는 방법은 다음과 같다.

Usage: oscsddump -r <region> <file> [-t type+]
     | oscsddump [options]

입력 항목

항목

설명

-r <region>

OSC Region 이름을 지정한다.

<file>

추출된 매크로 형식의 텍스트를 저장할 파일 이름을 지정한다.

기존에 있던 파일을 선택했을 경우 기존의 내용은 모두 삭제되고 새로 추출된 매크로로 대체한다.

[-t type+]

추출할 리소스들의 타입을 지정한다. 지정하지 않을 경우에는 선택한 OSC SD 테이블에 정의되어 있는 모든 종류의 리소스 정의들을 추출한다.

type에는 다음에서 하나 이상 지정할 수 있다.

connection
file
journalmodel
program
terminal
tdq
tranclass
transaction
tsmodel
typeterm

[options]

옵션 설명

[-h]

도움말을 출력한다.

[-v]

oscsddump의 버전 정보를 출력한다.

사용예제

다음은 OSC00001 Region에서 사용하는 SD 테이블에 정의되어 있는 리소스 정의를 읽어서 매크로 형태로 resource.dat 파일에 저장하는 예이다.

$ oscsddump -r OSC00001 resource.dat

28. oscsdgen

oscsdgen은 매크로 형식의 리소스 정의가 정의되어 있는 텍스트 파일을 읽어서 지정된 OSC Region에서 사용하는 DB 테이블에 저장하는 역할을 수행하는 툴이다.

리소스 정의 매크로 파일에 중복되는 정의가 있거나 SD 테이블에 같은 리소스에 대한 정의가 이미 존재하는 경우에는 기존 내용을 대체한다. 또한 지정한 리소스에 대한 삭제도 가능하다. oscsdgen을 수행할 때 TACF 인증절차를 수행하며 이 때 TACF 사용자의 SD 접근 권한은 체크하지 않는다.

트랜잭션에 대한 리소스를 추가하나 수정할 때 OSC에서는 Change User ID, Change Time, Define Time을 저장하며, 이에 대한 정보는 oscsddump로는 확인할 수 없으며 ofmanager를 통하여 확인 할 수 있다.

사용법

oscsdgen을 실행하는 방법은 다음과 같다.

Usage: oscsdgen -c -r <region> <file>
     | oscsdgen -f -r <region>] <group_name>:<resource_name>:<resource_type>
     | oscsdgen [options]

입력 공통 항목

항목 설명

-r <region>

OSC Region 이름을 지정한다.
리소스 저장 항목

항목 설명

-c

리소스 정의를 생성한다.

<file>

OSC SD 테이블에 저장하려는 리소스 정의 매크로 파일을 지정한다.

리소스 삭제 항목

항목

설명

-f

특정 리소스 정의를 삭제한다.

<group_name>

삭제할 리소스의 그룹명을 지정한다.

<resource_name>

삭제할 리소스의 이름을 지정한다.

<resource_type>

삭제할 리소스의 타입을 지정한다.

다음에서 하나 이상 지정할 수 있다.

connection
file
journalmodel
program
terminal
tdq
tranclass
transaction
tsmodel
typeterm

그 외 옵션

옵션 설명

[-h]

프로그램 사용을 위한 자세한 사용법을 출력한다.

[-v]

oscsdgen의 버전 정보를 출력한다.

사용예제

다음은 resource.dat 파일에 들어있는 리소스 정의 매크로들을 읽어서 SD 테이블에 리전명 'OSC00001’을 키로 하여 저장하는 예이다.

$ oscsdgen -c -r OSC00001 resource.dat

다음은 이미 등록되어 있는 리소스를 OSC00001 Region에서 사용하는 DB 테이블에서 삭제하는 예이다.

DEFINE TRANSACTION(TST1) GROUP(OIVP) PROGRAM(OIVPTST1) TWASIZE(255)

$ oscsdgen -f -r OSC00001 OIVP:TST1:TRANSACTION

다음은 oscsdgen을 수행하는 경우 TACF 사용자가 로그인이 되어 있지 않을 경우 TACF 사용자 로그인을 수행하는 예이다.

$ oscsdgen -c -r OSC00001 resource.dat
Input USERNAME  : USERID
Input PASSWORD  :

29. osctdlinit

osctdlinit은 OSC Region별로 TDL(Tmax Dynamic Library) 공유 메모리 및 동적 모듈을 초기화하는 툴이다. OSC를 기동하기 전에 수행하며, Region을 여러 개 지정하여 한 번에 초기화할 수 있다.

사용법

osctdlinit을 실행하는 방법은 다음과 같다.

Usage: osctdlinit [-f] <region>
     | osctdlinit [-h | -v]

[options]

옵션

설명

[-h]

프로그램 사용을 위한 자세한 사용법을 출력한다.

[-v]

osctdlinit의 버전 정보를 출력한다.

[-f]

공유 메모리가 이미 존재할 경우 강제로 초기화한다.

Tmax의 tdl.cfg를 MODE=SHARED로 설정했을 때 run 디렉터리를 초기화하기 위해서는 -f 옵션과 함께 수행해야 한다. 자세한 내용은 "Tmax Programming Guide(Dynamic Library)"를 참고한다.

입력 항목

항목 설명

<region>

TDL 공유 메모리 및 동적 모듈을 초기화할 OSC Region 이름들을 지정한다.

한 번에 여러 Region 이름을 지정할 수 있다.

사용예제

다음은 OSC00001 및 OSC00002 Region의 TDL 공유 메모리 및 동적 모듈을 초기화하는 예이다.

$ osctdlinit OSC0001 OSC0002

30. osctdlrm

osctdlrm은 TDL 공유 메모리를 완전히 제거하기 위한 툴이다. osctdlrm을 실행한 후 osctdlinit을 재실행하지 않으면 등록한 모듈들을 사용할 수 없다는 점을 주의한다. Region을 여러 개 지정하여 한 번에 제거할 수도 있다.

사용법

osctdlrm을 실행하는 방법은 다음과 같다.

Usage: osctdlrm [options] <region> ...

[options]

옵션 설명

[-h]

프로그램 사용을 위한 자세한 사용법을 출력한다.

[-v]

osctdlrm의 버전 정보를 출력한다.
입력 항목

항목 설명

<region>

TDL 공유 메모리를 제거할 OSC Region 이름을 지정한다.

한 번에 여러 Region 이름을 지정할 수 있다.

사용예제

다음은 OSC00001 및 OSC00002 Region의 TDL 공유 메모리를 제거하는 예이다.

$ osctdlrm OSC00001 OSC00002

31. osctdlupdate

osctdlupdate는 OSC Region에 지정한 동적 모듈을 업데이트하는 툴이다.

지정한 모듈이 이미 등록되어 있을 경우 업데이트하며 아직 등록되어 있지 않을 경우 새로 추가한다. 모듈을 여러 개 지정하여 한 번에 업데이트 할 수도 있다.

사용법

osctdlupdate를 실행하는 방법은 다음과 같다.

Usage: osctdlupdate [options] <region> <module> ...

[options]

옵션

설명

[-h]

프로그램 사용을 위한 자세한 사용법을 출력한다.

[-v]

osctdlupdate의 버전 정보를 출력한다.

[-c]

멀티 노드 환경에서 하나의 리전에 대한 노드간의 모듈 버전 동기화를 수행한다.

[-e]

shared 모드에서 특정 노드에 문제가 발생하여 모든 노드에 대해 명령이 수행되지 않았을 경우 나머지 노드들에 대해 업데이트를 수행한 후 최종 리턴값으로 에러 코드를 리턴한다.

[-N]

shared 모드에서 동기화하지 않고 실제 업데이트 대상 모듈만 복사한다.

입력 항목

항목

설명

<region>

OSC Region 이름을 지정한다.

<module>

업데이트하거나 새로 추가할 모듈명을 지정한다.

한 번에 여러 모듈을 지정할 수 있다. asmo 모듈의 경우는 확장자명까지 지정하여 실행해야 한다.

사용예제

다음은 OSC00001 Region에 OIVPMAIN 및 OIVPINFO 모듈을 업데이트하는 예이다.

$ osctdlupdate -e OSC00001 OIVPMAIN OIVPINFO

32. osctsqcheck

osctsqcheck는 TSQ 메모리 영역 내부에서 사용되는 Lock 정보를 모니터링하고 비정상적으로 사용되는 Lock을 해제하는 기능을 제공하는 툴이다. 그리고 TSQ 메모리 영역의 크기와 데이터 길이를 출력할 수 있다.

TSQ에는 Index Lock과 Item Lock이라는 2가지 종류의 Lock이 사용된다. Index Lock 은 TSQ 키 정보를 저장하는 해시 구조의 인덱스에 Lock이 실행 중임을 의미하고, Item Lock은 개별 TSQ 영역에 Lock이 실행 중임을 의미한다.

Lock 모니터링은 툴이 실행되는 시점에 이미 실행 중인 Lock을 일정한 시간 간격과 횟수만큼 Lock의 정보를 모니터링한 후, 최종적으로 모니터링이 끝날 때까지 해제되지 않은 Lock의 정보를 보고한다. 만약 처음 실행 시점에 실행 중인 Lock이 없었거나 모니터링 도중 처음에 실행 중이던 Lock이 모두 해제된다면 툴은 모니터링을 중단하고 지속적인 Lock이 없음을 보고하며 종료된다.

사용법

osctsqcheck를 실행하는 방법은 다음과 같다.

Usage: osctsqcheck -r <region> -c <count> -i <interval>
     | osctsqcheck -r <region> -n <index>
     | osctsqcheck -r <region> -q <name>
     | osctsqcheck -r <region> -a
     | osctsqcheck -r <region> -s
     | osctsqcheck -r <region> -d <name>
     | osctsqcheck [-h | -v]

항목

설명

-r <region>

OSC Region 이름을 지정한다.

다른 옵션을 지정하지 않은 경우에는 특정 Region의 Region 정보를 관리하는 TTREE의 Lock을 해제한다.

-c <count>

TSQ를 모니터링할 때 Lock 모니터링의 횟수를 지정한다. 반드시 -i 옵션과 함께 사용되어야 한다.

-i <interval>

TSQ를 모니터링할 때 모니터링의 시간 간격을 초 단위로 지정한다.

-c 옵션과 함께 사용되어야 한다. osctsqcheck는 <interval>의 간격을 두고 <count> 번만큼 Lock이 실행 중인 INDEX나 ITEM이 있는지 확인한다.

-n <index>

TSQ를 저장하는 해시 테이블의 지정된 인덱스에 실행 중인 Lock을 해제한다.

-q <name>

지정된 TSQ에 실행 중인 Lock을 해제한다.

-a

사용 중인 모든 TSQ 메모리 영역의 정보를 출력한다. 각 TSQ 이름과 데이터 길이, 전체 메모리 크기와 전체 데이터 길이를 출력한다.

-s

TSQ의 전체 메모리 크기와 전체 데이터 길이를 출력한다.

-d <name>

지정한 TSQ의 이름과 데이터 길이, 전체 메모리 크기와 전체 데이터 길이를 출력한다.

[-h]

프로그램 사용을 위한 자세한 사용법을 출력한다.

[-v]

osctsqcheck의 버전 정보를 출력한다.

사용예제

다음은 OSC00001 Region에서 사용하는 TSQ에 실행 중인 Lock을 1초 간격으로 10회 모니터링하는 예이다.

$ osctsqcheck -r OSC00001 -c 10 -i 1

다음은 OSC00001 Region에서 3852번 Index Lock을 해제하는 예이다.

$ osctsqcheck -r OSC00001 –n 3852

다음은 OSC00001 Region에서 사용하는 TSQ00001이라는 TSQ의 Lock을 해제하는 예이다.

$ osctsqcheck -r OSC00001 –q TSQ00001

다음은 OSC00001 Region에서 사용하는 모든 TSQ 메모리 영역의 정보를 출력하는 예이다.

$ osctsqcheck -r OSC00001 –a

33. osctxadm

osctxadm는 현재 Region 중에 실행되고 있는 트랜잭션의 상태를 조회하는 툴이다.

사용법

osctxadm을 사용하는 방법은 다음과 같다.

Usage:  osctxadm -r <region name>
     |  osctxadm [-h | -v]

항목

설명

-r <region name>

OSC Region 이름을 지정한다.

[-h]

프로그램 사용을 위한 자세한 사용법을 출력한다.

[-v]

osctxadm의 버전 정보를 출력한다.

사용예제

다음은 OSC00001 Region에서 실행 중인 트랜잭션 정보를 확인하는 예이다.

$ osctxadm -r OSC00001

34. oscxltc

oscxltc은 DFHXLT 매크로를 컴파일하는 툴이다.

사용법

oscxltc을 실행하는 방법은 다음과 같다.

Usage: oscxltc [-r <region>] <source>
     | oscxltc [-h | -v]

항목

설명

[-r <region>]

XLT 매크로를 컴파일하여 배포할 Region 이름을 지정한다.

해당 Region의 디폴트 테이블 디렉터리인 아래 경로에 결과물이 저장되거나, 설정 파일에 TBLDIR 항목을 지정한 경우 해당 디렉터리에 결과물이 저장된다.

${OPENFRAME_HOME}/osc/region/region이름/tbl

옵션을 지정하지 않는 경우 현재 디렉터리에 "DFHXLT.SUFFIX이름"이라는 파일명으로 결과물이 저장된다.

<source>

XLT 매크로 파일을 지정한다.

[-h]

프로그램 사용을 위한 자세한 사용법을 출력한다.

[-v]

oscxltc의 버전 정보를 출력한다.

사용예제

다음은 XLT.dat 파일에 들어있는 XLT 매크로 정의들을 읽어서 OSC00001 Region으로 배포하는 예이다.

$ oscxltc -r OSC00001 XLT.dat