리소스 정의 종류 및 속성

본 장에서는 리소스 정의 종류 및 속성에 대해 설명한다.

1. 개요

OSC는 아래와 같이 다양한 리소스 정의를 제공한다. 각 리소스 정의는 특징에 따라 다양한 설정 항목을 가진다. 따라서 운영자는 애플리케이션 프로그램에서 사용하는 리소스에 따라 아래의 리소스 정의를 적절하게 설정하도록 한다.

리소스 설명

CONNECTION

OSC 애플리케이션 서버에서 다른 OSC 애플리케이션 서버로 연결하기 위한 정보를 정의한다.

DOCTEMPLATE

문서 템플릿의 속성을 정의한다.

FILE

파일의 물리적인 데이터 셋 설정 및 파일의 동작과 관련된 항목 설정을 정의한다.

JOURNALMODEL

OSC 저널 이름과 실제 저널 레코드가 기록될 물리적인 데이터 셋과 연결 정보를 정의한다.

PROGRAM

트랜잭션 또는 트랜잭션의 일부를 수행하기 위한 프로그램 컨트롤 정보와 관련이 있는 항목을 정의한다.

TDQUEUE

TDQ(Transient Data Queue)의 속성을 정의한다.

TERMINAL

OSC와 통신하는 터미널의 특성, 현재 사용 여부 등을 정의한다.

TRANCLASS

트랜잭션을 그룹핑해서 동시에 실행가능한 트랜잭션수, 큐 카운트를 제어하기 위한 항목을 정의한다.

TRANSACTION

OSC에서 제공하는 기능(Function)과 관련이 있는 항목을 정의한다.

TSMODEL

TSQ(Temporary Storage Queue) 이름의 접두사에 따라 TSQ의 속성을 지정하는 기능을 지원한다.

TYPETERM

터미널 그룹에 대한 공통의 속성들을 정의한다.

LSRPOOL, DB2CONN 리소스는 파싱만 지원한다.

2. CONNECTION

CONNECTION 리소스 정의는 OSC 애플리케이션 서버에서 다른 OSC 애플리케이션 서버로 연결하기 위한 정보를 정의한다. OSC는 CICS와 다르게 CONNECTION 리소스 정의를 등록할 때 SESSION 리소스 정의를 함께 등록하지 않는다.

다음은 CONNECTION 리소스 정의에 설정하는 각 항목에 대한 설명이다(blank는 빈칸을 의미한다).

DEFINE  CONNECTION(connection_name)
        GROUP(resourcegroup_name)
        DESCRIPTION(resource_description)
        NETNAME(oscserver_name)
        PROTOCOL(blank)
        INSERVICE(NO | YES)
항목 설명

CONNECTION

CONNECTION 이름이다. (최대 4Bytes)

DESCRIPTION

CONNECTION 리소스 정의의 설명이다. (최대 58Bytes)

GROUP

리소스 정의 그룹이다. (최대 8Bytes)

NETNAME

연결 대상이 되는 OSC 서버 이름이다. (최대 8Bytes)

PROTOCOL

연결에 사용하는 프로토콜 종류를 설정한다. (현재는 blank만 지원)

  • blank : OSC 애플리케이션 서버로의 연결을 설정한다.

INSERVICE

해당 접속 정보 이용 여부를 설정한다. (NO|YES)

다음은 OSC00001라는 이름의 OSC 애플리케이션 서버로 연결 정보를 갖는 OSCA라는 CONNECTION 리소스를 정의하는 매크로의 예이다.

DEFINE  CONNECTION(OSCA)
        DESCRIPTION(CONNECTION SAMPLE)
        GROUP(TESTGRP)
        NETNAME(OSC00001)
        PROTOCOL()
        INSERVICE(YES)

3. DOCTEMPLATE

DOCTEMPLATE 리소스 정의는 문서 템플릿의 속성을 정의한다

다음은 DOCTEMPLATE 리소스 정의에 설정하는 각 항목에 대한 설명이다.

DEFINE  DOCTEMPLATE(doctemplate_name)
        GROUP(resourcegroup_name)
        DESCRIPTION(resource_description)
        DDNAME(DFHHTML | ddname_name)
항목 설명

DOCTEMPLATE

문서 템플릿 정의의 이름을 지정한다.

DDNAME

템플릿이 PDS에 있는 경우 PDS의 DD 이름을 지정한다. DDNAME에 대한 값을 지정하지 않으면 DFHHTML이 기본값으로 사용된다.

APPENDCRLF, MEMBERNAME, TEMPLATENAME, TYPE 속성은 파싱만 지원한다.

다음은 DOC01라는 이름의 DOCTEMPLATE 리소스를 정의하는 매크로의 예이다.

DEFINE  DOCTEMPLATE(DOC01)
        DESCRIPTION(DOCTEMPLATE SAMPLE)
        GROUP(TESTGRP)
        DDNAME(DFHHTML)

4. FILE

FILE 리소스 정의는 파일의 물리적인 데이터 셋 설정 및 파일의 동작과 관련된 항목 설정을 정의한다.

다음은 FILE 리소스 정의에 설정하는 각 항목에 대한 설명이다.

DEFINE  FILE(file_name)
        GROUP(resourcegroup_name)
        DESCRIPTION(resource_description)
        DSNAME(dataset_name)
        REMOTESYSTEM(sysid)
        REMOTENAME(file_name)
        ADD(NO | YES)
        BROWSE(NO | YES)
        DELETE(NO | YES)
        READ(NO | YES)
        UPDATE(NO | YES)
        OPENTIME(FIRSTREF | STARTUP)
항목 설명

FILE

FILE 이름이다. (최대 8Bytes)

GROUP

리소스 정의 그룹이다. (최대 8Bytes)

DESCRIPTION

