openframe osc resource - tmaxsoft · openframe osc resource 참조 3안내서 연락처 korea...

OpenFrame OSC Resource

참조 안내서

소프트웨어

OpenFrame/Online v5.3

안내서 버전 v1.2

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

OpenFrame OSC Resource 참조 안내서 2

Copyright Notice

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

TmaxSoft Co., Ltd.

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

Restricted Rights Legend

This software and documents are made available under the terms of the TmaxSoft License Agreement and may only be used or copied in accordance with the terms of this agreement. No part of this document may be reproduced, transmitted, or translated in any form or by any means, electronic, mechanical, manual, or optical, without the prior written consent of TmaxSoft Co., Ltd.

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

Trademarks

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

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

안내서 정보

안내서 제목: OpenFrame OSC Resource 참조 안내서

발행일: 2008년07월15일

소프트웨어 버전: OpenFrame/Online v5.3

안내서 버전: v1.2


연락처

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

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

Japan TmaxSoft Japan Co., Ltd. 5F Sanko Bldg, 3-12-16 Mita, Minato-Ku, Tokyo, 108-0073 Japan Tel: 81-3-5765-2550 Fax: 81-3-5765-2567 Email: [email protected] Website: http://www.tmaxsoft.co.jp

mailto:[email protected]


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, Chao yang District, Beijing, China, 100027 Tel: 86-10-6410-6145~8 Fax: 86-10-6410-6144 Email: [email protected] Website: http://www.tmaxchina.com.cn Shanghai Office Room 4123, 41 Floor, China Development Bank Building, No.500 Pudong Road(s), Shanghai, China, 200120 Tel: 86-21-6019-5751 Fax: 86-21-61095750 Email: [email protected] Website: http://www.tmaxsoft.com.cn


http://www.tmaxchina.com.cn/




내용 목차

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

안내서의 대상 ......................................................................................................... 14

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

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

안내서 구성............................................................................................................. 15

안내서 규약............................................................................................................. 16

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

관련 안내서............................................................................................................. 18

제1장 개요 ........................................................................................................ 19

1.1 소개 .................................................................................................................. 19

1.2 리소스 정의(Resource Definition) .................................................................. 20

리소스 정의 등록 ........................................................................................................... 21

리소스 정의 관리 ........................................................................................................... 23

1.3 리소스 접근....................................................................................................... 24

EXEC CICS 인터페이스................................................................................................ 24

EXEC DLI 및 CBLTDLI 호출 인터페이스...................................................................... 25

EXEC SQL 인터페이스 ................................................................................................. 25

OpenStudio OMC ........................................................................................................ 25

제2장 OSC 어플리케이션 프로그래밍 ............................................................... 27

2.1 개요 .................................................................................................................. 27

2.2 EXEC CICS 인터페이스 ................................................................................... 27

RESP 옵션 .................................................................................................................... 28

NOHANDLE 옵션.......................................................................................................... 29

EIB (EXEC Interface Block)........................................................................................ 29

CVDA (CICS-Value Data Areas).................................................................................. 31

2.3 OSC 프로그래밍 서비스 ................................................................................... 31

시스템 환경 명령어 그룹................................................................................................ 31

예외상황 처리 명령어 그룹 ............................................................................................ 34

비정상 종료 처리 명령어 그룹........................................................................................ 35

핸들링 정보 관리 명령어 그룹........................................................................................ 36

리소스 복구 명령어 그룹................................................................................................ 37


내장(Built-in) 기능 명령어 그룹 .................................................................................... 38

제3장 OSC 관리 리소스 .................................................................................... 39

3.1 OSC 저장소...................................................................................................... 39

COMMAREA ................................................................................................................ 39

TWA .............................................................................................................................. 40

CWA.............................................................................................................................. 40

TCTUA.......................................................................................................................... 41

OSC 저장소 명령어 그룹............................................................................................... 41

3.2 프로그램 ........................................................................................................... 42

프로그램 연결 명령어 그룹 ............................................................................................ 43

3.3 태스크............................................................................................................... 44

트랜잭션 기동 명령어 그룹 ............................................................................................ 44

태스크 순번화 명령어 그룹 ............................................................................................ 47

3.4 동적 영역 .......................................................................................................... 48

동적 영역 할당 명령어 그룹 ........................................................................................... 48

태스크 간 메모리 공유 ................................................................................................... 49

3.5 임시 저장 큐(TSQ)............................................................................................ 51

TSQ 및 TSMODEL 접근 명령어 그룹............................................................................ 52

TSMODEL 리소스 정의................................................................................................. 55

3.6 데이터 전송 큐(TDQ) ........................................................................................ 56

Intra-partition TDQ ...................................................................................................... 56

Extra-partition TDQ..................................................................................................... 57

Log TDQ....................................................................................................................... 58

Indirect TDQ ................................................................................................................ 58

Remote TDQ ................................................................................................................ 59

TDQ 접근 명령어 그룹................................................................................................... 59

3.7 TACF................................................................................................................ 60

사용자 프로파일 등록 .................................................................................................... 61

사용자 인증 명령어 그룹................................................................................................ 62

패스워드 명령어 그룹 .................................................................................................... 63

보안 권한 명령어 ........................................................................................................... 64

트랜잭션 보안................................................................................................................ 64

제4장 데이터 관리 리소스 ................................................................................. 67

4.1 파일 .................................................................................................................. 67

FILE 리소스 정의........................................................................................................... 67

레코드 열람 및 순차 검색 명령어 그룹........................................................................... 68


레코드 추가, 삭제 및 수정 명령어 그룹.......................................................................... 72

레코드 잠금 해제 명령어................................................................................................ 74

4.2 DL/I 데이터베이스 ............................................................................................ 74

EXEC DLI 인터페이스................................................................................................... 74

CBLTDLI 인터페이스 .................................................................................................... 80

4.3 Named Counter Server .................................................................................. 81

카운터 접근 명령어 그룹................................................................................................ 81

NCS 구조 및 복구.......................................................................................................... 83

제5장 데이터 통신 리소스 ................................................................................. 85

5.1 터미널............................................................................................................... 85

TERMINAL 리소스 정의................................................................................................ 85

TYPETERM 리소스 정의............................................................................................... 86

터미널 사용 명령어 그룹................................................................................................ 87

5.2 MSC ................................................................................................................. 88

맵 송신 및 수신 명령어 그룹 .......................................................................................... 88

텍스트 데이터 전송 명령어 그룹 .................................................................................... 90

터미널 컨트롤 명령어 그룹 ........................................................................................... 90

5.3 SPOOL............................................................................................................. 91

SPOOL 파일 접근 명령어 그룹...................................................................................... 91

제6장 상호 통신 ................................................................................................ 93

6.1 소개 .................................................................................................................. 93

6.2 SYSID 식별자와 CONNECTION 리소스 정의 .................................................. 93

6.3 Function Shipping.......................................................................................... 94

파일 ............................................................................................................................... 95

TDQ............................................................................................................................... 96

TSQ............................................................................................................................... 96

6.4 Distributed Program Link .............................................................................. 96

Appendix. A CICS Command Reference ...................................................... 99

A.1 어플리케이션 프로그래밍 인터페이스 .............................................................. 99

ABEND ......................................................................................................................... 99

ADDRESS .................................................................................................................... 99

ADDRESS SET ............................................................................................................ 99

ASKTIME.................................................................................................................... 100

ASSIGN ...................................................................................................................... 100

BIF DEEDIT ................................................................................................................ 103

CANCEL ..................................................................................................................... 103


CHANGE PASSWORD .............................................................................................. 103

DEFINE COUNTER|DCOUNTER .............................................................................. 104

DELAY ........................................................................................................................ 104

DELETE...................................................................................................................... 105

DELETE COUNTER|DCOUNTER ............................................................................. 105

DELETEQ TD ............................................................................................................. 105

DELETEQ TS ............................................................................................................. 106

DEQ ............................................................................................................................ 106

ENDBR ....................................................................................................................... 106

ENQ ............................................................................................................................ 107

FORMATTIME ............................................................................................................ 107

FREEMAIN ................................................................................................................. 108

GET COUNTER|DCOUNTER .................................................................................... 108

GETMAIN ................................................................................................................... 109

HANDLE ABEND ....................................................................................................... 110

HANDLE AID.............................................................................................................. 110

HANDLE CONDITION................................................................................................ 110

IGNORE CONDITION..................................................................................................111

ISSUE DISCONNECT .................................................................................................111

LINK.............................................................................................................................111

POP HANDLE..............................................................................................................111

PUSH HANDLE.......................................................................................................... 112

QUERY COUNTER|DCOUNTER ............................................................................... 112

QUERY SECURITY .................................................................................................... 112

READ.......................................................................................................................... 113

READNEXT ................................................................................................................ 113

READPREV ................................................................................................................ 114

READQ TD ................................................................................................................. 115

READQ TS ................................................................................................................. 115

RECEIVE MAP ........................................................................................................... 116

RESETBR................................................................................................................... 116

RETRIEVE .................................................................................................................. 117

RETURN ..................................................................................................................... 117

REWIND COUNTER|DCOUNTER ............................................................................. 117

REWRITE ................................................................................................................... 118

SEND CONTROL ....................................................................................................... 118


SEND MAP ................................................................................................................. 119

SEND TEXT................................................................................................................ 120

SIGNOFF .................................................................................................................... 121

SIGNON...................................................................................................................... 121

SPOOLCLOSE ........................................................................................................... 122

SPOOLOPEN OUTPUT ............................................................................................. 122

SPOOLWRITE ............................................................................................................ 123

START ........................................................................................................................ 123

STARTBR ................................................................................................................... 124

SYNCPOINT ............................................................................................................... 124

SYNCPOINT ROLLBACK.......................................................................................... 125

UNLOCK..................................................................................................................... 125

UPDATE COUNTER|DCOUNTER ............................................................................. 125

VERIFY PASSWORD ................................................................................................. 126

WRITE......................................................................................................................... 126

WRITEQ TD................................................................................................................ 127

WRITEQ TS ................................................................................................................ 127

XCTL........................................................................................................................... 127

A.2 시스템 프로그래밍 인터페이스....................................................................... 128

INQUIRE TRANSACTION.......................................................................................... 128

INQUIRE TSQUEUE|TSQNAME ............................................................................... 129

INQUIRE TSMODEL .................................................................................................. 130

SET TSQUEUE|TSQNAME ....................................................................................... 130


그림 목차

[그림 1-1] 리소스 정의 등록 및 관리 아키텍처 ............................................................................ 21


표 목차

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

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

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

[표 0-4] Mainframe 관련 안내서................................................................................................... 18

[표 2-1] ADDRESS SET 명령어 옵션 .......................................................................................... 32

[표 2-2] ASSIGN 명령어 옵션 ...................................................................................................... 32

[표 2-3] ASKTIME 명령어 옵션 .................................................................................................... 33

[표 2-4] FORMATTTIME 명령어 옵션.......................................................................................... 34

[표 2-5] HANDLE CONDITION 명령어 옵션................................................................................ 35

[표 2-6] IGNORE CONDITION 명령어 옵션 ................................................................................ 35

[표 2-7] ABEND 명령어 옵션 ....................................................................................................... 35

[표 2-8] HANDLE ABEND 명령어 옵션........................................................................................ 36

[표 2-9] BIF DEEDIT 명령어 옵션................................................................................................ 38

[표 3-1] ADDRESS 명령어 옵션 .................................................................................................. 42

[표 3-2] LINK 명령어 옵션............................................................................................................ 43

[표 3-3] XCTL 명령어 옵션........................................................................................................... 43

[표 3-4] RETURN 명령어 옵션..................................................................................................... 44

[표 3-5] START 명령어 옵션 ........................................................................................................ 45

[표 3-6] RETRIEVE 명령어 옵션.................................................................................................. 46

[표 3-7] DELAY 명령어 옵션 ........................................................................................................ 46

[표 3-8] CANCEL 명령어 옵션 ..................................................................................................... 46

[표 3-9] ENQ 명령어 옵션............................................................................................................ 47

[표 3-10] DEQ 명령어 옵션.......................................................................................................... 48

[표 3-11] GETMAIN 명령어 옵션 ................................................................................................. 49

[표 3-12] FREEMAIN 명령어 옵션 ............................................................................................... 49

[표 3-13] DELETEQ TS 명령어 옵션 ........................................................................................... 52

[표 3-14] READQ TS 명령어 옵션 ............................................................................................... 53

[표 3-15] WRITEQ TS 명령어 옵션.............................................................................................. 53

[표 3-16] INQUIRE TSQUEUE|TSQNAME 명령어 옵션 ............................................................. 54

[표 3-17] SET TSQUEUE|TSQNAME 명령어 옵션 ..................................................................... 54

[표 3-18] INQUIRE TSMODEL 명령어 옵션 ................................................................................ 55


[표 3-19] TSMODEL 리소스 정의 정보 ........................................................................................ 55

[표 3-20] TDQUEUE 리소스 정의 정보........................................................................................ 56

[표 3-21] Intra-partition TDQ 정보................................................................................................ 57

[표 3-22] Extra-partition TDQ 정보 .............................................................................................. 57

[표 3-23] Log TDQ 정보 ............................................................................................................... 58

[표 3-24] Indirect TDQ 정보 ......................................................................................................... 58

[표 3-25] Remote TDQ 정보 ........................................................................................................ 59

[표 3-26] DELETEQ TD 명령어 옵션 ........................................................................................... 59

[표 3-27] READQ TD 명령어 옵션 ............................................................................................... 60

[표 3-28] WRITEQ TD 명령어 옵션 ............................................................................................. 60

[표 3-29] SIGNON 명령어 옵션 ................................................................................................... 62

[표 3-30] CHANGE PASSWORD 명령어 옵션 ............................................................................ 63

[표 3-31] VERIFY PASSWORD 명령어 옵션............................................................................... 63

[표 3-32] QUERY SECURITY 명령어 옵션.................................................................................. 64

[표 4-1] FILE 리소스 정의 정보.................................................................................................... 68

[표 4-2] READ 명령어 옵션.......................................................................................................... 69

[표 4-3] STARTBR 명령어 옵션 ................................................................................................... 70

[표 4-4] READNEXT 명령어 옵션 ................................................................................................ 70

[표 4-5] READPREV 명령어 옵션................................................................................................ 71

[표 4-6] ENDBR 명령어 옵션 ....................................................................................................... 71

[표 4-7] RESETBR 명령어 옵션................................................................................................... 72

[표 4-8] WRITE 명령어 옵션 ........................................................................................................ 72

[표 4-9] REWRITE 명령어 옵션 ................................................................................................... 73

[표 4-10] DELETE 명령어 옵션.................................................................................................... 73

[표 4-11] UNLOCK 명령어 옵션 ................................................................................................... 74

[표 4-12] DLET 명령어 옵션 ........................................................................................................ 76

[표 4-13] GN 명령어 옵션 ............................................................................................................ 77

[표 4-14] GNP 명령어 옵션 .......................................................................................................... 77

[표 4-15] GU 명령어 옵션 ............................................................................................................ 78

[표 4-16] ISRT 명령어 옵션.......................................................................................................... 79

[표 4-17] REPL 명령어 옵션 ........................................................................................................ 79

[표 4-18] SCHD 명령어 옵션 ....................................................................................................... 79

[표 4-19] DEFINE COUNTER|DCOUNTER 명령어 옵션 ............................................................ 81

[표 4-20] DELETE COUNTER|DCOUNTER 명령어 옵션 ........................................................... 82

[표 4-21] GET COUNTER|DCOUNTER 명령어 옵션 .................................................................. 82

[표 4-22] REWIND COUNTER|DCOUNTER 명령어 옵션........................................................... 82


[표 4-23] UPDATE COUNTER|DCOUNTER 명령어 옵션 ........................................................... 83

[표 4-24] QUERY COUNTER|DCOUNTER 명령어 옵션............................................................. 83

[표 5-1] TERMINAL 리소스 정의 정보 ......................................................................................... 86

[표 5-2] TYPETERM 리소스 정의 정보........................................................................................ 87

[표 5-3] HANDLE AID 명령어 옵션 .............................................................................................. 87

[표 5-4] SEND MAP 명령어 옵션 ................................................................................................. 89

[표 5-5] RECEIVE MAP 명령어 옵션 ........................................................................................... 89

[표 5-6] SEND TEXT 명령어 옵션 ............................................................................................... 90

[표 5-7] SPOOLOPEN OUTPUT 명령어 옵션 ............................................................................. 92

[표 5-8] SPOOLCLOSE 명령어 옵션 ........................................................................................... 92

[표 6-1] CONNECTION 리소스 정의 정보 ................................................................................... 94

안내서에 대하여



안내서의 대상

본 안내서는 OSC 시스템에서 제공하는 리소스 정보에 대한 안내서로 IBM CICS

Transaction Server를 OpenFrame OSC 시스템으로 마이그레이션하는 리호스팅 프

로젝트를 수행하는 시스템 개발자와 OSC 어플리케이션 프로그램을 개발하는 어플리

케이션 개발자를 대상으로 기술한다.

안내서의 전제 조건

본 안내서를 필요로 하는 사용자는 OSC 시스템의 운영 및 관리자 또는 리호스팅 프로

젝트 수행자라고 전제한다.

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

고 있어야 한다.

OpenFrame/Online OSC 시스템

UNIX에 대한 이해

TmaxSoft의 TP-Monitor인 Tmax에 대한 이해

IBM의 CICS Transaction Server에 대한 이해

안내서의 제한 조건

본 안내서는 OpenFrame/Online 시스템 중 하나인 OSC에서 제공하는 리소스스에 대

한 정보를 제공한다. OpenFrame의 기반 환경인 UNIX, 그리고 OpenFrame의 구동 엔

진인 Tmax, OSC 시스템의 리호스팅 주체인 IBM CICS Transaction Server에 대해서

는 따로 상세히 기술하지 않는다.



안내서 구성

OpenFrame 설치 안내서는 총 6개의 장으로 구성되어 있다.

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

제1장: 개요

OSC 시스템에서 제공하는 리소스를 OSC 관리 리소스, 데이터 관리 리소스 및

데이터 통신 리소스로 분류하고, 각 분류에 해당하는 리소스 및 리소스의 기반이

되는 리소스 정의에 대해 설명하고, 사용자 리소스에 접근하는 방법에 대해 기술

한다.

제2장: OSC 어플리케이션 프로그래밍

OSC 어플리케이션에서 리소스에 접근하기 위한 EXEC CICS 인터페이스 및

EXEC CICS 인터페이스를 기반으로 OSC 어플리케이션 서버에서 제공하는 다양

한 기능 및 프로그래밍 서비스에 대해 기술한다.

제3장: OSC 관리 리소스

OSC 시스템에서 제공하는 리소스 중 OSC 관리 리소스에 대해 기술한다.

제4장: 데이터 관리 리소스

OSC 시스템에서 제공하는 리소스 중 데이터 관리 리소스에 대해 기술한다.

제5장: 데이터 통신 리소스

OSC 시스템에서 제공하는 리소스 중 데이터 통신 리소스에 대해 기술한다.

제6장: 상호 톨신

원격 OSC 어플리케이션 서버에 있는 파일, TDQ, TSQ 리소스에 대한 접근 및 프

로그램 링크 기능에 대해 기술한다.



안내서 규약

표기 의미

AaBbCc123 명령어

AaBbCc123 명령어 수행 후 화면에 출력된 결과물

참고: 참고 또는 주의사항

{ } 필수 인수값

[ ] 옵션 인수값

| 선택 인수값

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

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

이탤릭체 사용자 입력 값

underline 시스템 기본 값

진하게 강조

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

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

. . . 코드 생략

... 파라미터 등의 반복

[그림 1-1] 그림 이름

[표 1-1] 표 이름

[표 0-1] 안내서 규약



시스템 사용 환경

요구사항

Platform IBM AIX 5.x

HP-UX 11.xx

Solaris 9 (SunOS 5.9)

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

256MB 이상 메모리 공간

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

Database Tibero 3.0

Oracle 9i 또는 10g

Compiler MF-Cobol 컴파일러

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



관련 안내서

제품 안내서

OpenFrame HiDB 안내서

MSC 운영 안내서

OSC 운영자 안내서

OSC Supplied Transaction 참조 안내서

OpenStudio OMC 안내서

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

제품 안내서

Mainframe CICS Application Progamming Guide

CICS Application Programming Reference

CICS System Programming Reference

CICS Resource Definition Guide

CICS Intercommunication Guide

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

제1장 개요


제1장 개요

1.1 소개

OSC(Online Server type C) 시스템은 사용자가 OSC 어플리케이션 프로그램을 쉽고

편리하게 개발하거나 기존 IBM CICS Transaction Server에서 작동하던 어플리케이션

프로그램들을 리호스팅할 수 있도록 다양한 리소스를 제공한다. OSC 시스템에서 제

공하는 리소스들은 대부분 IBM CICS Transaction Server가 제공하는 기능 및 서비스

를 기반으로 한다.

OSC 시스템에서 제공하는 리소스는 다음과 같이 크게 세 가지로 분류할 수 있다.

OSC 관리 리소스

데이터 관리 리소스

데이터 통신 리소스

OSC 관리 리소스

OSC 어플리케이션 프로그램의 구성을 위하여 OSC 시스템에서 특별히 제공하는 리

소스이다.

다음과 같은 리스소들이 이에 해당한다.

OSC 저장소: 저장소 관리 기능 제공

프로그램: 프로그램 실행 처리 기능 제공

태스크: 태스크 간의 연결 처리 기능 제공

동적 영역: 동적 메모리 할당 또는 반환 처리 기능 제공

임시 저장 큐(TSQ): 임시로 데이터를 저장하기 위한 큐 기능 제공

데이터 전송 큐(TDQ): 데이터 전송을 위한 큐 기능 제공

보안: 사용자 ID 인증 및 인증 해제 기능 제공

제1장 개요


데이터 관리 리소스

OSC 어플리케이션 프로그램이 데이터를 관리할 수 있도록 제공하는 리소스이다.

다음과 같은 리소스들이 포함된다.

파일: TSAM(Tmax VSAM) 데이터 셋 접근 관리 기능 제공

DL/I 데이터베이스: HiDB(Hierarchical DataBase) 접근 처리 기능 제공

Named Counter Server: 카운터 관리 기능 제공

데이터 통신 리소스

OSC 어플리케이션 프로그램이 클라이언트 혹은 다른 제품과의 연결할 수 있도록 제

공하는 리소스이다.

다음과 같은 리소스들이 포함된다.

터미널: 터미널 연결 관리 기능 제공

MSC(Mapping Support type C): MSC 게이트웨이와 연결 기능 제공

SPOOL: TJES(Tmax Job Entry Subsystem) 시스템 인터페이스 역할 기능 제공

1.2 리소스 정의(Resource Definition)

리소스 정의란 리소스 이름, 리소스 유형, 리소스에 접근하기 위해 필요한 정보, 리소

스의 속성과 같은 내용을 포함하는 설정 정보이다. OSC 어플리케이션 서버에서 일부

리소스를 사용하기 위해서는 해당 리소스에 대한 정의가 필요하다.

OSC 어플리케이션 서버에서 리소스 정의가 필요한 리소스들은 다음과 같이 6개가 존

재한다.

CONNECTION

다른 OSC 어플리케이션 서버로의 연결 정보 정의

FILE

OSC 어플리케이션 프로그램에서 접근할 데이터 셋의 특성 및 접근 여부 정의

제1장 개요


TERMINAL

터미널 정보, 특성 및 사용 여부 정의

TDQUEUE

데이터 전송 큐(TDQ) 속성 정의

TSMODEL

임시 저장소 큐(TSQ)에 대한 생성 모델 정의

TYPETERM

터미널 타입 정의

리소스 정의 등록

리소스 정의는 매크로 스크립트 형식으로 작성한 뒤 osdgen이라는 툴을 사용하여

OSD(Online System Definition) 데이터 셋에 등록한다. 그리고, OSD 데이터 셋에 저

장된 내용은 OpenFrame 시스템이 구동될 때 RTSD(Runtime System Definition) 저장

