웹 트랜잭션 연계 특성
연계 특성 파일은 게이트웨이 서블릿에 웹 트랜잭션을 찾을 위치 및 웹 트랜잭션과의 통신 방법을 알립니다. 이 파일에 의해 제공된 함수는 VisualAge® Generator 클라이언트/서버 프로그램의 연계 테이블에 제공된 함수와 비슷합니다. 이 파일은 게이트웨이 서블릿 매개변수에서 hptLinkageProperties 매개변수에 의해 지정됩니다. 기본적으로 연계 특성은 Java™ 자원 폴더의 csogw.properties 파일에 저장됩니다.
연계 특성 파일에는 애플리케이션, serverLinkage 및 옵션이라는 세 가지 유형의 항목이 포함되어 있습니다. 각각의 애플리케이션 항목은 하나 이상의 웹 트랜잭션을 식별하며 해당 웹 트랜잭션에 연결하는 방법을 표시하는 serverLinkage 항목과 관련되어 있습니다.
application.WEBUITRAN=CICS5
application.WEBUI*=CICS5
application.STF*=idaho
application.MATT*=IMSC
application.BASIC*=rtpas400
application.Z*=remoteC
serverLinkage.CICS5.commtype=CICSECI
serverLinkage.CICS5.contable=CSOE037
serverLinkage.CICS5.location=nracics5
serverLinkage.CICS5.serverid=CPMI
serverLinkage.CICS5.javaProperty=my.pkg
serverLinkage.idaho.commtype=TCPIP
serverLinkage.idaho.contable=CSOX437
serverLinkage.idaho.location=machine01
serverLinkage.idaho.serverid=9877
serverLinkage.idaho.javaProperty=my.pak
serverLinkage.IMSC.commtype=TCPIMS
serverLinkage.IMSC.contable=CSOE037
serverLinkage.IMSC.location=carimsc
serverLinkage.IMSC.tcpport=4000
serverLinkage.IMSC.javaProperty=my.pak
serverLinkage.IMSC.imsgroupid=mygroup
serverLinkage.IMSC.imsdestid=IMSC
serverLinkage.IMSC.serverid=*
serverLinkage.rtpas400.commtype=as400
serverLinkage.rtpas400.contable=CSOE037
serverLinkage.rtpas400.location=rtpas400
serverLinkage.rtpas400.javaProperty=my.pag
serverLinkage.rtpas400.library=sdearth
serverLinkage.remoteC.commtype=cicseci
serverLinkage.remoteC.contable=CSOI1252
serverLinkage.remoteC.location=CSONT2
serverLinkage.remoteC.serverid=CPMI
serverLinkage.remoteC.ctgLocation=ctghostname
serverLinkage.remoteC.ctgPort=2006
serverLinkage.remoteC.javaProperty=my.cicspkg
애플리케이션 항목
application.webtran=servername
- webtran
- 웹 트랜잭션의 이름입니다.
최종 문자는 와일드카드 문자(*)일 수 있습니다. 예를 들어, application.webui*=CICS5라는 항목은 webui라는 문자로 시작하는 모든 웹 트랜잭션에 사용됩니다.
웹 트랜잭션 이름과 일치하는 애플리케이션 항목이 여럿 있는 경우에는 가장 구체적인 항목이 우선순위를 가집니다. 예를 들어, 연계 특성 파일에 다음과 같은 항목이 포함되어 있으면 게이트웨이 서블릿이 웹 트랜잭션 webuitran에 액세스합니다.
이 경우에는 두 번째 명령문이 사용됩니다.application.webui*=abc application.webuit*=def - servername
- 애플리케이션 항목 및 특정 웹 트랜잭션에 대한 관련 serverLinkage 항목 세트에
지정하는 임의의 이름입니다. 예를 들어, 다음과 같은 애플리케이션 항목을 생각해 보십시오.
application.SERVER1=CICS5SERVER1이라는 웹 트랜잭션에 액세스하기 위해 게이트웨이 서블릿은 CICS5에 의해 식별되는 serverLinkage 항목을 참조합니다.
ServerLinkage 항목
serverLinkage.servername.parameter=value
- servername
-
특정 웹 트랜잭션에 대한 serverLinkage 항목 세트에 지정하는 임의의 이름입니다. 이 이름은 애플리케이션 항목에 있어야 합니다.
- parameter
- 다음 중 하나입니다.
- commtype
- 웹 트랜잭션에 액세스하는 데 사용되는 통신의 유형을 지정합니다.
올바른 값은 다음과 같습니다.
- AS400
- 웹 트랜잭션이 OS/400®에 상주하는 경우 사용합니다.
- CICSECI
- 웹 트랜잭션이 CICS®(AIX®용 CICS, MVS™용 CICS, Solaris용 CICS 또는 VSE용 CICS)에 상주하는 경우 사용합니다.
- JCICS
- 웹 트랜잭션이 MVS용 CICS에 상주하고 게이트웨이 서블릿이 CICS Liberty에서 실행 중인 경우에 사용합니다.
- DIRECT
- 웹 트랜잭션이 Java 프로그램이고 티어 2 및 티어 3이 동일한 Windows 2000 또는 Windows NT 시스템이고 웹 트랜잭션이 게이트웨이 서블릿이 실행 중인 JVM(Java Virtual Machine)의 스레드에서 실행되게 하려는 경우 사용합니다. 이 경우에만 프로그램 특성 enableJ2EE가 유효합니다.
- TCPIMS
- 웹 트랜잭션이 IMS™ 시스템에 상주하는 경우 사용합니다.
- TCPIP
- 웹 트랜잭션이 네이티브 Windows 2000, Windows NT, OS/2, AIX, HP-UX 또는 Solaris 시스템에 상주하는 경우 사용합니다. 티어 2 및 티어 3 환경이 동일한 Windows 2000 또는 Windows NT 시스템인 경우 TCPIP 대신 commtype DIRECT 사용을 고려해 보십시오.
- contable
- 티어 2 플랫폼에서 사용되는 변환표를 지정합니다. 형식은
다음과 같습니다.
CSOzxxxx;- z
- 티어 3 플랫폼을 참조하는 다음 2진 형식 중 하나입니다.
- I(Intel의 경우)
- E(EBCDIC의 경우)
- J(Java Unicode의 경우)
- X(UNIX의 경우)
- xxxx
- 변환에 사용되는 코드 페이지입니다.
Java 변환 루틴은 UI 레코드의 데이터 정의에 따라 데이터를 변환합니다. 다양한 언어 및 플랫폼의 변환표에 대한 자세한 정보는 VisualAge Generator 클라이언트/서버 통신 안내서를 참조하십시오.
- ctgLocation
- 선택사항입니다. CICS Transaction Gateway가 상주하는 시스템을 지정합니다. commtype=CICSECI일 때 ctgLocation 및 ctgPort를 지정하지 않으면 CICS Transaction Gateway는 로컬인 것으로 가정됩니다.
- ctgPort
- 선택사항입니다. 원격 CICS Transaction Gateway가 청취하는 포트를 지정합니다.
commtype=CICSECI일 때 ctgLocation 및 ctgPort를 지정하지 않으면
CICS Transaction Gateway는
로컬인 것으로 가정됩니다. 참고: CICS Transaction Gateway 리스너의 포트 번호 설정을 위한 프로시저는 해당 프로젝트의 버전에 따라 다릅니다. 버전 3.01의 경우 ctgStart -port 명령을 사용하고 버전 3.03의 경우 JGate -port 명령을 사용하고 기타 버전의 경우 CICS Transaction Gateway 구성 매뉴얼을 참조하십시오. 기본 포트 번호는 2006입니다.
- debugcontable
- contable과 동등하지만 EGL 디버거에 의해
사용됩니다. 생성된 코드가 하나의 테이블을 사용하고 디버거가 두 번째
테이블을 사용하는 경우 이 매개변수를 설정하십시오.
기본값은 contable에 대해 지정된 값입니다.
- location
- commtype=CICSECI 또는 commtype=JCICS인 경우 CICS
클라이언트의 CICSCLI.INI 파일에서 서버 이름에 해당하는 CICS
시스템 ID를 지정합니다.
commtype=TCPIMS, commtype=TCPIP 또는 commtype=AS400인 경우 웹 트랜잭션이 상주하는 시스템의 TCP/IP 호스트 이름을 지정합니다.
JCICS를 사용하여 게이트웨이 서블릿과 동일한 CICS 리젼에 상주하는 CICS 프로그램을 호출하는 경우에는 이 옵션이 필요하지 않습니다.
- remoteapptype
- 웹 트랜잭션이 Java 프로그램이고 commtype=TCPIP인 경우에는 VGJAVA를 값으로 지정하고 그렇지 않으면 이 매개변수를 포함하지 마십시오.
- serverid
- commtype=CICSECI인 경우 캐처의 CICS
트랜잭션 ID를 지정합니다. 대부분의 경우에는 다음에 해당합니다.
- serverid의 값이 CPMI여서 프로그램 DFHMIRS가 호출됩니다.
- CPMI 이외의 트랜잭션 ID를 지정하면 CICS가 CPMI를 시작하여 사용자가 지정하는 CICS 트랜잭션으로 제어를 전환한 후 프로그램 DFHMIRS로 제어를 전환합니다.
트랜잭션 ID가 CPMI가 아닐 때 CPMI를 시작하지 않으려면 trans_id 앞에 tpn_을 추가하십시오. 예를 들어, 트랜잭션 ID가 WEBT인 경우 tpn_WEBT를 지정하십시오. 하지만 트랜잭션 ID가 CPMI인 경우에는 CPMI만 지정하십시오. tpn_ 없이 WEBT를 지정하는 경우 CICS는 CPMI를 시작한 후 제어를 WEBT로 전환합니다.
참고: OS/390®과 관련하여 serverid는 무시되며 다음에 해당하는 경우가 아니면 CICS 트랜잭션은 항상 CPMI로 실행됩니다.- CICS TS V1.3이 PTF UQ47399와 함께 설치되어 있습니다.
- CICS Transaction Gateway가 V3.1.2 이상입니다.
commType=JCICS의 경우 원격 CICS 리젼의 캐처에 대한 CICS trans-id를 지정합니다(기본값은 CPMI임). 지정하는 트랜잭션 ID는 DFHMIRS를 가리켜야 합니다. JCICS를 사용하여 게이트웨이 서블릿과 동일한 CICS 리젼에 상주하는 CICS 프로그램을 호출하는 경우에는 이 옵션이 무시됩니다.
commtype=TCPIP인 경우 serverid는 웹 트랜잭션이 상주하는 시스템에서 청취 소켓의 포트 번호를 지정합니다.
commtype=TCPIMS인 경우 serverid는 IMS 트랜잭션 코드를 지정합니다. serverid=*를 설정하는 경우 servername의 값은 트랜잭션 코드로 사용됩니다.
commtype=AS/400인 경우 serverid는 사용되지 않습니다.
- tcpport
- commtype=TCPIMS인 경우 웹 트랜잭션이 상주하는 시스템에서 청취 소켓의 포트 번호를 지정합니다. 청취 소켓은 ITOC(IMS TCPIP Open Transaction Manager Access connection)에서 구성됩니다.
- javaProperty
- 웹 트랜잭션에 대한 UI 레코드 오브젝트 및 UI 레코드 Bean이 위치하는 Java 패키지를 지정합니다. 이 항목은 대소문자를 구분합니다.
- imsgroupid
- 인증을 위해 연결해야 하는 RACF® 그룹을 지정합니다. 이 항목은 TCPIMS 연결에 대해서만 유효합니다.
- imsdestid
- 웹 트랜잭션이 실행되는 IMS 시스템이 ITOC 구성에 의해 정의된 대로 해당 시스템을 지정합니다. 이 항목은 TCPIMS 연결에 대해서만 유효합니다.
- keyring
- 선택사항입니다. keyring 비밀번호가 지정되는 경우 필수입니다. commtype=CICSECI인 경우 keyring은 Java 도구 keytool.exe 또는 CICS Transaction Gateway 도구 IKEYMAN을 사용하여 생성된 키 저장소의 이름이며 CICS 트랜잭션 게이트웨이는 ssl을 사용하는 것으로 가정됩니다. 기타 commtype의 경우 이 매개변수를 포함하지 마십시오.
- keyringPassword
- 선택사항입니다. keyring이 지정되는 경우 이는 필수입니다. commtype=CICSECI인 경우 keyringPassword는 키 저장소 생성 시 사용되는 비밀번호이며 CICS 트랜잭션 게이트웨이는 ssl을 사용하는 것으로 가정됩니다. 기타 commtype의 경우 이 매개변수를 포함하지 마십시오.
- library
- 웹 트랜잭션이 상주하는 OS/400 시스템에서 라이브러리의 이름을 지정합니다. 티어 3 플랫폼이 OS/400인 경우 이 항목을 생략하거나 공백으로 두면 VisualAge Generator는 QVGEN 라이브러리에서 웹 트랜잭션을 검색한 후 OS/400 변수 QUSRLIBL에 의해 지정된 라이브러리 목록에서 웹 트랜잭션을 검색합니다.
- value
- 매개변수가 설정되는 값입니다.
옵션 항목
- hptGateway.propertiesRefreshInterval=n
- n
- 게이트웨이 서블릿에 의한 연계 특성 파일의 검사 사이에서 경과하는 시간(분)을 지정합니다.
이 항목을 사용하면 웹 애플리케이션 서버를 중지한 후 다시 시작하지 않고도 연계 특성 파일에 대해 작성된 변경사항을 동적으로 적용할 수 있습니다. 검사 후 시작된 웹 트랜잭션은 새 값을 사용하여 호출됩니다. 값이 0이면 게이트웨이 서블릿이 시작 시에만 연계 특성 파일을 검토합니다.
- application.webtran.traceFlag=n
- webtran
- 웹 트랜잭션의 이름입니다(애플리케이션 항목에서 동일하게 이름 지정된 매개변수와 동일함).
- n
- 게이트웨이 서블릿이 내부 통신 계층 추적을 제공할지 여부를 표시합니다. 이는 IBM® 지원 센터에 문의하는 경우에만 유용합니다. 대안으로는 1(추적의 경우) 또는 0(기본값인 없음의 경우)이 있습니다. 통신 계층 추적을 사용하려면 일반적으로 게이트웨이 특성 파일에 있는 게이트웨이 서블릿 매개변수 hptErrorLog가 있어야 합니다.