아웃바운드 API를 사용하여 z/OS®용 WebSphere® Application Server에
배치된 애플리케이션에서 외부 주소 공간의 애플리케이션에 연결하려면
이 태스크를 사용하십시오.
시작하기 전에
최적화된 로컬 어댑터 API를 사용하려면 디먼 그룹, 주소 공간,
외부 주소 공간을 설정해야 합니다. 외부 주소 공간은
BBOA1REG API를 호출하여 디먼 그룹에 등록해야 합니다.
외부 주소 공간에서
실행 중인 애플리케이션은 BBOA1SRV, BBOA1RCA 또는 BBOA1RCS를 포함한
API 중 하나를 사용하여 자신을 최적화된 로컬 어댑터 서버 태스크로
설정했어야 합니다.
최적화된 로컬
어댑터 자원 어댑터 아카이브(RAR) 파일, ola.rar은
WebSphere Application Server 관리 콘솔 또는
olaRar.py 스크립트를 사용하여 배치 및 구성됩니다.
프로시저
- 애플리케이션에서 외부 호출을 수행하는 애플리케이션 배치 디스크립터를
찾으하십시오. 이는 아웃바운드 호출을
수행하려는 WebSphere Application Server에
배치되는 애플리케이션입니다.
- 최적화된 로컬 어댑터 연결 팩토리를 가리키는 자원 참조를
작성하십시오. 최적화된
로컬 어댑터 연결 팩토리는 ola.rar 파일이
WebSphere Application Server에 설치될 때 작성됩니다.
- 최적화된 로컬 어댑터에 대한 연결 팩토리를 찾으십시오. JNDI(Java™ Naming
Directory Interface)에서 자원 참조를 검색하여 연결 팩토리를 찾을 수 있습니다.
예를 들어, 다음과 같습니다.
Context ctx = new InitialContext();
ConnectionFactory cf = ctx.lookup("java:comp/env/ola");
- ConnectionSpecImpl 메소드 호출을 작성하고 연결할 레지스터 이름을
제공하십시오. 레지스터
이름을 관리 연결 팩토리에서 속성으로 사용하거나 ConnectionSpecImpl 메소드,
setRegisterName을 사용하여 연결하려는 외부 주소 공간
또는 서브시스템에서 실행 중인 애플리케이션의 등록 이름을 제공할 수 있습니다. 이 이름은 외부 주소 공간
또는 서브시스템의 애플리케이션이 서버 최적화된 로컬 어댑터 API, BBOA1SRV,
BBOA1RCA 또는 BBOA1RCS 중 하나를 사용하여 제공한
등록 이름과 동일해야 합니다. 예를 들어, 다음과 같습니다.
ConnectionSpecImpl csi = new ConnectionSpecImpl();
csi.setRegisterName ("MyRES1");
주의: RegisterName
사용자 정의 특성을 사용하여 ConnectionFactory 오브젝트에
레지스터 이름이 지정된 경우에는 ConnectionSpecImpl 오브젝트에
레지스터 이름을 설정할 필요가 없습니다.
주의: 자원
어댑터 고가용성 기능을 사용하려면
애플리케이션이 setRegisterName 메소드를 사용하지 않는지 확인하고, 대신에
관리 연결의 연결 팩토리 속성에 대상 레지스터 이름을
구성해야 합니다. 고가용성을 구성하는
방법에 대한 자세한 정보는 자원 어댑터 고가용성 지원 사용 주제의 내용을
참조하십시오.
- 옵션: 최적화된 로컬 어댑터 서버 API,
BBOA1SRV, BBOA1RCA 또는 BBOA1RCS를
사용하지 않는 IMS™(Information
Management System) 트랜잭션을 호출 중인 경우 이 단계를
사용하여 IMS OTMA(Open Transaction Manager Access) 매개변수를
설정하십시오. IMS OTMA 서버 이름,
XCF 그룹 ID, 트랜잭션 레벨을 관리 연결 팩토리의
속성으로 설정하거나 해당 ConnectionSpecImpl
setter 메소드, setOTMAServerName, setOTMAGroupID, setOTMATranLevel을
사용하여 연결하려는 외부 주소 공간 또는 서브시스템에서
실행 중인 애플리케이션에 이 정보를 제공할 수
있습니다.
주의: OTMA에 최적화된 로컬 어댑터를 사용할 때에는
등록 이름에 IMS 트랜잭션측의 대응하는 파트가
없습니다. 등록 이름을 설정할 수 있지만
OTMA의 최적화된 로컬 어댑터 호출에는 등록 이름이 사용되지
않습니다. 자세한 정보는 OTMA에서 최적화된 로컬 어댑터로 기존 IMS 트랜잭션 호출 주제의 내용을
참조하십시오.
- 연결 팩토리를 사용하여 연결을 작성하십시오. 예를 들어,
다음과 같습니다.
Connection con = cf.getConnection(csi);
결과
WebSphere Application Server에 배치된 애플리케이션이
외부 주소 공간에 연결되어 외부 주소 공간에서 호스팅되는
서비스를 호출할 준비가 되었습니다.