FILE 리소스 정의의 설명이다. (최대 58Bytes)

DSNAME

파일에 사용되는 데이터 셋 이름이다. (최대 44Bytes)

REMOTESYSTEM

리모트 시스템의 SYSID이다. (최대 4Bytes)

REMOTENAME

리모트 시스템에서 사용하는 FILE 이름이다. (최대 8Bytes)

ADD

파일에 레코드를 추가할 수 있는지를 설정한다. (NO|YES)

BROWSE

파일에서 레코드를 순차적으로 검색할 수 있는지를 설정한다. (NO|YES)

DELETE

파일에서 레코드를 삭제할 수 있는지를 설정한다. (NO|YES)

READ

파일에서 레코드를 읽을 수 있는지를 설정한다. (NO|YES)

UPDATE

파일에 레코드를 업데이트할 수 있는지를 설정한다. (NO|YES)

OPENTIME

  • FIRSTREF : 처음으로 파일에 대한 요청이 있을 때 열리고, 그전까지는 닫혀있다.

  • STARTUP : OSC가 기동될 때 파일이 열린다.

다음은 OSC.OSDLIB.FILE0001 데이터 셋에 레코드를 추가/읽기만 할 수 있는 FILE0001 파일을 정의하는 매크로의 예이다. FILE0001은 애플리케이션 프로그램이 레코드 추가 및 읽기에 대해 권한을 가지며, 검색/삭제/수정에 대한 권한을 가지지 않도록 설정하였다.

DEFINE  FILE(FILE0001)
        GROUP(TESTGRP)
        DESCRIPTION(FILE SAMPLE)
        DSNAME(OSC.OSDLIB.FILE0001)
        ADD(YES)
        BROWSE(NO)
        DELETE(NO)
        READ(YES)
        UPDATE(NO)

5. JOURNALMODEL

JOURNALMODEL 리소스 정의는 OSC 저널 이름과 실제 저널 레코드가 기록될 물리적인 데이터 셋과 연결 정보를 정의한다. 구 버전의 CICS에서 사용하였던 저널 이름의 경우 호환성을 위해 변경하여 사용하도록 한다.

다음은 JOURNALMODEL 리소스 정의에 설정하는 각 항목에 대한 설명이다.

DEFINE  JOURNALMODEL(journalmodel_name)
        GROUP(resourcegroup_name)
        DESCRIPTION(resource_description)
        JOURNALNAME(journal_name)
        TYPE(SMF|MVS|DUMMY)
        STREAMNAME(stream_name)
항목 설명

JOURNALMODEL

JOURNALMODEL 이름이다. (최대 8Bytes)

GROUP

리소스 정의 그룹이다. (최대 8Bytes)

DESCRIPTION

JOURNALMODEL 리소스 정의의 설명이다. (최대 58Bytes)

JOURNALNAME

저널 이름이다. (최대 8Bytes)

구 버전의 CICS에서 1부터 99까지 숫자를 저널 이름으로 사용하였다면 호환성을 위해 DFHJnn 형태로 변경한다. (nn은 1부터 99까지)

TYPE

저널 레코드가 기록될 위치를 지정한다.

  • SMF : SMF 데이터 셋에 기록한다.

  • MVS : MVS LOG STREAM에 기록한다.

  • DUMMY : 저널 레코드를 기록하지 않는다.

STREAMNAME

TYPE을 MVS로 지정한 경우에 사용한다.

로그 스트림 이름을 지정한다.

다음은 SMF 데이터 셋에 저널 레코드를 기록하는 JNMODEL2와 JNMODEL3를 정의하는 리소스의 매크로 예이다. JNMODEL3은 구 버전의 CICS와 호환성을 위해 DFHJ03으로 저널 이름을 변경하였다.

DEFINE  JOURNALMODEL(JNMODEL2)
        JOURNALNAME(JOURNAL2)
        GROUP(TESTGRP)
        DESCRIPTION(JOURNALMODEL SAMPLE)
        TYPE(SMF)

DEFINE  JOURNALMODEL(JNMODEL3)
        JOURNALNAME(DFHJ03)
        GROUP(TESTGRP)
        DESCRIPTION(JOURNALMODEL SAMPLE)
        TYPE(SMF)

다음은 MVS LOG STREAM에 저널 레코드를 기록하는 JNAUD01를 정의하는 리소스의 매크로 예이다.

DEFINE  JOURNALMODEL(JNAUD01)
        JOURNALNAME(JNAUD01)
        GROUP(TESTGRP)
        DESCRIPTION(JOURNALMODEL SAMPLE)
        TYPE(MVS)
        STREAMNAME(JNAUD01.LOGR01.AUDIT)

6. PROGRAM

PROGRAM 리소스 정의는 트랜잭션 또는 트랜잭션의 일부를 수행하기 위한 프로그램 컨트롤 정보와 관련이 있는 항목을 정의한다.

다음은 PROGRAM 리소스 정의에 설정하는 각 항목에 대한 설명이다.

DEFINE  PROGRAM(program_name)
        GROUP(resource_name)
        DESCRIPTION(resource_description)
        LANGUAGE(COBOL|PLI)
        REMOTESYSTEM(remote_sysid)
        REMOTENAME(remoteprogranm_name)
항목 설명

PROGRAM

PROGRAM 이름이다. (최대 8Bytes)

GROUP

리소스 정의 그룹이다. (최대 8Bytes)

DESCRIPTION

PROGRAM 리소스 정의의 설명이다. (최대 58Bytes)

LANGUAGE

프로그램이 작성된 프로그래밍 언어를 지정한다. (COBOL|PLI)

REMOTESYSTEM

리모트 시스템의 SYSID이다. (최대 4Bytes)

DPL(Distributed Program Link) 요청을 사용하기 위해서 설정이 필요하다.

