For z/OS platforms

Liberty 호출 API를 사용하여 외부 주소 공간에서 엔터프라이즈 Bean 호출

WebSphere 최적화 로컬 어댑터(WOLA) 호출 API를 사용하여 외부 주소 공간에서 z/OS®용 로컬 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 파일에 있습니다.

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

이 태스크 정보

엔터프라이즈 Bean을 호출하는 이 방법은 Bean을 호출하기 전에 응답 영역의 길이를 아는 경우를 위한 단순화된 경로를 제공합니다. Bean을 호출할 때 응답 영역의 길이를 모르거나 더 융통성 있는 방법을 원하는 경우에는 Liberty 최적화 로컬 어댑터 API를 사용하여 외부 주소 공간에서 엔터프라이즈 Bean 호출의 내용을 참조하십시오.

프로시저

  1. 호출 API BBOA1INV를 사용하여 Bean을 호출하는 경우 사용할 매개변수를 결정하십시오.
    이 API는 다음 항목을 위한 매개변수를 승인합니다.
    • 등록 API를 호출할 때 지정한 레지스터 이름
    • 요청 유형. 로컬 EJB 작업 요청의 경우 1로 설정되어야 합니다.
    • 호출할 서비스 이름. Stateless 세션 Bean의 JNDI(Java™ Naming and Directory Interface) 로컬 비즈니스 인터페이스 경로 이름이어야 합니다.
    • 서비스 이름의 길이
    • 전송할 요청 데이터의 시작 주소를 가리키는 포인터
    • 전송할 요청 데이터의 길이
    • 응답 데이터 영역의 시작 주소를 가리키는 포인터
    • 전송할 응답 데이터의 길이
    • 연결 제한시간까지의 초 수

    API 매개변수에 대한 자세한 정보는 z/OS용 Liberty의 최적화 로컬 어댑터 API의 내용을 참조하십시오.

  2. 클라이언트 주소 공간의 원시 언어 애플리케이션에서 사용자가 선택한 매개변수로 호출자를 위해 호출 API를 호출하십시오. 대상 EJB(Enterprise JavaBeans) 애플리케이션에서 실행 메소드는 실행한 후 직렬화된 바이트 배열로 원시 언어 호출자에게 응답 데이터를 다시 리턴하기 전에 필요한 비즈니스 로직을 시작합니다.
  3. 응답 데이터를 검토하십시오. 0 리턴 코드와 이유 코드는 클라이언트 호출 API 호출이 성공적으로 완료되었으며 호출자가 지정한 영역에 응답 데이터 및 응답 데이터 길이가 저장되었음을 표시합니다.
  4. 클라이언트 애플리케이션은 동일한 레지스터 이름 호출을 사용하고 필요한 수의 Stateless 세션 Bean을 호출하여 필요한 만큼 자주 이 단계를 반복합니다.
    주의: 호출 API를 사용하여 세 가지 기본 함수 Send_Request, Receive_RespLen 및 Get_Data가 모두 완료되었습니다. 호출 스레드는 응답 데이터가 수신되어 응답 영역에 복사될 때까지 차단됩니다.

결과

클라이언트는 최적화 로컬 어댑터 호출 API를 사용하여 Liberty 서버에서 Stateless 세션 Bean을 시작합니다.

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

파일 이름: twlp_dat_connectejbinvokeapi.html