For z/OS platforms

Liberty 최적화 로컬 어댑터 API를 사용하여 외부 주소 공간에서 엔터프라이즈 Bean 호출

WebSphere 최적화 로컬 어댑터(WOLA) API를 사용하여 외부 주소 공간을 Liberty 서버에 연결하고 로컬 Stateless 세션 Bean을 호출할 수 있습니다.

시작하기 전에

엔터프라이즈 Bean을 최적화 로컬 어댑터 호출의 잠재적인 대상으로 식별하기 위해 EJB(Enterprise JavaBean) 애플리케이션은 com.ibm.websphere.ola.ExecuteLocalBusiness 인터페이스를 로컬 비즈니스 인터페이스로 구현해야 합니다. 이 인터페이스는 wlp/dev/api/ibm/com.ibm.websphere.appserver.api.zosLocalAdapters_1.0.0.jar 파일에 있습니다.

CICS(Customer Information Control System)에서 실행 중인 프로그램의 경우에는 CICS 및 Liberty 서버 간에 연결이 이루어지기 전에 최적화 로컬 어댑터 TRUE(Task-Related User Exit) 프로그램이 활성화되어야 합니다. 추가 정보는 CICS의 Liberty 프로파일 서버 트랜잭션: BBOC, BBO$ 및 BBO#의 내용을 참조하십시오.

Liberty 서버는 등록 요청이 발생한 동일 z/OS® 이미지에서 활성이어야 합니다. 현재 주소 공간이 이미 등록되었으며 등록 API를 사용하여 대상 최적화 로컬 어댑터 그룹에 바인드되었는지 확인하십시오. 외부 주소 공간 등록에 대한 자세한 정보는 최적화 로컬 어댑터를 사용하여 로컬 Liberty 서버에 외부 주소 공간 등록의 내용을 참조하십시오.

이 태스크 정보

Stateless 세션 Bean을 호출하는 이 방법은 더 많은 융통성을 제공하며, 호출하기 전에 응답 영역의 최대 길이를 알지 못하는 상황에 사용됩니다. 응답 영역의 길이를 알고 있는 경우 Bean을 호출하는 간단한 방법은 Liberty 호출 API를 사용하여 외부 주소 공간에서 엔터프라이즈 Bean 호출의 내용을 참조하십시오.

프로시저

  1. 클라이언트 주소 공간의 원시 언어 애플리케이션에서 등록 API BBOA1REG를 호출할 때 사용한 레지스터 이름을 전달하여 연결 가져오기 API BBOA1CNG를 호출하십시오. 이 호출은 이후의 모든 API 호출에 사용되어야 하는 연결 핸들을 리턴합니다.
  2. 클라이언트 주소 공간의 원시 언어 애플리케이션에서 전송 요청 API BBOA1SRQ를 호출하십시오. requestservicename 매개변수에 호출할 엔터프라이즈 Bean의 JNDI(Java Naming and Directory Interface) 로컬 비즈니스 인터페이스 경로 이름을 지정하십시오. 글로벌 JNDI 네임스페이스에 JNDI 이름을 사용하십시오. 그리고 Liberty 서버는 EJB 애플리케이션이 구현하는 로컬 비즈니스 인터페이스에 대해 실행 메소드를 호출합니다.

    요청 전송 API async 매개변수를 0으로 설정하면 API는 응답 길이 및 리턴값을 리턴합니다. 그런 다음 직접 메시지 데이터 가져오기 API를 호출할 수 있습니다.

    요청 전송 API async 매개변수를 1로 설정하면 제어는 애플리케이션에 제어를 리턴하므로 응답 길이 수신 API를 호출할 수 있습니다.

  3. async 매개변수를 1로 설정하여 요청 전송 API를 호출했으면 async 매개변수를 0 또는 1로 설정하여 응답 길이 수신 API BBOA1RCL을 호출하십시오. 클라이언트 애플리케이션은 응답 길이 수신 API가 리턴한 응답 길이를 사용하여 응답 데이터를 보유할 공간이 충분한지 확인합니다.

    응답 길이 수신 API async 매개변수를 0으로 설정하면 API는 응답이 수신될 때까지 스레드를 차단합니다.

    응답 길이 수신 API async 매개변수를 1로 설정하면 API는 응답을 수신했는지 여부에 관계없이 즉시 리턴합니다.

  4. 메시지 데이터 가져오기 API BBOA1GET을 호출하여 응답 데이터를 클라이언트 애플리케이션의 버퍼에 복사하십시오.
  5. 클라이언트 애플리케이션은 모든 요청을 전송하고 연결을 해제할 준비가 될 때까지 동일한 연결 핸들을 사용하여 계속해서 요청을 전송하고 메시지 데이터를 수신할 수 있습니다. 연결을 해제하기 위해 애플리케이션은 연결 해제 API BBOA1CNR을 호출합니다. 연결 핸들을 우선 해제해야만 연결 가져오기 API 호출에 보유되어 다시 사용할 수 있습니다.

주제의 유형을 표시하는 아이콘 태스크 주제

파일 이름: twlp_dat_connectejbapi.html