리소스 정의 종류 및 속성
본 장에서는 리소스 정의 종류 및 속성에 대해 설명한다.
1. 개요
OSC는 아래와 같이 다양한 리소스 정의를 제공한다. 각 리소스 정의는 특징에 따라 다양한 설정 항목을 가진다. 따라서 운영자는 애플리케이션 프로그램에서 사용하는 리소스에 따라 아래의 리소스 정의를 적절하게 설정하도록 한다.
리소스 | 설명 |
---|---|
OSC 애플리케이션 서버에서 다른 OSC 애플리케이션 서버로 연결하기 위한 정보를 정의한다. |
|
문서 템플릿의 속성을 정의한다. |
|
파일의 물리적인 데이터 셋 설정 및 파일의 동작과 관련된 항목 설정을 정의한다. |
|
OSC 저널 이름과 실제 저널 레코드가 기록될 물리적인 데이터 셋과 연결 정보를 정의한다. |
|
트랜잭션 또는 트랜잭션의 일부를 수행하기 위한 프로그램 컨트롤 정보와 관련이 있는 항목을 정의한다. |
|
TDQ(Transient Data Queue)의 속성을 정의한다. |
|
OSC와 통신하는 터미널의 특성, 현재 사용 여부 등을 정의한다. |
|
트랜잭션을 그룹핑해서 동시에 실행가능한 트랜잭션수, 큐 카운트를 제어하기 위한 항목을 정의한다. |
|
OSC에서 제공하는 기능(Function)과 관련이 있는 항목을 정의한다. |
|
TSQ(Temporary Storage Queue) 이름의 접두사에 따라 TSQ의 속성을 지정하는 기능을 지원한다. |
|
터미널 그룹에 대한 공통의 속성들을 정의한다. |
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만 지원)
|
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 |
|
다음은 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 |
저널 레코드가 기록될 위치를 지정한다.
|
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) |
|
다음은 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의 유형을 설정한다.
각 유형별로 추가되는 항목이 다르다. 자세한 설명은 각 절을 참고한다. |
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 데이터 셋의 클래스를 지정한다.
|
RECORDSIZE |
레코드 크기이다. 각 경우의 최댓값으로 설정한다. (기본값: 1)
|
BLOCKSIZE |
블록 크기이다. 각 경우의 최댓값으로 설정한다.
|
RECORDFORMAT |
레코드 포맷을 설정하면 BLOCKFORMAT도 함께 설정해야 한다.
|
BLOCKFORMAT |
블록 포맷을 지정한다.
|
PRINTCONTROL |
컨트롤 문자를 지정한다.
|
DISPOSITION |
데이터 셋 정보를 지정한다.
|
DSORG |
JCL에 기술된 DSORG 이름을 지정한다.
|
WRITER |
JCL에 기술된 WRITER 이름을 지정한다.
|
다음은 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가 발생할 때 트랜잭션의 대상을 설정한다.
|
RECOVSTATUS |
오류가 발생할 경우 복구 여부를 설정한다.
|
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로 정의된 터미널 리소스를 가져와 자동으로 로그온을 허용해주도록 한다.
|
AUTINSTNAME |
특정 AUTINSTMODEL을 사용하기 위한 AUTO-INSTALL TERMINAL 모델명을 설정한다. (최대 8Bytes). |
DESCRIPTION |
TERMINAL 리소스 정의의 설명이다. (최대 58Bytes) |
TYPETERM |
터미널과 관련된 TYPETERM 이름이다. (최대 8Bytes) |
NETNAME |
터미널 LU 이름이다. (최대 8Bytes) NETNAME은 동일 애플리케이션 서버에서는 중복되지 않도록 한다. |
INSERVICE |
정의하는 터미널의 상태이다.
|
ALTPRINTCOPY |
ALTPRINTER 항목에 지정된 프린터를 이용할 것인지를 설정한다.
|
ALTPRINTER |
PRINTER에 지정된 프린터가 사용이 불가능할 때 사용할 대체 프린터 이름이다. (최대 4Bytes) 대체 프린터 이름은 TERMINAL 리소스로 정의되어 있어야 한다. |
PRINTCOPY |
인쇄 요청이 왔을 때, PRINTER 항목에 지정된 프린터를 이용할 것인지를 설정한다. PRINTER가 사용이 불가능할 때는 ALTPRINTCOPY 설정에 따라 ALTPRINTER에서 프린트한다.
|
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 설정으로 지원하는 기능이다.
|
다음은 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 |
트랜잭션이 접근하는 리소스들에 대해서 보안 확인 여부를 설정한다.
|
SHUTDOWN |
OSC 종료 과정에서 트랜잭션이 수행될 수 있는지를 설정한다. 해당 트랜잭션은 XLT에 기술되어 있어야 한다.
|
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의 위치를 설정한다.
|
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 |
터미널의 모델 번호를 설정한다.
|
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 화면 크기로 지정된 트랜잭션에서 사용할 화면 크기를 설정한다.
현재 지원하고 있는 ALTERNATE 화면 크기는 24x80, 32x80, 43x80, 27x132이다. |
DEFSCREEN |
PROFILE 정의에 기본 화면 크기로 지정된 트랜잭션에서 사용할 화면 크기를 설정한다.
현재 지원하고 있는 기본 화면 크기는 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 |
사용자의 요청에 의하여 실행될 프로그램을 지정한다. |
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) |