소로 로딩된다. OSC 어플리케이션 서버들은 로딩된 RTSD 저장소에 담긴 리소스 정

의를 바탕으로 기능을 제공한다.

[그림 1-1] 리소스 정의 등록 및 관리 아키텍처

제1장 개요


매크로 스크립트 작성

매크로 스크립트 형태의 리소스 정의는 IBM CICS Transaction Server에서 사용하던

리소스 정의를 전환하여 생성하거나 시스템 운영자가 직접 필요한 리소스를 등록하는

매크로를 작성할 수 있다.

참고: 매크로에 대한 자세한 정보는 OpenFrame 안내서 중 “OSC Administrator Guide”를 참조

한다.

OSD 데이터 셋

필요한 리소스 정의 매크로 파일이 작성되었다면 osdgen 툴을 이용해서 매크로 파일

의 내용을 OSD 데이터 셋에 등록한다. osdgen은 매크로 스크립트를 OSC 어플리케

이션 서버에서 필요로 하는 형태로 컴파일하여 OSD 데이터 셋에 리소스를 등록하는

역할을 수행한다.

대상이 되는 OSD 데이터 셋을 시스템 데이터 셋 서버에서 관리하고 있다면 osdgen

툴을 실행할 때 “-s” 옵션을 함께 지정해야 한다.

참고: osdgen 툴 사용에 대한 자세한 방법은 OpenFrame 안내서 중 ”툴 참조 안내서”를 참고

한다.

osdgen 툴 대신 OpenStudio의 OMC(Online Manager for OSC) 모듈의 System

Definition 메뉴를 사용하여 GUI 기반으로 보다 편리하게 OSD 데이터 셋에 리소스

정의를 추가, 변경 및 삭제할 수 있다.

참고: OMC 모듈의 자세한 내용은 OpenFrame 안내서 중 ”OpenStudio OMC 안내서”를 참고한

다.

OpenStudio를 통해 OSD 데이터 셋 관리 작업을 수행할 때 발생하는 일련의 작업들은

OSDM이라는 OSC 시스템 서버를 통해서 수행된다. OSDM 서버는 OpenStudio로부

터 입력 받은 데이터 셋을 열거나, 정보를 조회하거나 또는 수정 작업을 처리한 후

OpenStudio에 처리 결과를 반환하는 역할을 수행한다.

참고: OSDM에 대한 자세한 내용은 OpenFrame 안내서 중 ”OSC Supplied Transaction 참조 안

내서”를 참고한다.

OSD 데이터 셋의 변경 내용은 OpenFrame 시스템을 재기동할 때 반영된다.

제1장 개요


RTSD 저장소

리소스 정의는 둘 이상의 OSC 어플리케이션 서버 프로세스에서 공유되어야 하고, 리

소스 정의로 빠르게 접근이 가능해야 하며, 관리가 편리해야 한다. 이런 이유로 리소

스 정의는 OSC 시스템이 실행 중인 환경에서 RTSD라는 서버 프로세스가 공유할 수

있는 저장소에 저장된다.

시스템 기동 후에 OSC 어플리케이션 서버는 리소스에 대한 요청이 있을 때마다

RTSD 저장소에서 관련 리소스 정의를 검색하여 리소스에 대한 서비스를 제공한다.

OSC 어플리케이션 서버는 런타임 시에는 OSD 데이터 셋을 참조하지 않는다.

RTSD 저장소는 OSC 시스템이 종료될 때 함께 삭제되기 때문에 리소스 정의를 영구

적으로 수정하기 위해서는 OSD 데이터 셋에서 해당 내용을 수정해야 한다. RTSD 관

리에 대한 자세한 내용은 아래 “리소스 정의 관리” 절을 참고한다.

리소스 정의 관리

OSC 시스템은 OSC 어플리케이션 서버에서 사용하는 RTSD 저장소에 저장된 리소스

정의를 관리할 수 있도록 다음과 같이 두 가지 방법을 제공한다.

OpenStudio OMC 이용

시스템 프로그래밍 인터페이스 이용

위 두 가지 방법으로 변경한 내용은 해당 리소스를 사용하는 모든 OSC 어플리케이션

서버에 반영된다.

OpenStudio OMC 이용

OpenStudio의 OMC 모듈의 Runtime Resource 메뉴를 사용하여 GUI 기반으로

RTSD에 등록된 리소스 정의 정보를 변경할 수 있다.

참고: 1. OMC 모듈의 자세한 내용은 OpenFrame 안내서 중 ”OpenStudio OMC 안내서”를 참

고한다.

2.OpenStudio를 통해 RTSD 정보의 조회나 변경 작업을 수행할 때 발생하는 일련의 작

업들은 OEMT라는 OSC 시스템 서버를 통해서 수행된다. OEMT 서버는 OpenStudio로

부터 요청된 서버에서 사용하는 RTSD 영역에 접근해서 리소스 정의 정보를 조회하거나

수정하는 작업을 처리한 후 OpenStudio에 처리 결과를 반환하는 역할을 수행한다.

제1장 개요


시스템 프로그래밍 인터페이스 이용

OSC 시스템은 리소스에 접근하기 위한 어플리케이션 프로그래밍 인터페이스 외에도

시스템 또는 리소스를 관리하기 위한 시스템 프로그래밍 인터페이스를 제공한다. 이

를 통해 사용자는 시스템 또는 리소스에 대한 정보를 얻거나 리소스에 대한 정보를 직

접 수정할 수 있다. 시스템 프로그래밍 인터페이스는 크게 다음 두 가지로 구분된다.

INQUIRE 명령어: 시스템 또는 리소스에 대한 정보를 가져온다.

SET 명령어: 시스템 또는 리소스의 정보 또는 상태를 수정한다.

각 명령어에 대한 자세한 설명은 명령어가 사용되는 해당 리소스를 설명할 때 함께 기

술된다. 현재 시스템 프로그래밍 인터페이스는 제한적으로 제공된다.

1.3 리소스 접근

OSC 사용자 어플리케이션 프로그램은 보통 EXEC 인터페이스를 통해 리소스에 접근

한다. 계층형 데이터베이스인 HiDB의 경우에는 특별히 CBLTDLI 호출 인터페이스를

이용할 수 있고, 몇몇 리소스는 OpenStudio OMC를 통한 접근도 가능하다.

EXEC 인터페이스는 OSC 리소스 접근을 위한 EXEC CICS 인터페이스, 계층형 데이

터베이스인 HiDB 접근을 가능하게 하는 EXEC DLI 인터페이스(CBLTDLI 호출 인터페

이스도 지원), 그리고 관계형 데이터베이스에 접근하기 위한 EXEC SQL 인터페이스

세 가지로 나뉘어진다.

EXEC CICS 인터페이스

EXEC CICS 인터페이스는 다시 어플리케이션 프로그래밍 명령어와 시스템 프로그래

밍 명령어로 나뉘어진다. 어플리케이션 프로그래밍 명령어는 사용자가 어플리케이션

을 개발하는데 사용하는 명령어들로 리소스 접근을 목적으로 한다. 시스템 프로그래

밍 명령어들은 시스템 프로그래머들을 위한 명령어로 INQUIRE 또는 SET 중 하나로

시작하며 리소스에 대한 정보를 가져오기 위한 목적으로 사용된다.

EXEC CICS 인터페이스에 대한 자세한 내용은 “제2장 OSC 어플리케이션 프로그래

밍” 절을 참고한다.

제1장 개요


EXEC DLI 및 CBLTDLI 호출 인터페이스

OSC 어플리케이션 프로그램에서 HiDB에 접근하려면 DL/I 인터페이스를 이용해야

한다. DL/I 인터페이스는 EXEC DLI라는 명령어 레벨의 인터페이스와 CBLTDLI라는

COBOL 호출 수준의 인터페이스로 나뉘어진다. 자세한 내용은 “4.2 DL/I 데이터베이

스”를 참고한다.

EXEC SQL 인터페이스

OSC 어플리케이션 프로그램에서 관계형 데이터베이스에 접근할 때에는 EXEC SQL

인터페이스를 이용한다. OSC 어플리케이션 서버에서 관계형 데이터베이스 접근은

해당 데이터베이스의 EXEC SQL 인터페이스와 TP-Monitor인 Tmax의 데이터베이스

접근 기능에 의해 이루어지므로 본 안내서에서 다루지 않는다.

참고: EXEC SQL 인터페이스에 대한 자세한 정보는 사용하려는 관계형 데이터베이스의 EXEC

SQL 안내서를, 관계형 데이터베이스 관련 설정은 Tmax 안내서 중 “Tmax Administration

Guide” 및 해당 데이터베이스의 관련 안내서를 참고한다.

OpenStudio OMC

OSC 어플리케이션 서버 운영자는 OpenStudio OMC를 통해 다음 세 가지 리소스에

접근할 수 있다.

TSQ

TSQ에 접근하여 내용 조회 및 열람, 삭제

Intra-partition TDQ

Intra-partition TDQ에 접근하여 내용 조회 및 열람

Named Counter

카운터에 접근하여 내용 조회

참고: OpenStudio OMC를 통한 리소스 관리 방법에 대한 자세한 내용은 OpenFrame 안내서 중

“OpenStudio OMC 안내서”를 참고한다.

제2장 OSC 어플리케이션 프로그래밍



2.1 개요

OSC 어플리케이션 프로그램은 OpenFrame 시스템이 지원하는 프로그래밍 언어를

바탕으로 운영체제 및 OSC 리소스를 이용하여 작성된다. 운영체제 리소스는 시스템

이 제공하는 시스템 함수를 통해 접근하고, OSC 리소스는 EXEC CICS 인터페이스를

이용하여 접근한다. 그 밖에도 계층형 데이터베이스인 HiDB 접근을 위한 EXEC DLI

및 CBLTDLI 인터페이스, 관계형 데이터베이스 접근을 위한 EXEC SQL 인터페이스를

통하여 다양한 리소스에 접근할 수 있다.

이 장은 EXEC CICS 인터페이스의 사용 방법과 OSC 어플리케이션 서버가 제공하는

프로그래밍 서비스에 대해 설명한다.

2.2 EXEC CICS 인터페이스

EXEC CICS 인터페이스는 COBOL 프로그래밍 언어로 구성된 프로그램 소스에서 다

음과 같은 문법으로 사용한다.

EXEC CICS command [option …] END-EXEC.

command는 해당 명령어를 의미하고 필수적인 문법이다. 명령어에 따라 option부분

에 사용할 수 있는 항목은 정해져 있으며, 명령어에 따라 필수 옵션과 선택적으로 사

용할 수 있는 옵션으로 나뉘어진다. 또한, 옵션은 인자가 필요한 옵션과 그렇지 않은

옵션으로 구분할 수도 있다.

다음은 “FILE01”이라는 파일에서 “KEY-01”에 담긴 RIDFLD에 맞는 레코드를

UPDATE 방식으로 “AREA-01”에 읽어오는 예를 보여준다. 여기서 READ가 명령어이

고, “FILE”, “INTO”, “RIDFLD”, “UPDATE”는 옵션이다.

EXEC CICS READ FILE(‘FILE01’) INTO(AREA-01) RIDFLD(KEY-01) UPDATE END-EXEC.



이 장의 나머지 부분에서는 OSC 시스템에서 지원하는 명령어를 위주로 리소스 접근

기능을 설명한다. 현재 OSC 어플리케이션 서버가 지원하는 EXEC CICS 명령어의 문

법과 지원하는 옵션 목록은 “A.1 어플리케이션 프로그래밍 인터페이스”에 소개되어

있다.

각 명령어와 함께 설명된 옵션들 외에 “RESP” 옵션과 “NOHANDLE” 옵션은 OSC 시

스템이 지원하는 모든 명령어에서 사용이 가능하다. 이 두 가지 옵션에 대해서는 아래

“RESP 옵션” 절과 “NOHANDLE 옵션” 절에서 조금 더 자세히 알아보겠다.

또한 OSC 어플리케이션 서버는 사용자가 보다 쉽게 EXEC CICS 인터페이스를 사용

할 수 있도록 추가적인 시스템 컨트롤 블록인 EIB(EXEC Interface Block)와 시스템 제

공 데이터 값인 CVDA(CICS-Value Data Area)를 제공한다. 이에 대해서도 본 절의 마

지막 부분에서 설명한다.

RESP 옵션

EXEC CICS 명령어를 실행할 때마다 OSC 어플리케이션 서버는 사용자에게 명령어

실행에 대한 응답 코드를 알려주는데 이 코드를 RESP 값이라 한다.

RESP 값은 이미 시스템이 약속한 값에 따라 지정된다. NORMAL을 제외한 모든 값은

예외 조건에 해당한다. 예외 조건은 RESP 값으로 구분할 수 있지만, 추가로 RESP2

값을 사용하여 예외 조건에 대한 보다 자세한 정보를 제공하기 때문에 경우에 따라 적

절한 예외 처리를 위해서는 RESP, RESP2 값을 모두 참조할 필요가 있다.

RESP, RESP2 값은 명령어 옵션을 통해 사용자가 지정한 변수에 설정되도록 하거나,

EIB에 설정된 EIBRESP, EIBRESP2 필드를 통하여 접근할 수 있다.

이렇게 얻은 RESP, RESP2 값은 시스템 매크로 함수 DFHRESP의 결과 값과 비교하

여 정상적으로 실행되었는지, 아니면 특정 예외 조건이 발생했는지 확인할 수 있다.

DFHRESP 함수는 미리 약속된 심볼을 인자로 받아 적절한 바이너리 값을 반환한다.

다음은 NOTFND라는 예외 조건이 발생한 경우, 사용자가 해당 조건을 처리하는 예제

이다.

EXEC CICS ... RESP(MY-RESP) END-EXEC.

IF MY-RESP=DFHRESP(NOTFND) THEN ... END-IF



명령어에 RESP 옵션을 지정하면 예외 조건이 발생했을 때 시스템이 자동으로 디폴트

동작을 취하지 않는다. 자세한 내용은 다음 “NOHANDLE 옵션” 절을 참고한다.

NOHANDLE 옵션

EXEC CICS 인터페이스를 통하여 요청이 들어온 명령어를 실행하는 도중 예외 조건

이 발생하는 경우, 시스템은 디폴트 동작을 취하도록 약속되어 있다. 대부분의 경우

디폴트 동작은 비정상 종료이지만 조건에 따라 다른 동작을 취하기도 한다.

디폴트 액션을 사용자가 EXEC CICS 인터페이스의 특정 명령어를 사용하여 직접 수

정할 수도 있다. 이에 대한 자세한 내용은 “2.3 OSC 프로그래밍 서비스” 절의 “예외상

황 처리 명령어 그룹” 과 “비정상 종료 처리 명령어 그룹”을 참고한다.

명령어에 “RESP”나 “NOHANDLE” 옵션이 주어진 경우, 시스템은 예외 조건 발생해도

사용자가 이를 처리한다고 가정하고 약속된 디폴트 동작을 수행하지 하지 않는다.

참고: OSC 어플리케이션 서버는 기본적으로 IBM CICS Transaction Server와 동일한 디폴트

동작을 취하도록 되어 있다. 이에 대한 자세한 내용은 “IBM CICS Application

Programming Reference“ 또는 “IBM CICS System Application Programming

Reference”를 참고한다.

EIB (EXEC Interface Block)

EIB는 시스템 컨트롤 블록으로 사용자 프로그램과 시스템을 연결하는 역할을 한다.

EIB에는 트랜잭션 식별자, 트랜잭션 시작 시각, 터미널 식별자를 비롯하여 명령어의

실행 결과 값 등이 필드별로 저장되며 사용자는 EIB의 모든 필드에 접근이 가능하다.

따라서 사용자는 EIB에 저장된 값으로부터 현재 처리 중인 트랜잭션에 대한 자세한

정보를 쉽게 얻을 수 있다.

다음은 현재 OSC 어플리케이션 서버에서 지원하는 EIB 필드이다.

EIBAID

터미널로부터 받은 마지막 AID(Attention Identifier) 값

EIBCALEN

해당 프로그램으로 넘겨진 COMMAREA 길이



EIBCPOSN

터미널로부터 받은 커서 주소(position)

EIBDATE

태스크의 시작 날짜. ASKTIME 명령어에 의하여 업데이트된다.

EIBFN

EXEC CICS 인터페이스를 사용하여 가장 최근에 실행된 명령어

EIBRCODE

가장 최근에 실행된 EXEC CICS 명령어의 리턴 코드

EIBRESP

가장 최근에 실행된 EXEC CICS 명령어의 RESP 값

EIBRESP2

가장 최근에 실행된 EXEC CICS 명령어의 RESP2 값

EIBRSRCE

가장 최근에 접근한 리소스의 식별자

EIBTASKN

시스템에 의하여 해당 태스크에 할당된 태스크 개수

EIBTIME

태스크의 시작 시각. ASKTIME 명령어에 의하여 업데이트된다.

EIBTRMID

태스크와 연결된 주 터미널(principal facility)의 식별자

EIBTRNID

태스크의 트랜잭션 식별자



CVDA (CICS-Value Data Areas)

CVDA는 시스템에 미리 정의되어 있는 값에 사용자가 기억하고 사용하기 쉬운 심볼

릭한 이름을 부여해 놓은 것이다. 사용자는 OSC 어플리케이션 프로그램을 작성할 때

시스템에서 사용하는 바이너리 값을 직접 입력할 필요 없이 DFHVALUE 매크로 함수

에 심볼릭한 이름을 인자로 주고 그 결과 값을 이용할 수 있다.

참고: CVDA 값은 IBM CICS Transaction Server의 값과 동일하므로 “IBM CICS Application

Programming Reference”를 참고한다.

2.3 OSC 프로그래밍 서비스

EXEC CICS 인터페이스는 OSC 리소스에 접근하기 위한 명령어 외에도 사용자가

OSC 어플리케이션 프로그래밍을 쉽게 할 수 있도록 다음과 같은 프로그래밍 서비스

들을 제공한다.

시스템 환경

예외상황 처리

비정상 종료 처리

핸들링 정보 관리

리소스 복구

내장(Built-in) 기능

본 절에서는 이러한 프로그래밍 서비스들을 명령어 그룹별로 기술한다.

시스템 환경 명령어 그룹

환경 서비스는 사용자가 OSC 시스템 정보나 시스템이 제공하는 리소스 정보를 얻을

수 있게 한다. 주소 값을 변환할 수 있는 명령어와 시스템 환경 설정 값들을 가져오는

명령어를 제공한다.



ADDRESS SET

포인터 참조 파라미터를 주소에 지정하거나, 반대로 포인터 참조 파라미터에 메모리

주소를 저장하기 위해 사용되는 명령어이다. “USING” 옵션이 가리키는 값을 “SET” 옵

션이 가리키는 위치에 저장한다.

옵션 설명

SET 포인터 참조 값 반환

USING 포인터 값 지정

[표 2-1] ADDRESS SET 명령어 옵션

ASSIGN

시스템 환경 변수 값을 가져오는 명령어이다.

다음 옵션들을 이용하여 원하는 시스템 환경 변수 값을 가져올 수 있다.

옵션 설명

ABCODE 현재 ABCODE 값 (비정상 종료가 발생하지 않으면 빈 공간으로 채워짐)

APPLID 서버의 APPLID 값 (현재 프로그램이 동작하는 OSC 서버명과 동일)

SYSID 서버의 SYSID 값(설정 파일에 지정)

NETNAME 현재 연결된 터미널의 NETNAME

USERID 현재 사인온된 사용자 ID 반환

CWALENG CWA 영역의 길이

TCTUALENG TCTUA 영역의 길이

TWALENG TWA 영역의 길이

STARTCODE 트랜잭션 요청 방법 반환

[표 2-2] ASSIGN 명령어 옵션

참고: OpenFrame OSC 시스템에서는 STARTCODE 옵션에 대해 다음 값을 지원한다.

SD: 넘어온 데이터와 함께 START 명령어로 실행

S: 넘어온 데이터 없이 START 명령어로 실행

TD: 터미널로부터 실행되거나, tpcall/tpacall/tpconnect 등의 Tmax API로 실행



ASKTIME

현재 날짜와 시간 정보를 가져오는 명령어이다.

해당 정보는 EIB 필드 중 EIBTIME, EIBDATE에 저장이 된다. 시스템의 절대 시간

(absolute time) 값으로 가져오는데, 이는 사람이 알아보기 힘든 값이므로

FORMATTIME 명령어로 변환 후 자세한 내용을 가져올 것을 권장한다.

옵션 설명

ABSTIME OSC 시스템이 관리하는 시간 정보에 대한 복사본이 ABSTIME 옵션에 의해 지정된 변수에 저장

[표 2-3] ASKTIME 명령어 옵션

FORMATTIME

ASKTIME 명령어으로 받아온 날짜 및 시간 정보, 또는 EIBDATE 및 EIBTIME에 저장

된 날짜 및 시간을 사용자가 원하는 포맷으로 변환하는 명령어이다.

옵션 설명

ABSTIME 절대 날짜 및 시간(absolute date/time) 포맷 지정

DATE 날짜 형태로 반환

FULLDATE DATEFORM에 기반하여, YEAR 부분이 4자리로 반환

DATEFORM MMDDYY로 반환

DATESEP YEAR 및 MONTH, MONTH 및 DAY 사이에 구분자를 넣거나, YYDDD와 같은 옵션에서 YEAR과 DAY 사이에 구분

자를 넣을 때 구분자 지정 가능. 구분자 값이 없이 옵션 설정 시 슬래시(/)가 디폴트 구분자

가 된다.

DAYCOUNT 1900년 1월 1일 이후 날짜 수 반환

DAYOFMONTH 현재 달에서 날짜 수 반환

DAYOFWEEK 현재 주에서 상대적인 날짜 수 반환 (SUNDAY는 0, SATURDAY는 6)

DDMMYY DAY/MONTH/YEAR(마지막 두 자리)로 날짜 반환. DAY, MONTH, YEAR 사이에 구분자가 포함된다.

DDMMYYYY DAY/MONTH/YEAR(네 자리)로 날짜 반환. DAY, MONTH, YEAR 사이에 구분자가 포함된다.

MMDDYY MONTH/DAY/YEAR(마지막 두 자리)로 날짜 반환. MONTH, DAY, YEAR 사이에 구분자가 포함된다.

MMDDYYYY MONTH/DAY/YEAR(네 자리)로 날짜 반환.



옵션 설명 MONTH, DAY, YEAR 사이에 구분자가 포함된다.

YYDDMM YEAR(마지막 두자리)/DAY/MONTH로 날짜 반환. YEAR, DAY, MONTH 사이에 구분자가 포함된다.

YYMMDD YEAR(마지막 두자리)/MONTH/DAY로 날짜 반환. YEAR, MONTH, DAY 사이에 구분자가 포함된다.

YYYYDDMM YEAR(네 자리)/DAY/MONTH로 날짜 반환. YEAR, DAY, MONTH 사이에 구분자가 포함된다.

YYYYMMDD YEAR(네 자리)/MONTH/DAY로 날짜 반환. YEAR, MONTH, DAY 사이에 구분자가 포함된다.

YYDDD YEAR(마지막 두 자리)/DAY로 날짜 반환. 여기서 DAY는 해당 년도의 날짜 수를 의미. YEAR, DAY 사이에 구분자가 포함된다.

MONTHOFYEAR 해당 년도의 달 수

TIME hh:mm:ss 형태로 시간 반환. 구분자 디폴트(TIMESEP 옵션으로 구분자 변경 가능)로 콜론(:)을 사용한다.

TIMESEP TIME 옵션에서 반환될 시간 포맷의 구분자 지정

YEAR 네 자리 YEAR 반환

[표 2-4] FORMATTTIME 명령어 옵션

예외상황 처리 명령어 그룹

“2.2 EXEC CICS 인터페이스” 절에서 설명하였듯이, OSC 어플리케이션 서버는

EXEC CICS 명령어 실행 중 예외 조건이 발생하면, 디폴트 동작을 취하도록 약속되어

있다. 사용자는 HANDLE CONDITION, IGNORE CONDITION 명령어를 통하여 디폴

트 액션을 변경할 수 있다.

HANDLE CONDITION