리모트 시스템에 연결하기 위해서 REMOTESYSTEM 이름과 동일한 이름을 가지는 CONNECTION 리소스 정의의 설정이 필요하다.

REMOTENAME

리모트 시스템에서 사용하는 PROGRAM 이름이다. (최대 8Bytes)

  1. DPL 요청에 대한 자세한 내용은 OpenFrame OSC "개발자 안내서"를 참고한다.

  2. BATCH의 MTPBATCH를 통하여 PHAS <프로그램명>을 수행하여 프로그램을 PHASEIN시킬 수 있다.

다음은 COBOL로 작성된 OIVPMAIN 프로그램을 정의하는 리소스 정의 매크로 예이다.

DEFINE  PROGRAM(OIVPMAIN)
        GROUP(OIVP)
        DESCRIPTION(PROGRAM SAMPLE)
        LANGUAGE(COBOL)

7. TDQUEUE

TDQUEUE 리소스 정의는 TDQ(Transient Data Queue)의 속성을 정의한다. TDQUEUE 리소스 정의 항목에는 파일명과 해당 파일 사용 방법 등이 있다.

TDQ는 기능적인 특징에 따라 Extra-partition, Intra-partition, Log 3가지로 분류할 수 있고, 관리 측면에 따라 Indirect, Remote 2가지로 분류할 수 있다. OSC는 총 5가지의 TDQ에 대해 리소스 정의를 지원한다.

다음은 각 TDQUEUE 리소스의 공통 항목에 대한 설명이다.

DEFINE  TDQUEUE(TDQ_name)
        GROUP(resource_name)
        DESCRIPTION(resource_description)
        TYPE(EXTRA | INDIRECT | INTRA | LOG | REMOTE)
항목 설명

TDQUEUE

TDQ 이름이다. (최대 4Bytes)

GROUP

리소스 정의 그룹이다. (최대 8Bytes)

DESCRIPTION

TDQ 리소스 정의의 설명이다. (최대 58Bytes)

TYPE

TDQUEUE의 유형을 설정한다.

  • EXTRA

  • INDIRECT

  • INTRA

  • LOG

  • REMOTE(기본값)

각 유형별로 추가되는 항목이 다르다. 자세한 설명은 각 절을 참고한다.

7.1. Extra-partition TDQ

Extra-partition TDQ는 TDQ 타입이 EXTRA인 경우 아래 항목을 정의한다.

다음은 Extra-partition TDQ 리소스 정의에 설정하는 각 항목에 대한 설명이다. (blank는 빈칸을 의미한다.)

DEFINE  .......
        DDNAME(DD_name)
        SYSOUTCLASS(문자 | * | blank)
        RECORDSIZE(record_size)
        BLOCKSIZE(block_size)
        RECORDFORMAT(blank | FIXED | VARIABLE)
        BLOCKFORMAT(blank | BLOCKED | UNBLOCKED)
        PRINTCONTROL(blank | ASA | MACHINE)
        DISPOSITION(SHR | OLD | MOD)
        DSORG(PS | DA | IS | PO)
        WRITER(blank | INTRDR)
항목 설명

DDNAME

JCL에 기술된 DD 이름이다. (최대 8Bytes)

SYSOUTCLASS

SYSOUT 데이터 셋의 클래스를 지정한다.

  • 문자 : A..Z 또는 0..9 문자 중에 하나를 설정한다.

  • 애스터리스크(*) : 기본값이다.

  • blank : 빈칸을 의미한다.

RECORDSIZE

레코드 크기이다. 각 경우의 최댓값으로 설정한다. (기본값: 1)

  • SYSOUTCLASS를 설정한 경우 레코드 포맷에 상관없이 최댓값은 8,968이다.

  • SYSOUTCLASS를 설정하지 않은 경우 레코드 포맷에 상관없이 최댓값은 32,767이다.

BLOCKSIZE

블록 크기이다. 각 경우의 최댓값으로 설정한다.

  • SYSOUTCLASS를 설정한 경우, 레코드 포맷이 VARIABLE이면 최댓값은 8,972이고 FIXED이면 최댓값은 8,968이다.

  • SYSOUTCLASS를 설정하지 않은 경우, 레코드 포맷에 상관없이 최댓값은 32,767이다.

RECORDFORMAT

레코드 포맷을 설정하면 BLOCKFORMAT도 함께 설정해야 한다.

  • blank(기본값)

  • FIXED

  • VARIABLE

BLOCKFORMAT

블록 포맷을 지정한다.

  • blank

  • BLOCKED

  • UNBLOCKED

PRINTCONTROL

컨트롤 문자를 지정한다.

  • blank

  • ASA

  • MACHINE

DISPOSITION

데이터 셋 정보를 지정한다.

  • SHR

  • OLD

  • MOD

DSORG

JCL에 기술된 DSORG 이름을 지정한다.

  • PS

  • DA

  • IS

  • PO

WRITER

JCL에 기술된 WRITER 이름을 지정한다.

  • blank

  • INTRDR

다음은 EXTD라는 DD명을 가지고 고정 레코드 길이의 80Byte 레코드 블록을 갖는 EXTD라는 Extra-partition TDQ를 정의하는 매크로의 예이다.

DEFINE  TDQUEUE(EXTD)
        GROUP(TESTGRP)
        DESCRIPTION(EXTRA TDQ SAMPLE)
        TYPE(EXTRA)
        DDNAME(EXTD)
        RECORDSIZE(80)
        RECORDFORMAT(FIXED)
        BLOCKSIZE(80)
        BLOCKFORMAT(BLOCKED)

7.2. Indirect TDQ

Indirect TDQ는 TDQ 타입이 INDIRECT인 경우 아래 항목을 정의한다.

