For z/OS platforms

최적화 로컬 어댑터를 사용하여 로컬 Liberty 서버에 외부 주소 공간 등록

WebSphere 최적화 로컬 어댑터(WOLA)가 로컬 최적화 로컬 어댑터 그룹에 대한 아웃바운드 호출이나 Liberty 서버에 대한 인바운드 호출을 작성할 수 있도록 하려면, 현재 주소 공간을 Liberty 서버에 바인드하고 등록 API를 사용하여 연결 속성을 설정해야 합니다.

시작하기 전에

WOLA을 사용하도록 Liberty 서버 환경을 사용으로 설정하십시오. 추가 정보는 최적화 로컬 어댑터를 사용하도록 Liberty 서버 환경 사용의 내용을 참조하십시오.

Liberty 서버는 등록 요청이 발생한 동일 z/OS 이미지에서 활성이어야 합니다.

CICS®(Customer Information Control System)를 사용 중인 경우, CICS에서 최적화 로컬 어댑터 지원을 사용으로 설정하십시오. 추가 정보는 CICS에서 Liberty 최적화 로컬 어댑터에 대한 지원 사용의 내용을 참조하십시오. CICS 및 Liberty 서버 간의 연결을 작성하기 전에 TRUE(Task-Related User Exit) 프로그램을 활성화하십시오.

프로시저

  1. 등록 API BBOA1REG를 사용하여 주소 공간을 등록하는 경우 사용할 매개변수를 결정하십시오.
    이 API는 다음 항목을 위한 매개변수를 승인합니다.
    • server.xml 파일에 기능을 추가할 때 지정한 WOLA 그룹 이름의 세 파트
    • 레지스터 이름
    • 최소 초기 연결 수
    • 최대 연결 수
    • 추적 동작을 지정하는 등록 플래그 단어

    Liberty 서버에 대한 인바운드 호출의 경우, 요청을 작성하는 주소 공간의 사용자 ID를 포함하는 보안 컨텍스트는 항상 Liberty 서버로 전파됩니다. CICS의 경우 reg_flag_C2Wprop 등록 플래그는 주소 공간의 사용자 ID가 아니라 CICS 태스크의 사용자 ID를 전파합니다.

    Liberty 서버에서의 아웃바운드 호출의 경우, reg_flag_W2Cprop registration 플래그는 Liberty 서버에게 사용자 ID를 CICS로 전파하도록 지시합니다. 그러면 CICS는 해당 사용자 ID로 대상 프로그램을 시작하려고 시도합니다.

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

  2. 이 주소 공간이 연결된 다른 최적화 로컬 어댑터 그룹이 이미 선택된 레지스터 이름을 사용 중이 아닌지 확인하십시오. 다른 최적화 로컬 어댑터 그룹이 해당 레지스터 이름을 사용 중인 경우, 오류 리턴 코드가 반환되며 등록 요청이 실패합니다.
  3. 선택한 매개변수를 사용하여 클라이언트 주소 공간의 원시 언어 애플리케이션에서 호출자에 대해 등록 API를 호출하십시오.

    0 리턴 및 이유 코드는 클라이언트 주소 공간이 이제 Liberty 서버에 바인드되어 있음을 표시합니다.

결과

전달된 레지스터 이름 문자열은 현재 주소 공간에서 예약되어 있습니다. 이 토큰에 대해 등록 해제 API 호출이 수신될 때까지 이 토큰으로 다른 등록 호출을 작성할 수 없습니다.
중요사항: 이 호출에 최소 연결 설정을 사용하는 경우, 결과는 요청의 대상 서버와 대기로 사전 설정된 연결 풀입니다.
등록 항목 컨텍스트 또는 제어 블록도 작성되어 레지스터 이름 문자열에 연관됩니다. 각 고유 레지스터 이름에는 등록 컨텍스트가 있습니다. 주소 공간과 스레드가 동일한 다수의 레지스터 이름은 하나 이상의 Liberty 최적화 로컬 어댑터 그룹과 바인드될 수 있습니다.

다음에 수행할 작업

등록을 사용하여 Liberty 환경과 외부 주소 공간 간의 인바운드 및 아웃바운드 호출을 작성할 수 있습니다. 추가 정보는 Liberty에서 최적화 로컬 어댑터를 사용하는 애플리케이션 개발의 내용을 참조하십시오.

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

파일 이름: twlp_dat_register.html