특정 예외 조건에 레이블을 지정하면, 해당 예외 조건이 발생했을 때 지정한 레이블이

설정된 프로그램 섹션이 실행된다. 지정한 예외 조건 발생 시 수행할 동작이 정의된

레이블을 설정하는 명령어이다.

“condition” 옵션에 아무런 레이블을 지정하지 않고 사용하면, 디폴트 동작이 설정된다.



옵션 설명

condition 예외 조건을 옵션 이름으로 지정하고 인자로 컨트롤을 넘길 레이블을 지정

[표 2-5] HANDLE CONDITION 명령어 옵션

IGNORE CONDITION

특정 예외 조건에 대한 자동 처리를 무시하는 명령어이다. 이 경우 사용자가 해당 예

외 조건에 대한 결과를 직접 처리해야 한다.

옵션 설명

condition 예외 조건을 옵션 이름으로 지정

[표 2-6] IGNORE CONDITION 명령어 옵션

비정상 종료 처리 명령어 그룹

사용자가 ABEND 명령을 내려 트랜잭션을 즉시 종료하거나, 명령어 수행 중에 에러

가 발생하여 시스템이 현재 수행 중인 태스크를 종료시키는 경우와 같이 비정상적으

로 프로그램이 종료하는 것을 비정상 종료(abend)라 한다. 이 때, 해당 트랜잭션에서

복구 가능한 리소스들은 롤백된다.

ABEND

현재 태스크를 비정상 종료시키는 명령어이다.

옵션 설명

ABCODE 비정상 종료 코드 지정

CANCEL HANDLE ABEND 명령어로 지정된 핸들링 처리를 무시

NODUMP DUMP하지 않음

[표 2-7] ABEND 명령어 옵션



HANDLE ABEND

비정상 종료(abend)가 발생했을 때 지정한 레이블이나 프로그램을 실행한 뒤 종료하

도록 설정하는 명령어이다.

여러 프로그램 레벨(LINK 명령어를 통하여 프로그램 호출)에서 비정상 종료 출구를

지정한 경우, OSC 어플리케이션 서버는 가장 최근의 HANDLE ABEND 설정을 사용

한다.

옵션 설명

PROGRAM 태스크 비정상 종료 시 컨트롤을 넘길 프로그램 이름 지정

LABEL 태스크 비정상 종료 시 컨트롤이 분기될 프로그램 레이블

명 지정

CANCEL 이전 종료 설정 취소

RESET 이전에 취소된 종료 재설정

[표 2-8] HANDLE ABEND 명령어 옵션

핸들링 정보 관리 명령어 그룹

앞서 기술한 HANDLE CONDITION, HANDLE ABEND, IGNORE CONDITION 등의

명령어와 “5.1 터미널” 절의 “터미널 사용 명령어 그룹” 절에서 소개할 HANDLE AID

명령어 등은 어플리케이션 프로그램이 어떤 특정 상황에 이른 경우, 시스템이 어떻게

행동할 지를 지정하는 명령어들이다.

하지만 업무 로직을 구성하다 보면, 일시적으로 설정한 핸들링 정보를 적용시키지 않

길 원하는 경우가 생긴다. 이 때 PUSH HANDLE POP HANDLE 명령어를 사용할 수

있다.

PUSH HANDLE

현재 HANDLE 명령어들로 설정된 내용을 보류하는 명령어이다. 옵션은 없다.

POP HANDLE

PUSH HANDLE 호출을 통해 보류된 HANDLE 명령어들의 설정 내용을 복원하는 명

령어이다. 옵션은 없다.



리소스 복구 명령어 그룹

태스크가 비정상 종료하거나, OSC 어플리케이션 서버 또는 시스템 전체에 문제가 생

겨 재기동하는 경우, 리소스들에 대한 복구가 필요하다. 복구 가능한 리소스들은 마지

막으로 정상 마무리가 된 시점의 상태로 돌아가게 된다.

일반적으로 복구 시점은 태스크를 시작하기 전이지만, SYNCPOINT 명령어를 통해

사용자가 복구 시점을 임의로 지정할 수 있다. 이러한 복구 시점을 기준으로 프로그램

의 흐름이 논리적으로 나뉜 구간을 UOW(Unit of Work) 또는 LUW(Logical Unit of

Work)라 부른다.

SYNCPOINT 명령어를 실행하면 현재 구간에 일어난 모든 작업을 커밋한 뒤 새로운

UOW를 시작한다. SYNCPOINT ROLLBACK 명령어는 현재 구간에서 일어난 모든

복구 가능한 리소스 변경 내용을 롤백한 뒤 새로운 UOW를 시작한다.

RETURN 명령어로 프로그램이 종료하는 경우, 자동으로 커밋이 이루어진다. ABEND

명령어로 프로그램을 종료하거나 예외 조건이 발생하여 비정상 종료하는 경우, 사용

한 복구 가능한 리소스들은 롤백 된다.

OSC 시스템의 모든 리소스들이 복구가 가능한 것은 아니다. OSC 시스템에서 복구

기능을 지원하는 리소스는 다음과 같다.

파일

TSQ(Temporary Storage Queue)

TDQ(Transient Data Queue)

DL/I 데이터베이스

파일은 기본적으로 복구가 가능하고, TSQ, TDQ는 시스템 관리자가 리소스 정의에 설

정한 내용에 따라 복구 여부를 결정할 수 있으며, DL/I 데이터베이스는 HiDB의 특성상

복구가 가능하다.

SYNCPOINT

태스크를 UOW로 나누는 명령어이다. 이전 SYNCPOINT 지점 이후 수정된 모든 복구

가능한 리소스들을 커밋하는 명령어이다. 옵션은 없다.



SYNCPOINT ROLLBACK

태스크를 UOW로 나누는 명령어이다. 이전 SYNCPOINT 지점 이후 수정된 모든 복구

가능한 리소스들을 롤백하는 명령어이다. 옵션은 없다.

내장(Built-in) 기능 명령어 그룹

BIF DEEDIT 명령어는 시스템 내장 기능으로 Deeting, 즉 EBCDIC 데이터 필드 내의

알파벳 및 특수 캐릭터를 제거하고 나머지 숫자들을 오른쪽 나열시키면서 왼쪽 빈 공

간을 0으로 채우는 기능이다.

BIF DEEDIT

Deediting을 처리하는 명령어이다.

옵션 설명

FIELD 편집할 필드 지정

LENGTH 편집할 길이 지정

[표 2-9] BIF DEEDIT 명령어 옵션

제3장 OSC 관리 리소스



3.1 OSC 저장소

OSC 어플리케이션 프로그램은 업무 로직에 필요한 데이터를 관리하기 위하여 프로

그램의 로컬 저장 공간(COBOL의 경우, WORKING-STORAGE SECTION) 외에 서버

가 제공하는 OSC 저장소를 임시로 이용할 수 있다. OSC 저장소는 프로그램 간 데이

터 공유나 한 프로그램에서 수행된 결과를 다른 트랜잭션이나 프로그램으로 전달하는

목적으로도 사용할 수 있어서, 사용자가 서로 연결된 업무를 구성하는데 도움을 준다.

본 절에서는 프로그램 간 데이터 공유를 위한 COMMAREA, TWA를 비롯하여, 프로

그램 및 트랜잭션 간 공유가 가능한 CWA, TCTUA 등에 대하여 설명하고, 이 영역들

을 이용하기 위한 명령어에 대하여 기술한다.

COMMAREA

COMMAREA(Communication Area)는 한 트랜잭션으로 묶여 있는 두 프로그램 간, 또

는 한 터미널로부터 작동되는 두 트랜잭션 간에 데이터를 주고 받을 때 사용한다. 사

용자는 ADDRESS 명령어로 COMMAREA 주소 값을 얻은 뒤 이 영역에 저장된 데이

터에 접근할 수 있다.

COBOL 프로그램에서는 LINKAGE SECTION에 DFHCOMMAREA라는 이름으로 변

수을 선언하면 ADDRESS 명령어를 실행하지 않아도 이 변수를 사용하여

COMMAREA 영역에 접근할 수 있다.

COMMAREA는 다음과 같은 용도로 사용한다.

동일한 트랜잭션 내부에서의 두 프로그램 간의 연결

LINK 또는 XCTL 명령어의 “COMMAREA” 옵션을 통하여 사용자는 원하는 길이

의 데이터를 LINK 또는 XCTL되는 프로그램에 전달한다.

Tmax 클라이언트 프로그램과 OSC 어플리케이션 서버 프로그램 간의 연결



Tmax 클라이언트에서 OSC 어플리케이션 서버 프로그램에 전달한 데이터는 해

당 OSC 어플리케이션 서버 프로그램의 COMMAREA에 저장된다.

같은 터미널에서 시작된 두 트랜잭션 간의 연결

RETURN 명령어의 “COMMAREA” 옵션을 통해 전달한 데이터를 다음에 실행되

는 트랜잭션에서 받을 수 있다.

의사 대화형(pseudo-conversational) 프로그램을 작성할 때 유용한 방법이다.

TWA

TWA(Transaction Work Area)는 트랜잭션이 발생할 때마다 시스템에서 트랜잭션에

할당하는 영역으로 해당 트랜잭션이 활성화되어 있는 동안 접근이 가능하다. 이 공간

은 트랜잭션 내부에서 적은 양의 데이터를 관리하기에 유용하며 다음과 같은 특징을

가지고 있다.

기본 값으로 8,196 바이트의 공간 할당

트랜잭션이 발생할 때마다 “0x00”으로 초기화

WORKING-STORAGE SECTION와 같은 프로그램 영역처럼 사용자 처리 작업으

로 인한 오버헤드 거의 없음

ADDRESS 명령어로 TWA 주소에 접근

영역에 대한 리소스 보호 기능 없음

CWA

CWA(Common Work Area)는 OSC 어플리케이션 서버마다 할당되는 데이터 영역이

다. OSC 어플리케이션 서버가 기동할 때 생성되어 시스템이 활성화되어 있는 동안만

존재한다.

CWA 영역의 특징은 다음과 같다.

설정 파일의 CWA_SIZE 항목에 크기 지정

특정 값으로 초기화되지 않음



사용자 처리로 인한 오버헤드 거의 없음

ADDRESS 명령어로 CWA 주소에 접근


시스템 장애에 대한 복구 기능 없음

모든 트랜잭션에서 동시 접근 가능

이에 대한 대책은 사용자가 직접 마련해야 한다.

TCTUA

TCTUA(Terminal Control Table User Area)는 터미널이 제공하는 사용자 데이터 영역

으로 해당 터미널에서 실행되는 모든 트랜잭션 간에 공유된다.

TCTUA 영역의 특징은 다음과 같다.

기본 값으로 256 바이트의 공간 할당

특정 값으로 초기화되지 않음

사용자 처리로 인한 오버헤드가 거의 없음

ADDRESS 명령어로 TCTUA 주소에 접근


시스템 장애에 대한 복구 기능 없음

OSC 저장소 명령어 그룹

OSC 저장소에 사용자가 접근하려면 해당 영역에 대한 주소 값이 있어야 한다. 해당

영역의 주소 값은 EXEC CICS 구문의 ADDRESS 명령어를 사용하여 받을 수 있다.



ADDRESS

각종 OSC 저장소의 주소 값을 받는 명령어이다.

옵션 설명

COMMAREA COMMAREA 주소 반환

CWA CWA 주소 반환

EIB EIB 주소 반환

TCTUA TCTUA 주소 반환

TWA TWA 주소 반환

[표 3-1] ADDRESS 명령어 옵션

3.2 프로그램

OSC 어플리케이션은 하나 혹은 여러 프로그램들의 조합으로 이루어진다. 여러 프로

그램들로 이루어지는 경우, 프로그램 간 연결이 필요하다. 본 절에서는 OSC 어플리케

이션 서버가 제공하는 프로그램 연결 기능을 사용하기 위한 명령어들을 기술한다.

이어서 설명할 프로그램 연결 명령어를 이용하여 프로그램을 서로 연결 시키기 위해

서는 다음 과정이 필요하다.

Step I. 프로그램을 공유 바이너리 오브젝트로 컴파일한다.

Step II. 공유 바이너리 오브젝트를 TDL(Tmax Dynamic Library) 실행 디렉토리에 위

치시킨다.

Step III. TDL 관련 툴을 이용하여 시스템에 적재한다.

참고: 1.프로그램 컴파일 및 배포에 대한 자세한 내용은 OpenFrame 안내서 중 ”OSC 운영자

안내서”를 참고한다.

2.OSC 어플리케이션 서버는 다른 서버에 위치한 연결된 프로그램을 실행할 수 있는 기

능도 제공하는데 이에 대한 자세한 내용은 “6.4 Distributed Program Link” 을 참고한다.



프로그램 연결 명령어 그룹

LINK

현재 수행 중인 프로그램에서 다른 프로그램을 연결하는 명령어이다. 대상이 되는 프

로그램은 시스템에 의하여 자동으로 메모리에 로딩 및 실행된다. 잠시 대상 프로그램

에 전달되었던 프로그램 제어권은 대상 프로그램의 실행이 완료되면 LINK 명령을 호

출한 프로그램으로 되돌아온다. 제어권이 돌아온 뒤에는 EXEC CICS LINK 명령어 다

음에 오는 프로그램 내용이 실행된다. 필요하다면 명령어 옵션을 사용하여 연결 대상

이 되는 프로그램에 데이터를 넘겨줄 수도 있다.

옵션 설명

PROGRAM 대상 프로그램 이름 지정

COMMAREA 대상 프로그램의 통신 영역으로 전달할 데이터 저장소

LENGTH COMMAREA 길이

DATALENGTH 실제 넘길 COMMAREA 저장소의 데이터 길이

INPUTMSG 대상 프로그램에서 첫 RECEIVE 명령어를 통해 받을 데이터 지정

INPUTMSGLEN INPUTMSG에 넘길 길이 지정

SYSID 대상 프로그램이 있는 시스템의 식별자

[표 3-2] LINK 명령어 옵션

XCTL

현재 수행 중인 프로그램을 종료하고 다른 프로그램을 연결하는 명령어이다. 대상 프

로그램에서 RETURN을 호출하더라도 LINK 명령어와 달리 호출한 프로그램으로 제

어권이 돌아가지 않는다.

옵션 설명

PROGRAM 제어권이 넘겨질 프로그램 이름

COMMAREA 연결될 프로그램의 통신 영역으로 넘길 데이터 저장소 이름


INPUTMSG 다음에 연결되는 프로그램에서 첫 RECEIVE 명령어에서 받을 데이터 지정


[표 3-3] XCTL 명령어 옵션



RETURN

현재 수행 중인 프로그램을 종료하고 이전에 수행했던 프로그램으로 제어권을 돌려주

는 명령어이다. 제어권을 돌려줄 대상이 없는 경우, 어플리케이션 서버로 제어권이 돌

아간다.

옵션 설명

TRANSID 해당 터미널에서 다음 터미널 입력을 받을 경우 실행되는 트랜잭션 ID

COMMAREA TRANSID에 설정된 트랜잭션이 COMMAREA로 받을 데이

터 저장소 이름


IMMEDIATE 현재 터미널과 관련하여 어떤 트랜잭션이 대기 상태에 있더

라도, TRANSID에 설정된 트랜잭션이 먼저 실행

INPUTMSG 다음에 연결되는 프로그램에서 첫 RECEIVE 명령어에서 받을 데이터 지정


[표 3-4] RETURN 명령어 옵션

참고: 개방형 환경의 운영 체제의 특성으로 인해 OSC 시스템은 프로그램 연결 시 디스크에서

메모리로 바로 리소스가 로딩되는 작동 구조를 갖고 있다. 프로그램 로딩 및 릴리즈를 위

한 LOAD 및 RELEASE 명령어는 내부적으로 아무런 작업을 수행하지 않는다.

3.3 태스크

OSC 어플리케이션은 일반적으로 클라이언트의 트랜잭션 요청에 의하여 실행된다.

트랜잭션 요청은 서버로 하여금 일련의 작업을 처리하게 하는데, 이러한 일련의 작업

을 태스크라 한다.

트랜잭션 기동 명령어 그룹

일반적인 트랜잭션 요청은 클라이언트에 의해 직접 이루어진다. 하지만 태스크를 수

행 중인 OSC 어플리케이션 프로그램 내에서 새로운 트랜잭션을 요청하기도 한다. 시

간 옵션을 주어 기동 시각을 지정하거나 새로운 트랜잭션에 데이터를 넘길 수도 있다.

또한 OSC 어플리케이션 서버는 아직 기동되지 않은 트랜잭션 요청을 취소할 수 있는



기능도 제공한다.

START

특정 트랜잭션을 지정한 시각에 실행할 것을 시스템에 요청하는 명령어이다.

옵션 설명

INTERVAL

태스크가 시작될 기간을 Packed Decimal로 지정

TIME

태스크가 시작될 시각을 Packed Decimal로 지정

AFTER {HOURS|MINUTES|SECOND}

바이너리 값으로 시작 기간 지정

AT{HOURS|MINUTES|SECOND} 바이너리 값으로 시작 시각 지정

FROM

START될 태스크에서 RETRIEVE로 받을 데이터 영역

LENGTH FROM 옵션으로 넘길 데이터의 길이

TRANSID START 요청할 트랜잭션 이름

TERMID

START 요청할 트랜잭션이 첨부될 터미널 이름

QUEUE

START 요청으로 사용될 큐 이름 지정(현 5.0 버전은 TSQ 사용 안함)

REQID

요청에 대한 식별자(이 식별자를 이용하여 만기되지 않은 START 요청 CANCEL 가능)

RTERMID

TRANSID에 지정된 START된 트랜잭션이 기동된 경우 RETRIEVE에서 받을 터미널 식별자

RTRANSID

TRANSID에 지정된 START된 트랜잭션이 기동된 경우 RETRIEVE에서 받을 트랜잭

션 식별자

SYSID START를 요청할 Tmax 노드 식별자 지정

[표 3-5] START 명령어 옵션

RETRIEVE

START 명령어로 기동된 트랜잭션이 START의 각종 옵션을 통하여 넘겨진 데이터를

받아오는 명령어이다.



옵션 설명

INTO 받을 데이터의 저장소 지정

SET 받을 데이터가 저장된 장소의 포인터 참조 값

LENGTH 데이터 저장소의 길이 지정

RTERMID 다음에 연결되는 START 명령어의 TERMID에서 사용할 수 있는 TERMID 값 지정

RTRANSID 다음에 연결되는 START 명령어의 TRANSID에서 사용할 수 있는 TRANSID 값 지정

[표 3-6] RETRIEVE 명령어 옵션

DELAY

특정 시각까지 또는 기간 동안 태스크의 실행을 지연시키는 명령어이다.

옵션 설명

INTERVAL

태스크가 지연될 기간을 Packed Decimal로 지정

TIME

태스크가 지연이 종료될 시각을 Packed Decimal로 지정

FOR {HOURS|MINUTES|SECONDS}

바이너리 값으로 지연 기간 지정

UNTIL{HOURS|MINUTES|SECONDS} 바이너리 값으로 지연 끝날 시각 지정

REQID

요청에 대한 식별자(이 식별자를 이용하

여 만기되지 않은 START 요청 CANCEL 가능)

[표 3-7] DELAY 명령어 옵션

CANCEL

DELAY 또는 START 명령어의 요청을 취소하는 명령어이다. DELAY 명령어에서 연

기 요청된 시간이 지났거나, START 명령어에서 요청한 기동 시각이 지난 요청은 취

소가 불가능하다.

옵션 설명

REQID 취소할 REQID 지정

[표 3-8] CANCEL 명령어 옵션



태스크 순번화 명령어 그룹

OSC 어플리케이션 서버는 다수의 서버 프로세스를 활용하여 태스크를 병렬적으로

처리하기 때문에 여러 태스크가 동시에 같은 리소스에 접근하는 일을 막기 위해 다음

과 같이 리소스를 중심으로 태스크들을 순번화시킨다.

1. 태스크 T가 ENQ 명령어로 특정 이름의 리소스 R을 선점한다.

2. 다른 태스크 U가 리소스 R을 선점하기 위해 ENQ 명령어를 실행한다.

3. 태스크 T가 리소스 R을 선점하고 있기 때문에 태스크 U는 대기 상태에 돌입힌다.

4. 태스크 T가 DEQ 명령어로 리소스 R에 대한 선점을 해제한다.

5. 태스크 U가 대기 상태에서 빠져 나와 리소스 R을 선점한다.

ENQ 명령어로 선점된 리소스는 사용자가 직접 DEQ 명령어를 호출하지 않아도 해당

UOW 또는 태스크가 끝날 때 자동으로 해제된다. 이 선점 지속 시간은 ENQ 명령어의

옵션으로 지정할 수 있다.

현재 OSC 어플리케이션 서버는 ENQ 명령어를 통한 리소스 선점이 리소스 이름으로

만 가능하므로 “LENGTH” 옵션을 필수적으로 지정해 주어야 한다.

ENQ

리소스에 대한 선점을 요청하는 명령어이다.

옵션 설명

RESOURCE 선점하려는 리소스 이름 지정

LENGTH 리소스 이름으로 선점할 경우 길이 지정

UOW|TASK|MAXLIFETIME UOW 또는 태스크 단위의 리소스 선점 지속 시간 지정 MAXLIFETIME은 CVDA 값을 이용하여 지속 기간 지정

NOSUSPEND 다른 사용자가 리소스를 사용하고 있으면 기다리

지 않고 ENQBUSY 상태로 명령어에서 나옴

[표 3-9] ENQ 명령어 옵션



DEQ

리소스 선점을 해제하는 명령어이다.

옵션 설명

RESOURCE ENQ 명령어로 선점한 리소스 이름 지정

LENGTH 리소스 이름으로 선점한 경우 길이 지정

UOW|TASK|MAXLIFETIME 선점을 해제할 리소스의 선점 지속 시간 지정 MAXLIFETIME은CVDA 값을 이용하여 지속 기간 지정

[표 3-10] DEQ 명령어 옵션

3.4 동적 영역

OSC 어플리케이션 서버는 어플리케이션 프로그램 실행 시, 고정된 크기의 프로그램

로컬 영역(COBOL 프로그램의 경우, WORKING-STORAGE SECTION)을 할당하고,

프로그램은 이 영역을 활용하여 업무 로직을 구성한다. 하지만 업무 로직에 따라 동적

영역을 할당받아 사용하는 것이 더 효율적이거나 유용한 경우도 있다. 이를 위해 OSC

어플리케이션 서버는 프로그램이 메모리를 동적으로 할당받을 수 있는 기능을 제공한

다. 할당받을 수 있는 메모리 저장 공간은 1바이트부터 정수형의 최대 값까지 가능하

다. 이 크기는 요청 시점의 시스템 상태에 제한 받을 수 있다.

할당된 공간은 일반적으로 태스크 단위로 시스템에 자동 반환되지만, “SHARED” 옵

션을 지정하면 태스크 종료 후에도 반환되지 않고, 태스크 간에 데이터를 주고 받을

수 있는 공간으로 활용할 수 있다. “SHARED” 옵션의 기능은 IBM CICS Transaction

Server 기능과 약간의 차이가 있으므로, “태스크 간 메모리 공유” 절을 참고한다.

동적 영역 할당 명령어 그룹

GETMAIN

동적 메모리 할당을 요청하는 명령어이다. 설정에 따라 프로세스 영역이나 시스템 공

유 메모리 영역(SWA)에서 메모리를 할당받을 수 있다.

참고: 자세한 설정 방법은 OpenFrame 안내서 중 ”OSC 운영자 안내서”를 참고한다.



할당받은 메모리의 반환 시점은 “SHARED” 옵션의 유무에 따라 달라진다. “SHARED”

옵션을 지정하지 않으면 FREEMAIN 명령어를 호출하지 않더라도 태스크 종료 시점

에 자동으로 반환된다. “SHARED” 옵션을 지정하면 사용자가 직접 FREEMAIN 명령

어를 사용하여 메모리를 반환해야 한다.

옵션 설명

SET 할당될 포인터 참조 값 지정

FLENGTH|LENGTH 받아올 데이터 영역의 크기 지정

INITIMG 초기화 값 지정