다음은 Indirect TDQ 리소스 정의에 설정하는 각 항목에 대한 설명이다.

DEFINE     .......
           INDIRECTNAME(Indirect TDQ_name)
항목 설명

INDIRECTNAME

간접적으로 가리키는 TDQ 이름이다. (최대 4Bytes)

INDIRECTNAME에 기술되는 TDQ의 TYPE은 모두 가능하다.

다음은 EXTD라는 TDQ를 가리키는 INTD라는 Indirect TDQ를 정의하는 매크로의 예이다.

DEFINE  TDQUEUE(INTD)
        GROUP(TESTGRP)
        DESCRIPTION(INDIRECT TDQ SAMPLE)
        TYPE(INDIRECT)
        INDIRECTNAME(EXTD)

7.3. Intra-partition TDQ

Intra-partition TDQ는 TDQ 타입이 INTRA인 경우 아래 항목을 정의한다.

다음은 Intra-partition TDQ 리소스 정의에 설정하는 각 항목에 대한 설명이다. (blank는 빈칸을 의미한다.)

DEFINE     .......
           ATIFACILITY(TERMINAL | FILE)
           RECOVSTATUS(NO | PHYSICAL | LOGICAL)
           FACILITYID(terminal_id)
           TRANSID(trans_id)
           TIGGERLEVEL(TDQrecord_count)
           USERID(User_id)
항목 설명

ATIFACILITY

ATI가 발생할 때 트랜잭션의 대상을 설정한다.

  • TERMINAL : 터미널로 트랜잭션을 발생시킨다. QZERO가 되지 않는다면 해당 트랜잭션이 다시 실행된다.

  • FILE : 터미널없이 트랜잭션만 발생시킨다.

RECOVSTATUS

오류가 발생할 경우 복구 여부를 설정한다.

  • NO : 복구하지 않는다.

  • PHYSICAL : TDQ에 변경사항이 반영된 시점으로 복구한다.

  • LOGICAL : TDQ에 변경사항이 반영되지 않았더라도 오류가 발생한 시점으로 복구한다.

FACILITYID

ATIFACILITY을 터미널로 설정하면 대상 터미널 식별자를 설정한다.

ATIFACILITY을 FILE로 설정하면 blank를 설정한다. (최대 4Bytes)

TRANSID

ATI 기능을 통해 발생되는 트랜잭션 식별자이다.

TIGGERLEVEL

ATI 기능을 통해 트랜잭션이 발생하기 전에 쌓이는 TDQ 레코드 개수로 최댓값을 지정한다.

TRANSID를 설정하면 기본값은 1이고, 설정하지 않으면 ATI 기능을 사용하지 않는다. ATI 기능을 사용하지 않으려면 TRIGERLEVEL을 0으로 설정한다. (최댓값: 32,767)

USERID

TRANSID가 설정되었을 때 보안 확인을 하기 위해 사용자 이름을 지정한다. (최대 8Bytes)

다음은 오류가 발생했을 때 복구가 가능하고, ATI를 발생시키는 레코드의 개수는 100, 발생하는 트랜잭션 식별자는 OIVP이며 해당 트랜잭션의 대상은 TTRM이라는 터미널로 설정된 ITTD라는 Intra-partition TDQ를 정의하는 매크로의 예이다.

DEFINE  TDQUEUE(ITTD)
        GROUP(TESTGRP)
        DESCRIPTION(INTRA TDQ SAMPLE)
        TYPE(INTRA)
        ATIFACILITY(TERMINAL)
        FACILITYID(TTRM)
        RECOVSTATUS(LOGICAL)
        TRANSID(OIVP)
        TRIGGERLEVEL(100)

7.4. Log TDQ

Log TDQ는 TDQ 타입이 LOG인 경우 아래 항목을 정의한다.

다음은 Log TDQ 리소스 정의에 설정하는 각 항목에 대한 설명이다.

DEFINE     .......
           DDNAME(DD_name)
항목 설명

DDNAME

JCL에 기술된 DD 이름이다. (최대 8Bytes)

다음은 LOGT라는 Log TDQ를 추가하는 매크로 정의 예이다.

DEFINE  TDQUEUE(LOGT)
        GROUP(TESTGRP)
        DESCRIPTION(LOG TDQ SAMPLE)
        TYPE(LOG)
        DDNAME(LOGD)

7.5. Remote TDQ

Remote TD는 TDQ 타입이 REMOTE인 경우 아래 항목을 정의한다.

다음은 Remote TD 리소스 정의에 설정하는 각 항목에 대한 설명이다.

DEFINE     .......
           REMOTENAME(TDQ_name)
           REMOTESYSTEM(remote_sysid)
항목 설명

REMOTENAME

리모트 시스템에서 사용하는 TDQ 이름이다. (최대 8Bytes)

REMOTESYSTEM

리모트 시스템의 SYSID이다. (최대 4Bytes)

다음은 리모트 시스템의 SYSID가 EXTD, 리모트 시스템에서 사용하는 TDQ 이름이 OSCA인 RTDQ를 정의하는 매크로의 예이다.

DEFINE  TDQUEUE(RTDQ)
        GROUP(TESTGRP)
        DESCRIPTION(REMOTE TDQ SAMPLE)
        REMOTESYSTEM(OSCA)
        REMOTENAME(EXTD)

8. TERMINAL

TERMINAL 리소스 정의는 OSC와 통신하는 터미널의 특성, 현재 사용 여부 등을 정의한다.

다음은 TERMINAL 리소스 정의에 설정하는 각 항목에 대한 설명이다.

