
CICS의 Liberty 프로파일 서버 트랜잭션: BBOC, BBO$ 및 BBO#
WOLA(WebSphere® Optimized Local Adapter)는 BBOC, BBO$ 및 BBO# 트랜잭션을 통해 CICS® 제품에서 지원됩니다.
최적화된 로컬 어댑터는 CICS 리젼에서 자원 관리자로 실행됩니다. CICS에서 TRUE(Task Related User Exit)는 자원 제공자가 사용하는 1차 수단입니다. TRUE 지원에서는 CICS 애플리케이션 스레드와 외부 자원 관리자 스레드 간 경계를 제공합니다. 현재는 DB2®, WebSphere MQ 및 TCPIP 소켓이 TRUE를 사용하여 CICS에서 실행됩니다.
- 애플리케이션이 제공된 스텁 루틴을 실행합니다.
- 스텁 루틴이 CICS 자원 관리자 인터페이스 모듈을 시작하여 이 모듈에 각 API에 대해 고유한 매개변수, BBOATRUE 및 최적화된 로컬 어댑터 TRUE 루틴의 이름을 전달합니다.
- CICS가 OPENAPI TCB(Task Control Block) 중 하나에 TRUE를 디스패치하고 API 호출이 완료될 때까지 실행됩니다.
- 이 호출이 다시 출력 매개변수와 함께 CICS로 이동합니다.
CICS를 위한 제어 트랜잭션: BBOC
BBOC 트랜잭션은 CICS 아래의 어댑터 지원에 대한 WebSphere 제어(또는 조작 트랜잭션)입니다. Liberty 서버 TRUE를 사용하고 시작하며 Liberty 서버와 인터페이스하는 코드 및 API를 디버깅하기 위한 추적 레벨을 설정하는 트랜잭션을 사용할 수 있습니다. 또한 BBOC는 등록 및 등록 해제를 설정하고 CICS에서 링크 서버 태스크를 시작 및 중지합니다. 이 서버 태스크는 기존 CICS 프로그램을 시작한 후 어댑터를 통해 입력 매개변수가 포함된 COMMAREA 오브젝트 또는 컨테이너와 함께 데이터를 전달하는 데 필요한 지원을 제공합니다. BBOC는 3270 워크스테이션, 또는 순차(또는 SDSCI 유형) 워크스테이션에서 실행할 수 있는 CICS 워크스테이션 기반 트랜잭션입니다.
BBOC 트랜잭션에 대한 구문은 BBOC operation_name parameters입니다. 여기서 여러 매개변수는 하나 이상의 공백으로 구분됩니다.
- RGN
- 12자 등록 이름
- DGN
- 참여할 WOLA 그룹의 처음 8자 이름
- NDN
- 참여할 WOLA 그룹의 두 번째 8자 이름
- SVN
- 참여할 WOLA 그룹의 세 번째 8자 이름
- LSYNC
- LSYNC는 대상 프로그램에 링크될 때 CICS가 SYNCONRETURN 옵션을 전달하는지 여부를 제어합니다. LSYNC=Y를 지정하면 CICS 링크 서버는 EXEC CICS LINK 명령에 SYNCONRETURN 옵션을 전달합니다. 대상 프로그램이 다른 CICS 리젼에 있는 경우 이 옵션을 지정해야 합니다. 기본값은 LSYNC=N입니다.
- SVC
- 최대 8자의 서비스 이름입니다. 이 매개변수는 별표(*)를 사용한 마스킹을 지원합니다. 예를 들어, *, abc*, *abc, abc*xyz, abc*xy*z 등을 지정할 수 있습니다.
- MNC
- 최소 연결 수입니다. 최소값은 0이고 기본값은 1입니다.
- MXC
- 최대 연결 수입니다. 최대값은 9999이고 기본값은 10입니다.
- SEC
- SEC 매개변수는 전파되는 사용자 ID를 제어합니다. 기본값은 SEC=N입니다.
SEC=N을 지정하며 Liberty 서버에 대해 CICS에서 호출 중인 경우, CICS 리젼 사용자 ID가 전파됩니다. SEC=N을 지정하며 링크 서버 태스크(BBO$) 하에서 CICS에 대해 Liberty 서버에서 호출 중인 경우, 링크 태스크가 시작된 링크 서버의 사용자 ID 아래에서 실행됩니다.
SEC=Y를 지정하며 Liberty 서버에 대해 CICS에서 호출 중인 경우, 태스크 레벨 사용자 ID가 Liberty 서버에 전파됩니다. SEC=Y를 지정하며 CICS에 대해 Liberty 서버에서 호출 중인 경우, 링크 서버가 Liberty 서버에서 전파된 사용자 ID로 링크 태스크(BBO#)의 시작을 시도합니다. 이러한 전파는 링크 서버의 사용자 ID가 EXEC CICS START TRAN('BBO#') USERID(<propagated_id>) 명령을 실행할 수 있도록 하기 위해 SAF(System Authorization Facility) SURROGAT 명령을 작성한 경우에만 작동합니다.
- STX
- 사용할 링크 서버 CICS 트랜잭션 ID의
4자 이름입니다. 기본값은 BBO$입니다.
참고: 기본값과 다른 트랜잭션 이름을 정의하는 경우에는 BBO$와 동일한 프로그램 이름 및 속성을 사용하여 기본 CSD(CICS System Definition) 파일 DFHCSD에서 트랜잭션도 정의해야 합니다.
- LTX
- 사용할 링크에서 프로그램으로의 CICS 트랜잭션 ID의
4자 이름입니다. 기본값은 BBO#입니다.
참고: 기본값과 다른 트랜잭션 이름을 정의하는 경우에는 BBO#와 동일한 프로그램 이름 및 속성을 사용하여 기본 CSD(CICS System Definition) 파일 DFHCSD에서 트랜잭션도 정의해야 합니다.
- TRC
- 이 매개변수의 값을 정의하면 다음과 같은 레벨에서 추적을 사용할 수 있습니다.
- 0으로 설정된 경우: 추적 없음(오류 메시지만)
- 1로 설정된 경우: 기본 추적
- 2로 설정된 경우: 자세한 추적
- TDQ
- 어댑터 메시지가 작성되는 CICS 리젼 외부 TDQ(Transient Data Queue)의 4자 이름입니다. 이 매개변수를 지정하지 않는 경우 기본값은 BBOQ 및 DD BBOUT입니다. 지정된 TDQ에 메시지를 작성할 수 없는 경우 메시지는 CICS 리젼 stdout, tdq CESO dd CEEOUT에 작성됩니다.
- REU
- REU는 링크 서버가 프로그램 호출 요청 사이에서 프로그램 링크 호출
태스크(BBO# 트랜잭션)를 재사용하는지 여부를 제어합니다. 중요사항: SEC=N 및 REU=Y를 사용하여 링크 서버를 실행하면 최적화된 로컬 어댑터 JCA는 더 이상 별도의 링크 트랜잭션 ID의 전달을 지원하지 않습니다. 별도의 트랜잭션 ID에 대한 요청을 사용하면 애플리케이션에서 ResourceException이 발생합니다. SEC=Y 및 REU=Y를 사용하여 링크 서버를 실행하는 경우에는 링크 서버가 각 요청에 대해 새 프로그램 링크를 시작하고 전파된 ID를 어설션해야 하므로 재사용 옵션이 아니오로 강제로 설정됩니다.
- REUC
- CICS 링크 태스크(BBO#)가 활성 상태를 유지하고 재사용되는 요청의
수입니다. 이 수에 도달하면 링크 태스크가 종료됩니다.
최대값은 2147483648입니다. 중요사항: 트랜잭션 시나리오의 경우, 링크 태스크는 해당 개수에 도달되며 Liberty 서버로부터 다음 커미트를 수신한 이후에 종료됩니다.
- REUT
- CICS 링크 태스크(BBO#)가 활성 상태를 유지하고 재사용되는 기간(초)입니다.
이 시간 간격이 만료되면 다음 요청이 수신되어 처리된 후 링크 태스크가
종료됩니다. 최대값은 2147483648입니다.
중요사항: 트랜잭션 시나리오의 경우, 링크 태스크는 요청된 시간에 도달하고 Liberty 서버에서 다음 커미트가 수신된 후에 종료됩니다.
| 조작 이름 | 약어 | 설명 | 매개변수 |
|---|---|---|---|
| START_TRUE | STR | Liberty 서버 TRUE 시작 | TRC=<0|1|2> TDQ=<tdqname> |
| STOP_TRUE | PTR | Liberty 서버 TRUE 중지 | TRC=<0|1|2> TDQ=<tdqname> |
| REGISTER | REG | Liberty 서버 WOLA 그룹에 등록 | RGN=<name> DGN=<name> NDN=<name> SVN=<name> MNC=<minimum_number_ of_connections> MXC=<maximum_number_ of_connections> SEC=<Y|N> TRC=<0|1|2> TDQ=<tdqname> |
| UNREGISTER | Liberty 서버 최적화된 로컬 어댑터에서 등록 해제 | RGN=<name> | |
| START_SRVR | STA | 전달된 등록 이름에 대해 Liberty 서버 태스크를 시작합니다. | RGN=<name> DGN=<name> NDN=<name> SVC=<name> SVN=<name> MNC=<minimum_number_ of_connections> MXC=<maximum_number_ of_connections> SEC=<Y|N> STX=<CICS_link_server_ transaction_ID> LTX=<CICS_link_server_ transaction_ID> TRC=<0|1|2> TDQ=<tdqname> REU=<Y|N> REUC=<number_of_requests> REUT=<number_of_seconds> |
| STOP_SRVR | STP | 등록 이름에 대해 Liberty 서버 태스크를 중지합니다. | RGN=<name> TRC=<0|1|2> TDQ=<tdqname> |
샘플 BBOC 명령
- 어댑터 CICS TRUE 프로그램을 시작합니다.
bboc start_true
- 어댑터 CICS TRUE 프로그램을 중지합니다.
bboc stop_true
- 최대 연결 수가 10이고, 최소 연결 수가 5이고 및 보안 전파를 가진 LIB1, LIB2 및 LIB3라는
이름을 가진 WOLA 그룹에서 CICS-HR1이라는 이름으로 등록합니다.
bboc register rgn=CICS-HR1 dgn=LIB1 ndn=LIB2 svn=LIB3 mnc=5 mxc=10 sec=y
- CICS-HR1라는 이름으로 등록 해제합니다.
bboc unregister rgn=CICS-HR1
- 최대 연결 수가 10이고 최소 연결 수가 5이고 보안 전파를 가진 WOLA 그룹을 가진
CICSPAYR이라는 등록 이름 아래의 모든 서비스 및 프로그램 이름에 대해 BBO$로
서버 트랜잭션을 시작합니다.
bboc start_srvr rgn=CICSPAYR dgn=LIB1 ndn=LIB2 svn=LIB3 mnc=5 mxc=10 sec=y
- 등록 이름 CICSPAYR 아래에서 실행 중인 BBO$ 서버 트랜잭션을 중지합니다.
bboc stop_srvr rgn=CICSPAYR
- 최대 연결 수가 10이고 최소 연결 수가 5이고 보안 전파를 가진 WOLA 그룹을 가진
CICSPAY1이라는 등록 이름 아래에서 PAYR로 시작하는 서비스 및 프로그램 이름에 대해
BBO$로 서버 트랜잭션을 시작합니다.
bboc start_srvr rgn=CICSPAY1 dgn=LIB1 ndn=LIB2 svn=LIB3 mnc=5 mxc=10 sec=y svc=PAYR*
- 트랜잭션 ID PAY2 아래에서 서버 트랜잭션을 시작하고 최대 연결 수가 10이고
최소 연결 수가 5이고 기본 추적 및 보안 전파를 가진 WOLA 그룹에서 모든 서비스 및
프로그램 이름에 대해 PAYROLL2라는 이름으로 등록합니다.
bboc start_srvr rgn=PAYROLL2 dgn=LIB1 ndn=LIB2 svn=LIB3 mnc=5 mxc=10 sec=y stx=PAY2 trc=1
- 트랜잭션 ID PAY3 및 링크 트랜잭션 ID PY3L 아래에서 서버 트랜잭션을 시작합니다.
최대 연결 수가 10이고 최소 연결 수가 5이고 기본 추적 및 보안 전파를 가진 WOLA 그룹에서
PAYRL3로 시작하는 서비스 및 프로그램 이름에 대해 PAYROLL3라는 이름으로 등록합니다.
bboc start_srvr rgn=PAYROLL3 dgn=LIB1 ndn=LIB2 svn=LIB3 mnc=5 mxc=10 sec=y svc=PAYRL3* stx=PAY3 ltx=PY3L trc=1
CICS 시작 중에 자동으로 BBOC 명령 실행
- CICS가 시작될 때 최적화된 로컬 어댑터 TRUE를 시작하려면 CICS PLT에서 BBOACLPT를 단계(Phase) 2 또는 단계(Phase) 3 항목으로 추가하십시오.
- CICS가 시작될 때 INITPARM 데이터를 사용하여 BBOC 명령을 실행하려면 CICS PLT에서 BBOACLP2를 단계(Phase) 2 또는 단계(Phase) 3 항목으로 추가하십시오.
INITPARM=(BBOACPL2='STA RGN=PAYROLL DGN=LIB1 NDN=LIB2 SVN=LIB3 SVC=*')
INITPARM=(BBOACPL2='REG RGN=LIBAPP DGN=LIB1 NDN=LIB2 SVN=LIB3 MNC=10 MXC=100')
CICS가 시작될 때 등록을 작성하는 경우에는 애플리케이션에서 등록 API를 사용하지 마십시오. 대신 즉시 다른 API(예: 호출 또는 연결 가져오기)를 사용하십시오.
- 모든 CICS 링크 서버에 대해 BBOC STOP_SERVER를 실행하거나 모든 등록에 대해 BBOC URG를 실행하십시오.
- BBO$ 태스크를 제거하십시오.
- STOP_SERVER 문자열을 전달하는 각각의 링크 서버에 대한 BBOACNTL에 EXEC CICS LINK 명령을 실행하는 PLT(Program List Table) 종료 프로그램을 쓰십시오.
- CEMT P SHUT,IMMED 명령을 실행하십시오.
CICS를 위한 링크 서버 트랜잭션: BBO$
BBO$ CICS 트랜잭션은 CICS에 대한 Liberty 서버의 호출을 지원합니다. BBO$ 트랜잭션은 특정 등록 이름 및 서비스 이름에 대한 BBOC START_SRVR 조작으로 시작되는 서버 태스크의 인스턴스를 나타내는 비워크스테이션 트랜잭션입니다. 이 서버 태스크는 최적화된 로컬 어댑터 API를 통해 Liberty 서버에서 기존 CICS 프로그램을 시작하는 기능인 프로그램 링크 호출 기능을 제공합니다.BBOC START_SRVR 명령에서 STX=name을 지정하여 트랜잭션(BBO$)의 이름을 대체할 수 있습니다. BBO$와 동일한 프로그램 이름 및 속성으로 새 트랜잭션 이름을 CICS에 대해 정의해야 합니다. 자세한 정보는 CICS에 대한 최적화된 로컬 어댑터 정의의 내용을 참조하십시오.
CICS를 위한 프로그램 링크 호출 트랜잭션: BBO#
BBO# CICS 트랜잭션은 CICS에 대한 Liberty 서버의 호출을 지원합니다. BBO# 트랜잭션은 링크 서버 태스크(BBO$)가 프로그램 링크를 호출하기 위해 시작하는 태스크의 인스턴스를 나타내는 비워크스테이션 트랜잭션입니다. BBO$ 트랜잭션은 Liberty 서버 애플리케이션에서 각 CICS 프로그램 링크 요청에 대해 BBO#를 시작합니다.BBOC START_SRVR 명령에서 LTX=name을 지정하여 트랜잭션(BBO#)의 이름을 대체할 수 있습니다. BBO#와 동일한 프로그램 이름 및 속성으로 새 트랜잭션 이름을 CICS에 대해 정의해야 합니다. 자세한 정보는 CICS에 대한 최적화된 로컬 어댑터 정의의 내용을 참조하십시오. 또는 Liberty 서버 애플리케이션은 JCA setLinkTaskTransid 메소드를 사용하여 새 트랜잭션 이름을 CICS에 전달할 수 있습니다.
참조 주제