SHARED 사용자가 직접 FREEMAIN을 호출해야 반환되도록 지정

[표 3-11] GETMAIN 명령어 옵션

FREEMAIN

GETMAIN으로 할당 받은 저장 공간을 사용자가 명시적으로 반환하는 명령어이다.

옵션 설명

DATA|DATAPOINTER DATA는 반환될 영역 지정 DATAPOINTER는 반환될 영역의 주소 지정

[표 3-12] FREEMAIN 명령어 옵션

태스크 간 메모리 공유

“SHARED” 옵션을 지정하여 GETMAIN으로 받은 저장 공간은 태스크 간 데이터 전달

을 위해 활용할 수 있다.

한편, OSC 어플리케이션 서버의 각 태스크는 서로 다른 서버 프로세스에 의해 실행되

기 때문에 현재 태스크에서 사용하는 메모리 주소를 다른 태스크에 전달하더라도 상

대 태스크에서 동일한 메모리 공간을 접근하리라는 보장이 없다. 동일한 메모리 공간

에 접근하도록 하려면 ENCODEMAIN, DECODEMAIN 함수를 사용하여 메모리 주소

를 변환하여 전달해야 한다.

ENCODEMAIN 함수는 GETMAIN 명령어로 받은 메모리 특정 주소를 다른 태스크에

서 DECODMAIN 함수로 역변환해서 접근할 수 있도록 주소 변환 역할을 수행한다.



ENCODEMAIN 함수에 다른 프로세스와 공유하기 위한 메모리 블럭의 주소 값과 상

대 주소 값을 받아올 정수 변수의 참조를 전달하면 ENCODEMAIN 함수는 받아온 주

소 값을 상대 주소 값으로 변환해서 넘겨 준 정수 변수에 넣어주게 된다.

ENCODEMAIN 함수의 사용 예제는 다음과 같다.

. . .

WORKING-STORAGE SECTION.

01 PTR USAGE IS POINTER.

01 OFFSET PIC S9(9) COMP.

PROCEDURE DIVISION.

. . .

CALL "cics_encodemain" USING BY VALUE PTR

BY REFERENCE OFFSET.

. . .

상대방 어플리케이션 프로그램에서는 시스템 저장소 등을 통해서 넘겨받은 상대 주소

를 DECODEMAIN 함수를 통해 변환한 후 해당 메모리에 접근한다. DECODEMAIN

함수에 메모리 주소를 받아올 변수의 참조와 정수 타입으로 된 상대 주소를 넣어주게

되면 DECODEMAIN 함수에서 받아온 상대 주소를 절대 주소로 변환해서 받아온 메

모리 주소의 참조에 넣어준다.

DECODEMAIN 함수의 사용 예제는 다음과 같다.

. . .

WORKING-STORAGE SECTION.

01 PTR USAGE IS POINTER.

01 OFFSET PIC S9(9) COMP.

PROCEDURE DIVISION.

. . .



CALL "cics_decodemain" USING BY REFERENCE PTR

BY VALUE OFFSET.

. . .

3.5 임시 저장 큐(TSQ)

TSQ(Tempoary Storage Queue)는 사용자가 큐(queue) 형식의 데이터 구조에 데이터

를 저장하거나 큐 데이터 전체를 삭제할 수 있도록 제공하는 리소스이다.

TSQ는 OSC 어플리케이션 서버가 미리 준비해 놓지 않고 큐의 첫 레코드 데이터가

작성될 때 생성된다. 따라서 이미 속성이 정의된 리소스들과 달리 큐가 생성될 때 각

큐의 개별 속성이 정해진다. 큐의 속성은 크게 다음과 같이 구분할 수 있다.

저장소: MAIN 또는 AUXILIARY

복구 여부: RECOVERABLE 또는 NON-RECOVERABLE

TSQ는 큐 데이터를 다른 대상 저장소(Destination)에서 관리한다는 특징이 있다.

데이터 저장소는 다음 두 가지로 나뉜다.

MAIN: 큐 내용은 서버 설정에 지정된 공유 메모리 영역에서 관리된다.

AUXILIARY: 큐 내용은 서버 설정에 지정된 QINFO, QDATA 등 두 TSAM 데이터

셋을 이용하여 관리된다.

저장소는 다르지만 어플리케이션에서 사용하는 방법은 동일하다. MAIN 저장소는 시

스템 공유 메모리에 구성이 되므로 TSAM 데이터 셋을 사용하는 AUXILIARY 저장소

보다 훨씬 빠른 I/O 성능을 제공한다. AUXILIARY 저장소는 성능은 느리지만, 트랜잭

션 단위의 복구가 가능할 뿐만 아니라, 시스템 재기동 시에도 이전 정보가 그대로 남

아 있다는 장점이 있다. AUXILIARY 저장소에 저장된 큐는 RECOVERABLE 또는

NON-RECOVERABLE 속성을 선택할 수 있는 반면, MAIN 저장소는 NON-

RECOVERABLE한 속성을 갖는다.

저장소에 대한 속성은 EXEC CICS WRITEQ TS 명령어에서 MAIN 또는 AUXILIARY

옵션을 설정하거나 TSMODEL 리소스 정의에 설정함으로써 지정할 수 있다. 그 밖의

경우에는 기본값으로 AUXILIARY가 지정된다. 이 기본값은 서버 설정의 [TSQ] 절의



DFLTDEST 항목을 MAIN으로 설정함으로써 변경 가능하다.

복구 여부 속성은 TSMODEL 리소스 정의에 의해 결정되는데, TSMODEL이 없는 경

우에는 NON-RECOVERABLE로 설정된다.

TSQ 리소스는 Function Shipping의 대상이므로, 한 어플리케이션 서버에서 작동하는

어플리케이션에서 다른 서버에 있는 TSQ에 접근하는 것이 가능하다. 이에 대한 자세

한 내용은 “6.3 Function Shipping” 절을 참고한다.

TSQ 및 TSMODEL 접근 명령어 그룹

사용자는 어플리케이션 프로그램을 통하여 TSQ의 데이터를 읽고, 쓰고, 삭제할 수 있

다. TSQ 이름은 최대 16바이트까지 지원한다. 8바이트까지는 QUEUE 옵션을 사용하

여 이름을 지정하고, 최대 16바이트까지 사용하는 경우에는 QNAME 옵션을 사용한

다. 단순히 큐 이름의 길이에 따라 옵션을 달리하여 지정한다.

DELETEQ TS

특정 TSQ를 삭제하는 명령어이다. 해당 큐가 가지고 있는 모든 내용 또한 함께 삭제

된다.

옵션 설명

QUEUE 1~8바이트의 문자열로 삭제할 큐 이름 지정

QNAME 1~16바이트의 문자열로 삭제할 큐 이름지정

SYSID Function shipping할 SYSID 지정

[표 3-13] DELETEQ TS 명령어 옵션

READQ TS

특정 TSQ의 데이터를 읽어오는 명령어이다. “ITEM” 번지 수를 지정하여 저장된 레코

드를 읽어올 수도 있고, “NEXT” 옵션을 이용하여 차례로 다음 레코드를 읽어오는 순

차 검색도 지원한다. 레코드를 읽더라도 큐에서 데이터가 삭제되지 않는다.

옵션 설명

QUEUE 1~8바이트의 문자열로 읽으려고 하는 큐 이름 지정



옵션 설명

QNAME 1~16바이트의 문자열로 읽으려고 하는 큐 이름 지정

INTO 읽어올 데이터의 저장소 지정

SET 읽어올 데이터가 저장된 장소의 포인터 참조 값 지정. 저장소는 시스템이 할당한다.

LENGTH 읽어올 데이터의 저장소 길이 지정

NUMITEMS 큐에 쌓인 데이터 레코드의 개수 반환

NEXT 순차적으로 다음 레코드를 읽어오기

ITEM 읽어올 레코드의 번지 수


[표 3-14] READQ TS 명령어 옵션

WRITEQ TS

지정한 TSQ에 데이터를 기록하는 명령어이다. 기존 생성된 TSQ가 없는 경우, 큐가

동적으로 생성되고, 동적으로 생성된 큐에 데이터가 쌓인다. “REWRITE” 옵션이 없는

경우, 단순히 큐에 데이터가 쌓이는 형식으로 저장되고, “REWRITE” 옵션을 지정할

경우, 기존에 작성된 레코드를 덮어쓴다.

옵션 설명

QUEUE 1~8바이트의 문자열로 기록할 큐 이름 지정

QNAME 1~16바이트의 문자열로 기록할 큐 이름지정

FROM 기록할 데이터의 저장소 지정

LENGTH 기록할 데이터 길이 지정

NUMITEMS 큐에 쌓인 데이터 레코드의 개수 반환

ITEM 기록할 레코드의 번지 수

REWRITE 특정 번지 수의 레코드를 덮어쓰려는 경우 지정

AUXILIARY 데이터 셋에 TSQ 저장

MAIN 메모리에 TSQ 저장


[표 3-15] WRITEQ TS 명령어 옵션



INQUIRE TSQUEUE|TSQNAME

특정 TSQ에 대한 정보를 읽어오는 시스템 명령어이다.

옵션 설명

TSQUEUE 1~8바이트의 문자열로 조회하려고 하는 큐 이름 지정

TSQNAME 1~16바이트의 문자열로 조회하려고 하는 큐 이름 지정

FLENGTH 해당 큐의 전체 길이 반환

LASTUSEDINT 마지막으로 큐가 사용된 시간과 현재 시간과의 간격 반환

LOCATION 저장소

MAXITEMLEN 저장된 레코드 중 최대 레코드 길이 반환

MINITEMLEN 저장된 레코드 중 최소 레코드 길이 반환

NUMITEMS 저장된 총 레코드 개수

RECOVSTATUS 복구 가능 정보

TRANSID 큐를 처음 생성한 트랜잭션 ID

[표 3-16] INQUIRE TSQUEUE|TSQNAME 명령어 옵션

SET TSQUEUE|TSQNAME

특정 TSQ를 관리하는 명령어이다. DELETEQ TS와 달리 마지막으로 큐가 사용된 시

간과 현재 시간과의 간격을 조건으로 지정하여 큐를 삭제할 수 있다..

옵션 설명

TSQUEUE 1~8바이트의 문자열로 조회하려고 하는 큐 이름 지정

TSQNAME 1~16바이트의 문자열로 조회하려고 하는 큐 이름 지정

ACTION 어떤 액션을 취할 지 CVDA 값 지정. CVDA 값 중 현재 DELETE 값만 지원한다.

LASTUSEDINT 마지막 사용 시간 간격이 지정된 값 이상인 경우에만 삭제

DELETE CVDA 값 대신 큐 삭제 명령

[표 3-17] SET TSQUEUE|TSQNAME 명령어 옵션

INQUIRE TSMODEL

TSMODEL에 대한 리소스 정보를 가져오는 명령어이다. TSMODEL에 대한 자세한 내

용은 다음 “TSMODEL 리소스 정의” 절을 참고한다.



옵션 설명

TSMODEL 열람하려는 TSMODEL 지정

LOCATION 해당 TSMODEL에 매치되는 큐의 저장소 정보 반환

PREFIX 모델에 대한 접두사 반환

RECOVSTATUS 복구 여부 정보 반환

[표 3-18] INQUIRE TSMODEL 명령어 옵션

TSMODEL 리소스 정의

앞서 설명했듯이, TSQ는 다른 리소스와 다르게 동적으로 생성된다. 동적으로 생성되

는 시점에 명령어의 옵션이나 시스템의 설정에 따라 그 속성이 정해진다. 하지만, 명

령어에서 특정 옵션이 지정되지 않은 경우, 이미 해당되는 TSMODEL 정의가 있으면

TSMODEL 정보에 따라 TSQ의 속성이 결정된다.

TSMODEL은 미리 TSQ 속성을 지정해 두고, 생성하는 TSQ 이름이 특정 문자열로 시

작하는 경우 해당 리소스 정의의 설정이 적용되는 방식을 취한다.

다음은 TSMODEL 리소스 정의에 사용되는 키워드 및 키워드에 해당하는 설명이다.

키워드 설명

TSMODEL TSMODEL 이름 (최대 8바이트)

GROUP 리소스 정의 그룹 (최대 8바이트)

DESCRIPTION TSMODEL 설명 (최대 58바이트)

LOCATION 이 모델의 적용을 받는 TSQ의 저장 공간 설정. 디스크 또는 메모리로 설정 가능(AUX|MAIN)

PREFIX 이 모델의 적용을 받을 TSQ의 접두사 규칙 설정 (최대 16바

이트)

RECOVERY 이 모델의 적용을 받는 TSQ의 오류 발생시 복구 여부 설정

[표 3-19] TSMODEL 리소스 정의 정보



3.6 데이터 전송 큐(TDQ)

TDQ(Transient Data Queue)는 데이터 전송을 위하여 데이터를 쌓는 큐이다.

다음과 같은 용도로 사용한다.

OSC 어플리케이션 간의 데이터 통신

OSC와 다른 시스템과의 연계 시 데이터를 일시적으로 저장

UNIX 파일의 로그 형태로 데이터를 쌓는 기능

TDQ는 기능적인 특징에 따라 Intra-partition, Extra-partition, Log 등 세 가지 타입으로

분류할 수 있고, 관리 측면에서 유용한 Indirect, Remote 등을 포함하여 총 다섯 가지

의 타입으로 분류할 수 있다. OSC 어플리케이션 서버에서 사용되는 모든 TDQ의 특

성은 TDQUEUE 리소스 정의에 지정되어야 한다.

기본적으로 다음과 같은 항목이 필요하다.

키워드 설명

TDQUEUE TDQ 이름(최대 4바이트)

GROUP 리소스 정의 그룹(최대 8바이트)

DESCRIPTION TDQ 설명(최대 58바이트)

TYPE 큐 타입(EXTRA|INTRA|LOG|INDIRECT) 중 선택. 선택 값이 없는 경우 REMOTE로 지정됨

[표 3-20] TDQUEUE 리소스 정의 정보

Intra-partition TDQ

TDQUEUE 리소스 정의에서 TYPE을 INTRA로 지정한 TDQ로, OSC 어플리케이션 간

에 데이터를 주고 받는데 사용된다. OSC 어플리케이션 서버는 Intra-partition TDQ에

저장되는 레코드를 TSAM 데이터 셋을 통하여 관리한다.

Intra-partition TDQ에는 리소스 정의에 RECOVSTATUS를 설정하여 장애 발생시 복구

가능하게 할 수 있다.

Intra-partition TDQ가 다른 TDQ와 구별되는 또 다른 특징으로 ATI(Automatic



Transaction Initiation) 기능이 있다. 이는 큐에 쌓인 레코드 개수가 리소스 정의에 설

정된 값에 이르면 지정된 트랜잭션을 자동으로 기동시키는 기능이다.

다음은 Intra-partition TDQ 리소스에 사용되는 키워드 및 키워드에 해당하는 설명이다.

키워드 설명

ATIFACILITY ATI가 발생할 때 트랜잭션의 대상으로 TERMINAL 또는 FILE로 지정. TERMINAL인 경우는 해당 터미널로 트랜잭션

을 발생시키며, FILE인 경우에는 터미널 없이 트랜잭션만 발생시킨다.

FACILITYID ATIFACILITY가 TERMINAL인 경우 대상 TERMINAL의 ID

RECOVSTATUS 오류 발생시 복구 여부

TIGGERLEVEL ATI 기능을 통해 트랜잭션이 발생되는 TDQ 레코드 개수

TRANSID ATI 기능을 통해 발생되는 트랜잭션 ID

[표 3-21] Intra-partition TDQ 정보

Extra-partition TDQ

OSC 시스템 내부의 데이터 공유가 아닌, 다른 시스템에 데이터를 보내기 위한 목적으

로 사용된다. TDQ 리소스 정의에서 TYPE을 EXTRA로 정의한다.

Extra-partition TDQ에 저장한 데이터는 OSC 어플리케이션 서버의 SYSOUT 데이터

셋에 쓰여진다. 이는 서버의 JOBID를 기반으로 OpenFrame 시스템의 SPOOL 디렉토

리에 DDNAME에 따라 저장된다.

다음은 Extra-partition TDQ 리소스에 사용되는 키워드 및 이에 해당하는 설명이다.

키워드 설명

DDNAME DD명(최대 8바이트)

SYSOUTCLASS SYSOUT 데이터 셋의 클래스 지정(*|blank|문자 하나)

RECORDSIZE 레코드 크기(기본 값은 1, 최대 32,767)

RECORDFORMAT 레코드 포맷([blank|FIXED|VARIABLE])

BLOCKSIZE 블록 크기(레코드 포맷이 VARIABLE인 경우 8,972 초과 안됨, VARIABLE이 아닌 경우 8,976 미만이어야 함)

BLOCKFORMAT 블록 포맷([blank|BLOCKED|UNBLOCKED])

PRINTCONTROL 컨트롤 문자 지정([blank|ASA|MACHINE])

DISPOSITION 데이터 셋 disposition 정보([SHR|OLD|MOD])

[표 3-22] Extra-partition TDQ 정보



Log TDQ

Log TDQ는 OSC 어플리케이션 프로그램에서 로그 기능으로 사용할 수 있는 TDQ 리

소스 타입이다. Extra-partition TDQ가 어플리케이션 프로그램이 로그를 남기는 용도

로 많이 사용된다는 점에 착안하여 파일 I/O 성능을 개선하여 추가된 기능이다. Log

TDQ는 TDQ 리소스 정의에서 TYPE을 LOG로 정의한다.

OSC 어플리케이션 서버마다 설정된 OSCTLSVR 시스템 서버가 해당 서버의 모든

Log TDQ의 I/O 처리를 담당한다. 어플리케이션 프로그램에서 해당 TDQ에 데이터를

기록하면, 서버 이름과 동일한 SPOOL 디렉토리의 지정된 DDNAME과 동일한 이름의

파일에 데이터가 순차적으로 쌓인다. 이 때 OSCTLSVR 시스템 서버가 여러 프로세스

에서 저장하는 데이터를 내부적으로 버퍼링하여 파일에 기록하므로 전체 시스템 부하

를 줄일 수 있다. 어플리케이션 서버와 OSCTLSVR 시스템 서버는 TCP/IP 통신을 한

다.

다음은 Log TDQ 리소스에 사용되는 키워드 및 키워드에 해당하는 설명이다.

키워드 설명

DDNAME DD명(최대 8바이트)

[표 3-23] Log TDQ 정보

Indirect TDQ

Indirect TDQ는 시스템 관리적인 면에서 유용한 TDQ로, TDQ 리소스 정의에서 TYPE

을 INDIRECT로 정의한다.

어플리케이션 프로그램에서 해당 TDQ를 사용하면 INDIRECTNAME에 지정된 큐를

사용하는 것과 동일한 효과를 나타낸다.

다음은 Indirect TDQ 리소스에 사용되는 키워드 및 키워드에 해당하는 설명이다.

키워드 설명

INDIRECTNAME 간접적으로 가리키는 큐 이름(최대 4바이트)

[표 3-24] Indirect TDQ 정보



Remote TDQ

어플리케이션 프로그램은 원격 어플리케이션 서버에 있는 TDQ를 접근할 수 있다.

Function Shipping의 대상으로 쓰이는 TDQ는 Remote로 설정해야 한다. Function

Shipping 기능에 대해서는 “6.3 Function Shipping” 절에서 다룬다. Remote TDQ로 지

정할 경우, 해당 TDQ 리소스 정의의 TYPE에 아무것도 지정하지 않고,

REMOTESYSTEM에 원격 어플리케이션 서버를 지정한다.

다음은 Remote TDQ 리소스에 사용되는 키워드 및 키워드에 해당하는 설명이다.

키워드 설명

REMOTESYSTEM 원격 TDQ인 경우 원격 TDQ가 위치한 시스템의 SYSID (최대 4바이트)

REMOTENAME 원격 시스템에서 사용하는 TDQ 이름 (최대 8바이트)

[표 3-25] Remote TDQ 정보

TDQ 접근 명령어 그룹

TDQ 접근 방법은 타입에 따라 약간씩 다르지만, 기본적으로 DELETEQ TD, READQ

TD, WRITEQ TD 등 각각 TDQ의 데이터를 삭제하고, 레코드를 읽어오고, 새로운 레

코드를 기록하는 명령어들을 지원한다.

DELETEQ TD

TDQ를 삭제하는 명령어이다. Intra-partition TDQ 및 이를 가리키는 Indirect TDQ와 원

격 Intra-partition TDQ에 대해서만 삭제 기능을 지원한다.

옵션 설명

QUEUE 큐 이름 지정

SYSID 원격 시스템 식별자 지정

[표 3-26] DELETEQ TD 명령어 옵션



READQ TD

TDQ의 레코드를 읽는 명령어이다. Intra-partition TDQ 및 이를 가리키는 Indirect TDQ

와 원격 Intra-partition TDQ에 대해서만 읽기 기능을 지원한다.

옵션 설명


INTO 읽어올 데이터의 저장소 지정

SET 읽어올 데이터가 저장된 장소의 포인터 참조 값 지정

LENGTH 읽어올 INTO 데이터 저장소의 최대 길이 지정

SYSID 읽어올 원격 TDQ의 시스템 식별자 지정

[표 3-27] READQ TD 명령어 옵션

WRITEQ TD

TDQ에 레코드 데이터를 기록하는 명령어이다. 모든 TDQ 타입에 이 명령어를 사용할

수 있다.

옵션 설명


FROM 큐에 기록할 데이터 저장소 지정

LENGTH 기록할 데이터의 길이 지정

SYSID 기록할 원격 TDQ의 시스템 식별자 지정

[표 3-28] WRITEQ TD 명령어 옵션

3.7 TACF

OSC 어플리케이션 서버의 운영 목적에 따라 많은 사용자가 접속하는 경우 다음과 같

은 보안 위협이 있을 수 있다.

시스템이나 데이터로의 권한이 없는 접근

원하지 않는 정보 공개

허용되어서는 안 되는 데이터 수정

데이터 삭제 및 파괴



이러한 문제가 발생하지 않도록 하기 위해 시스템 운영자는 중요한 데이터를 특정 사

용자들로부터 보호하도록 설정할 수 있다.

OSC 어플리케이션 서버의 보안 기능은 TACF(Tmax Access Control Facility)를 기반

으로 한다. TACF는 OpenFrame 시스템에 접근하려는 사용자에 대한 인증 과정을 통

해 허가되지 않은 사용자로부터 시스템을 보호하고, 권한이 없는 사용자로부터 시스

템상의 리소스에 대한 부적절한 접근을 차단하는 기능을 제공한다. TACF 제품은 IBM

RACF(Resource Access Control Facility) 제품에 대응하는 OpenFrame 제품으로,

TACF가 기본적인 접근 제어 및 권한 인증 기능을 제공하고, OSC 어플리케이션 서버

의 TACF 리소스 모듈이 보안 규칙을 적용한다.

서버마다 보안 체크 기능을 다르게 지정할 수 있으며, 이는 설정 파일의 [OSC_SAF]

절의 설정을 통하여 가능하다. [OSC_SAF] 절의 SEC 항목은 전체 보안을 사용할 것

인지를 선택하고, XTRAN 항목은 트랜잭션에 대한 보안 기능을 이용할 것인지를 지정

한다.

참고: 보안 설정에 대한 자세한 내용은 OpenFrame 안내서 중 “OSC 운영자 안내서”를 참고한

다.

사용자 프로파일 등록

TACF 보안의 기본은 특정 사용자가 어떤 리소스를 사용할 수 있는지를 확인하는 것

이다. TACF 시스템은 사용자와 리소스 정보, 사용자와 리소스 사이에 설정된 보안 규

칙을 가지고 있다.

사용자 및 리소스는 TACF에 사용자 프로파일과 리소스 프로파일로 저장된다. 어떤

사용자, 또는 사용자 그룹이 특정 리소스에 접근이 가능한지에 대한 정보는 접근 리스

트(Access List)에 저장된다. 이 정보들은 OSC 어플리케이션 서버와 별개로 TACF 운

영자가 등록해야 한다.