DEFINE     TERMINAL(terminal_name)
           GROUP(rsourcegroup_name)
           AUTINSTMODEL(NO | YES | ONLY)
           AUTINSTNAME(autoinstallmodel_name)
           DESCRIPTION(resource_description)
           TYPETERM(TYPETERM_name)
           NETNAME(teminalLU_name)
           INSERVICE(NO | YES)
           ALTPRINTCOPY(NO | YES)
           ALTPRINTER(printer_name)
           PRINTCOPY(NO | YES)
           PRINTER(printer_name)
항목 설명

TERMINAL

터미널 이름이다. (최대 4Bytes)

GROUP

리소스 정의 그룹이다. (최대 8Bytes)

AUTINSTMODEL

터미널 정의를 AUTO-INSTALL TERMINAL로 이용할 것인지를 설정한다. AUTINSTMODEL 설정에 따라서 로그온 접속을 시도하는 터미널 LU명이 TERMINAL 리소스에 정의되어 있지 않은 경우, AUTINSTMODEL로 정의된 터미널 리소스를 가져와 자동으로 로그온을 허용해주도록 한다.

  • NO : 터미널 정의를 AUTO-INSTALL TERMINAL 모델로 사용하지 않는다. (기본값)

  • YES : 터미널 정의에 지정된 NETNAME으로 접속한 터미널 LU를 허용하며 AUTO-INSTALL TERMINAL 모델로도 사용가능하다.

  • ONLY : 터미널 정의를 AUTO-INSTALL TERMINAL 모델로만 사용한다.

AUTINSTNAME

특정 AUTINSTMODEL을 사용하기 위한 AUTO-INSTALL TERMINAL 모델명을 설정한다. (최대 8Bytes).

DESCRIPTION

TERMINAL 리소스 정의의 설명이다. (최대 58Bytes)

TYPETERM

터미널과 관련된 TYPETERM 이름이다. (최대 8Bytes)

NETNAME

터미널 LU 이름이다. (최대 8Bytes)

NETNAME은 동일 애플리케이션 서버에서는 중복되지 않도록 한다.

INSERVICE

정의하는 터미널의 상태이다.

  • NO : 터미널은 메시지를 받거나 입력을 전송할 수 없다.

  • YES : 터미널은 트랜잭션을 초기화하고, 자동으로 터미널에 메시지를 전송한다.

ALTPRINTCOPY

ALTPRINTER 항목에 지정된 프린터를 이용할 것인지를 설정한다.

  • NO : 프린트하지 않는다.

  • YES : 프린트한다.

ALTPRINTER

PRINTER에 지정된 프린터가 사용이 불가능할 때 사용할 대체 프린터 이름이다. (최대 4Bytes)

대체 프린터 이름은 TERMINAL 리소스로 정의되어 있어야 한다.

PRINTCOPY

인쇄 요청이 왔을 때, PRINTER 항목에 지정된 프린터를 이용할 것인지를 설정한다. PRINTER가 사용이 불가능할 때는 ALTPRINTCOPY 설정에 따라 ALTPRINTER에서 프린트한다.

  • NO : 프린트하지 않는다.

  • YES : 프린트한다.

PRINTER

인쇄 요청을 수행하기 위한 프린터 이름이다. (최대 4Bytes)

프린터 이름은 TERMINAL 리소스로 정의되어 있어야 한다.

다음은 NETNAME이 TESTTERM이고, TESTTTRM이라는 TYPETERM을 설정 정보로 사용하는 TTRM 터미널을 정의하는 매크로의 예이다. TTRM 터미널은 프린터 요청이 왔을 경우 프린터 PRNT에 프린트를 수행하도록 설정하였다. PRNT는 TERMINAL 리소스로 정의가 되어 있어야 하며 PRNT를 사용할 수 없을 경우 인쇄가 실패한다.

DEFINE  TERMINAL(TTRM)
        GROUP(TEST)
        DESCRIPTION(TERMINAL SAMPLE)
        TYPETERM(TESTTTRM)
        NETNAME(TESTTERM)
        INSERVICE(YES)
        PRINTCOPY(YES)
        PRINTER(PRNT)

9. TRANCLASS

TRANCLASS 리소스 정의는 트랜잭션을 그룹핑해서 동시에 실행가능한 트랜잭션수, 큐카운트를 제어하기 위한 항목을 정의한다.

TRANCLASS 기능은 Tmax의 서버 설정으로 지원하므로 리소스 정의에 맞추어 Tmax 설정이 필요한데, oscadmin 툴에서 자동으로 Tmax 설정을 출력하는 기능을 제공한다. 자세한 설명은 OpenFrame OSC "툴 참조안내서"를 참고한다.

다음은 TRANCLASS 리소스 정의에 설정하는 각 항목에 대한 설명이다.

DEFINE     TRANCLASS(transaction_id)
           GROUP(rsourcegroup_name)
           MAXACTIVE(number)
           PURGETHRESH(NO | number)
항목 설명

TRANCLASS

트랜클래스 이름이다. (최대 8Bytes)

GROUP

리소스 정의 그룹이다. (최대 8Bytes)

MAXACTIVE

동시실행 가능한 트랜잭션 수를 지정한다. Tmax 서버의 MAX 설정으로 지원하는 기능이다.

PURGETHRESH

트랜잭션 요청이 폭주하여 큐에 쌓이는 경우 설정한 값 이상의 요청은 즉시 에러로 응답한다. Tmax 서버의 MAXQCOUNT 설정으로 지원하는 기능이다.

  • NO : 큐의 크기가 무제한이다.

  • number

다음은 TCL1 트랜클래스를 정의하는 리소스 정의 매크로 예이다. 동시실행 가능한 트랜잭션 수는 3개이고, 트랜잭션 요청은 10개까지만 큐에 쌓이도록 설정하였다.

DEFINE  TRANCLASS(TCL1)
        GROUP(DFHGRP)
        MAXACTIVE(3)
        PURGETHRESH(10)

10. TRANSACTION

TRANSACTION 리소스 정의는 OSC에서 제공하는 기능(Function)과 관련이 있는 항목을 정의한다.

OSC 애플리케이션 프로그램은 특정 기능을 제공하기 위해서 하나 또는 여러 개의 프로그램으로 구성이 되어있다. 이러한 프로그램에 대한 요청을 트랜잭션이라 하며, OSC는 트랜잭션 식별자(TRANSID)에 따라 구별을 한다.

다음은 TRANSACTION 리소스 정의에 설정하는 각 항목에 대한 설명이다.

DEFINE     TRANSACTION(transaction_id)
           GROUP(rsourcegroup_name)
           DESCRIPTION(resource_description)
           PROGRAM(program_name)
           RESSEC(NO | YES)
           SHUTDOWN(DISABLED | ENABLED)
           TWASIZE(TWA_size)
항목 설명

TRANSACTION

트랜잭션 이름 또는 트랜잭션 식별자이다. (최대 8Bytes)

GROUP

리소스 정의 그룹이다. (최대 8Bytes)

DESCRIPTION

트랜잭션 리소스 정의의 설명이다. (최대 58Bytes)

PROGRAM

트랜잭션을 실행하기 위해서 OSC에서 컨트롤 정보를 넘겨주는 프로그램 이름이다. (최대 8Bytes)

REMOTESYSTEM

리모트 시스템의 SYSID이다. (최대 4Bytes)

REMOTENNAME

리모트 시스템에서 사용하는 TRANSACTION 이름이다. (최대 8Bytes)

RESSEC

트랜잭션이 접근하는 리소스들에 대해서 보안 확인 여부를 설정한다.

  • NO : 사용자는 모든 리소스에 대한 접근 가능하다.

  • YES : TACF에 의해 리소스 보안을 확인하여 인증된 리소스에 대한 접근이 가능하다.

SHUTDOWN

OSC 종료 과정에서 트랜잭션이 수행될 수 있는지를 설정한다. 해당 트랜잭션은 XLT에 기술되어 있어야 한다.

  • DISABLED : OSC 종료 과정에서 트랜잭션이 수행될 수 없다.

  • ENABLED : OSC 종료 과정에서 트랜잭션이 수행될 수 있다.

TRANCLASS

트랜잭션이 속한 트랜클래스 이름이다. 기본값은 리전 설정 파일에서 지정할수 있다.

TWASIZE

트랜잭션에 할당된 TWA 크기이다. (기본값: 0, 최댓값: 32,767)

다음은 OIVP 트랜잭션을 정의하는 리소스 정의 매크로 예이다. 프로그램 이름은 OIVPMAIN을 설정하고, 보안 확인을 하도록 설정하고 TWASIZE는 255로 설정하였다.

DEFINE  TRANSACTION(OIVP)
        GROUP(OIVP)
        DESCRIPTION(TRANSACTION SAMPLE)
        PROGRAM(OIVPMAIN)
        RESSEC(YES)
        SHUTDOWN(DISABLED)
        TRANCLASS(TCL1)
        TWASIZE(255)

11. TSMODEL

TSMODEL 리소스 정의는 TSQ(Temporary Storage Queue) 이름의 접두사에 따라 TSQ의 속성을 지정하는 기능을 지원한다. TSMODEL 리소스 정의는 TSMODEL 이름과 이 모델을 적용할 TSQ의 접두사를 정의하고, 모델의 적용을 받을 TSQ의 속성으로 LOCATION, RECOVERY 항목을 설정한다.

다음은 TSMODEL 리소스 정의에 설정하는 각 항목에 대한 설명이다.

DEFINE     TSMODEL(TSMODEL_name)
           GROUP(rsourcegroup_name)
           DESCRIPTION(resource_description)
           PREFIX(TSQ_prefix)
           LOCATION(AUX | MAIN)
           RECOVERY(NO | YES)
           SECURITY(NO | YES)
           REMOTESYSTEM(remote_sysid)
항목 설명

TSMODEL

TSMODEL 이름이다. (최대 8Bytes)

GROUP

리소스 정의 그룹이다. (최대 8Bytes)

DESCRIPTION

TSMODEL 리소스 정의의 설명이다. (최대 58Bytes)

PREFIX

TSMODEL의 적용을 받는 TSQ의 접두사를 설정한다. (최대 16Bytes)

LOCATION

TSMODEL의 적용을 받는 TSQ의 위치를 설정한다.

  • AUX : 디스크 공간

  • MAIN : 메모리 공간

RECOVERY

TSMODEL의 적용을 받는 TSQ의 오류가 발생할 경우 복구 여부를 설정한다. (NO|YES)

SECURITY

TSMODEL의 적용을 받는 TSQ의 보안 확인 여부를 설정한다. (NO|YES)

REMOTESYSTEM

리모트 시스템의 SYSID이다. (최대 4Bytes)

리모트 시스템에 연결하기 위해서 REMOTESYSTEM 이름과 동일한 이름을 갖는 CONNECTION 리소스 정의 설정이 필요하다.

다음은 TEST로 시작하는 TSQ에 대해서 저장 장소를 메모리로 선택하고, 복구 기능을 사용하지 않도록 하고, 보안 확인 기능을 사용하도록 TSMODEL을 정의하는 매크로 예이다.

DEFINE  TSMODEL(TESTTSML)
        GROUP(TESTGRP)
        DESCRIPTION(TSMODEL SAMPLE)
        LOCATION(MAIN)
        PREFIX(TEST)
        RECOVERY(NO)
        SECURITY(YES)

12. TYPETERM