참고: 프로파일 등록 및 관리 방법에 대해서는 OpenFrame 안내서 중 “TACF 운영자 안내서”를

참고한다.



사용자 인증 명령어 그룹

사용자가 특정 리소스에 접근할 수 있는지를 확인하기 위해서 현재 누가 시스템을 사

용하고 있는지 시스템에 알려 주어야 한다. 이는 SIGNON 과정을 통해서 이루어지는

데, 터미널을 이용하는 경우 OESN 트랜잭션을 요청하여 원하는 사용자로 SIGNON

이 가능하다. 그 외의 경우, 어플리케이션에서 SIGNON 명령어를 호출하여 특정 사용

자로 SIGNON할 수 있다.

SIGNON에 대응하는 SIGNOFF 과정은 더 이상 그 사용자로 시스템을 사용하지 않음

을 알리는 것으로, OESF 트랜잭션 또는 어플리케이션 프로그램의 SIGNOFF 명령어

에 의해 이루어진다.

참고: OESN/OESF 트랜잭션에 대해서는 OpenFrame 안내서 중 ”OSC Supplied Transaction

참조 안내서”를 참조한다.

본 절에서는 어플리케이션 프로그램에서 사용하는 SIGNON 및 SIGNOFF 명령어를

설명한다.

SIGNON

특정 사용자의 ID를 인증하는 명령어이다.

옵션 설명

USERID SIGNON하려는 사용자 식별자 지정

GOUPID 사용자를 어떤 TACF 그룹에 SIGNON할 지 지정

PASSWORD 현재 패스워드 지정

NEWPASSWORD 새로운 패스워드 지정

[표 3-29] SIGNON 명령어 옵션

SIGNOFF

특정 사용자의 ID에 대한 인증을 해제하는 명령어이다. 명령어 외에 다른 명령어 옵션

은 없다.

특정 사용자로 SIGNON 하지 않고 시스템을 사용하는 경우, 모든 업무는 해당 서버

설정의 [OSC_SAF] 절 아래의 DFLTUSER 항목에 지정된 디폴트 사용자 ID로 이루어

진다.



패스워드 명령어 그룹

사용자 인증과 별도로 특정 사용자의 패스워드를 수정하거나 확인할 수 있는 기능을

제공한다.

CHANGE PASSWORD

특정 사용자의 패스워드를 수정하는 명령어이다. 변경하려면 기존에 시스템에 설정된

패스워드가 필요하다.

옵션 설명

PASSWORD 현재 패스워드 지정

NEWPASSWORD 변경할 새로운 패스워드 지정

USERID 패스워드를 변경할 사용자 식별자 지정

[표 3-30] CHANGE PASSWORD 명령어 옵션

VERIFY PASSWORD

지정한 패스워드가 사용자의 패스워드와 일치하는지 확인하는 명령어이다. 일치하는

경우, 사용자에 대한 자세한 보안 관련 정보를 얻을 수 있다.

옵션 설명

PASSWORD 체크할 패스워드 지정

USERID 체크할 사용자 식별자 지정

CHANGETIME 언제 마지막으로 패스워드가 변경되었는지 ABSTIME으로 반환

DAYSLEFT 패스워드가 만기될 때까지 남은 날짜

EXPIRYTIME 패스워드 만기 시간이 ABSTIME으로 반환

INVALIDCOUNT 유효하지 않은 패스워드가 입력된 횟수

LASTUSETIME 지정한 사용자로 마지막 접근된 시간을 ABSTIME으로 반환

[표 3-31] VERIFY PASSWORD 명령어 옵션



보안 권한 명령어

현재 SIGNON된 사용자의 보안 권한에 대한 정보를 얻는다.

QUERY SECURITY

사용자가 특정 리소스에 대한 접근 권한을 확인하는 명령어이다.

옵션 설명

RESTYPE 확인하려는 리소스 타입 지정

RESCLASS 확인하려는 리소스 클래스 지정

RESIDLENGTH 확인하려는 리소스 이름 길이 지정 (RESCLASS 옵션 지정 시)

RESID 확인하려는 리소스 이름 지정

READ 리소스에 대한 READ 권한이 있는 경우 CVDA 값으로 반환

UPDATE 리소스에 대한 UPDATE 권한이 있는 경우 CVDA 값으로 반환

CONTROL 리소스에 대한 CONTROL 권한이 있는경우 CVDA 값으로 반환

ALTER 리소스에 대한 ALTER 권한이 있는 경우 CVDA 값으로 반환

[표 3-32] QUERY SECURITY 명령어 옵션

트랜잭션 보안

OSC 어플리케이션 서버는 사용자의 트랜잭션 요청에 대한 보안 기능을 제공한다. 트

랜잭션을 요청한 사용자가 해당 트랜잭션을 실행할 권한이 있는지를 파악하여 실행

여부를 결정한다.

트랜잭션에 대한 보안 기능을 이용하려면 다음의 절차를 거쳐야 한다.

Step I. 보안 규칙을 적용할 트랜잭션을 TACF의 디폴트 TCICSTRN 리소스 클래스

에 등록한다. 또는 그 트랜잭션이 멤버로 등록된 리소스 그룹 프로파일을 디

폴트 그룹 클래스인 GCICSTRN에 등록한다.

Step II. 리소스의 접근 리스트에 접근할 사용자를 등록한다.

Step III. 해당 트랜잭션과 연관된 어플리케이션 프로그램을 컴파일할 때,



OpenFrame COBOL 프로그래밍 언어 전처리 툴인 cobolprep에 “–C1” 옵

션을 추가하여 전처리 한다.

Step IV. OSC 어플리케이션 서버의 설정 파일에서 [OSC_SAF] 절 아래 SEC 항목과

XTRAN 항목을 YES로 설정한다.

참고: cobolprep 툴을 이용한 전처리하는 과정과 OSC 어플리케이션 서버 설정 파일에 트랜잭

션 보안 관련 항목을 지정하는 방법에 대한 자세한 내용은 OpenFrame 안내서 중 ”OSC

운영자 안내서”를 참고한다.

제4장 데이터 관리 리소스



4.1 파일

OSC 어플리케이션 프로그램은 TSAM 데이터 셋에 대한 접근이 가능하다. TSAM 데

이터 셋은 IBM Mainframe VSAM 데이터 셋에 대응하는 OpenFrame 시스템의 파일

시스템이다. OSC 어플리케이션 프로그램에서 TSAM 데이터 셋을 접근하는 기능은

IBM Mainframe CICS 어플리케이션 프로그램이 VSAM 데이터 셋에 접근하는 것과 동

일하다. 사용자는 TSAM 데이터 셋에 대하여 데이터를 검색, 저장 및 삭제할 수 있다.

OSC 시스템은 TSAM 데이터 셋 중 KSDS, ESDS, RRDS 등 세 가지 타입의 데이터

셋에 대한 접근을 지원한다.

KSDS(Key-Sequenced Dataset)

각 레코드가 고유한 키로 식별되는 데이터 셋

ESDS(Entry-Sequenced Dataset)

RBA(Relative Byte Address)로 레코드가 식별되는 데이터 셋

RRDS(Relative Record Dataset)

RRN(Relative Record Number)로 레코드가 식별되는 데이터 셋

참고: 1.TSAM 데이터 셋에 대한 자세한 정보는 OpenFrame 안내서 중 “ TSAM 안내서“를 참고

한다.

2.파일에 대한 Function Shipping 기능에 대한 자세한 내용은 “6.3 Function Shipping” 절

을 참고한다.

FILE 리소스 정의

OSC 어플리케이션 프로그램에서 파일에 접근하려면 해당 파일에 대한 리소스 정의

가 필요하다.



파일 리소스 정의는 파일에 관한 다양한 속성을 정의한다. 해당 파일과 실제로 연결된

데이터 셋 이름 및 각종 레코드 접근 가능 여부와 함께 원격 시스템에 있는 파일을 이

용하는 경우 그에 대한 정보를 기술한다.

다음은 파일 리소스 정의에 사용되는 키워드 및 키워드에 해당하는 설명이다.

키워드 설명

FILE 파일 이름(최대 8바이트)


DESCRIPTION 파일 설명(최대 58바이트)

DSNAME 파일명과 연결된 데이터 셋(최대 44바이트)

ADD 레코드 추가 가능 여부 설정

DELETE 레코드 삭제 가능 여부 설정

READ 레코드 읽기 가능 여부 설정

UPDATE 레코드 업데이트 가능 여부 설정

REMOTESYSTEM 원격 파일인 경우 원격 파일이 위치한 시스템의 SYSID(최대 4바이트)

REMOTENAME 원격 시스템에서 사용하는 FILE 이름(최대 8바이트)

[표 4-1] FILE 리소스 정의 정보

OSC 어플리케이션 서버 기동 시, DSNAME에 기술한 데이터 셋이 존재하지 않으면

에러가 발생하며 서버 기동에 실패한다.

레코드 열람 및 순차 검색 명령어 그룹

파일 레코드를 열람 및 검색하는 방법은 다음 두 가지로 나뉜다.

직접 읽기

원하는 레코드 하나를 직접 읽어올 때 사용한다. READ 명령어를 사용한다.

순차 읽기

레코드를 순차적으로 하나씩 읽어올 때 사용한다. STARTBR, READNEXT,

READPREV, RESETBR, ENDBR 명령어를 사용한다.



READ

데이터 셋의 특정 레코드를 읽어오는 명령어이다.

옵션 설명

FILE 읽어올 파일 이름 지정


SET 받을 데이터가 저장된 장소의 포인터 참조 값 지정

UPDATE 레코드에 대한 수정 또는 삭제를 위한 락지정

TOKEN READ UPDATE에 대한 고유한 식별자 반환

LENGTH 읽으려는 레코드 버퍼(INTO 옵션에 지정)의 데이터 길이 지정

RIDFLD 읽으려는 레코드 식별 필드 지정(KSDS는 레코드에 대한 키, ESDS는 RBA 값, RRDS는 RRN 값 지정)

KEYLENGTH 키 길이 지정(KSDS 경우만 유효)

GENERIC KEYLENGTH 옵션에 표시된 값이 GENERIC 키인지 지정


RBA RIDFLD 옵션에 지정한 값이 RBA인지 지정

RRN RIDFLD 옵션에 지정한 값이 RRN인지 지정

EQUAL 레코드 검색 시 RIDFLD 값과 동일한 레코드만 가져오기

GTEQ 레코드 검색 시 RIDFLD 값과 동일하거나 큰 값을 가진 레코

드를 가져오기

[표 4-2] READ 명령어 옵션

STARTBR

순차적으로 데이터 셋 레코드를 읽어올 때, 첫 번째로 읽어올 레코드의 위치를 지정하

는 명령어이다.

옵션 설명

FILE 순차 검색할 파일 이름 지정

RIDFLD 읽으려는 레코드 식별 필드 지정(KSDS는 레코드에 대한 키, ESDS는 RBA 값, RRDS는 RRN 값)



REQID 순차 검색에 대한 요청 ID 얻기





옵션 설명


EQUAL RIDFLD 값과 동일한 레코드에 첫 순차 검색 위치 지정

GTEQ RIDFLD 값과 동일하거나 큰 값을 가진 레코드에 첫 순차 검색 위치 지정

[표 4-3] STARTBR 명령어 옵션

READNEXT

순차 검색 중 다음 레코드를 읽어오는 명령어이다. 이미 STARTBR로 순차 검색을 시

작한 파일이어야 한다.

옵션 설명




UPDATE 레코드에 대한 수정 또는 삭제를 위한 락 지정



RIDFLD 읽으려는 레코드 식별 필드 지정(KSDS는 레코드에 대한 키, ESDS는 RBA 값, RRDS는 RRN 값 지정)


REQID STARTBR에서 받은 순차 검색 요청 ID 지정




[표 4-4] READNEXT 명령어 옵션

READPREV

순차 검색 중 이전 레코드를 읽어오는 명령어이다. 이미 STARTBR로 순차 검색을 시

작한 파일이어야 한다.



옵션 설명




UPDATE 레코드에 대한 수정 또는 삭제를 위한 락 지정



RIDFLD 읽으려는 레코드 식별 필드를 지정 (KSDS는 레코드에 대한 키, ESDS는 RBA 값, RRDS는 RRN 값 지정)






[표 4-5] READPREV 명령어 옵션

ENDBR

특정 파일에 대한 순차 검색의 마지막을 알리는 명령어이다.

옵션 설명




[표 4-6] ENDBR 명령어 옵션

RESETBR

순차 검색 위치를 재설정하는 명령어이다. 재설정하려는 파일은 STARTBR 명령어로

순차 검색을 시작한 파일이어야 한다.

옵션 설명

FILE 순차 검색 위치를 재설정할 파일 이름 지정

RIDFLD 지정할 레코드 식별 필드 지정(KSDS는 레코드에 대한 키, ESDS는 RBA 값, RRDS는 RRN 값 지정)



옵션 설명







EQUAL RIDFLD 값과 동일한 레코드에 새로운 위치 지정

GTEQ RIDFLD 값과 동일하거나 큰 값을 가진 레코드에 새로운 위치 지정

[표 4-7] RESETBR 명령어 옵션

레코드 추가, 삭제 및 수정 명령어 그룹

WRITE 명령어로 특정 데이터 셋의 레코드를 추가하고, REWRITE 명령어로 레코드

를 수정할 수 있다. 레코드를 수정하는 경우, READ, READNEXT, READPREV 명령

어에서 “UPDATE” 옵션을 이용하여 레코드를 잠근 뒤 REWRITE 명령어를 사용해야

한다.

WRITE

레코드를 추가하는 명령어이다.

옵션 설명

FILE 레코드 추가할 파일 이름 지정

FROM 기록할 레코드 데이터 지정

LENGTH 기록할 레코드 길이 지정






MASSINSERT MASSINSERT의 일부분으로 레코드를 기록할 것인지 지정

[표 4-8] WRITE 명령어 옵션



REWRITE

레코드를 수정하는 명령어이다.

옵션 설명

FILE 레코드를 수정할 파일 이름 지정

FROM 기록할 레코드 데이터 지정

LENGTH 기록할 레코드 길이 지정






MASSINSERT MASSINSERT의 일부분으로 레코드를 기록할 것인지 지정

[표 4-9] REWRITE 명령어 옵션

DELETE

KSDS, RRDS 타입의 데이터 셋만 레코드 삭제가 가능하다. 레코드를 토큰 값으로 식

별하여 삭제하거나, RIDFLD 값으로 삭제하는 두 가지 방법이 있다.

옵션 설명

FILE 레코드를 삭제할 파일 이름 지정

TOKEN READ, READNEXT, READPREV, UPDATE 명령어에서 받아온 토큰 값 지정

RIDFLD 지정할 레코드 식별 필드 지정(KSDS는 레코드에 대한 키, RRDS는 RRN 값 지정)



NUMREC 지워진 레코드 개수 반환




[표 4-10] DELETE 명령어 옵션



레코드 잠금 해제 명령어

READ, READNEXT, READPREV 명령어에서 “UPDATE“ 옵션으로 레코드에 걸린 잠

금을 해제한다. 직접 UNLOCK 명령어를 요청하지 않더라도, 잠금은 SYNCPOINT 명

령어가 수행되거나 태스크가 종료하는 시점에 자동으로 해제된다.

UNLOCK

레코드에 걸린 잠금을 해제하는 명령어이다.

옵션 설명

FILE 레코드를 삭제할 파일 이름 지정

TOKEN READ, READNEXT, READPREV UPDATE 명령어에서 받아

온 토큰값 지정

SYSID Function Shipping할 SYSID 지정

[표 4-11] UNLOCK 명령어 옵션

4.2 DL/I 데이터베이스

OSC 어플리케이션 서버는 IBM Mainframe IMS/DB에 대응하는 OpenFrame의 HiDB

제품을 기반으로 DL/I 데이터베이스 기능을 제공한다.

EXEC DLI 명령어 인터페이스와 CBLTDLI 호출 인터페이스의 두 가지 인터페이스를

지원한다.

EXEC DLI 인터페이스

EXEC DLI 인터페이스는 DL/I 데이터베이스 접근을 위한 명령어 인터페이스이다.

OSC 어플리케이션 서버는 EXEC DLI 인터페이스를 통하여 명령어를 실행할 때마다

현재 상태 코드 및 DL/I과 관련된 정보들을 어플리케이션이 접근할 수 있도록

DIB(DL/I Interface Block)라는 컨트롤 블럭을 제공한다. 사용자는 이 블록에 저장된

상태 코드를 통해 명령어가 성공적으로 실행되었는지 확인하게 된다.



DIB를 통하여 다음과 같은 정보를 얻을 수 있다.

DIBSTAT

2바이트 문자열로 명령어 실행 후 상태를 알려준다.

DIBSEGM

8바이트 문자열로 GN, GNP, GU, ISRT 명령어가 성공적으로 실행된 경우 가장

낮은 수준의 세그먼트의 이름이 저장된다.

DIBSEGLV

2바이트 문자열로 GN, GNP, GU, ISRT 명령어가 성공적으로 실행된 경우 가장

낮은 수준의 값이 저장된다.

DIBKFBL

2바이트 바이너리 숫자로 GN, GNP, GU 명령어에서 “KEYFEEDBACK” 옵션을

사용한 경우 연쇄 키(concatenated key)의 길이가 저장된다.

DL/I 데이터베이스로의 접근은 PSB(Program Specification Block)를 스케줄링함으로

써 시작한다. PSB는 PCB(Program Communication Block)들의 집합체이고, PCB는

어플리케이션이 어떤 뷰(View)를 통하여 데이터베이스를 바라볼 지를 정의한다. OSC

어플리케이션은 여러 PCB 타입 중 DB PCB 타입만 지원한다. 각 명령어는 PSB에 설

정된 PCB를 이용하여 어떤 데이터베이스를 접근할 것인지를 지정한다.

다음은 EXEC DLI 명령어의 사용 예를 보여준다.

* PSB 스케줄링한다.

EXEC DLI SCHD PSB(PSB-NAME) END-EXEC.

* FIELDA라는 필드에 123이라는 SEGA 세그먼트 값을 가지고 온다.

MOVE ‘123’ TO FIELD1.

EXEC DLI GU SEGMENT(SEGA) INTO(SEGA-AREA) WHERE(FIELDA=FIELD1) END-EXEC.

* PSB 사용을 종결한다.

EXEC DLI TERM END-EXEC.



스케줄링이 성공하면, 아래에서 설명하는 명령어들을 이용하여 PSB에 지정된 데이터

베이스에 접근할 수 있다.

참고: DL/I 기능 및 HiDB에 대한 자세한 정보는 OpenFrame 안내서 중 ”HiDB 안내서”를 참고한

다.

DLET (DELETE)

데이터베이스로부터 세그먼트와 해당 세그먼트에 종속된 항목들을 삭제하는 명령어

이다. 삭제하기 전 삭제하려고 하는 세그먼트를 먼저 받아야 하고 그 받은 세그먼트를

DLET 명령어로 삭제한다.

옵션 설명

USING PCB 사용할 DB PCB 지정

SEGMENT 삭제할 세그먼트의 타입 지정

SEGLENGTH I/O 경로의 길이 지정

FROM 삭제할 세그먼트가 위치한 I/O 경로 지정

[표 4-12] DLET 명령어 옵션

GN (GET NEXT)

데이터베이스로부터 순차적으로 세그먼트를 읽어오는 명령어이다. GN 명령어를 실

행할 때마다 옵션에 지정한 정보에 따라 다음 세그먼트를 받아온다. GN 명령어를 실

행하기 전 필수적으로 GU 명령어를 이용하여 어디부터 읽을 것인지 지정해야 한다.

“SEGMENT” 옵션과 “WHERE” 옵션으로 읽기에 대한 조건 부여가 가능하다.

옵션 설명


KEYFEEDBACK 세그먼트의 연쇄 키(concatenated key)가 저장될 경로 지정

FEEDBACKLEN KEYFEEDBACK 저장소의 길이 지정

INTO 읽어올 세그먼트가 저장될 경로 지정

FIRST 세그먼트 타입의 첫 세그먼트 가져오기

LAST 세그먼트 타입의 마지막 세그먼트 가져오기

CURRENT 현재 포지션을 기반으로 세그먼트 추가

SEGMENT 읽어올 세그먼트의 타입 지정




옵션 설명

FIELDLENGTH WHERE 옵션에 지정할 필드 값 길이 지정

WHERE 읽어올 세그먼트에 대한 Qualification Statement를 기술. Qualification Statement는 다음의 세 가지 조합으로 구성된

다. 1) 세그먼트의 필드 이름 2) 비교 연산자 3) 비교할 값이 저장된 변수

[표 4-13] GN 명령어 옵션

GNP (GET NEXT IN PARENT)

특정 부모에게 종속된 항목만 가져오기 위한 명령어이다. GNP 명령어를 실행하기 전,

부모 정보가 주어진 GU 또는 GN 명령어를 실행해야 한다.

“SEGMENT” 옵션과 “WHERE” 옵션으로 읽기에 대한 조건 부여가 가능하다.

옵션 설명


KEYFEEDBACK 세그먼트의 연쇄 키(concatenated key)가 저장될 경로 지정



FIRST 세그먼트 타입의 첫 세그먼트 가져오기






WHERE 읽어올 세그먼트에 대한 Qualification Statement를 기술. Qualification Statement는 다음의 세 가지 조합으로 구성된

다. 1) 세그먼트의 필드 이름 2) 비교 연산자 3) 비교할 값이 저장된 변수

[표 4-14] GNP 명령어 옵션



GU (GET UNIQUE)

특정 세그먼트를 가져오고, 순차 검색을 위하여 시작 포인트를 지정하는 명령어이다.

어떤 세그먼트 타입을 가져올 것인지 적어도 하나의 “SEGMENT” 옵션을 지정해야 하

고, “WHERE” 옵션을 통하여 읽기에 대한 조건 부여가 가능하다.

옵션 설명


KEYFEEDBACK 세그먼트의 연쇄 키(concatenated key)가 저장될 장소 지정







WHERE 읽어올 세그먼트에 대한 Qualification Statement를 기술. Qualification Statement는 다음 세 가지 조합으로 구성된다. 1) 세그먼트의 필드 이름 2) 비교 연산자 3) 비교할 값이 저장된 변수

[표 4-15] GU 명령어 옵션

ISRT (INSERT)

하나 이상의 세그먼트를 추가하기 위한 명령어이다.

옵션 설명


FROM 추가할 세그먼트의 데이터가 저장된 경로 지정

FIRST 세그먼트 타입의 첫 세그먼트로 추가

LAST 세그먼트 타입의 마지막 세그먼트로 추가


SEGMENT 추가할 세그먼트의 타입 지정



WHERE 추가할 세그먼트에 대한 Qualification Statement를 기술. Qualification Statement는 다음 세 가지 조합으로 구성된다.



옵션 설명 1) 세그먼트의 필드 이름 2) 비교 연산자 3) 비교할 값이 저장된 변수

[표 4-16] ISRT 명령어 옵션

REPL (REPLACE)

세그먼트를 변경하기 위한 명령어이다. 적어도 하나의 “SEGMENT”와 “FROM” 옵션

이 지정되어야 하고, 두 개가 하나의 묶음으로 수정하려고 하는 세그먼트를 선택하고

수정하려고 하는 내용을 지정한다.

옵션 설명


FROM 수정할 세그먼트의 데이터 저장소 지정

SEGMENT 수정할 세그먼트의 타입 지정


[표 4-17] REPL 명령어 옵션

SCHD (SCHEDULE)

PSB를 스케줄링하는 명령어이다.

옵션 설명

PSB 스케줄링하려는 PSB 지정

[표 4-18] SCHD 명령어 옵션

TERM (TERMINATE)

PSB의 사용을 끝났음을 알리는 명령어이다.



CBLTDLI 인터페이스

CBLTDLI 인터페이스는 EXEC DLI 인터페이스와 별도로 COBOL 프로그램에서 DL/I

데이터베이스에 접근할 수 있도록 OSC 시스템에서 제공하는 호출 인터페이스 모듈

이다.

본 절에서는 EXEC DLI 인터페이스와 CBLTDLI의 차이점을 소개하고, CBLTDLI를 사