TYPETERM 리소스 정의는 터미널 그룹에 대한 공통의 속성들을 정의한다. 만약 동일한 속성을 가진 터미널들이 있다면 해당 속성들을 TYPETERM 리소스 정의에 설정하고, 각 TERMINAL 리소스 정의에 TYPETERM의 이름을 설정하여 여러 터미널이 동일하게 동작하도록 할 수 있다. 각 TERMINAL 리소스 정의는 반드시 TYPETERM 리소스 이름을 설정해야 한다.

TYPETERM 리소스 정의는 일일이 터미널들에 대해 개별 설정을 할 필요가 없이 다수의 터미널에 대해 설정이 가능하여 운영자의 실수를 줄일 수 있고, 설정하는 데 많은 시간이 들지 않도록 하는 장점이 있다.

다음은 TYPETERM 리소스 정의에 설정하는 각 항목에 대한 설명이다.

DEFINE     TYPETERM(TYPETERM_name)
           GROUP(rsourcegroup_name)
           DESCRIPTION(resource_description)
           DEVICE(device_type)
           TERMMODEL( 1 | 2 )
           LOGONMSG(NO | YES)
           AUDIBLEALARM(NO | YES)
           COLOR(NO | YES)
           HILIGHT(NO | YES)
           KATAKANA(NO | YES)
           OUTLINE(NO | YES)
           PROGSYMBOLS(NO | YES)
           VALIDATION(NO | YES)
           FORMFEED(NO | YES)
           SOSI(NO | YES)
           BACKTRANS(NO | YES)
           IOAREALEN(length_byte)
           USERAREALEN(length_byte)
           ATI(NO | YES)
           TTI(NO | YES)
           CREATESESS(NO | YES)
           ALTSCREEN(rows,columns)
           DEFSCRREN(rows,columns)
항목 설명

TYPETERM

TYPETERM 이름이다. (최대 8Bytes)

GROUP

리소스 정의 그룹이다. (최대 8Bytes)

DESCRIPTION

TYPETERM 리소스 정의의 설명이다. (최대 58Bytes)

DEVICE

DEVICE 종류이다. (최대 8Bytes)

TERMMODEL

터미널의 모델 번호를 설정한다.

  • 1 : 12X40의 크기를 지원하는 터미널 또는 3275 Display Station Model 11

  • 2 : 24X80의 크기를 지원하는 터미널 또는 3275 Display Station Model 12

LOGONMSG

Good Morning 트랜잭션 지원 여부를 설정한다. (NO|YES)

AUDIBLEALARM

경고음 발생 기능 지원 여부를 설정한다. (NO|YES)

COLOR

확장 색상 지원 여부를 설정한다. (NO|YES)

HILIGHT

반전, 밑줄, 깜빡임 등의 하이라이트 기능 지원 여부를 설정한다. (NO|YES)

KATAKANA

가타카나 지원 여부를 설정한다. (NO|YES)

OUTLINE

테두리선 지원 여부를 설정한다. (NO|YES)

PROGSYMBOLS

확장 문자 셋 지원 기능(Programmed Symbol Facility) 지원 여부를 설정한다. (NO|YES)

VALIDATION

MANDATORY FILL, MANDATORY ENTER 등의 지원 여부를 설정한다. (NO|YES)

FORMFEED

FORMFEED 지원 여부를 설정한다. (NO|YES)

SOSI

1Byte 문자와 2Byte 문자 혼합 모드 지원 여부를 설정한다. (NO|YES)

BACKTRANS

배경 투명화 지원 여부를 설정한다. (NO|YES)

IOAREALEN

트랜잭션에 전달되는 터미널의 입출력 영역의 길이(최솟값, 최댓값)를 설정한다. (최댓값: 32,767)

USERAREALEN

TCTUA 영역 크기를 지정한다. (기본값: 0, 최솟값: 0, 최댓값: 32,767)

ATI

터미널에서 START 명령 혹은 Intra-Partition의 TDQueue를 통한 ATI 요청을 허용할 것인지 설정한다. (NO|YES, 기본값: NO)

TTI

터미널에서 트랜잭션 기동을 허용할 것인지 설정한다. (NO|YES, 기본값: YES)

CREATESESS

해당 터미널이 Region에 접속하지 않은 상태에서 ATI 요청을 받으면 자동으로 Region에 접속하도록 할 것인지 설정한다. (NO|YES, 기본값: NO)

ALTSCREEN

PROFILE 정의에 ALTERNATE 화면 크기로 지정된 트랜잭션에서 사용할 화면 크기를 설정한다.

  • rows: 행의 크기

  • columns: 열의 크기

현재 지원하고 있는 ALTERNATE 화면 크기는 24x80, 32x80, 43x80, 27x132이다.

DEFSCREEN

PROFILE 정의에 기본 화면 크기로 지정된 트랜잭션에서 사용할 화면 크기를 설정한다.

  • rows: 행의 크기

  • columns: 열의 크기

현재 지원하고 있는 기본 화면 크기는 24x80이다.

다음은 TESTTTRM이라는 TYPETERM을 정의하는 매크로 예이다. 알람 기능이 지원되지 않고 확장 색상을 지원하며, 반전, 밑줄, 깜빡임 등의 효과를 지원한다. 터미널의 입출력 값 길이는 512~4,096Bytes, 일본어 가타카나 문자를 지원하고 필드의 테두리 선을 지원한다. Programmed symbol facility를 지원하며 2Bytes 문자 사용이 가능하다.

소문자를 자동으로 대문자로 변환하지 않는 24x80 크기의 화면 설정 정보와 TCTUA 영역으로 128Bytes를 갖는다. 또한 수행된 트랜잭션이 ALTERNATE 화면 크기가 지정된 PROFILE 정의를 가지고 있으면 27x132 크기의 화면을 사용하고, 기본 화면 크기가 지정된 PROFILE 정의를 가지고 있으면 24x80 크기의 화면을 사용한다.

DEFINE  TYPETERM(TESTTTRM)
        GROUP(TESTGRP)
        DESCRIPTION(TYPETERM SAMPLE)
        AUDIBLEALARM(NO)
        COLOR(YES)
        HILIGHT(YES)
        IOAREALEN(512,4096)
        KATAKANA(YES)
        OUTLINE(YES)
        PROGSYMBOLS(YES)
        SOSI(YES)
        TERMMODEL(2)
        USEARAREALEN(128)
        ATI(YES)
        TTI(YES)
        CREATESESS(YES)
        ALTSCREEN(27,132)
        DEFSCREEN(24,80)

13. URIMAP

URIMAP 리소스 정의는 OSC가 HTTP 클라이언트 혹은 서버로 사용 될 때 정의한다. URIMAP을 통하여 HOST와 PATH를 지정할 수 있으며, HOST와 PATH에 해당하는 외부 클라이언트의 요청을 받거나 HOST와 PATH에 해당하는 외부 서버로 요청을 보낼 수 있다. URIMAP을 통하여 외부 클라이언트로부터 요청이 들어왔을 때, ANALZYER 지정 및 Alias Transaction 을 지정할 수 있으며, Alias Transaction의 경우 DFHWBA 프로그램이 시작될 때 매핑될 트랜잭션명이다. 또한 PROGRAM 명을 지정하여 특정 요청 시 실행 될 프로그램을 지정 할 수 있다.

다음은 URIMAP 리소스 정의에 설정하는 각 항목에 대한 설명이다.

DEFINE     URIMAP(URIMAP_name)
           GROUP(rsourcegroup_name)
           STATUS(ENABLED | DISABLED)
           PATH(path)
           SCHEME(HTTP)
           USAGE(SERVER | CLIENT)
항목 설명

URIMAP

URIMAP 이름이다. (최대 8Bytes)

GROUP

리소스 정의 그룹이다. (최대 8Bytes)

STATUS

URIMAP 정의를 ENABLED 혹은 DISABLED 상태로 지정한다.

PATH

요청을 보내거나 받을 PATH를 지정한다.

SCHEME

HTTP 통신으로 지정한다.

USAGE

OSC를 WEB 서버로서 동작 할 것인지 WEB 클라이언트로서 동작 할 것인지 지정한다. (SERVER | CLIENT)

13.1. WEB Server URIMAP

WEB Server URIMAP은 URIMAP의 USAGE가 SERVER인 경우 아래 항목을 지정한다.

다음은 WEB Server URIMAP 리소스 정의에 설정하는 각 항목에 대한 설명이다.

DEFINE  .......
        HOST(hostname | *)
        TCPIPSERVICE(name)
        MEDIATYPE(type)
        ANALYZER(NO | YES)
        CONVERTER(name)
        TRANSACTION(name)
        PROGRAM(name)
항목 설명

HOST

접속을 허용할 HOST를 지정한다.

TCPIPSERVICE

TCPIPSERVICE 리소스 정의와 연결시켜 PORT 등을 지정할 수 있으며, ANALYZER 프로그램을 사용하는 경우 지정된 TCPIPSERVICE의 URM을 호출한다.

MEDIATYPE

응답의 MEDIATYPE을 지정할 수 있다. (예: text/xml, text/html 등)

ANALYZER

ANALYZER의 사용 유무를 지정 할 수 있다.

CONVERTER

CONVERTER를 사용할 경우 특정 CONVERTER의 이름을 지정 할 수 있다.

TRANSACTION

Alias Transaction을 지정할 수 있다. Alias Transaction은 DFHWBA 프로그램을 호출할 때 사용되는 트랜잭션명이다.

PROGRAM

사용자의 요청에 의하여 실행될 프로그램을 지정한다.

13.2. WEB Client URIMAP

WEB Client URIMAP은 URIMAP의 USAGE가 CLIENT인 경우 아래 항목을 지정한다.

다음은 WEB Client URIMAP 리소스 정의에 설정하는 각 항목에 대한 설명이다.

DEFINE     .......
           HOST(hostname)
           PORT(NO | PORT)
항목 설명

HOST

외부 서버의 HOST를 지정한다.

PORT

외부 서버의 PORT를 지정한다. NO로 지정하는 경우 SCHEME로 지정된 프로토콜의 PORT로 지정된다.

14. TCPIPSERVICE

TCPIPSERVICE 리소스 정의는 OSC의 TCP 단의 설정을 통하여 외부와의 통신을 하는 경우 정의한다. 현재 OSC에서는 TCPIPSERVICE를 단독으로 사용하지 않고, URIMAP과 연동하여 URIMAP으로 들어온 요청에 대하여 ANALYZER 프로그램 혹은 Alias Transaction을 지정할 때 사용된다.

다음은 TCPIPSERVICE 리소스 정의에 설정하는 각 항목에 대한 설명이다.

DEFINE     TCPIPSERVICE(TCPIPSERVICE_name)
           GROUP(rsourcegroup_name)
           URM(program_name)
           PORTNUMBER(port)
           STATUS(OPEN | CLOSED)
           PROTOCOL(HTTP)
           TRANSACTION(CWBA | transaction)
항목 설명

TCPIPSERVICE

TCPIPSERVICE 이름이다. (최대 8Bytes)

GROUP

리소스 정의 그룹이다. (최대 8Bytes)

URM

ANALYZER 프로그램을 지정한다.

PORTNUMBER

요청을 수신할 PORT 지정한다.

STATUS

수신 여부를 지정한다.

PROTOCOL

현재 OSC에서는 HTTP PROTOCOL 만을 지원한다.

TRANSACTION

Alias transaction으로 수행될 트랜잭션명을 지정한다. (기본값: CWBA)