용하는 OpenFrame/Batch DL/I 인터페이스와의 차이점을 기술한다.

참고: CBLTDLI 인터페이스에 대한 자세한 내용은 OpenFrame 안내서 중 ”HiDB 안내서”를 참

고한다.

EXEC DLI 인터페이스와 달리 CBLTDL 인터페이스 사용 시에는 IBM CICS

Transaction Server에서와 동일하게 DLIUIB(DL/I User Interface Block)와 PCB MASK

등을 직접 지정해주어야 하며, DL/I 데이터베이스 접근 시 세그먼트를 식별하기 위하

여, 직접 SSA(Segment Search Arguments)를 생성하여 기술해야 한다.

다음은 CBLTDLI 인터페이스를 이용하여 PSB를 스케줄링하는 예이다.

CALL ‘CBLTDLI’ USING ‘PCB ‘ PSBNAME ADDRESS OF DLIUIB

다음은 특정 필드 조건에 맞는 세그먼트 값을 가지고 오는 예이다.

CALL ‘CBLTDLI’ USING ‘GU ‘ THE-PCB-MASK SEGA-AREA FIELDA-SSA.

OSC 시스템에서 CBLTDLI 인터페이스로 DL/I 데이터베이스에 접근하는 것은 Batch

프로그램에서 CBLTDLI 인터페이스를 사용하는 것과 다음 두 가지 차이점을 제외하

면 동일하다.

첫째, EXEC DLI 인터페이스와 마찬가지로 PSB 스케줄링이 필요하다.

둘째, CBLTDLI 호출 결과에 대한 상태 체크에 차이가 있다. DLIUIB의 UIBRCODE가

각각의 CBLTDLI 호출의 성공 여부를 결정하게 된다. UBIRCODE는 에러 정보를 보여

주는 UIBFCTR과 부가 에러 정보를 보여주는 UIBDLTR로 나뉘어진다. 먼저

UIBFCTR로 에러를 확인하여 만약 이 값이 심각한 상태를 표현하는 경우, CBLTDLI

인터페이스는 직접 에러 처리를 하지 않기 때문에 사용자가 직접 EXEC CICS 인터페

이스의 ABEND 명령어를 이용하여 태스크를 종료해야 한다. Batch DL/I 프로그램에

서와 마찬가지로 CBLTDLI 호출이 정상적으로 이루어졌는 지는 PCB MASK의 상태

코드를 이용하여 확인한다.



4.3 Named Counter Server

Named Counter Server(NCS)는 사용자가 지정한 이름으로 생성된 카운터로부터 값

을 받아오는 기능을 제공한다. 사용자 값을 받아올 때마다 그 카운터 값은 하나씩 증

가하는 기능을 기본으로 제공하고, 그 외에 사용자의 명령어나 옵션에 따라 최소, 최

대값 지정, 증가값 설정, 카운터 재설정, 카운터 삭제 등 다양한 기능을 제공한다.

OSC 어플리케이션 서버는 두 가지 종류의 카운터(COUNTER, DCOUTNER)를 지원

한다. COUNTER는 카운터 값으로 4바이트 바이너리 정수(fullword signed binary

values) 형식으로 지원하고, DCOUNTER는 8바이트 바이너리 양수(doubleword

unsigned binary values) 형식으로 지원한다. COUNTER, DCOUNTER 둘 다 명령어

수준에서 사용 방법은 동일하지만, 특정 타입으로 생성된 카운터는 동일한 타입의 카

운터 명령어를 통해서만 접근이 가능하다.

카운터 접근 명령어 그룹

어플리케이션 프로그램은 다음의 명령어를 통하여 NCS에 접근할 수 있다.

DEFINE COUNTER|DCOUNTER

카운터를 생성하는 명령어이다.

옵션 설명

COUNTER|DCOUNTER 생성할 카운터 이름 지정

POOL 사용할 POOL 이름 지정

VALUE 생성할 카운터의 초기값 지정

MINIMUM 카운터의 최소값 지정

MAXIMUM 카운터의 최대값 지정

[표 4-19] DEFINE COUNTER|DCOUNTER 명령어 옵션



DELETE COUNTER|DCOUNTER

카운터를 삭제하는 명령어이다.

옵션 설명

COUNTER|DCOUNTER 삭제할 카운터 이름 지정

POOL 카운터가 있는 POOL 이름 지정

[표 4-20] DELETE COUNTER|DCOUNTER 명령어 옵션

GET COUNTER|DCOUNTER

카운터의 다음 값을 가져오는 명령어이다.

옵션 설명

COUNTER|DCOUNTER 값을 가져올 카운터 이름 지정


VALUE 가져올 값이 저장될 변수 지정

INCREMENT 값을 가져온 후의 카운터의 증가값 지정(1)

REDUCE 카운터 값 감소

WRAP 카운터가 제한값에 도달하면 자동으로 되돌아가기

COMPAREMIN 카운터로부터 받아올 값이 현재 지정된 값 이상인 경우에 가져오기

COMPAREMAX 카운터로부터 받아올 값이 현재 지정된 값 이하인 경우에 가져오기

[표 4-21] GET COUNTER|DCOUNTER 명령어 옵션

REWIND COUNTER|DCOUNTER

최대값에 도달한 카운터를 되돌린다.

옵션 설명

COUNTER|DCOUNTER 카운터 이름 지정


INCREMENT 카운터가 최대값에 도달하는지 확인하기 위하여 사용

할 증가값 지정

[표 4-22] REWIND COUNTER|DCOUNTER 명령어 옵션



UPDATE COUNTER|DCOUNTER

카운터의 현재 값을 업데이트하는 명령어이다.

옵션 설명

COUNTER|DCOUNTER 카운터 이름 지정


VALUE 새로 설정할 값 지정

INCREMENT 카운터가 최대값에 도달하는지 확인하기 위하여 사용

할 증가값

COMPAREMIN 현재 설정된 값 이상인 경우에만 업데이트

COMPAREMAX 현재 설정된 값 이하인 경우에만 업데이트

[표 4-23] UPDATE COUNTER|DCOUNTER 명령어 옵션

QUERY COUNTER|DCOUNTER

카운터 정보를 가져오는 명령어이다.

옵션 설명

COUNTER/DCOUNTER 카운터 이름 지정


VALUE 현재 값 가져오기

MINIMUM 카운터 최소값 가져오기

MAXIMUM 카운터 최대값 가져오기

[표 4-24] QUERY COUNTER|DCOUNTER 명령어 옵션

NCS 구조 및 복구

NCS 카운터는 OSCNCSVR(Online Server type C Named Counter Server)라는 OSC

시스템 서버에 의해 관리되며, 각 어플리케이션 서버들은 OSCNCSVR에 카운터 접근

을 요청한다. OSCNCSVR는 시스템 전체에 유일한 프로세스로 모든 어플리케이션 서

버들의 요청을 받아 처리한다.

OSCNCSVR 서버 프로세스에 문제가 발생하면 Tmax 설정의 “RESTART” 옵션에 의

해 새로운 서버 프로세스가 부팅된다. 내부에서 사용하는 서버 정보 구조체에 문제가

생기지 않는 한 새로운 프로세스는 이전 상태를 복구하여 OSC 어플리케이션 서버에



서비스를 지속적으로 제공한다.

노드에서 장애가 발생했을 때에는 서버 프로세스가 다른 노드에서 재시작된다. 이 경

우 osc.conf에 설정된 NCS_FILE이 공유 디스크의 동일한 파일을 지정하고 있다면

지속적인 서비스 제공이 가능하다.

제5장 데이터 통신 리소스



5.1 터미널

OSC 시스템에서의 터미널은 현재 TN3270 에뮬레이터를 의미한다. TN3270 에뮬레

이터는 TN3270 프로토콜을 바탕으로 OSC 어플리케이션 서버와 데이터 통신을 하는

장치이다. 터미널은 서버로부터 수신한 데이터를 화면에 출력하고, 사용자의 입력 데

이터를 서버로 송신하는 역할을 담당한다.

터미널은 MSC 게이트웨이를 매개체로 OSC 어플리케이션 서버와 연결한다. 한편

MSC 게이트웨이는 터미널과 서버가 주고 받는 데이터의 형식을 변환한 다음 각 개체

의 형식에 맞는 데이터를 전달하는 역할을 담당한다.

참고: MSC에 대한 자세한 내용은 “5.2 MSC” 절과 OpenFrame 안내서 중 “MSC 운영자 안내서”

를 참조한다.

터미널이 OSC 시스템에 정상적으로 접속하려면 사전에 터미널이 접속하려는 게이트

웨이에서 참조하는 리소스 정의에 해당 터미널 정의가 등록되어 있어야 한다. 정상적

으로 등록된 터미널은 MSC 게이트웨이의 확인 절차를 거친 후에 OSC 시스템으로 트

랜잭션을 요청하고 OSC 시스템에 정보를 보내거나 트랜잭션 결과 화면을 받아오는

등의 작업을 수행할 수 있다.

TERMINAL 리소스 정의

TERMINAL 리소스 정의에는 터미널에서 보내오는 터미널의 이름, LUNAME에 해당

하는 NETNAME, 터미널을 위한 속성이 설정된 TYPETERM, 사용 가능 여부 등의 정

보가 포함된다.

터미널 리소스 정의는 다음과 같은 목적으로 사용된다.

해당 터미널이 시스템에 등록된 터미널이고 현재 사용 가능한지 확인



특정 터미널을 대상으로 트랜잭션이 발생했을 때 MSC 게이트웨이에서 어느 터

미널로 트랜잭션을 보내야 하는지 결정

다음은 TERMINAL 리소스 정의에 사용되는 키워드 및 키워드에 해당하는 설명이다.

키워드 설명

TERMINAL 터미널 이름(최대 4바이트)


NETNAME 터미널 LU명(최대 8바이트)

TYPETERM TYPETERM명(최대 8바이트)

INSERVICE 해당 접속 정보 이용 여부

[표 5-1] TERMINAL 리소스 정의 정보

TYPETERM 리소스 정의

TYPETERM 리소스 정의에는 터미널의 화면 크기, 색상 지원, 하이라이트 기능 지원

등과 같은 터미널의 속성 정보가 포함된다.

TYPETERM 리소스 정의 사용 방법은 다음과 같다.

OSC 시스템 운영자는 사용하기 원하는 터미널 종류를 결정하고 이에 대한

TYPETERM을 지정한다.

터미널 정의에 있는 TYPETERM에 터미널에 해당되는 TYPETERM을 선택한다.

같은 속성을 가지는 모든 터미널 리스소 정의를 중복 설정하지 않아도 된다.

다음은 TYPETERM 리소스 정의에 사용되는 키워드 및 이에 해당하는 설명이다.

키워드 설명

TYPETERM TYPETERM 이름(최대 8바이트)


AUDIBLEALARM 알람 설치 여부

COLOR 추가 색상 사용 여부

HILIGHT 반전, 밑줄, 깜빡임 등의 하이라이트 기능 사용 여부

IOAREALEN 터미널의 입출력 영역의 길이 선택. “(최소값, 최대값)”의 형식

(0, 0). 설정 값은 32767을 넘으면 안됨

KATAKANA 가타카나 지원 여부

OUTLINE FIELD 테두리선 지원 여부



키워드 설명

PROGSYMBOLS Programmed symbol facility(확장 문자 셋 기능) 지원 여부

SOSI 1바이트 문자와 2바이트 문자 혼합 모드 지원 여부

TERMMODEL 터미널의 모델 번호 선택 (1은 12X40의 크기를 지원하는 터미널또는 3275 Display Station Model 11, 2는 24X80의 크기를 지원하는 터미널 또는 3275 Display Station Model 12)

UCTRAN 소문자의 대문자 변환 기능 사용 여부

[표 5-2] TYPETERM 리소스 정의 정보

터미널 사용 명령어 그룹

터미널과 관련된 명령어로 HANDLE AID 명령어와 ISSUE DISCONNECT 명령어를

지원한다. HANDLE AID 명령어는 POP|PUSH HANDLE 명령어의 적용 범위에 포함

된다.

HANDLE AID

특정 AID(Attention Identifier) 값을 터미널로 받은 경우 해당하는 레이블로 컨트롤을

전송할 것을 설정하는 명령어이다.

옵션 설명

ANYKEY <PA>, <PF>, <CLEAR> 키에 대한 처리 지정

CLEAR <CLEAR> 키에 대한 처리 지정

CLRPARTN <CLRPARTN> 키에 대한 처리 지정

ENTER <ENTER> 키에 대한 처리 지정

LIGHTPEN 라이트 펜(light-pen) 대한 주의 처리 지정

OPERID 오퍼레이터 인식 카드 리더, 자기 슬롯 리더(MSR), 확장 MSR에 대한 처리 지정

PA1-PA3 <PA1>부터 <PA3>까지 프로그램 액세스 키에 대한 처리 지정

PF1-PF24 <PF1>부터 <PF24>까지 프로그램 함수 키에 대한 처리 지정

TRIGGER 트리거 필드(trigger field)에 대한 주의 처리 지정

[표 5-3] HANDLE AID 명령어 옵션



ISSUE DISCONNECT

OSC 어플리케이션 서버와 터미널 간의 연결을 종료하는 명령어이다.

5.2 MSC

OSC 시스템에서 어플리케이션과 터미널 간의 통신을 위해서 화면을 구성하는 여러

가지 명령들을 모아놓은 맵(map)이 있다. 이 맵 파일은 화면에 사용되는 COBOL 어플

리케이션과는 별도의 로직으로 작성된다. 맵 파일은 어셈블러 매크로들로 구성되며,

각각의 매크로들은 사용하고자 하는 화면에 대한 속성들을 정의한다. 이와 같은 방식

으로 개발자가 자신이 사용할 맵을 정의하여 실제로 사용자가 사용하는 터미널에 출

력하는 서비스를 MSC(Mapping Support type C)라 한다.

MSC는 OSC 어플리케이션 서버와 터미널 사이에서 정해진 형식의 데이터를 서로 주

고 받도록 한다. MSC는 OSC 어플리케이션 서버와는 약속된 형식의 데이터 구조를

주고 받으며, 터미널과는 TN3270 형식의 데이터 스트림을 주고 받는다. 또한 MSC는

OSC 어플리케이션 서버와 터미널 간의 EBCDIC 데이터와 ASCII 데이터가 원활하게

통신할 수 있도록 한다.

MSC를 통해 데이터를 주고 받음으로써 어플리케이션 프로그램 개발 시 다음과 같은

장점이 있다.

터미널과 상관 없이 어플리케이션 프로그램 안에서 필드에 데이터를 입력하면 터

미널이 해석할 수 있는 데이터 스트림으로 변환된다. 그와 반대의 경우도 마찬가

지이다. 이와 같은 특성은 어플리케이션 프로그램이 불필요한 데이터 변환을 신

경쓰지 않아도 되게 한다.

어플리케이션 프로그램의 로직과 상관 없이 별도의 맵 작성이 가능하다. 따라서

맵 변화로 인해 다른 프로그램에 영향을 주는 일이 발생하지 않는다. 다시 말해

소스 관리와 새로운 프로그램 작성이 용이하게 된다.

맵 송신 및 수신 명령어 그룹

어플리케이션 프로그램에서 터미널로 맵을 보내거나 받을 수 있는 명령어가 제공된다.



SEND MAP

OSC 어플리케이션 프로그램에서 터미널로 화면을 보내는 명령어이다.

옵션 설명

MAP 화면에 보여질 MSC 맵 이름 지정

MAPSET 맵이 속한 맵셋 이름 명시

FROM 터미널로 전송될 데이터 지정

DATAONLY 데이터를 터미널에 보낼 때 맵에 정의된 화면 부분은 그대로 두고 사용자 데이터 부분만 화면에 표시

LENGTH FROM 옵션으로 전송할 데이터의 길이 지정

MAPONLY 데이터를 터미널에 보낼 때 맵에 정의된 출력 필드만 화면에 표시

CURSOR 데이터가 터미널에 출력될 때 첫 입력 필드에 커서를 위치시키는 옵션. 0~1919 사이의 숫자를 입력하여 커서 위치를 지정한

다. 0을 입력하면 (1,1) 80을 입력하면 (2,1)이 되는 방식이다.

ERASE 새로운 데이터가 터미널에 출력되기 전에 화면 지우

기

ERASEAUP 입력 필드의 데이터 지우기

PRINT 프린트 옵션

FREEKB 데이터가 작성된 후에 키보드의 잠금 해제

ALARM 알람 지정

[표 5-4] SEND MAP 명령어 옵션

RECEIVE MAP

OSC 어플리케이션 프로그램에서 터미널로부터 데이터를 받아오는 명령어이다.

옵션 설명

MAP 화면에 보여질 MSC 맵 이름 지정

MAPSET 맵이 속한 맵셋 이름 지정

INTO 터미널로 전송될 COBOL 변수 선언 부분 지정

[표 5-5] RECEIVE MAP 명령어 옵션



텍스트 데이터 전송 명령어 그룹

어플리케이션 프로그램에서 MSC를 이용하여 터미널로 맵 데이터 이외에 텍스트를

보내는 기능이 지원된다.

SEND TEXT

맵이 아닌 텍스트 데이터를 터미널로 전송하는 명령어이다.

옵션 설명

FROM 터미널로 전송될 데이터 지정

LENGTH FROM 옵션으로 전송할 데이터의 길이 지정

CURSOR 데이터가 터미널에 출력될 때 첫 입력 필드에 커서를 위치시키는 옵션. 0~1919 사이의 숫자를 입력하여 커서 위치를 지정한

다. 0을 입력하면 (1,1) 80을 입력하면 (2,1)이 되는 방식이다.

ERASE 새로운 데이터가 터미널에 출력되기 전에 화면 지우

기



ALARM 알람 지정

[표 5-6] SEND TEXT 명령어 옵션

터미널 컨트롤 명령어 그룹

맵이나 텍스트 데이터 없이 터미널을 컨트롤하기 위한 명령어가 지원된다.

SEND CONTROL

터미널로 컨트롤을 넘기는 명령어이다..

옵션 설명

CURSOR 데이터가 터미널에 출력될 때 첫 입력 필드에 커서를 위치시

키는 옵션. 0~1919 사이의 숫자를 입력하여 커서 위치를 지정한다. 0을 입력하면 (1,1) 80을 입력하면 (2,1)이 되는 방식이다.



옵션 설명

FORMFEED 새 페이지

ERASE 새로운 데이터가 터미널에 출력되기 전에 화면 지우기

ERASEUP 입력 필드의 데이터 지우기



ALARM 알람 지정

FRSET 필드 리셋

[표 5-7] SEND CONTROL 명령어 옵션

5.3 SPOOL

OSC 어플리케이션 서버는 사용자 프로그램이 TJES 시스템을 접근할 수 있도록 인터

페이스를 제공한다. TJES SPOOL에 데이터를 쌓아 특정 대상 노드로 보낼 수 있을 뿐

만 아니라, TJES 시스템을 통하여 JOB을 돌릴 수 있는 기능도 지원한다. SPOOL에

작성된 데이터는 시스템의 SPOOL 디렉토리 아래, 서버 설정의 [OSC] 절에 지정된

JOBID와 동일한 디렉토리에 데이터가 저장된다.

SPOOL 파일 접근 명령어 그룹

SPOOL 파일 작성은 다음 명령어들을 통하여 이루어진다.

SPOOLOPEN OUTPUT

SPOOL 파일을 먼저 오픈한다. “TOKEN” 옵션을 통하여 토큰을 받아온다.

SPOOLWRITE

파일 오픈 시 받아온 토큰 값을 이용하여 데이터를 넘기면 지정된 SPOOL 파일에

데이터가 작성된다. 하나의 SPOOL 파일에 여러 번 SPOOLWRITE를 사용할 수

있다.

SPOOLCLOSE

직접 SPOOL 파일을 닫거나 태스크를 종료하면 자동으로 닫힌다. 닫힘과 동시에

해당 작성자에게 데이터 전송 요청이 이루어진다.



SPOOLOPEN OUTPUT

SPOOL 파일을 열면서 그 파일에 대한 속성을 정의하는 명령어이다.

옵션 설명

TOKEN SPOOL 파일의 토큰 값

NODEID SPOOL 파일을 보낼 경로의 식별자 지정

USERID SPOOL 파일을 보낼 경로의 사용자 식별자 지정

CLASS 클래스 지정

NOCC|ASA|MCC 출력 시 캐리지 컨트롤(carriage-control character) 지정

PRINT|PUNCH|RECORDLENGTH 기록할 레코드 길이 지정

[표 5-7] SPOOLOPEN OUTPUT 명령어 옵션

SPOOLWRITE

SPOOL 파일에 데이터를 기록하는 명령어이다.

옵션 설명

TOKEN 데이터를 기록할 SPOOL 파일의 토큰 값 지정

FROM 기록할 데이터가 저장된 경로 지정

FLENGTH 기록할 데이터의 길이 지정

LINE|PAGE 라인과 페이지 중 데이터 포맷 지정

SPOOLCLOSE

SPOOL 파일을 닫는 명령어이다.

옵션 설명

TOKEN 닫을 SPOOL 파일의 토큰 값 지정

KEEP|DELETE KEEP은 SPOOL 파일을 대상 노드로 보내고, DELETE는 SPOOL 파일을 삭제

[표 5-8] SPOOLCLOSE 명령어 옵션

참고: Internal reader로 데이터를 기록하려면 SPOOLOPEN OUTPUT 명령어에서 USERID에

INTRDR를 설정한다. TJES로 보낼 마지막 레코드에 /* EOF을 기술하면 자동으로

SPOOL 파일이 닫힘과 동시에 TJES Internal reader에 데이터가 전송된다.

제6장 상호 통신



6.1 소개

OSC 어플리케이션 서버는 OSC 어플리케이션 프로그램에서 원격 OSC 어플리케이

션 서버가 관리하는 리소스에 접근할 수 있도록 하는 서버 간 상호 통신

(Intercommunication) 기능을 제공한다. 다음과 같은 두 가지 기능이 있다.

Function Shipping

OSC 어플리케이션 프로그램이 원격 OSC 어플리케이션 서버가 관리하는 파일,

TDQ, TSQ 등의 리소스에 접근하는 기능이다.

Distributed Program Link(DPL)

OSC 어플리케이션 프로그램이 원격 OSC 어플리케이션 서버의 프로그램을 링

크하는 기능이다.

본 장에서는 다른 시스템의 SYSID를 관리하는 CONNECTION 리소스 정의와 같은 상

호 통신의 기본 개념과 이를 이용한 Function Shipping, DPL 기능에 대해 설명한다.

6.2 SYSID 식별자와 CONNECTION 리소스 정의

OSC 어플리케이션 서버는 SYSID라는 식별자로 자신과 다른 OSC 어플리케이션 서

버를 구별하고, CONNECTION 리소스 정의를 통해 특정 SYSID에 해당하는 서버와의

연결 정보를 얻는다.

SYSID는 OSC 어플리케이션 서버의 식별자이다. 이는 OpenFrame 시스템 내에서 각

서버를 구분짓기 위하여 OSC 어플리케이션 서버마다 배정되는 식별자가 아니라, 한

OSC 어플리케이션 서버 내부에서 다른 OSC 어플리케이션 서버를 구분하기 위한 식

별자를 의미한다. OSC00001이라는 이름의 서버에서 OSC00002를 식별하는 SYSID

와 OSC00002에서 OSC00003을 식별하는 SYSID는 동일하게 설정하더라도 실제 가

리키는 물리적인 서버는 다르다.

SYSID 식별자를 이용하여 원격 OSC 어플리케이션 서버에 접근하는 방법은 다음과

같다.



OSC 어플리케이션 서버 자신의 SYSID 식별자를 설정한다.

서버 설정 파일의 [OSC] 절에서 SYSID 항목에 4바이트의 문자열로 지정한다.

EXEC CICS 인터페이스를 호출하면서 “SYSID” 옵션에 Function Shipping 또는

DPL을 요청하려는 원격 어플리케이션 서버의 SYSID를 설정하거나, 파일이나

TDQ의 경우, 해당 리소스 정의의 REMOTESYSTEM 항목에 SYSID를 지정한다.

CONNECTION 리소스 정의는 다른 OSC 어플리케이션 서버 간의 연결 정보를

제공한다. 접근하려는 원격 OSC 어플리케이션 서버의 SYSID 식별자와 동일한

CONNECTION 이름을 갖는 CONNECTION 리소스 정의가 존재해야만 해당 원

격 OSC 어플리케이션 서버로 연결이 가능하다.

다음은 CONNECTION 리소스 정의에 사용되는 키워드 및 키워드에 해당하는 설명이

다.

키워드 설명

CONNECTION CONNECTION 이름 (최대 4바이트)

GROUP 리소스 정의 그룹 (최대 8바이트)

NETNAME 접속 대상이 되는 OSC 서버명 또는 CICS Region의 APPLID (최대 8바이트)

TYPE 접속 대상 지정 (INTERNAL만 지원: INTERNAL은 원격 어플

리케이션 서버가 동일 OSC 시스템에 있다는 의미)

INSERVICE 해당 접속 정보 이용 여부

[표 6-1] CONNECTION 리소스 정의 정보

6.3 Function Shipping

Function Shipping은 OSC 어플리케이션 프로그램이 다른 어플리케이션 서버에 설정

된 리소스(파일, TDQ, TSQ 등)에 접근할 수 있는 기능을 의미한다. 접근하고자 하는

원격 어플리케이션 서버를 지정하는 방법에는 다음 두 가지가 있다.

EXEC CICS 명령어의 SYSID 옵션으로 해당 리소스가 존재하는 원격 어플리케

이션 서버의 SYSID를 지정한다.

파일, TDQ의 경우, 리소스 정의의 REMOTESYSTEM 항목에 해당 원격 어플리

케이션 서버의 SYSID를 설정한다.



원격 리소스에 접근하는 방법은 리소스의 종류에 따라 차이가 있으므로 자세한 설명

은 이어지는 “파일”, “TDQ”, “TSQ” 절을 참고한다.

OSC 어플리케이션 서버에서 Function Shipping 기능을 사용할 때 리소스 관리 모듈

에서 하는 일은 다음과 같다.

1. SYSID 식별자를 통해 접근하려는 원격 OSC 어플리케이션 서버에 대한

CONNECTION 리소스 정의를 얻는다.

2. CONNECTION 리소스 정의에서 NETNAME에 기술된 이름에 해당하는 원격 서

버의 미러 서버에 지정된 미러 서비스를 호출한다.

이와 같이 Function Shipping 기능은 원격 서버에 대한 미러 서버 및 미러 서비스를 기

반으로 하므로 미러 서버와 미러 서비스가 미리 등록되어 있어야 한다.

참고: 자세한 설정 방법은 OpenFrame 안내서 중 ”OSC 운영자 안내서”를 참고한다.

Function Shipping은 다음과 같이 작동한다.

1. OSC 어플리케이션 프로그램에서 Function Shipping을 요청한다.

2. 리소스 관리 모듈이 요청 내용을 메시지화하여 해당 미러 서버의 미러 서비스를

호출한다.

3. 미러 서비스가 해당 리소스에 접근하여 요청을 처리하고 그 결과를 Function

Shipping을 요청한 어플리케이션 서버에 돌려준다.

4. 순차 검색 또는 리소스를 업데이트한 경우가 아니면 해당 미러 서비스는 종료된

다.

5. 순차 검색 또는 리소스를 업데이트한 경우, 미러 서비스는 어플리케이션 프로그

램에서 RETURN, SYNCPOINT 또는 SYNCPOINT ROLLBACK 명령어를 실행

할 때까지 기다렸다가 요청에 따라 커밋 또는 롤백 처리를 수행하고 종료된다.

파일

DELETE, READ, REWRITE, UNLOCK, WRITE, ENDBR, READNEXT, READPREV,

RESETBR, STARTBR 등 파일에 접근하는 EXEC CICS 인터페이스 명령어에서 다음

과 같은 방법으로 Function Shipping 기능을 활용할 수 있다.



명령어의 “SYSID” 옵션에 원격 어플리케이션 서버의 SYSID 식별자를 지정한다.

FILE 리소스 정의에서 REMOTESYSTEM에 SYSID 식별자를 지정한다.

REMOTENAME도 지정하면 원격 시스템에서 REMOTENAME과 동일한 이름을

가진 파일에 명령어 요청이 내려진다.

TDQ

TDQ 접근 명령어 중 DELETEQ TD, READQ TD, WRITEQ TD 명령어에서 다음과 같

은 방법으로 Function Shipping 기능을 활용할 수 있다.

명령어의 SYSID 옵션에 원격 어플리케이션 서버의 SYSID 식별자를 지정한다.

FILE 리소스 정의에서 REMOTESYSTEM에 SYSID 식별자를 지정한다.

REMOTENAME도 지정하면 원격 시스템에서 REMOTENAME과 동일한 이름을

가진 파일에 명령어 요청이 내려진다.

TYPE에 아무것도 지정하지 않은 채 TDQ 리소스 정의의 REMOTESYSTEM에

원격 서버의 SYSID 식별자를 지정한다. REMOTENAME에 접근할 TDQ 이름을

지정한다.

TSQ

TSQ에 접근하는 명령어 중 DELETEQ TS, READQ TS, WRITEQ TS 명령어에서

Function Shipping 기능을 활용할 수 있다.

파일 또는 TDQ와 달리 TSQ를 이용한 Function Shipping은 명령어에서 “SYSID” 옵션

으로 원격 시스템의 SYSID 식별자를 지정하는 방법만 가능하다.

6.4 Distributed Program Link

Distributed Program Link(DPL)는 OSC 어플리케이션 프로그램에서 원격 OSC 어플

리케이션 서버에 존재하는 프로그램을 링크하는 기능이다. 원격으로 연결하려는 프로

그램과 수행될 어플리케이션 서버가 같은 노드에 있는 경우, 현재 OSC 시스템 구조상



SYSID를 이용하지 않고도 링크가 가능하므로 DPL 기능을 사용하는 것을 추천하지

않는다. 연결하려는 프로그램이 다른 노드에 존재하는 경우, DPL을 이용하여 프로그

램을 링크하여 유용하게 사용할 수 있다.

어플리케이션 프로그램에서 DPL을 사용하기 위해서는, EXEC CICS LINK 명령어의

“SYSID” 옵션에 원격 어플리케이션 서버의 식별자를 지정한다.

DPL은 다음과 같은 방식으로 작동한다.

1. LINK 명령어를 처리하는 프로그램 매니저는 “SYSID” 옵션으로 받은 식별자에 대

한 CONNECTION 리소스 정의를 찾는다.

2. 해당 CONNECTION 리소스 정의의 TYPE이 INTERNAL인지 확인한다.

현재 TYPE은 INTERNAL만 지원한다.

3. CONNECTION 리소스 정의의 NETNAME에 기술된 원격 서버의 이름에 따라, 원

격 서버의 미러 서버에 미러 서비스를 요청한다.

참고: 원격 서버에 대한 미러 서버와 미러 서비스 등록 방법은 OpenFrame 안내서 중 “OSC 운

영자 안내서”를 참고한다.

4. 미러 서비스는 내부적으로 프로그램을 링크하여 실행한 다음 COMMAREA를 통

해 DPL을 요청한 프로그램으로 돌려준다.

“SYSNCONRETURN” 옵션이 지정된 경우, 미러 서비스는 요청된 프로그램을 실행한

뒤 바로 SYNCPOINT 처리를 하고 COMMAREA를 돌려주면서 종료한다.

반면 “SYSNCONRETURN” 옵션이 지정되지 않은 경우, 미러 서비스는 요청된 프로

그램 실행한 뒤에도 SYNCPOINT 처리 없이 SYNCPOINT 처리 요청이 올 때까지 기

다린다. 어플리케이션 프로그램에서 SYNCPOINT 또는 SYNCPOINT ROLLBACK 명

령어를 실행하거나, 태스크가 종료되는 경우에는 미러 서비스도 커밋 또는 롤백한다.

Appendix. A CICS Command Reference



A.1 어플리케이션 프로그래밍 인터페이스

ABEND 시놉시스 EXEC CICS ABEND [ABCODE(name)] [CANCEL] [NODUMP] END-EXEC.

파라미터 영역 이름 지원 여부 기타 ABCODE 지원 CANCEL 지원 NODUMP 지원

지원 조건

ADDRESS 시놉시스 EXEC CICS ADDRESS [ACEE(ptr-ref)] [COMMAREA(ptr-ref)] [CWA(ptr-ref)] [EIB(ptr-ref)] [TCTUA(ptr-ref)] [TWA(ptr-ref)] END-EXEC. 파라미터 영역 이름 지원 여부 기타 ACEE 지원 안함 COMMAREA 지원 CWA 지원 EIB 지원 TCTUA 지원 TWA 지원

지원 조건 INVREQ(200)

ADDRESS SET 시놉시스 EXEC CICS ADDRESS SET {SET(data-area) USING(ptr-ref)|SET(ptr-ref) USING(data-area)} END-EXEC. 파라미터 영역



이름 지원 여부 기타 ABCODE 지원 ABDUMP 지원 안함 ABPROGRAM 지원 안함 ACTIVITY 지원 안함 ACTIVITYID 지원 안함 ALTSCRNHT 지원 안함 ALTSCRNWD 지원 안함 APLKYBD 지원 안함 APLTEXT 지원 안함 APPLID 지원 ASRAINTRPT 지원 안함 ASRAKEY 지원 안함 ASRAPSW 지원 안함 ASRAREGS 지원 안함 ASRASPC 지원 안함 ASRASTG 지원 안함 BRIDGE 지원 안함 BTRANS 지원 안함 CMDSEC 지원 안함 COLOR 지원 안함 CWALENG 지원 DEFSCRNHT 지원 안함 DEFSCRNWD 지원 안함 DELIMETER 지원 안함 DESTOCUNT 지원 안함 DESTID 지원 안함 DESTIDLENG 지원 안함 DSSCS 지원 안함 DS3270 지원 안함 EWASUPP 지원 안함 EXTDS 지원 안함 FACILITY 지원 안함 FCI 지원 안함 GCHARS 지원 안함 GCODES 지원 안함 GMMI 지원 안함 HIGHLIGHT 지원 안함 INITPARM 지원 안함 INITPARMLEN 지원 안함



INPARTN 지원 안함 INVOKINGPROG 지원 안함 KATAKANA 지원 안함 LANGINUSE 지원 안함 LDCMNEM 지원 안함 LDCNUM 지원 안함 MAPCOLUMN 지원 안함 MAPHEIGHT 지원 안함 MAPLINE 지원 안함 MAPWIDTH 지원 안함 MSRCONTROL 지원 안함 NATLANGINUSE 지원 안함 NETNAME 지원 NEXTTRANSID 지원 안함 NUMTAB 지원 안함 OPCLASS 지원 안함 OPERKEYS 지원 안함 OPID 지원 안함 OPSECURITY 지원 안함 ORGABCODE 지원 안함 OUTLINE 지원 안함 PAGENUM 지원 안함 PARTNPAGE 지원 안함 PARTNS 지원 안함 PARTNSET 지원 안함 PRINSYSID 지원 안함 PROCESS 지원 안함 PROCESSTYPE 지원 안함 PROGRAM 지원 안함 PS 지원 안함 QNAME 지원 안함 RESSEC 지원 안함 RESTART 지원 안함 RETURNPROG 지원 안함 SCRNHT 지원 안함 SCRNWD 지원 안함 SIGDATA 지원 안함 SOSI 지원 안함 STARTCODE 지원 STATIONID 지원 안함



SYSID 지원 TASKPRIORITY 지원 안함 TCTUALENG 지원 TELLERID 지원 안함 TERMCODE 지원 안함 TERMPRIORITY 지원 안함 TEXTKYBD 지원 안함 TEXTPRIORITY 지원 안함 TWALENG 지원 UNATTEND 지원 안함 USERID 지원 USERNAME 지원 안함 USERPRIORITY 지원 안함 VALIDATION 지원 안함

지원 조건 INVREQ(1, 2, 3, 4, 5, 200)

BIF DEEDIT 시놉시스 EXEC CICS BIF DEEDIT FIELD(data-area) [LENGTH(data-value)] END-EXEC.

파라미터 영역 이름 지원 여부 기타 FILED 지원 LENGTH 지원

지원 조건

CANCEL 시놉시스 EXEC CICS CANCEL [REQID(name) [SYSID(systemname)] [TRANSID(name)]] END-EXEC. 파라미터 영역 이름 지원 여부 기타 REQID 지원 SYSID 지원 안함 TRANSID 지원 안함

지원 조건 NOTFND, SYSIDERR

CHANGE PASSWORD



시놉시스 EXEC CICS CHANGE PASSWORD(data-value) NEWPASSWORD(data-value) USERID(data-value) END-EXEC. 파라미터 영역 이름 지원 여부 기타 PASSWORD 지원 NEWPASSWORD 지원 USERID 지원 ESMREASON 지원 안함 ESMRESP 지원 안함

지원 조건 INVREQ(18, 29), NOTAUTH(2, 4, 19, 31), USERIDERR(8)

DEFINE COUNTER|DCOUNTER 시놉시스 EXEC CICS DEFINE {COUNTER(name)|DCOUNTER(name)} [POOL(name)] [VALUE(data-value)] [MINIMUM(data-value)] [MAXIMUM(data-value)] END-EXEC. 파라미터 영역 이름 지원 여부 기타 COUNTER 지원 DCOUNTER 지원 POOL 지원 VALUE 지원 MINIMUM 지원 MAXIMUM 지원

지원 조건 INVREQ(403, 404, 406, 407)

DELAY 시놉시스 EXEC CICS DELAY [_INTERVAL(0)_|INTERVAL(hhmmss)|TIME(hhmmss)|FOR [HOURS(data-value)|MINUTES(data-value)|SECONDS(data-value)] [ ...]|UNTIL [HOURS(data-value)|MINUTES(data-value)|SECONDS(data-value)] [ ...]] [REQID(name)] END-EXEC. 파라미터 영역 이름 지원 여부 기타 INTERVAL 지원 TIME 지원 FOR 지원 HOURS 지원 MINUTES 지원



SECONDS 지원 UNTIL 지원 REQID 지원

지원 조건 EXPIRED, INVREQ(4, 5, 6)

DELETE 시놉시스 EXEC CICS DELETE FILE(filename) [TOKEN(data-area)|RIDFLD(data-area) [KEYLENGTH(data-value) [GENERIC [NUMREC(data-area)]]]] [SYSID(systemname)] [NOSUSPEND] [RBA|RRN] END-EXEC. 파라미터 영역 이름 지원 여부 기타 FILE 지원 TOKEN 지원 RIDFLD 지원 KEYLENGTH 지원 GENERIC 지원 NUMREC 지원 SYSID 지원 NOSUSPEND 지원 RBA 지원 RRN 지원

지원 조건 DISABLED(50), DUPKEY(140), FILENOTFOUND(1), INVREQ(20, 25, 26, 31, 42, 47), NOTFND(80), SYSIDERR(0, 130)

DELETE COUNTER|DCOUNTER 시놉시스 EXEC CICS DEFINE {COUNTER(name)|DCOUNTER(name)} [POOL(name)] END-EXEC.

파라미터 영역 이름 지원 여부 기타 COUNTER 지원 DCOUNTER 지원 POOL 지원

지원 조건 INVREQ(201, 403)

DELETEQ TD 시놉시스 EXEC CICS DELETEQ TD QUEUE(name) [SYSID(systemname)] END-EXEC.



파라미터 영역 이름 지원 여부 기타 QUEUE 지원 SYSID 지원

지원 조건 DISABLED, INVREQ, QIDERR, SYSIDERR

DELETEQ TS 시놉시스 EXEC CICS DELETEQ TS {QUEUE(name)|QNAME(name)} [SYSID(systemname)] END-EXEC. 파라미터 영역 이름 지원 여부 기타 QUEUE 지원 QNAME 지원 SYSID 지원

지원 조건 INVREQ, QIDERR, SYSIDERR,

DEQ 시놉시스 EXEC CICS DEQ RESOURCE(data-area) [LENGTH(data-value)] [_UOW_|MAXLIFETIME(cvda)|TASK] END-EXEC. 파라미터 영역 이름 지원 여부 기타 RESOURCE 지원 LENGTH 지원 UOW 지원 MAXLIFETIME 지원 TASK 지원

지원 조건 LENGERR(1)

ENDBR 시놉시스 EXEC CICS ENDBR FILE(filename) [REQID(data-value)] [SYSID(systemname)] END-EXEC. 파라미터 영역 이름 지원 여부 기타 FILE 지원 REQID 지원



SYSID 지원

지원 조건 FILENOTFUND(1), INVREQ(35), SYSIDERR(0, 130)

ENQ 시놉시스 EXEC CICS ENQ RESOURCE(data-area) [LENGTH(data-value)] [_UOW_|MAXLIFETIME(cvda)|TASK] [NOSUSPEND] END-EXEC. 파라미터 영역 이름 지원 여부 기타 RESOURCE 지원 LENGTH 지원 UOW 지원 MAXLIFETIME 지원 TASK 지원 NOSUSPEND 지원

지원 조건 ENQBUSY(0), LENGERR(1)

FORMATTIME 시놉시스 EXEC CICS FORMATTIME ABSTIME(data-area) [DATE(data-area)] [FULLDATE(data-area)] [DATEFORM(data-area)] [DATESEP[(data-value)]] [DAYCOUNT(data-area)] [DAYOFMONTH(data-area)] [DAYOFWEEK(data-area)] [DDMMYY(data-area)] [DDMMYYYY(data-area)] [MMDDYY(data-area)] [MMDDYYYY(data-area)] [MONTHOFYEAR(data-area)] [TIME(data-area) [TIMESEP[(data-value)]]] [YEAR(data-area)] [YYDDD(data-area)] [YYDDMM(data-area)] [YYMMDD(data-area)] [YYYYDDD(data-area)] [YYYYDDMM(data-area)] [YYYYMMDD(data-area)] END-EXEC. 파라미터 영역 이름 지원 여부 기타 ABSTIME 지원 DATE 지원 FULLDATE 지원 DATEFORM 지원 DATESEP 지원 DAYCOUNT 지원 DAYOFMONTH 지원 DAYOFWEEK 지원 DDMMYY 지원 DDMMYYYY 지원 MMDDYY 지원 MMDDYYYY 지원



MONTHOFYEAR 지원 TIME 지원 TIMESEP 지원 YEAR 지원 YYDDD 지원 YYDDMM 지원 YYMMDD 지원 YYYYDDD 지원 YYYYDDMM 지원 YYYYMMDD 지원

지원 조건 INVREA(1)

FREEMAIN 시놉시스 EXEC CICS FREEMAIN {DATA(data-area)|DATAPOINTER(ptr-value)} END-EXEC.

파라미터 영역 이름 지원 여부 기타 DATA 지원 DATAPOINTER 지원

지원 조건

GET COUNTER|DCOUNTER 시놉시스 EXEC CICS GET {COUNTER(name)|DCOUNTER(name)} [POOL(name)] VALUE(data-value) [INCREMENT(data-value) [REDUCE]] [WRAP] [COMPAREMIN(data-value)] [COMPAREMAX(data-value)] END-EXEC. 파라미터 영역 이름 지원 여부 기타 COUNTER 지원 DCOUNTER 지원 POOL 지원 VALUE 지원 INCREMENT 지원 REDUCE 지원 WRAP 지원 COMPAREMIN 지원 COMPAREMAX 지원

지원 조건



INVREQ(201, 403, 404, 406), SUPPRESSED(101, 103)

GETMAIN 시놉시스 EXEC CICS GETMAIN SET(ptr-ref) {FLENGTH(data-value) [BELOW]|LENGTH(data-value)} END-EXEC. 파라미터 영역 이름 지원 여부 기타 SET 지원 FLENGTH 지원 BELOW 지원 안함 LENGTH 지원 INITIMG 지원 SHARED 지원 NOSUSPEND 지원 안함 USERDATAKEY 지원 안함 CICSDATAKEY 지원 안함

지원 조건 LENGERR(1), NOSTG(2)



HANDLE ABEND 시놉시스 EXEC CICS HANDLE ABEND [_CANCEL_|PROGRAM(name)|LABEL(label)|RESET] END-EXEC. 파라미터 영역 이름 지원 여부 기타 CANCEL 지원 PROGRAM 지원 LABEL 지원 RESET 지원

지원 조건 PGMIDERR(1)

HANDLE AID 시놉시스 EXEC CICS HANDLE AID [ANYKEY[(label)]|CLEAR[(label)]|CLRPARTN[(label)]|ENTER[(label)] |LIGHTPEN[(label)]|OPERID[(label)]|PA1-PA3[(label)]|PF1-PF24[(label)]|TRIGGER[(label)]] END-EXEC. 파라미터 영역 이름 지원 여부 기타 ANYKEY 지원 CLEAR 지원 CLRPARTN 지원 ENTER 지원 LIGHTPEN 지원 OPERID 지원 PA1-PA3 지원 PF1-PF24 지원 TRIGGER 지원


HANDLE CONDITION 시놉시스 EXEC CICS HANDLE CONDITION [condition[(label)] [ ...] END-EXEC.

파라미터 영역 이름 지원 여부 기타 condition 지원

지원 조건



IGNORE CONDITION 시놉시스 EXEC CICS IGNORE CONDITION [condition] END-EXEC.

파라미터 영역 이름 지원 여부 기타 condition 지원

지원 조건

ISSUE DISCONNECT 시놉시스 EXEC CICS ISSUE DISCONNECT END-EXEC.

파라미터 영역 이름 지원 여부 기타

지원 조건

LINK 시놉시스 EXEC CICS LINK PROGRAM(name) [COMMAREA(data-area) [LENGTH(data-value)] END-EXEC. 파라미터 영역 이름 지원 여부 기타 COMMAREA 지원 LENGTH 지원 DATALENGTH 지원 INPUTMSG 지원 INPUTMSGLEN 지원 PROGRAM 지원

지원 조건 INVREQ(8, 19, 16), LENGERR(11, 12, 13, 26, 27), PGMIDERR(0, 1, 3)

POP HANDLE 시놉시스 EXEC CICS POP HANDLE END-EXEC.




지원 조건 INVREQ

PUSH HANDLE 시놉시스 EXEC CICS PUSH HANDLE END-EXEC.


지원 조건

QUERY COUNTER|DCOUNTER 시놉시스 EXEC CICS QUERY {COUNTER(name)|DCOUNTER(name)} [POOL(name)] [VALUE(data-area)] [MINIMUM(data-area)] END-EXEC. 파라미터 영역 이름 지원 여부 기타 COUNTER 지원 DCOUNTER 지원 POOL 지원 VALUE 지원 MINIMUM 지원 MAXIMUM 지원

지원 조건 INVREQ(201, 403, 404)

QUERY SECURITY 시놉시스 EXEC CICS QUERY SECURITY {RESTYPE(data-value)|RESCLASS(data-value) END-EXEC. 파라미터 영역 이름 지원 여부 기타 RESTYPE 지원 RESCLASS 지원 RESIDLENGTH 지원 RESID 지원 LOGMESSAGE 지원안함 READ 지원 UPDATE 지원



CONTROL 지원 ALTER 지원

지원 조건 INVREQ(7, 10), LENGERR(6)

READ 시놉시스 EXEC CICS READ FILE(filename) [UNCOMMITTED|CONSISTENT|REPEATABLE|UPDATE [TOKEN(data-area)]] {INTO(data-area)|SET(ptr-ref)} [LENGTH(data-area)] RIDFLD(data-area) [KEYLENGTH(data-value) [GENERIC]] [SYSID(systemname)] [RBA|RRN|DEBKEY|DEBREC] [EQUAL|GTEQ] [NOSUSPEND] END-EXEC. 파라미터 영역 이름 지원 여부 기타 FILE 지원 UNCOMMITTED 지원 안함 CONSISTENT 지원 안함 REPEATABLE 지원 안함 UPDATE 지원 TOKEN 지원 INTO 지원 SET 지원 LENGTH 지원 RIDFLD 지원 KEYLENGTH 지원 GENERIC 지원 SYSID 지원 RBA 지원 RRN 지원 DEBKEY 지원 안함 DEBREC 지원 안함 EQUAL 지원 GTEQ 지원 NUSUSPEND 지원 안함

지원 조건 DISABLED(50), DUPKEY(140), FILENOTFOUND(1), ILLOGIC(110), INVREQ(20, 25, 26, 28, 42), IOERR(120), LENGERR(10, 11, 13), NOTFND(10), NOTOPEN(60), SYSIDERR(0, 130)

READNEXT 시놉시스 EXEC CICS READNEXT FILE(filename) {INTO(data-area)|SET(ptr-ref)} [UNCOMMITTED|CONSISTENT|REPEATABLE|UPDATE TOKEN(data-area)] [LENGTH(data-area)] RIDFLD(data-area) [KEYLENGTH(data-value)]



[REQID(data-value)] [SYSID(systemname)] [RBA|RRN] [NOSUSPEND] END-EXEC. 파라미터 영역 이름 지원 여부 기타 FILE 지원 INTO 지원 SET 지원 UNCOMMITTED 지원 안함 CONSISTENT 지원 안함 REPEATABLE 지원 안함 UPDATE 지원 TOKEN 지원 LENGTH 지원 RIDFLD 지원 KEYLENGTH 지원 REQID 지원 SYSID 지원 RBA 지원 RRN 지원 NOSUSPEND 지원 안함

지원 조건 DISABLED(50), DUPKEY(140), ENDFILE(90), FILENOTFOUND(1), ILLOGIC(110), INVREQ(20, 25, 26, 34, 37, 42), IOERR(120), LENGERR(10, 11, 13), NOTFND(80), NOTOPEN(60), SYSIDERR(0, 130)

READPREV 시놉시스 EXEC CICS READPREV FILE(filename) {INTO(data-area)|SET(ptr-ref)} [UNCOMMITTED|CONSISTENT|REPEATABLE|UPDATE TOKEN(data-area)] [LENGTH(data-area)] RIDFLD(data-area) [REQID(data-value)] [SYSID(systemname)] [RBA|RRN] [NOSUSPEND] END-EXEC. 파라미터 영역 이름 지원 여부 기타 FILE 지원 INTO 지원 SET 지원 UNCOMMITTED 지원 안함 CONSISTENT 지원 안함 REPEATABLE 지원 안함 UPDATE 지원 TOKEN 지원 LENGTH 지원



RIDFLD 지원 REQID 지원 SYSID 지원 RBA 지원 RRN 지원 NOSUSPEND 지원 안함

지원 조건 DISABLED(50), DUPKEY(140), ENDFILE(90), FILENOTFOUND(1), ILLOGIC(110), INVREQ(20, 24, 26, 37, 41), IOERR(120), LENGERR(10, 11, 13), NOTFND(80), NOTOPEN(60), SYSIDERR(0, 130)

READQ TD 시놉시스 EXEC CICS READQ TD QUEUE(name) {INTO(data-area)|SET(ptr-ref)} [LENGTH(data-area)] [SYSID(systemname)] [NOSUSPEND] END-EXEC. 파라미터 영역 이름 지원 여부 기타 QUEUE 지원 INTO 지원 SET 지원 LENGTH 지원 SYSID 지원 NOSUSPEND 지원

지원 조건 INVREQ, IOERR, NOTOPEN, QBUSY, QIDERR, QZERO, SYSIDERR

READQ TS 시놉시스 EXEC CICS READQ TS {QUEUE(name)|QNAME(name)} {INTO(data-area)|SET(ptr-ref)} [LENGTH(data-area)] [NUMITEMS(data-area)] [NEXT|ITEM(data-value)] [SYSID(systemname)] END-EXEC. 파라미터 영역 이름 지원 여부 기타 QUEUE 지원 QNAME 지원 INTO 지원 SET 지원 LENGTH 지원 NUMITEMS 지원 NEXT 지원 ITEM 지원 SYSID 지원



지원 조건 INVREQ, ITEMERR, LENGERR, QIDERR, SYSIDERR

RECEIVE MAP 시놉시스 EXEC CICS RECEIVE MAP(name) [MAPSET(name)] [INTO(data-area)|SET(ptr-ref)] [TERMINAL|FROM(data-area) [LENGTH(data-value)]|TERMINAL [ASIS] [INPARTN(name)]] END-EXEC. 파라미터 영역 이름 지원 여부 기타 MAP 지원 MAPSET 지원 INTO 지원 SET 지원 안함 TERMINAL 지원 안함 FROM 지원 안함 LENGTH 지원 안함 ASIS 지원 안함 INPARTN 지원 안함

지원 조건 MAPFAIL

RESETBR 시놉시스 EXEC CICS RESETBR FILE(filename) RIDFLD(data-area) [KEYLENGTH(data-value) [GENERIC]] [REQID(data-value)] [SYSID(systemname)] [GTEQ|EQUAL] [RBA|RRN] END-EXEC. 파라미터 영역 이름 지원 여부 기타 FILE 지원 RIDFLD 지원 KEYLENGTH 지원 GENERIC 지원 REQID 지원 SYSID 지원 GTEQ 지원 EQUAL 지원 RBA 지원 RRN 지원

지원 조건



DISABLED(50), FILENOTFOUND(1), ILLOGIC(110), INVREQ(25, 26, 36, 42), IOERR(120), NOTFND(80), NOTOPEN(60), SYSIDERR(0, 130)

RETRIEVE 시놉시스 EXEC CICS RETRIEVE {INTO(data-area)|SET(ptr-ref)} [LENGTH(data-area)] [RTRANSID(data-area)] [RTERMID(data-area)] [QUEUE(data-area)] [WAIT] END-EXEC. 파라미터 영역 이름 지원 여부 기타 INTO 지원 SET 지원 LENGTH 지원 RTRANSID 지원 RTERMID 지원 QUEUE 지원 WAIT 지원 안함

지원 조건 ENDDATA, ENVDEFERR, INVREQ, LENGERR

RETURN 시놉시스 EXEC CICS RETURN [TRANSID(name) [COMMAREA(data-area) [LENGTH(data-value)]] [IMMEDIATE]] [INPUTMSG(data-area) [INPUTMSGLEN(data-value)]] [ENDACTIVITY] END-EXEC. 파라미터 영역 이름 지원 여부 기타 TRANSID 지원 COMMAREA 지원 LENGTH 지원 IMMEDIATE 지원 INPUTMSG 지원 INPUTMSGLEN 지원 ENDACTIVITY 지원 안함

지원 조건 INVREQ(1, 2, 8, 200), LENGERR(11, 26, 27)

REWIND COUNTER|DCOUNTER 시놉시스 EXEC CICS REWIND {COUNTER(name)|DCOUNTER(name)} [POOL(name)] [INCREMENT(data-value)] END-EXEC. 파라미터 영역 이름 지원 여부 기타



COUNTER 지원 DCOUNTER 지원 POOL 지원 INCREMENT 지원

지원 조건 INVREQ(201, 403, 404, 406), SUPPRESSED(102)

REWRITE 시놉시스 EXEC CICS REWRITE FILE(filename) [TOKEN(data-area)] FROM(data-area) [LENGTH(data-value)] [SYSID(systemname)] [NOSUSPEND] END-EXEC. 파라미터 영역 이름 지원 여부 기타 FILE 지원 TOKEN 지원 FROM 지원 LENGTH 지원 SYSID 지원 NOSUSPEND 지원 안함

지원 조건 DISABLED(50), DUPREC(150), FILENOTFOUND(1), ILLOGIC(110), INVREQ(30), IOERR(120), LENGERR(10, 14), NOSPACE(100), NOTOPEN(60), SYSIDERR(0, 130)

SEND CONTROL 시놉시스 EXEC CICS SEND CONTROL [CURSOR[(data-value)]] [FORMFEED] [ERASE [DEFAULT|ALTERNATE]|ERASEUP] [PRINT] [FREEKB] [ALARM] [FRSET] [MSR(data-value)] [LDC(name)|[OUTPARTN(name)] [ACTPARTN(name)]] [ACCUM] [TERMINAL|SET(ptr-ref)|PAGING|TERMINAL [WAIT] [LAST]] [REQID(name)] [NOFLUSH] [HONEOM|L40|L64|L80] END-EXEC. 파라미터 영역 이름 지원 여부 기타 CURSOR 지원 FORMFEED 지원 ERASE 지원 DEFAULT 지원안함 ALTERNATE 지원안함 ERASEUP 지원 PRINT 지원 FREEKB 지원 ALARM 지원 FRSET 지원



MSR 지원안함 LDC 지원안함 OUTPARTN 지원안함 ACTPARTN 지원안함 ACCUM 지원안함 TERMINAL 지원안함 SET 지원안함 PAGING 지원안함 WAIT 지원안함 LAST 지원안함 REQID 지원안함 HONEOM 지원안함 L40 지원안함 L64 지원안함 L80 지원안함

지원 조건

SEND MAP 시놉시스 EXEC CICS SEMD MAP(name) [MAPSET(name)] [MAPONLY|[FROM(data-area)] [DATAONLY] [LENGTH(data-value)]] [CURSOR [(data-value)]] [FORMFEED] [ERASE [DEFAULT|ALTERNATE]|ERASEUP] [PRINT] [FREEKB] [ALARM] [FRSET] [NLEOM] [MSR(data-value)] [FMHPARM(name)] [LDC(name)|[OUTPARTN(name)] [ACTPARTN(name)]] [ACCUM] [TERMINAL|SET(ptr-ref)|PAGING|TERMINAL [WAIT] [LAST]] [REQID(name)] [NOFLUSH] [HONEOM|L40|L64|L80] END-EXEC. 파라미터 영역 이름 지원 여부 기타 MAP 지원 MAPSET 지원 MAPONLY 지원 FROM 지원 DATAONLY 지원 LENGTH 지원 CURSOR 지원 FORMFEED 지원 안함 ERASE 지원 DEFAULT 지원 안함 ALTERNATE 지원 안함 ERASEUP 지원 PRINT 지원 FREEKB 지원



ALARM 지원 FRSET 지원 안함 NLEOM 지원 안함 MSR 지원 안함 FMHPARM 지원 안함 LDC 지원 안함 OUTPARTN 지원 안함 ACTPARTN 지원 안함 ACCUM 지원 안함 TERMINAL 지원 안함 SET 지원 안함 PAGING 지원 안함 WAIT 지원 안함 LAST 지원 안함 REQID 지원 안함 NOFLUSH 지원 안함 HONEOM 지원 안함 L40 지원 안함 L64 지원 안함 L80 지원 안함

지원 조건

SEND TEXT 시놉시스 EXEC CICS SEND TEXT FROM(data-area) [LENGTH(data-value)] [CURSOR(data-value)] [FORMFEED] [ERASE [DEFAULT|ALTERNATE]] [PRINT] [FREEKB] [ALARM] [NLEOM] [FMHPARM(name)] [LDC(name)|[OUTPARTN(name)] [ACTPARTN(name)]] [MSR(data-value)] [TERMINAL|SET(ptr-ref)|PAGING|TERMINAL [WAIT] [LAST]] [REQID(name)] [HEADER(data-area)] [TRAILER(data-area)] [JUSTIFY(data-value)|JUSFIRST||JUSLAST] [ACCUM] [HONEOM|L40|L64|L80] END-EXEC. 파라미터 영역 이름 지원 여부 기타 FROM 지원 LENGTH 지원 CURSOR 지원 FORMFEED 지원 안함 ERASE 지원 DEFAULT 지원 안함 ALTERNATE 지원 안함 PRINT 지원



FREEKB 지원 ALARM 지원 NLEOM 지원 안함 FMHPARM 지원 안함 LDC 지원 안함 OUTPARTN 지원 안함 ACTPARTN 지원 안함 MSR 지원 안함 TERMINAL 지원 안함 PAGING 지원 안함 WAIT 지원 안함 LAST 지원 안함 REQID 지원 안함 HEADER 지원 안함 TRAILER 지원 안함 JUSTIFY 지원 안함 JUSFIRST 지원 안함 JUSLAST 지원 안함 ACCUM 지원 안함 HONEOM 지원 안함 L40 지원 안함 L64 지원 안함 L80 지원 안함

지원 조건

SIGNOFF 시놉시스 EXEC CICS SIGNOFF END-EXEC.



SIGNON 시놉시스 EXEC CICS SIGNON USERID(data-value) [ESMREASON(data-area)] [ESMRESP(data-area)] [GROUPID(data-value)] [LANGUAGECODE(data-value)|NATLANG(data-value)] [LANGINUSE(data-area)] [NATLANGINUSE(data-area)] [PASSWORD(data-value)] [NEWPASSWORD(data-value)] [OIDCARD(data-



value)] END-EXEC.

파라미터 영역 이름 지원 여부 기타 USERID 지원 ESMREASON 지원 안함 ESMRESP 지원 안함 GROUPID 지원 LANGUAGECODE 지원 안함 NATLANG 지원 안함 LANGINUSE 지원 안함 NATLANGINUSE 지원 안함 PASSWORD 지원 NEWPASSWORD 지원 OIDCARD 지원 안함

지원 조건 INVREQ(9, 10, 18, 27), NOTAUTH(2, 3, 4, 23)USERIDERR(8, 30)

SPOOLCLOSE 시놉시스 EXEC CICS SPOOLCLOSE TOKEN(data-area) [KEEP|DELETE] END-EXEC.

파라미터 영역 이름 지원 여부 기타 TOKEN 지원 KEEP 지원 DELETE 지원안함

지원 조건 ALLOCERR

SPOOLOPEN OUTPUT 시놉시스 EXEC CICS SPOOLOPEN OUTPUT TOKEN(data-area) USERID(data-value) NODE(data-value) [CLASS(data-value)] [OUTDESCR(ptr-ref)] [NOCC|ASA|MCC] [PRINT|PRINT [RECORDLENGTH(data-value)]|PUNCH] END-EXEC. 파라미터 영역 이름 지원 여부 기타 TOKEN 지원 USERID 지원 NODE 지원 CLASS 지원 OUTDESCR 지원 안함



NOCC 지원 ASA 지원 MCC 지원 PRINT 지원 RECORDLENGTH 지원 PUNCH 지원

지원 조건 ALLOCERR, INVREQ(20, 48), LENGERR

SPOOLWRITE 시놉시스 EXEC CICS SPOOLWRITE TOKEN(data-area) FROM(data-area) [FLENGTH(data-value)] [LINE|PAGE] END-EXEC. 파라미터 영역 이름 지원 여부 기타 TOKEN 지원 FROM 지원 FLENGTH 지원 LINE 지원 PAGE 지원

지원 조건 ALLOCERR, INVREQ(4, 28), NOTOPEN(8, 16), LENGERR

START 시놉시스 EXEC CICS START TRANSID(name) [INTERVAL(0)|INTERVAL(hhmmss)|TIME(hhmmss)|AFTER {HOURS(data-value)|MINUTES(data-value)|SECOND(data-value)} [ ...]|AT {HOURS(data-value)|MINUTES(data-value)|SECOND(data-value)} [ ...]] [REQID(name)] [FROM(data-area) LENGTH(data-value) [FMH]] [TERMID(name)|USERID(data-value)] [SYSID(systemname)] [RTRANSID(name)] [RTERMID(name)] [QUEUE(name)] [NOCHECK] [PROTECT] END-EXEC. 파라미터 영역 이름 지원 여부 기타 TRANSID 지원 INTERVAL 지원 TIME 지원 AFTER 지원 HOURS 지원 MINUTES 지원 SECOND 지원 AT 지원 REQID 지원



FROM 지원 LENGTH 지원 FMH 지원 안함 TERMID 지원 USERID 지원 안함 SYSID 지원 RTRANSID 지원 RTERMID 지원 QUEUE 지원 NOCHECK 지원 안함 PROTECT 지원 안함

지원 조건

STARTBR 시놉시스 EXEC CICS STARTBR FILE(filename) RIDFLD(data-area) [KEYLENGTH(data-value) [GENERIC]] [REQID(data-value)] [SYSID(systemname)] [RBA|RRN|DEBKEY|DEBREC] [GTEQ|EQUAL] END-EXEC. 파라미터 영역 이름 지원 여부 기타 FILE 지원 RIDFLD 지원 KEYLENGTH 지원 GENERIC 지원 REQID 지원 SYSID 지원 RBA 지원 RRN 지원 DEBKEY 지원 안함 DEBREC 지원 안함 GTEQ 지원 EQUAL 지원

지원 조건 DISABLED(50), FILENOTFOUND(1), INVREQ(25, 26, 33, 42), IOERR(120), NOTFND(80), NOTOPEN(60), SYSIDERR(0, 130)

SYNCPOINT 시놉시스 EXEC CICS SYNCPOINT END-EXEC.

파라미터 영역



이름 지원 여부 기타


SYNCPOINT ROLLBACK 시놉시스 EXEC CICS SYNCPOINT ROLLBACK END-EXEC.



UNLOCK 시놉시스 EXEC CICS UNLOCK FILE(filename) [TOKEN(data-area)] [SYSID(systemname)] END-EXEC. 파라미터 영역 이름 지원 여부 기타 FILE 지원 TOKEN 지원 SYSID 지원

지원 조건 DISABLED(50), FILENOTFOUND(1), INVREQ(47), IOERR(120), NOTOPEN(60), SYSIDERR(0, 130)

UPDATE COUNTER|DCOUNTER 시놉시스 EXEC CICS UPDATE {COUNTER(name)|DCOUNTER(name)} [POOL(name)] VALUE(data-value) [COMPAREMIN(data-value)] [COMPAREMAX(data-value)] END-EXEC. 파라미터 영역 이름 지원 여부 기타 COUNTER 지원 DCOUNTER 지원 POOL 지원 VALUE 지원 COMPAREMIN 지원 COMPAREMAX 지원

지원 조건



INVREQ(201, 403, 404, 406), SUPPRESSED(103)

VERIFY PASSWORD 시놉시스 EXEC CICS VERIFY PASSWORD(data-value) USERID(data-value) [CHANGETIME(data-area)] [DAYSLEFT(data-area)] [ESMREASON(data-area)] [ESMRESP(data-area)] [EXPIRYTIME(data-area)] [INVALIDCOUNT(data-area)] [LASTUSETIME(data-area)] END-EXEC. 파라미터 영역 이름 지원 여부 기타 PASSWORD 지원 USERID 지원 CHANGETIME 지원 DAYSLEFT 지원 ESMREASON 지원 안함 ESMRESP 지원 안함 EXPIRYTIME 지원 INVALIDCOUNT 지원 LASTUSETIME 지원

지원 조건 INVREQ(18, 29), NOTAUTH(2, 3, 19)

WRITE 시놉시스 EXEC CICS WRITE FILE(filename) [MASSINSERT] FROM(data-area) [LENGTH(data-value)] RIDFLD(data-area) [KEYLENGTH(data-value)] [SYSID(systemname)] [RBA|RRN] [NOSUSPEND] END-EXEC. 파라미터 영역 이름 지원 여부 기타 FILE 지원 MASSINSERT 지원 FROM 지원 LENGTH 지원 RIDFLD 지원 KEYLENGTH 지원 SYSID 지원 RBA 지원 RRN 지원 NOSUSPEND 지원 안함

지원 조건



DISABLED(50), DUPREC(150), FILENOTFOUND(1), INVREQ(20, 23, 26), IOERR(120), NOSPACE(100), NOTOPEN(60), LENGERR(10, 12, 14), SYSIDERR(0, 130)

WRITEQ TD 시놉시스 EXEC CICS WRITEQ TD QUEUE(name) FROM(data-area) [LENGTH(data-value)] [SYSID(systemname)] END-EXEC. 파라미터 영역 이름 지원 여부 기타 QUEUE 지원 FROM 지원 LENGTH 지원 SYSID 지원

지원 조건 DISABLED, INVREQ, IOERR, NOTOPEN, QIDERR, SYSIDERR

WRITEQ TS 시놉시스 EXEC CICS WRITEQ TS {QUEUE(name)|QNAME(name)} FROM(data-area) [LENGTH(data-value)] [NUMITEMS(data-area)|ITEM(data-area) [REWRITE]] [SYSID(systemname)] [AUXILIARY|MAIN] [NOSUSPEND] END-EXEC. 파라미터 영역 이름 지원 여부 기타 QUEUE 지원 QNAME 지원 FROM 지원 LENGTH 지원 NUMITEMS 지원 ITEM 지원 REWRITE 지원 SYSID 지원 AUXILIARY 지원 MAIN 지원 NOSUSPEND 지원 안함

지원 조건 ITEMERR, LENGERR, QIDERR, SYSIDERR

XCTL 시놉시스 EXEC CICS XCTL PROGRAM(name) [COMMAREA(data-area) [LENGTH(data-value)]] [INPUTMSG(data-area) [INPUTMSGLEN(data-value)]] END-EXEC. 파라미터 영역



PURGEABILITY 지원 안함 REMOTENAME 지원 안함 REMOTESYSTEM 지원 안함 RESSEC 지원 안함 ROUTING 지원 안함 ROUTESTATUS 지원 안함 RTIMEOUT 지원 안함 RUNAWAY 지원 안함 RUNAWAYTYPE 지원 안함 SCRNSIZE 지원 안함 SHUTDOWN 지원 안함 STATUS 지원 STORAGECLEAR 지원 안함 TASKDATAKEY 지원 안함 TASKDATALOC 지원 안함 TCLASS 지원 안함 TRANCLASS 지원 안함 TRACING 지원 안함 TRPROF 지원 안함 TWASIZE 지원 안함

지원 조건 TRANSIDERR(1)

INQUIRE TSQUEUE|TSQNAME 시놉시스 EXEC CICS INQUIRE {TSQUEUE(data-value)|TSQNAME(data-value)} [POOLNAME(data-value)|SYSID(data-value)] [FLENGTH(data-area)|LASTUSEDINT(data-area)|LOCATION(cvda)|MAXITEMLEN(data-area)|MINITEMLEN(data-area)|NUMITEMS(data-area)|RECOVSTATUS(cvda)|TRANSID(data-area)] [ ...] END-EXEC. 파라미터 영역 이름 지원 여부 기타 TSQUEUE 지원 TSQNAME 지원 POOLNAME 지원 안함 SYSID 지원 안함 FLENGTH 지원 LASTUSEDINT 지원 LOCATION 지원 MAXITEMLEN 지원 MINITEMLEN 지원



NUMITEMS 지원 RECOVSTATUS 지원 TRANSID 지원

지원 조건 END(2), ILLOGIC(1), QIDERR(1)

INQUIRE TSMODEL 시놉시스 EXEC CICS INQUIRE TSMODEL(data-value) [LOCATION(cvda)|POOLNAME(data-area)|PREFIX(data-area)|RECOVSTATUS(cvda)|REMOTEPREFIX(data-area)|REMOTESYSTEM(data-area)|SECURITYST(cvda)] [ ...] END-EXEC. 파라미터 영역 이름 지원 여부 기타 TSMODEL 지원 LOCATION 지원 POOLNAME 지원 안함 PREFIX 지원 RECOVSTATUS 지원 REMOTEPREFIX 지원 안함 REMOTESYSTEM 지원 안함 SECURITYST 지원

지원 조건 END(2), ILLOGIC(1), NOTFND(1), QIDERR(1)

SET TSQUEUE|TSQNAME 시놉시스 EXEC CICS SET {TSQUEUE(data-value)|TSQNAME(data-value)} [SYSID(data-value)|POOLNAME(data-value)] [ACTION(cvda) [LASTUSEDINT(data-value)]|DELETE] END-EXEC. 파라미터 영역 이름 지원 여부 기타 TSQUEUE 지원 TSQNAME 지원 SYSID 지원 안함 POOLNAME 지원 안함 ACTION 지원 LASTUSEDINT 지원 DELETE 지원

지원 조건 INVREQ(1, 2, 3), NOTFND(1), QIDERR(1)

openframe osc resource - tmaxsoft · openframe osc resource 참조 3안내서 연락처 korea...

Documents