![[z/OS]](../images/ngzos.gif)
z/OS API용 최적화된 로컬 어댑터
WebSphere® Application Server for z/OS® 최적화된 로컬 어댑터는 z/OS 기본 언어 호출 가능 서비스 또는 API(Application Programming Interface) 및 JCA(Java™ EE Connector Architecture) 세트로 지원됩니다.
- Cobol
- C/C++
- PL/I
- 상위 레벨 어셈블러
매개변수 목록이 막대 밑에 있으며 31비트 변환을 사용하여 매개변수를 전달하는 경우 AMODE 64에서 실행 중인 호출자는 API의 AMODE 31 버전을 사용할 수 있습니다(각 매개변수 포인터는 31비트 주소). 64비트에서 실행 중인 호출자는 C, C++ 또는 어셈블러여야 하며 64비트 주소 지정 모드로 실행되어야 합니다. 어셈블러 애플리케이션 형식 4 또는 F4SA에서 BBGA1* 64비트 API를 사용하는 경우, 64비트 저장 영역은 필수이며 이는 호출자의 레지스터를 저장하고 복원하기 위해 최적화된 로컬 어댑터 스텁에서 사용됩니다. C 또는 C++에서 호출되는 경우, <Prod_FS_root>/util/zos/OLASamples/bboaapi.h의 샘플 헤더는 64비트 API를 외부 OS_NOSTACK으로 정의하며 이를 통해 적절한 연계와 저장 영역 규칙으로 호출됩니다.
이 API 문서에서 로컬 연결 용어가 사용되면 z/OS 시스템과 동일한 z/OS 시스템의 WebSphere Application Server에서 외부 주소 공간 사이의 통신에 대해 작성되는 교차 메모리 링크가 참조됩니다. 클라이언트 주소 공간은 동일한 z/OS 이미지에서 실행 중이어야 합니다. 어댑터 API는 각 고유하게 등록된 호출자에 연관된 풀에서 이 로컬 연결을 관리합니다. 12자의 등록 이름은 주소 공간별로 한 개의 연결 풀 세트에 대해서만 사용할 수 있습니다. 단일 주소 공간에서는 고유 등록 수에 대한 제한은 없습니다. 단지 사용 가능한 스토리지 크기로만 제한됩니다.
- 등록 - BBOA1REG/BBGA1REG
- 등록 해제 - BBOA1URG/BBGA1URG
- 연결 가져오기 - BBOA1CNG/BBGA1CNG
- 연결 릴리스 - BBOA1CNR/BBGA1CNR
- 요청 전송 - BBOA1SRQ/BBGA1SRQ
- 응답 전송 - BBOA1SRP/BBGA1SRP
- 응답 전송 예외 - BBOA1SRX/BBGA1SRX
- 모든 요청 수신 - BBOA1RCA/BBGA1RCA
- 특정 요청 수신 - BBOA1RCS/BBGA1RCS
- 응답 길이 수신 - BBOA1RCL/BBGA1RCL
- 메시지 데이터 가져오기 - BBOA1GET/BBGA1GET
- 호출 - BBOA1INV/BBGA1INV
- 호스트 서비스 - BBOA1SRV/BBGA1SRV
- JCA 어댑터 API
등록
BBOA1REG(31비트 호출자) 및 BBGA1REG(64비트 호출자) API를 사용하여 로컬 WebSphere Application Server for z/OS 디먼 그룹 및 서버에 등록할 수 있습니다. BBOA1REG 및 BBGA1REG API는 로컬 WebSphere Application Server 디먼 그룹 및 서버에 대한 최적화된 연결 그룹이 지정한 "registername"으로 할당 및 등록되도록 요청합니다.
API | 구문 |
---|---|
BBOA1REG 또는 BBGA1REG | BBOA1REG (daemongroupname, nodename, servername, registername, minconn, maxconn, registerflags, rc, rsn) BBGA1REG(daemongroupname, nodename, servername, registername, minconn, maxconn , registerflags, rc, rsn) |
매개변수
daemongroupname(입력)결합되는 WebSphere Application Server for z/OS 디먼 그룹의 이름이 포함된 입력 변수 또는 입력 상수입니다. 디먼 그룹 이름은 디먼 작업 이름이 아니라 셀의 짧은 이름과 동일해야 합니다.
이 항목 변수 또는 상수는 정확하게 8자의 널로 종료되는 문자열이어야 하며 참조로 전달되어야 합니다. WebSphere Application Server for z/OS 디먼은 로컬 시스템에서 실행되고 초기화되어야 합니다.
nodename(입력)결합되는 WebSphere Application Server for z/OS의 이름이 포함된 입력 변수 또는 입력 상수입니다. 입력 변수 또는 상수는 참조로 전달되어야 합니다. WebSphere Application Server for z/OS 서버는 로컬 시스템에서 실행되고 초기화되어야 합니다. 이는 정확하게 8자의 공백으로 채워지는 문자열이어야 합니다.
servername(입력)결합되는 WebSphere Application Server for z/OS 서버의 이름(짧은 이름)이 포함된 입력 변수 또는 입력 상수입니다. 입력 변수 또는 상수는 참조로 전달되어야 합니다. WebSphere Application Server for z/OS 서버는 로컬 시스템에서 실행되고 초기화되어야 합니다. 이는 정확하게 8자의 공백으로 채워지는 문자열이어야 합니다.
registername(입력)로컬 연결 세트 등록에 사용되는 이름이 포함된 입력 변수 또는 입력 상수입니다. 이후 호출에서 이 이름은 사용할 연결 풀을 식별해야 합니다. 이는 정확하게 12자의 공백으로 채워지는 문자열이어야 하며 현재 주소 공간에는 사용할 수 없습니다.
minconn(입력)이 등록에 할당되는 연결의 최대 수를 포함하는 정수입니다. 어댑터는 최소 연결 수가 항상 사용 중인 경우 연결 가져오기 요청 중에 이 수만큼 연결 풀을 확장하려고 시도합니다.
registerflags(입력)- reg_flag_trans - 비트 30
트랜잭션 복구가 지원되지 않는 경우 이 등록 및 0으로 연결에 대해 트랜잭션 복구가 지원되는 경우 1이 포함됩니다.
트랜잭션 매개변수가 사용되는 경우 어댑터 API는 z/OS RRS(Resource Recovery Services)에 등록을 시도하고 글로벌 트랜잭션 지원 2단계의 커미트가 WebSphere Application Server 및 API 탐색자 환경 사이에서 작성됩니다.
버전 8.5.0.2부터 IMS™ 종속 리젼을 실행 중이고 이 플래그를 1로 설정하면 IMS 환경은 RRS=YES 및 서버를 사용하여 실행하거나 노드 레벨 환경 변수 ola_rrs_context_propagate4가 구성에 추가되어 true(또는 1)로 설정되어야 합니다. IMS에서 RRS 컨텍스트는 호출 또는 전송 요청 WOLA API가 전파되어 WebSphere Application Server for z/OS EJB 컨테이너에 사용되는 경우 스레드에 영향을 줍니다.
문제점 방지: ola_rrs_context_propagate 변수를 구성 설정에 추가하거나 이 변수에서 설정을 true로 변경하려는 경우 구성 변경 후에 서버를 다시 시작해야 합니다. gotcha
- reg_flag_W2Cprop - 비트 31 또는 비트 64
reg_flag_W2Cprop는 WebSphere Application Server에서 CICS® 아웃바운드 트랜잭션 보안 전파를 제어합니다.
- reg_flag_C2Wprop - 비트 29CICS에서 WebSphere Application Server까지의 호출 태스크의 ID를 전파합니다. CICS에서 WebSphere Application Server까지의 인바운드되는 트랜잭션의 경우 등록 플래그 reg_flag_C2Wprop는 ID 식별 방법을 제어합니다. 이 비트가 설정되면 CICS 애플리케이션 태스크 ID는 WebSphere Application Server 서버 인증 프로세스에 사용됩니다. 이 비트가 off로 설정된 경우 CICS 리젼 ID가 사용됩니다.주의: WebSphere Application Server를 요청되는 CICS 애플리케이션 레벨 보안에 대해 사용되도록 해야 합니다. WebSphere 환경 변수 ola_cicsuser_identity_propagate를 이 유형의 보안 전파가 설정되도록 관리 콘솔에서 1로 설정하십시오.
- reg_flag_trcmod - 비트 0
요청된 등록에 대해 최적화된 로컬 어댑터 추적 설정을 수정하려면 reg_flag_trcmod를 설정하십시오. 이 플래그를 설정하지 않으면 추적 설정이 수정되지 않으며 등록 이름이나 작업 이름에 적용되는 시스템 기본값 또는 사전 정의된 추적 설정이 사용됩니다.
- reg_flag_trcmore - 비트 1 및 reg_flag_trcsome -
비트 2
reg_flag_trcmod를 1로 설정하고 등록에 대해 자세한 추적이나 대단위 레벨 추적을 사용하려면 추적 설정이 지정되도록 reg_flag_trcmore 또는 reg_flag_trcsome을 설정하십시오. reg_flag_trcmod를 1로 설정하고 이 둘을 "off"로 설정하면 사전 정의된 값이나 기본 값에 상관없이 등록에는 아무런 추적도 사용되지 않습니다.
이 호출의 성공 또는 실패를 나타내는 정수의 리턴 코드입니다.
rsn(출력)이 호출 실패에 대한 이유를 설정하는 정수의 이유 코드입니다.
- 이 호출에 지정된 WebSphere Application Server for z/OS 디먼 그룹 및 서버가 시작되고 로컬 어댑터 지원이 사용되도록 해야 합니다.
- 요청된 최소 연결이 WebSphere Application Server 관리 콘솔을 사용하여 구성 가능한 서버 최대 연결에 대해 유효성이 검증됩니다. 3의
최소 연결(minconn) 값은 3개의 연결이 등록 호출 중에 예약되었음을 나타냅니다. 지정된 시간 동안
4 이상의 연결이 요청되면 연결 풀은 최대 연결(maxconn) 값으로 증가 가능합니다. 서버에 대한 모든 연결 수가
허용된 최대값에 도달하는 경우, maxconn 값에 도달하지 않았더라도
해당 서버에 대한 모든 후속 연결 가져오기 API 요청은
거부됩니다. 중요사항: 최소 연결 값 설정 시에는 주의하십시오. 특정 상황을 제외하고는 WebSphere Application Server 제어 리젼에서의 자원은 각 연결에 대해 예약되기 때문에 큰 값으로 설정하는 것은 바람직하지 않습니다.
- 등록 API에 대한 여러 번의 호출은 동일한 주소 공간, 스레드 또는 CICS(Customer Information Control System) 태스크에서 가능하지만 동일한 등록 이름을 공유할 수는 없습니다. 공유 이름은 고유한 이름이어야 합니다.
- 트랜잭션 매개변수를 1로 설정하면 이 등록에 대한 모든 연결이 트랜잭션 가능하게 실행됩니다. 즉, RRS가 현재 주소 공간에서 접속됩니다. 요구사항 및 이를 설정하는 데 필요한 자세한 정보는 트랜잭션 전파 절을 참조하십시오. 트랜잭션 가능성은 WebSphere Application Server 및 CICS 사이에서만 지원됩니다. 다른 환경에서 transactional(1)을 요청하면 등록 호출 중에 경고가 발생하고 플래그는 무시되며 처리는 계속됩니다.
- 등록 해제 API 호출을 사용하여 이 등록을 제거하고 연결된 연결 풀을 해제하십시오.
- 등록 호출을 작성한 주소 공간이 종료되면 등록은 자동으로 종료되고 연결은 릴리스됩니다.
리턴 코드 | 이유 코드 | 설명 | 조치 |
---|---|---|---|
0 | - | 성공 | |
4 | - | 경고 - 이유 코드 참조 | |
4 | 어댑터가 글로벌 트랜잭션을 지원하지 않는 환경에서 트랜잭션 등록 플래그가 1로 설정되었습니다. | 이 설정은 무시되며 처리는 계속됩니다. | |
8 | - | 오류 - 이유 코드 참조 | |
8 | 등록 이름 토큰이 이미 있습니다. | 해당 등록 API를 호출하기 전에 이 이름을 등록 해제해야 합니다. | |
10 | 최대 연결 매개변수가 한 번의 등록에 허용되는 최대 연결 수를 초과합니다. | 등록 API 요청이 거부됩니다. 대상 서버 최적화된 로컬 어댑터 값이 이 요청 및 다른 요청을 모두 수용할 수 있도록 커야 합니다. WAS_DAEMON_ONLY_adapter_max_conn 환경 변수에 대한 자세한 정보는 최적화된 로컬 어댑터 사용자 정의 특성 주제와 최적화된 로컬 어댑터 사용을 위한 서버 환경 사용 주제를 참조하십시오. | |
12 | 지정한 최소 연결 매개변수가 최대보다 큽니다. | 최소 연결 설정은 최대 설정보다 작거나 같아야 합니다. | |
14 | 등록 작성 중에 공유 메모리가 부족합니다. | 최적화된 로컬 어댑터에 대한 공유 메모리 할당을 늘리거나 등록 해제 호출을 발행하여 자원 이용을 줄이십시오. | |
21 | 로컬 WebSphere Application Server 연결 중에 오류가 발생했습니다. | reg_flag_C2Wprop 비트(비트 29)를 1로 설정한 경우 WebSphere 환경 변수가 1로 설정되도록 하십시오. | |
25 | 트랜잭션 관리자를 시작할 수 없습니다. | IBM® 지원 센터에 도움을 문의하십시오. | |
70 | 연결 작성 중에 공유 메모리가 부족합니다. | 최적화된 로컬 어댑터에 대한 공유 메모리 할당을 늘리십시오. | |
74 | 입력 등록 이름에 널이 포함되어 있습니다. | 등록 API를 시작하기 전에 레지스터 이름을 공백으로 채우십시오. | |
12 | 4 | BBOACALL 모듈 찾기 중에 오류가 발생했습니다. | WebSphere Application Server BBOACALL 모듈이 포함된 데이터 세트가 STEPLIB, LNKLST에서 사용 가능한지 확인하십시오. |
10 | 선택한 WebSphere Application Server 디먼 그룹을 찾을 수 없습니다. | WebSphere Application Server 디먼 및 대상 서버가 시작되었는지 확인하고 최적화된 로컬 어댑터 지원이 활성화되었는지 확인한 후에 다시 시도하십시오. | |
14 | 사용자 ID는 요청된 WebSphere Application Server에 대해 권한 부여되지 않았습니다. | 사용자 ID가 요청된 WebSphere Application Server에 대한 CBIND SAF에 권한 부여되었는지 확인하십시오. | |
16 | 노드 이름 또는 서버 이름을 찾을 수 없습니다. | 전달 중인 노드 이름 및 서버 이름이 유효한지 확인하고 서버가 활성화되어 있는지 확인하십시오. | |
23 | 토큰 이름 지정 중에 오류가 발생했습니다. | IBM 지원 센터에 도움을 문의하십시오. | |
24 | 초기 WebSphere Application Server 로컬 통신 연결 설정 중에 오류가 발생했습니다. | 로컬 통신 연결 호출에 대한 자세한 내용은 WebSphere Application Server 리젼 로그를 참조하십시오. | |
28 | 이 이름으로 식별된 등록은 유효하지 않습니다. | 지정된 등록 이름이 이미 등록되었지만 RGE가 누락되었습니다. IBM 지원 센터에 문의하고 오류를 보고하십시오. 임시 해결책은 등록 해제 API를 호출하고 등록 API를 다시 호출하는 것입니다. | |
30 | 디먼 그룹이 WAS_DAEMON_ONLY_enable_adapter 특성을 1로 설정하여 실행 중이지 않습니다. | WebSphere Application Server 관리 콘솔에서 변수:WAS_DAEMON_ONLY_enable_adapter=1을 추가하십시오. | |
34 | IMS 환경에서 64비트 API 스텁이 사용되었습니다. | 64비트 API는 IMS에서 지원되지 않습니다. | |
38 | 64비트 API 스텁이 CICS 환경에서 사용되었습니다. | 64비트 API는 CICS에서 지원되지 않습니다. | |
68 | 공유 메모리 접속이 실패했습니다. | IBM 지원 센터에 도움을 문의하십시오. | |
86 | WebSphere Application Server for z/OS 마스터 BGVT를 찾을 수 없습니다. | WebSphere Application Server for z/OS 시스템 이미지에서 시작되지 않았습니다. 임의의 WebSphere Application Server 최적화된 로컬 어댑터 클라이언트 프로세스를 시작하기 전에 디먼 및 노드/서버가 시작되었는지 확인하십시오. | |
88 | WebSphere Application Server for z/OS 스텁 테이블을 찾을 수 없습니다. | WebSphere Application Server가 현재 z/OS 시스템 이미지에서 시작되었지만 최적화된 로컬 어댑터 클라이언트 스텁 테이블이 지원되는 레벨에서 실행 중이 아닙니다. 애플리케이션 서버의 유지보수 레벨과 호환되지 않는 WebSphere Application Server 버전 8.0.0.1 최적화된 로컬 어댑터 스텁 인터페이스를 실행 중일 수 있습니다. V8.0.0.1 최적화된 로컬 어댑터 스텁을 사용하려면 애플리케이션 서버도 WebSphere Application Server 버전 8.0.0. 레벨에서 실행 중이어야 합니다. 애플리케이션이 이 z/OS 시스템의 WebSphere Application Server와 호환되는 최적화된 로컬 어댑터 스텁 레벨로 실행 중인지 확인하십시오. | |
90 | WebSphere Application Server for z/OS 최적화된 로컬 어댑터 마스터 클라이언트 스텁 테이블을 찾을 수 없습니다. | WebSphere Application Server가 현재 z/OS 시스템 이미지에서 시작되었지만 최적화된 로컬 어댑터 클라이언트 스텁 테이블이 지원되는 레벨에서 실행 중이 아닙니다. 애플리케이션 서버의 유지보수 레벨과 호환되지 않는 WebSphere Application Server 버전 8.0.0.1 최적화된 로컬 어댑터 스텁 인터페이스를 실행 중일 수 있습니다. V8.0.0.1 최적화된 로컬 어댑터 스텁을 사용하려면 애플리케이션 서버도 WebSphere Application Server 버전 8.0.0. 레벨에서 실행 중이어야 합니다. 애플리케이션이 이 z/OS 시스템의 WebSphere Application Server와 호환되는 최적화된 로컬 어댑터 스텁 레벨로 실행 중인지 확인하십시오. |
등록 해제
BBOA1URG(31비트 호출자) 및 BBGA1URG(64비트 호출자) API를 사용하여 로컬 WebSphere Application Server for z/OS 디먼 그룹 및 서버에서 등록 해제합니다.API | 구문 |
---|---|
BBOA1URG 또는 BBGA1URG | BBOA1URG(registername, unregflags, rc, rsn) BBGA1URG(registername, unregflags, rc, rsn) |
매개변수:
registername(입력)로컬 연결 세트 등록 해제에 사용되는 이름이 포함된 입력 변수 또는 입력 상수입니다. 이는 정확하게 12자로, 공백으로 채워지고 BBOA1REG에 사용된 이름과 동일해야 합니다.
unregisterflags(입력)- 예약됨 - 비트 0-30
- 강제 실행(0|1) - 비트 31 또는 비트 64
등록 해제 요청이 강제 실행되어야 하는 경우에는 1이 포함됩니다. 기본적으로 등록 해제 요청은 모든 연결이 연결 풀로 리턴되면 완료됩니다. 모든 연결이 풀로 리턴되지 않으면 경고가 호출자로 리턴됩니다. 등록 해제 프로세스는 마지막 연결이 풀로 리턴될 때 완료됩니다. 두 번째 등록 해제 요청은 강제 실행 비트를 1로 설정하여 작성할 수 있으며 이는 등록 해제 프로세스가 강제 완료되도록 하며 해당 등록 해제에 대한 나머지 모든 연결 핸들이 무효화되도록 합니다.
이 호출의 성공 또는 실패를 나타내는 정수의 리턴 코드입니다.
rsn(출력)이 호출 실패에 대한 이유를 설정하는 정수의 이유 코드입니다.
- 이 호출에 지정된 WebSphere Application Server for z/OS 디먼 그룹 및 서버가 시작되고 로컬 어댑터 지원이 사용되도록 해야 합니다.
- 등록 해제 API가 호출되지 않고 등록 호출을 종료시킨 주소 공간이 종료되면 등록 해제 호출은 자동으로 완료되고 연결은 릴리스됩니다.
- 등록 해제 호출 발생 시에 활성화된 이 등록에 대한 연결 핸들은 BBOA1CNR API를 사용하여 연결 풀에 리턴될 때까지 계속 유효합니다. 연결 핸들이 강제 정리되도록 하려면 강제 실행 플래그를 지정하여 두 번째 등록 해제 호출을 작성해야 합니다. 그러면 모든 미해결 연결 핸들이 무효화됩니다.
리턴 코드 | 이유 코드 | 설명 | 조치 |
---|---|---|---|
0 | - | 성공 | |
4 | - | 경고 - 이유 코드 참조 | |
66 | 모든 연결이 풀로 리턴될 때까지 등록 해제 호출이 지연됩니다. | 마지막 연결이 사용 가능 풀로 리턴될 때 등록 해제가 완료됩니다. | |
8 | - | 오류 - 이유 코드 참조 | |
8 | 등록 토큰 이름이 없습니다. | 해당 등록 해제 API를 호출하기 전에 이 이름을 등록해야 합니다. | |
64 | 강제 실행 옵션은 일반 등록 해제가 발행되기 전에는 지정할 수 없습니다. | 강제 실행 옵션을 지정하지 않고 등록 해제 API를 호출하십시오. | |
76 | 서버가 더 이상 실행되지 않아서 서버 통신 시도가 실패했습니다. | 서버를 시작하고 통신을 다시 시도하십시오. | |
82 | 이 등록에 대한 등록 해제가 이미 시도되었습니다. | 이전 등록 해제 요청이 완료될 때까지 기다리거나 강제 실행 옵션으로 등록 해제를 다시 실행하십시오. | |
96 | 정보 관리 시스템(IMS) 초기화 또는 IMS 사전 초기화 종료 중에 이 API는 구동할 수 없습니다. | IMS 초기화가 완료된 후에 이 API를 호출하십시오. | |
12 | 34 | IMS 환경에서 64비트 API 스텁이 사용되었습니다. | 64비트 API는 IMS에서 지원되지 않습니다. |
38 | 64비트 API 스텁이 CICS 환경에서 사용되었습니다. | 64비트 API는 CICS에서 지원되지 않습니다. | |
86 | WebSphere Application Server for z/OS 마스터 BGVT를 찾을 수 없습니다. | WebSphere Application Server for z/OS 시스템 이미지에서 시작되지 않았습니다. 임의의 WebSphere Application Server 최적화된 로컬 어댑터 클라이언트 프로세스를 시작하기 전에 디먼 및 노드/서버가 시작되었는지 확인하십시오. | |
88 | WebSphere Application Server for z/OS 스텁 테이블을 찾을 수 없습니다. | WebSphere Application Server가 현재 z/OS 시스템 이미지에서 시작되었지만 최적화된 로컬 어댑터 클라이언트 스텁 테이블이 지원되는 레벨에서 실행 중이 아닙니다. 애플리케이션 서버의 유지보수 레벨과 호환되지 않는 WebSphere Application Server 버전 8.0.0.1 최적화된 로컬 어댑터 스텁 인터페이스를 실행 중일 수 있습니다. V8.0.0.1 최적화된 로컬 어댑터 스텁을 사용하려면 애플리케이션 서버도 WebSphere Application Server 버전 8.0.0. 레벨에서 실행 중이어야 합니다. 애플리케이션이 이 z/OS 시스템의 WebSphere Application Server와 호환되는 최적화된 로컬 어댑터 스텁 레벨로 실행 중인지 확인하십시오. | |
90 | WebSphere Application Server for z/OS 최적화된 로컬 어댑터 마스터 클라이언트 스텁 테이블을 찾을 수 없습니다. | WebSphere Application Server가 현재 z/OS 시스템 이미지에서 시작되었지만 최적화된 로컬 어댑터 클라이언트 스텁 테이블이 지원되는 레벨에서 실행 중이 아닙니다. 애플리케이션 서버의 유지보수 레벨과 호환되지 않는 WebSphere Application Server 버전 8.0.0.1 최적화된 로컬 어댑터 스텁 인터페이스를 실행 중일 수 있습니다. V8.0.0.1 최적화된 로컬 어댑터 스텁을 사용하려면 애플리케이션 서버도 WebSphere Application Server 버전 8.0.0. 레벨에서 실행 중이어야 합니다. 애플리케이션이 이 z/OS 시스템의 WebSphere Application Server와 호환되는 최적화된 로컬 어댑터 스텁 레벨로 실행 중인지 확인하십시오. |
연결 가져오기
이 API는 선택한 등록 이름으로 작성된 풀에서 사용 가능한 연결이 리턴되도록 요청합니다.API | 구문 |
---|---|
BBOA1CNG 또는 BBGA1CNG | BBOA1CNG(registername, connectionhandle, waittime, rc, rsn) BBGA1CNG(registername, connectionhandle, waittime, rc, rsn) |
매개변수:
registername(입력)연결을 검색하는 연결 풀을 찾는 데 사용되는 이름이 포함된 입력 변수 또는 입력 상수입니다. 이는 정확하게 12자의 공백으로 채워지는 문자열이어야 합니다.
connectionhandle(출력)이 연결에 대한 조치에 대한 다음 요청에서 전달되어야 하는 12바이트의 연결 핸들입니다.
waittime(입력)연결 사용 불가능 이유 코드를 리턴하기 전에 연결이 완료되기를 기다리는 시간(초)이 포함된 정수입니다. 0 값은 대기 시간이 없으며 API가 무한정 대기하는 것을 나타냅니다.
rc(출력)이 호출의 성공 또는 실패를 나타내는 정수의 리턴 코드입니다.
rsn(출력)이 호출 실패에 대한 이유를 설정하는 정수의 이유 코드입니다.
- 이 호출에 지정된 WebSphere Application Server for z/OS 디먼 그룹 및 서버가 시작되고 로컬 어댑터 지원이 사용되도록 해야 합니다.
- 연결 가져오기 API 사용 전에 일치하는 이름으로 현재 주소 공간에서 성공적인 등록(BBOA1REG) 호출이 완료되어야 합니다.
리턴 코드 | 이유 코드 | 설명 | 조치 |
---|---|---|---|
0 | - | 성공 | |
4 | - | 경고 - 이유 코드 참조 | |
8 | - | 오류 - 이유 코드 참조 | |
8 | 등록 이름 토큰이 없습니다. | 연결 가져오기 API를 사용하여 이름을 호출하기 전에 이 이름을 등록해야 합니다. | |
10 | 연결이 사용 불가능합니다. 연결 요청을 확보하기 전에 대기 시간이 만료되었습니다. | 애플리케이션 동작은 다양합니다. 대기한 후 다시 시도하거나 이 연결을 이상 종료하십시오. 또는, 등록 API 호출에서 최대 연결 설정을 늘릴 수도 있습니다. | |
24 | 등록 호출이 성공한 후에 풀에서 연결을 가져오는 중에 오류가 발생했습니다. | 서버가 시작되었는지 확인하십시오. 제대로 작동하지 않으면 서버를 다시 시작하고 API 요청을 다시 시도하십시오. | |
28 | 등록은 있지만 비활성 상태입니다. | ||
96 | 이 API는 IMS 초기화 동안 또는 IMS 사전 초기화 종료 중에 구동할 수 없습니다. | IMS 초기화가 완료된 후에 이 API를 호출하십시오. | |
12 | 10 | WebSphere Application Server 디먼 그룹 또는 서버를 찾을 수 없습니다. | WebSphere Application Server 디먼 및 서버가 시작되었는지 및 로컬 연결 지원이 활성화되어 있는지 확인하고 다시 시도하십시오. |
34 | IMS 환경에서 64비트 API 스텁이 사용되었습니다. | 64비트 API는 IMS에서 지원되지 않습니다. | |
38 | 64비트 API 스텁이 CICS 환경에서 사용되었습니다. | 64비트 API는 CICS에서 지원되지 않습니다. | |
86 | WebSphere Application Server for z/OS 마스터 BGVT를 찾을 수 없습니다. | WebSphere Application Server for z/OS 시스템 이미지에서 시작되지 않았습니다. 임의의 WebSphere Application Server 최적화된 로컬 어댑터 클라이언트 프로세스를 시작하기 전에 디먼 및 노드/서버가 시작되었는지 확인하십시오. | |
88 | WebSphere Application Server for z/OS 스텁 테이블을 찾을 수 없습니다. | WebSphere Application Server가 현재 z/OS 시스템 이미지에서 시작되었지만 최적화된 로컬 어댑터 클라이언트 스텁 테이블이 지원되는 레벨에서 실행 중이 아닙니다. 애플리케이션 서버의 유지보수 레벨과 호환되지 않는 WebSphere Application Server 버전 8.0.0.1 최적화된 로컬 어댑터 스텁 인터페이스를 실행 중일 수 있습니다. V8.0.0.1 최적화된 로컬 어댑터 스텁을 사용하려면 애플리케이션 서버도 WebSphere Application Server 버전 8.0.0. 레벨에서 실행 중이어야 합니다. 애플리케이션이 이 z/OS 시스템의 WebSphere Application Server와 호환되는 최적화된 로컬 어댑터 스텁 레벨로 실행 중인지 확인하십시오. | |
90 | WebSphere Application Server for z/OS 최적화된 로컬 어댑터 마스터 클라이언트 스텁 테이블을 찾을 수 없습니다. | WebSphere Application Server가 현재 z/OS 시스템 이미지에서 시작되었지만 최적화된 로컬 어댑터 클라이언트 스텁 테이블이 지원되는 레벨에서 실행 중이 아닙니다. 애플리케이션 서버의 유지보수 레벨과 호환되지 않는 WebSphere Application Server 버전 8.0.0.1 최적화된 로컬 어댑터 스텁 인터페이스를 실행 중일 수 있습니다. V8.0.0.1 최적화된 로컬 어댑터 스텁을 사용하려면 애플리케이션 서버도 WebSphere Application Server 버전 8.0.0. 레벨에서 실행 중이어야 합니다. 애플리케이션이 이 z/OS 시스템의 WebSphere Application Server와 호환되는 최적화된 로컬 어댑터 스텁 레벨로 실행 중인지 확인하십시오. |
연결 릴리스
연결 릴리스 API는 연결이 검색되고 다른 요청자에 대해 사용 가능한 풀로 연결이 리턴되도록 요청합니다.API | 구문 |
---|---|
BBOA1CNR 또는 BBGA1CNR | BBOA1CNR(connectionhandle, rc, rsn) BBGA1CNR(connectionhandle, rc, rsn) |
매개변수:
connectionhandle(입력)연결 풀로 다시 릴리스되는 이전에 확보한 연결을 표시하는 12바이트의 연결 핸들입니다.
rc(출력)이 호출의 성공 또는 실패를 나타내는 정수의 리턴 코드입니다.
rsn(출력)호출이 실패한 이유를 설명하는 정수의 이유 코드입니다.
- 이 호출에 지정된 WebSphere Application Server for z/OS 디먼 그룹 및 서버가 시작되고 로컬 어댑터 지원이 사용되도록 해야 합니다.
- 연결 릴리스 API를 사용하기 전에 성공적인 등록(BBOA1REG 또는 BBGA1REG API) 호출이 일치하는 이름을 사용하여 현재 주소 공간에서 완료되고 성공적인 연결 가져오기(BBOA1CNG 또는 BBGA1CNG) 호출이 현재 릴리스되는 연결 확보를 완료하는지 확인하십시오.
리턴 코드 | 이유 코드 | 설명 | 조치 |
---|---|---|---|
0 | - | 성공 | |
4 | - | WebSphere Application Server 디먼 그룹 및 서버를 찾을 수 없습니다. 이 연결에 연관된 모든 자원이 선택 취소됩니다. | 없음 |
8 | - | 오류 - 이유 코드 참조 | |
36 | 연결 상태가 유효하지 않습니다. | 이 요청에 사용되는 연결 핸들 상태가 잘못되었습니다. 연결 상태 규칙에 대해 API 문서를 참조하십시오. | |
38 | 클라이언트 연결 핸들이 유효하지 않습니다. | 이 요청에 사용되는 클라이언트 연결 핸들이 유효하지 않습니다. 클라이언트 연결 핸들 정보에 대해서는 API 문서를 참조하십시오. | |
96 | 이 API는 IMS 초기화 동안 또는 IMS 사전 초기화 종료 중에 구동할 수 없습니다. | IMS 초기화가 완료된 후에 이 API를 호출하십시오. | |
12 | 14 | 제공된 연결 핸들을 사용하는 API 호출 벡터를 찾을 수 없거나 확인할 수 없습니다. | 연결 핸들이 유효하지 않거나 API(BBOA1URG API)가 연결 풀을 무효화했을 수도 있습니다. |
34 | IMS 환경에서 64비트 API 스텁이 사용되었습니다. | 64비트 API는 IMS에서 지원되지 않습니다. | |
38 | 64비트 API 스텁이 CICS 환경에서 사용되었습니다. | 64비트 API는 CICS에서 지원되지 않습니다. | |
86 | WebSphere Application Server for z/OS 마스터 BGVT를 찾을 수 없습니다. | WebSphere Application Server for z/OS 시스템 이미지에서 시작되지 않았습니다. 임의의 WebSphere Application Server 최적화된 로컬 어댑터 클라이언트 프로세스를 시작하기 전에 디먼 및 노드/서버가 시작되었는지 확인하십시오. | |
88 | WebSphere Application Server for z/OS 스텁 테이블을 찾을 수 없습니다. | WebSphere Application Server가 현재 z/OS 시스템 이미지에서 시작되었지만 최적화된 로컬 어댑터 클라이언트 스텁 테이블이 지원되는 레벨에서 실행 중이 아닙니다. 애플리케이션 서버의 유지보수 레벨과 호환되지 않는 WebSphere Application Server 버전 8.0.0.1 최적화된 로컬 어댑터 스텁 인터페이스를 실행 중일 수 있습니다. V8.0.0.1 최적화된 로컬 어댑터 스텁을 사용하려면 애플리케이션 서버도 WebSphere Application Server 버전 8.0.0. 레벨에서 실행 중이어야 합니다. 애플리케이션이 이 z/OS 시스템의 WebSphere Application Server와 호환되는 최적화된 로컬 어댑터 스텁 레벨로 실행 중인지 확인하십시오. | |
90 | WebSphere Application Server for z/OS 최적화된 로컬 어댑터 마스터 클라이언트 스텁 테이블을 찾을 수 없습니다. | WebSphere Application Server가 현재 z/OS 시스템 이미지에서 시작되었지만 최적화된 로컬 어댑터 클라이언트 스텁 테이블이 지원되는 레벨에서 실행 중이 아닙니다. 애플리케이션 서버의 유지보수 레벨과 호환되지 않는 WebSphere Application Server 버전 8.0.0.1 최적화된 로컬 어댑터 스텁 인터페이스를 실행 중일 수 있습니다. V8.0.0.1 최적화된 로컬 어댑터 스텁을 사용하려면 애플리케이션 서버도 WebSphere Application Server 버전 8.0.0. 레벨에서 실행 중이어야 합니다. 애플리케이션이 이 z/OS 시스템의 WebSphere Application Server와 호환되는 최적화된 로컬 어댑터 스텁 레벨로 실행 중인지 확인하십시오. |
요청 전송
이 API는 처리를 위해 요청을 로컬 WebSphere Application Server에 전송합니다.API | 구문 |
---|---|
BBOA1SRQ 또는 BBGA1SRQ | BBOA1SRQ(connectionhandle, requesttype, requestservicename, requestservicenamel, requestdata, requestdatalen, async(0|1), responsedatalen, rc, rsn) BBGA1SRQ(connectionhandle, requesttype, requestservicename, requestservicenamel, requestdata, requestdatalen, async(0|1), responsedatalen, rc, rsn) |
매개변수:
connectionhandle(입력)이 요청에 사용되는 12바이트의 연결 핸들입니다.
requesttype(입력)처리하려는 작업 요청 유형을 표시하는 요청 유형이 포함된 정수입니다. 지원되는 유형 값: 1 = 로컬 EJB 작업 요청, 2 = 원격 EJB 작업 요청.
requestservicename(입력)호출하려는 서비스 이름이 포함된 최대 길이가 256바이트인 EBCDIC 문자열입니다. 유형=1, EJB 및 유형 2, 원격 EJB에 대해 이는 대상의 JNDI 홈 이름입니다.
requestservicenamel(입력)시작하려는 서비스 이름의 길이 또는 서비스 이름이 널로 종료되는 경우 0을 포함하는 정수입니다.
requestdata(입력)전송하려는 요청 데이터 시작 주소에 대한 31비트 또는 64비트 포인터입니다.
requestdatalen(입력)전송하려는 데이터 길이가 포함된 31비트 모드의 32비트 부호 없는 값 또는 64비트 모드의 64비트 부호 없는 값입니다.
async(0|1)(입력)1로 설정된 정수 값은 응답 길이를 아직 알 수 없는 경우에도 호출자에게 제어가 즉시 리턴되도록 표시합니다. async(0)의 경우, 현재 스레드는 WebSphere Application Server에서의 응답 리턴을 대기하도록 요청하고 리턴 길이는 responsedatalen 출력 인수로 리턴됩니다.
responsedatalen(출력)응답 길이가 포함된 31비트 모드의 32비트 부호 없는 값 또는 64비트 모드의 64비트 부호 없는 값입니다. 그러면 이 길이는 호출자가 데이터 가져오기 API를 호출하여 복사하려는 스토리지를 확보하는 데 사용할 수 있습니다. 호출자가 즉시 제어를 다시 확보하는 1로 async가 설정되는 경우, 이는 응답이 아직 수신되지 않은 경우 모든 0xFFs에 설정됩니다.
rc(출력)이 호출의 성공 또는 실패를 나타내는 정수의 리턴 코드입니다.
rsn(출력)이 호출 실패에 대한 이유를 설정하는 정수의 이유 코드입니다.
- 이 호출에 지정된 WebSphere Application Server for z/OS 디먼 그룹 및 서버가 시작되고 로컬 어댑터 지원이 사용되도록 해야 합니다.
- 요청 전송 API 사용 전에 일치하는 이름으로 현재 주소 공간에서 성공적인 등록(BBOA1REG) 호출이 완료되어야 합니다.
리턴 코드 | 이유 코드 | 설명 | 조치 |
---|---|---|---|
0 | - | 성공 | |
4 | - | 경고 - 이유 코드 참조 | |
8 | - | 오류 - 이유 코드 참조 | |
8 | 등록 이름 토큰이 이미 있습니다. | 전달된 등록 이름이 유효한지 확인하십시오. | |
14 | 메시지 저장 중에 메모리 부족 조건이 발생했습니다. | 메시지 처리를 위해 요청을 전송하기 위한 메모리가 부족합니다. 현재 주소 공간이 개인 스토리지를 벗어났습니다. | |
16 | 요청 서비스 이름 길이가 유효하지 않습니다. | 프로그램을 정정하고 다시 시도하십시오. | |
18 | 요청 기간이 시스템 한계를 초과했습니다. | 메시지 크기가 WebSphere Application Server 크기가 지원할 수 있는 크기보다 큽니다. 크기가 유효한지 확인하십시오. 크기가 유효한 경우 WebSphere Application Server 크기가 메시지 크기를 수용할 정도로 큰지 확인하십시오. | |
26 | 글로벌 트랜잭션을 시작할 수 없습니다. | ||
32 | API 호출 요청 유형이 유효하지 않습니다. | 요청 유형이 유효하지 않습니다. 프로그램을 정정하고 호출을 다시 시도하십시오. | |
34 | 대상 서비스를 찾지 못했습니다. | 대상 엔터프라이즈 Bean을 포함하는 애플리케이션이 WebSphere Application Server의 대상 서버에 설치되어 시작되었는지 확인하십시오. | |
36 | 연결 상태가 유효하지 않습니다. | 요청에 사용되는 연결 핸들의 상태가 올바르지 않습니다. 연결 상태 규칙에 대해 API 문서를 참조하십시오. | |
38 | 클라이언트 연결 핸들이 유효하지 않습니다. | 요청에 사용되는 클라이언트 연결 핸들이 유효하지 않습니다. 클라이언트 연결 핸들 정보에 대해서는 API 문서를 참조하십시오. | |
40 | 로컬 통신 오류가 발생했습니다. | 모든 로컬 통신 오류 메시지에 대해서는 WebSphere Application Server 서버 로그를 확인하십시오. | |
44 | 대상 엔터프라이즈 Bean에서 예외 또는 예기치 않은 조건이 발생했습니다. | WebSphere Application Server 로그에서 예외 데이터를 검토하십시오. | |
46 | 로컬 통신 전송 요청 호출에서 오류가 발생했습니다. | WebSphere Application Server 로그를 참조하여 오류를 판별하십시오. | |
96 | 이 API는 IMS 초기화 동안 또는 IMS 사전 초기화 종료 중에 구동할 수 없습니다. | IMS 초기화가 완료된 후에 이 API를 호출하십시오. | |
98 | 제공된 요청 버퍼 시작에 액세스할 수 없습니다. | 제공된 요청 버퍼 주소 및 길이가 올바른지 확인하십시오. | |
100 | 제공된 요청 버퍼 끝에 액세스할 수 없습니다. | 제공된 요청 버퍼 주소 및 길이가 올바른지 확인하십시오. | |
12 | 10 | WebSphere Application Server 디먼 그룹 또는 서버를 찾을 수 없습니다. | WebSphere Application Server 디먼 및 서버가 시작되었는지 및 로컬 연결 지원이 활성화되어 있는지 확인하십시오. WebSphere Application Server 디먼 그룹 및 서버 찾기를 재시도하십시오. |
14 | 제공된 연결 핸들을 사용하는 API 호출 벡터를 찾을 수 없거나 확인할 수 없습니다. | 연결 핸들이 유효하지 않거나 API(BBOA1URG API)가 연결 풀을 무효화했을 수도 있습니다. | |
34 | IMS 환경에서 64비트 API 스텁이 사용되었습니다. | 64비트 API는 IMS에서 지원되지 않습니다. | |
38 | 64비트 API 스텁이 CICS 환경에서 사용되었습니다. | 64비트 API는 CICS에서 지원되지 않습니다. | |
86 | WebSphere Application Server for z/OS 마스터 BGVT를 찾을 수 없습니다. | WebSphere Application Server for z/OS 시스템 이미지에서 시작되지 않았습니다. 임의의 WebSphere Application Server 최적화된 로컬 어댑터 클라이언트 프로세스를 시작하기 전에 디먼 및 노드/서버가 시작되었는지 확인하십시오. | |
88 | WebSphere Application Server for z/OS 스텁 테이블을 찾을 수 없습니다. | WebSphere Application Server가 현재 z/OS 시스템 이미지에서 시작되었지만 최적화된 로컬 어댑터 클라이언트 스텁 테이블이 지원되는 레벨에서 실행 중이 아닙니다. 애플리케이션 서버의 유지보수 레벨과 호환되지 않는 WebSphere Application Server 버전 8.0.0.1 최적화된 로컬 어댑터 스텁 인터페이스를 실행 중일 수 있습니다. V8.0.0.1 최적화된 로컬 어댑터 스텁을 사용하려면 애플리케이션 서버도 WebSphere Application Server 버전 8.0.0. 레벨에서 실행 중이어야 합니다. 애플리케이션이 이 z/OS 시스템의 WebSphere Application Server와 호환되는 최적화된 로컬 어댑터 스텁 레벨로 실행 중인지 확인하십시오. | |
90 | WebSphere Application Server for z/OS 최적화된 로컬 어댑터 마스터 클라이언트 스텁 테이블을 찾을 수 없습니다. | WebSphere Application Server가 현재 z/OS 시스템 이미지에서 시작되었지만 최적화된 로컬 어댑터 클라이언트 스텁 테이블이 지원되는 레벨에서 실행 중이 아닙니다. 애플리케이션 서버의 유지보수 레벨과 호환되지 않는 WebSphere Application Server 버전 8.0.0.1 최적화된 로컬 어댑터 스텁 인터페이스를 실행 중일 수 있습니다. V8.0.0.1 최적화된 로컬 어댑터 스텁을 사용하려면 애플리케이션 서버도 WebSphere Application Server 버전 8.0.0. 레벨에서 실행 중이어야 합니다. 애플리케이션이 이 z/OS 시스템의 WebSphere Application Server와 호환되는 최적화된 로컬 어댑터 스텁 레벨로 실행 중인지 확인하십시오. |
응답 전송
이 API는 요청에 대한 응답을 로컬 WebSphere Application Server에 다시 전송합니다.API | 구문 |
---|---|
BBOA1SRP 또는 BBGA1SRP | BBOA1SRP(connectionhandle, responsedata, responsedatalen, rc, rsn) BBGA1SRP(connectionhandle, responsedata, responsedatalen, rc, rsn) |
매개변수:
connectionhandle(입력)이 응답에 사용되는 12바이트의 연결 핸들입니다.
responsedata(입력)전송하려는 응답 데이터 시작 주소에 대한 31비트 또는 64비트 포인터입니다.
responsedatalen(입력)전송하려는 데이터 길이가 포함된 31비트 모드의 32비트 부호 없는 값 또는 64비트 모드의 64비트 부호 없는 값입니다.
rc(출력)이 호출의 성공 또는 실패를 나타내는 정수의 리턴 코드입니다.
rsn(출력)이 호출 실패에 대한 이유를 설정하는 정수의 이유 코드입니다.
- 이 호출에 지정된 WebSphere Application Server for z/OS 디먼 그룹 및 서버가 시작되고 로컬 어댑터 지원이 사용되도록 해야 합니다.
- 응답 전송 API 사용 전에 일치하는 이름으로 현재 주소 공간에서 성공적인 등록(BBOA1REG 또는 BBGA1REG API) 호출이 완료되어야 합니다.
- 성공적인 연결 가져오기(BBOA1CNG 또는 BBGA1CNG) 호출이 완료되고 핸들이 이 호출에 대한 입력으로 제공되는지 확인하십시오.
- 성공적인 모든 요청 수신, 특정 요청 수신 또는 호스트 API 호출이 발행되어 연결 핸들에 대한 요청 데이터로 리턴되었는지 확인하십시오. 연결은 응답 전송 API가 유효한 상태여야 합니다.
리턴 코드 | 이유 코드 | 설명 | 조치 |
---|---|---|---|
0 | - | 성공 | |
4 | - | 경고 - 이유 코드 참조 | |
8 | - | 오류 - 이유 코드 참조 | |
8 | 등록 이름 토큰이 이미 있습니다. | 전달된 등록 이름이 유효한지 확인하십시오. | |
14 | 메시지 저장 중에 메모리 부족 조건이 발생했습니다. | 메시지 처리를 위해 응답을 전송하기 위한 메모리가 부족합니다. 현재 주소 공간이 개인 스토리지를 벗어났습니다. | |
18 | 응답 길이가 시스템 한계를 초과했습니다. | 메시지 크기가 WebSphere Application Server 크기가 지원할 수 있는 크기보다 큽니다. 크기가 유효한지 확인하십시오. 크기가 유효한 경우 WebSphere Application Server 크기가 메시지 크기를 수용할 정도로 큰지 확인하십시오. | |
34 | 대상 서비스를 찾지 못했습니다. | 대상 EJB를 포함하는 애플리케이션이 대상 WebSphere Application Server에 설치되어 시작되었는지 확인하십시오. | |
36 | 연결 상태가 유효하지 않습니다. | 이 요청에 사용되는 연결 핸들 상태가 잘못되었습니다. 연결 상태 규칙에 대해 API 문서를 참조하십시오. | |
38 | 클라이언트 연결 핸들이 유효하지 않습니다. | 이 요청에 사용되는 클라이언트 연결 핸들이 유효하지 않습니다. 클라이언트 연결 핸들 정보에 대해서는 API 문서를 참조하십시오. | |
40 | 로컬 통신 오류가 발생했습니다. | 모든 로컬 통신 오류 메시지에 대해서는 WebSphere Application Server 서버 로그를 확인하십시오. | |
46 | 로컬 통신 전송 요청 호출에서 오류가 발생했습니다. | WebSphere Application Server 로그를 참조하여 오류를 판별하십시오. | |
96 | 이 API는 IMS 초기화 동안 또는 IMS 사전 초기화 종료 중에 구동할 수 없습니다. | IMS 초기화가 완료된 후에 이 API를 호출하십시오. | |
102 | 제공된 응답 버퍼 시작에 액세스할 수 없습니다. | 제공된 응답 버퍼 주소 및 길이가 올바른지 확인하십시오. | |
104 | 제공된 응답 버퍼 끝에 액세스할 수 없습니다. | 제공된 응답 버퍼 주소 및 길이가 올바른지 확인하십시오. | |
12 | 10 | WebSphere Application Server 디먼 그룹 또는 서버를 찾을 수 없습니다. | WebSphere Application Server 디먼 및 서버가 시작되었는지 및 로컬 연결 지원이 활성화되어 있는지 확인하고 호출을 다시 시도하십시오. |
14 | 제공된 연결 핸들을 사용하는 API 호출 벡터를 찾을 수 없거나 확인할 수 없습니다. | 연결 핸들이 유효하지 않거나 API(BBOA1URG)가 연결 풀을 무효화했을 수도 있습니다. | |
34 | IMS 환경에서 64비트 API 스텁이 사용되었습니다. | 64비트 API는 IMS에서 지원되지 않습니다. | |
38 | 64비트 API 스텁이 CICS 환경에서 사용되었습니다. | 64비트 API는 CICS에서 지원되지 않습니다. | |
86 | WebSphere Application Server for z/OS 마스터 BGVT를 찾을 수 없습니다. | WebSphere Application Server for z/OS 시스템 이미지에서 시작되지 않았습니다. 임의의 WebSphere Application Server 최적화된 로컬 어댑터 클라이언트 프로세스를 시작하기 전에 디먼 및 노드/서버가 시작되었는지 확인하십시오. | |
88 | WebSphere Application Server for z/OS 스텁 테이블을 찾을 수 없습니다. | WebSphere Application Server가 현재 z/OS 시스템 이미지에서 시작되었지만 최적화된 로컬 어댑터 클라이언트 스텁 테이블이 지원되는 레벨에서 실행 중이 아닙니다. 애플리케이션 서버의 유지보수 레벨과 호환되지 않는 WebSphere Application Server 버전 8.0.0.1 최적화된 로컬 어댑터 스텁 인터페이스를 실행 중일 수 있습니다. V8.0.0.1 최적화된 로컬 어댑터 스텁을 사용하려면 애플리케이션 서버도 WebSphere Application Server 버전 8.0.0. 레벨에서 실행 중이어야 합니다. 애플리케이션이 이 z/OS 시스템의 WebSphere Application Server와 호환되는 최적화된 로컬 어댑터 스텁 레벨로 실행 중인지 확인하십시오. | |
90 | WebSphere Application Server for z/OS 최적화된 로컬 어댑터 마스터 클라이언트 스텁 테이블을 찾을 수 없습니다. | WebSphere Application Server가 현재 z/OS 시스템 이미지에서 시작되었지만 최적화된 로컬 어댑터 클라이언트 스텁 테이블이 지원되는 레벨에서 실행 중이 아닙니다. 애플리케이션 서버의 유지보수 레벨과 호환되지 않는 WebSphere Application Server 버전 8.0.0.1 최적화된 로컬 어댑터 스텁 인터페이스를 실행 중일 수 있습니다. V8.0.0.1 최적화된 로컬 어댑터 스텁을 사용하려면 애플리케이션 서버도 WebSphere Application Server 버전 8.0.0. 레벨에서 실행 중이어야 합니다. 애플리케이션이 이 z/OS 시스템의 WebSphere Application Server와 호환되는 최적화된 로컬 어댑터 스텁 레벨로 실행 중인지 확인하십시오. |
응답 예외 전송
이 API는 로컬 WebSphere Application Server의 JCA 호출자로 예외 응답 데이터를 다시 전송합니다. 응답은 지정된 예외 응답 데이터가 리턴된 ResourceAdapterException입니다.
API | 구문 |
---|---|
BBOA1SRX 또는 BBGA1SRX | BBOA1SRX(connectionhandle, excresponsedata, exresponsedatalen, rc, rsn) BBGA1SRX(connectionhandle, excresponsedata, exresponsedatalen, rc, rsn) |
매개변수:
connectionhandle(입력)응답에 사용되는 12바이트의 연결 핸들입니다.
excresponsedata(입력)전송하려는 예외 응답 데이터 시작 주소에 대한 31비트 또는 64비트 포인터를 지정합니다.
excresponsedatalen(입력)전송하려는 예외 응답 데이터 길이에 대한 31비트 모드의 32비트 부호 없는 값 또는 64비트 모드의 64비트 부호 없는 값을 지정합니다. 예외 응답 데이터는 오류를 설명하는 EBCDIC 문자열입니다.
rc(출력)이 호출의 성공 또는 실패를 나타내는 정수의 리턴 코드입니다.
rsn(출력)이 호출 실패에 대한 이유를 설정하는 정수의 이유 코드입니다.
- 이 호출에 지정된 WebSphere Application Server for z/OS 디먼 그룹 및 서버가 시작되고 로컬 어댑터 지원이 사용되도록 해야 합니다.
- 응답 전송 호출 사용 전에 일치하는 이름으로 현재 주소 공간에서 성공적인 등록(BBOA1REG 또는 BBGAREG API) 호출이 완료되어야 합니다.
- 성공적인 연결 가져오기(BBOA1CNG 또는 BBGA1CNG API) 호출이 완료되고 이에 대한 핸들이 이 호출에 대한 입력으로 제공되는지 확인하십시오.
- 성공적인 모든 요청 수신 또는 특정 요청 수신 또는 호스트 API 호출이 발행되어 연결 핸들에 대한 요청 데이터로 리턴되었는지 확인하십시오. 연결은 응답 전송 및 응답 예외 전송 API가 유효한 상태여야 합니다.
리턴 코드 | 이유 코드 | 설명 | 조치 |
---|---|---|---|
0 | - | 성공 | |
4 | - | 경고 - 이유 코드 참조 | |
8 | - | 오류 - 이유 코드 참조 | |
8 | 등록 이름 토큰이 이미 있습니다. | 전달된 등록 이름이 유효한지 확인하십시오. | |
10 | 연결 핸들은 릴리스 또는 유효하지 않은 상태입니다. | 유효한 연결 핸들이 전달되어야 합니다. | |
14 | 메시지 저장 중에 메모리 부족 조건이 발생했습니다. | 메시지 처리를 위해 응답 예외를 전송하기 위한 메모리가 부족합니다. 현재 주소 공간이 개인 스토리지를 벗어났습니다. | |
16 | 하나 이상의 매개변수가 유효하지 않습니다. | 모든 매개변수가 유효한지 확인하고 호출을 다시 시도하십시오. | |
18 | 응답 길이가 시스템 한계를 초과했습니다. | 메시지 크기가 WebSphere Application Server 크기가 지원할 수 있는 크기보다 큽니다. 크기가 유효한지 확인하십시오. 크기가 유효한 경우 WebSphere Application Server 크기가 메시지 크기를 수용할 정도로 큰지 확인하십시오. | |
20 | 하나 이상의 매개변수가 유효하지 않습니다. | 모든 매개변수가 유효한지 확인하고 호출을 다시 시도하십시오. | |
28 | 연결 핸들이 연관된 등록이 더 이상 활성화되어 있지 않습니다. | 연결 가져오기 및 요청 전송 호출을 수행하기 전에 등록 이름을 사용하여 등록을 다시 호출하십시오. | |
36 | 연결 상태가 유효하지 않습니다. | 이 요청에 사용되는 연결 핸들 상태가 잘못되었습니다. 연결 상태 규칙에 대해 API 문서를 참조하십시오. | |
38 | 클라이언트 연결 핸들이 유효하지 않습니다. | 이 요청에 사용되는 클라이언트 연결 핸들이 유효하지 않습니다. 클라이언트 연결 핸들 정보에 대해서는 API 문서를 참조하십시오. | |
40 | 로컬 통신 오류가 발생했습니다. | 모든 로컬 통신 오류 메시지에 대해서는 WebSphere Application Server 서버 로그를 확인하십시오. | |
46 | 로컬 통신 전송 요청 호출에서 오류가 발생했습니다. | WebSphere Application Server 로그를 참조하여 오류를 판별하십시오. | |
96 | 이 API는 IMS 초기화 동안 또는 IMS 사전 초기화 종료 중에 구동할 수 없습니다. | IMS 초기화가 완료된 후에 이 API를 호출하십시오. | |
102 | 제공된 응답 버퍼 시작에 액세스할 수 없습니다. | 제공된 응답 버퍼 주소 및 길이가 올바른지 확인하십시오. | |
104 | 제공된 응답 버퍼 끝에 액세스할 수 없습니다. | 제공된 응답 버퍼 주소 및 길이가 올바른지 확인하십시오. | |
12 | 10 | WebSphere Application Server 디먼 그룹 또는 서버를 찾을 수 없습니다. | WebSphere Application Server 디먼 및 서버가 시작되었는지 및 로컬 연결 지원이 활성화되어 있는지 확인하고 호출을 다시 시도하십시오. |
14 | 제공된 연결 핸들을 사용하는 API 호출 벡터를 찾을 수 없거나 확인할 수 없습니다. | 연결 핸들이 유효하지 않거나 API(BBOA1URG API)가 연결 풀을 무효화했을 수도 있습니다. | |
34 | IMS 환경에서 64비트 API 스텁이 사용되었습니다. | 64비트 API는 IMS에서 지원되지 않습니다. | |
38 | 64비트 API 스텁이 CICS 환경에서 사용되었습니다. | 64비트 API는 CICS에서 지원되지 않습니다. | |
86 | WebSphere Application Server for z/OS 마스터 BGVT를 찾을 수 없습니다. | WebSphere Application Server for z/OS 시스템 이미지에서 시작되지 않았습니다. 임의의 WebSphere Application Server 최적화된 로컬 어댑터 클라이언트 프로세스를 시작하기 전에 디먼 및 노드/서버가 시작되었는지 확인하십시오. | |
88 | WebSphere Application Server for z/OS 스텁 테이블을 찾을 수 없습니다. | WebSphere Application Server가 현재 z/OS 시스템 이미지에서 시작되었지만 최적화된 로컬 어댑터 클라이언트 스텁 테이블이 지원되는 레벨에서 실행 중이 아닙니다. 애플리케이션 서버의 유지보수 레벨과 호환되지 않는 WebSphere Application Server 버전 8.0.0.1 최적화된 로컬 어댑터 스텁 인터페이스를 실행 중일 수 있습니다. V8.0.0.1 최적화된 로컬 어댑터 스텁을 사용하려면 애플리케이션 서버도 WebSphere Application Server 버전 8.0.0. 레벨에서 실행 중이어야 합니다. 애플리케이션이 이 z/OS 시스템의 WebSphere Application Server와 호환되는 최적화된 로컬 어댑터 스텁 레벨로 실행 중인지 확인하십시오. | |
90 | WebSphere Application Server for z/OS 최적화된 로컬 어댑터 마스터 클라이언트 스텁 테이블을 찾을 수 없습니다. | WebSphere Application Server가 현재 z/OS 시스템 이미지에서 시작되었지만 최적화된 로컬 어댑터 클라이언트 스텁 테이블이 지원되는 레벨에서 실행 중이 아닙니다. 애플리케이션 서버의 유지보수 레벨과 호환되지 않는 WebSphere Application Server 버전 8.0.0.1 최적화된 로컬 어댑터 스텁 인터페이스를 실행 중일 수 있습니다. V8.0.0.1 최적화된 로컬 어댑터 스텁을 사용하려면 애플리케이션 서버도 WebSphere Application Server 버전 8.0.0. 레벨에서 실행 중이어야 합니다. 애플리케이션이 이 z/OS 시스템의 WebSphere Application Server와 호환되는 최적화된 로컬 어댑터 스텁 레벨로 실행 중인지 확인하십시오. |
모든 요청 수신
모든 연결에서 로컬 WebSphere Application Server의 요청을 수신합니다. 전달된 등록 이름에 대해 풀에서 사용 가능한 모든 연결의 요청 및 관련된 데이터를 수신합니다. 출력 매개변수로 요청 데이터 길이를 리턴합니다. 연결 핸들도 호출자에게 리턴된 출력 매개변수입니다. 리턴된 연결 핸들을 사용하는 데이터 가져오기 API 호출은 수신된 메시지 데이터를 리턴합니다.
API | 구문 |
---|---|
BBOA1RCA 또는 BBGA1RCA | BBOA1RCA(registername, connectionhandle, requestservicename, requestservicenamel, requestdatalen, waittime, rc, rsn) BBGA1RCA(registername, connectionhandle, requestservicename, requestservicenamel, requestdatalen, waittime, rc, rsn) |
매개변수:
registername(입력)연결을 검색하는 연결 풀을 찾는 데 사용되는 이름이 포함된 입력 변수 또는 입력 상수입니다. 이는 정확하게 12자의 공백으로 채워지는 문자열이어야 합니다.
connectionhandle(출력)이 연결에 대한 조치에 대한 다음 요청에서 리턴되고 전달되어야 하는 12바이트의 연결 핸들입니다.
requestservicename(입/출력)서비스 이름이 포함된 최대 256바이트인 EBCDIC 문자열입니다. 이는 WebSphere Application Server 애플리케이션의 InteractionSpec에 지정된 대상 서비스 이름입니다. * 값은 현재 등록 이름으로 수신 중인 모든 서비스 이름에 대한 수신 요청을 표시합니다.
requestservicenamel(입/출력)서비스 시작하려는 서비스 이름의 길이 또는 이름이 널로 종료되는 경우 0을 포함하는 정수입니다.
requestdatalen(출력)수신하려는 데이터 길이가 포함된 31비트 모드의 32비트 부호 없는 값 또는 64비트 모드의 64비트 부호 없는 값이 리턴됩니다.
waittime(입력)연결 사용 불가능 이유 코드를 리턴하기 전에 연결이 완료되기를 기다리는 시간(초)가 포함된 정수입니다. 0 값은 대기 시간이 없으며 API가 무한정 대기하는 것을 나타냅니다.
rc(출력)이 호출의 성공 또는 실패를 나타내는 정수의 리턴 코드입니다.
rsn(출력)이 호출 실패에 대한 이유를 설정하는 정수의 이유 코드입니다.
- 이 호출에 지정된 WebSphere Application Server for z/OS 디먼 그룹 및 서버가 시작되고 로컬 어댑터 지원이 사용되도록 해야 합니다.
- 이 API 사용 전에 일치하는 이름으로 현재 주소 공간에서 성공적인 등록(BBOA1REG 또는 BBGA1REG API) 호출이 완료되어야 합니다.
리턴 코드 | 이유 코드 | 설명 | 조치 |
---|---|---|---|
0 | - | 성공 | |
4 | - | 경고 - 이유 코드 참조 | |
8 | - | 오류 - 이유 코드 참조 | |
8 | 등록 이름 토큰이 이미 있습니다. | 전달된 등록 이름이 유효한지 확인하십시오. | |
11 | WebSphere Application Server에서 잘못된 데이터 전송 | ||
16 | 요청 서비스 이름 길이가 유효하지 않습니다. | 프로그램을 정정하고 호출을 다시 시도하십시오. | |
19 | 로컬 통신 기존 데이터 실패 | ||
21 | 로컬 통신 미리보기 데이터 실패 | ||
38 | 클라이언트 연결 핸들이 유효하지 않습니다. | 이 요청에 사용되는 클라이언트 연결 핸들이 유효하지 않은 것으로 판별되었습니다. 클라이언트 연결 핸들 정보에 대해서는 API 문서를 참조하십시오. | |
40 | 로컬 통신 오류가 발생했습니다. | 모든 로컬 통신 오류 메시지에 대해서는 WebSphere Application Server 서버 로그를 확인하십시오. | |
46 | 로컬 통신 전송 요청 호출에서 오류가 발생했습니다. | WebSphere Application Server 로그를 참조하여 오류를 판별하십시오. | |
76 | 서버가 더 이상 실행되지 않아서 서버 통신 시도가 실패했습니다. | 서버를 시작하고 통신을 다시 시도하십시오. | |
96 | 이 API는 IMS 초기화 동안 또는 IMS 사전 초기화 종료 중에 구동할 수 없습니다. | IMS 초기화가 완료된 후에 이 API를 호출하십시오. | |
12 | 10 | WebSphere Application Server 디먼 그룹 또는 서버를 찾을 수 없습니다. | WebSphere Application Server 디먼 및 서버가 시작되었는지 및 로컬 연결 지원이 활성화되어 있는지 확인하고 호출을 다시 시도하십시오. |
24 | 등록 호출이 성공한 후에 풀에서 연결을 가져오는 중에 오류가 발생했습니다. | 서버가 시작되었는지 확인하십시오. 서버가 시작되지 않은 경우 서버를 다시 시작하고 API 요청을 다시 시도하십시오. | |
34 | IMS 환경에서 64비트 API 스텁이 사용되었습니다. | 64비트 API는 IMS에서 지원되지 않습니다. | |
38 | 64비트 API 스텁이 CICS 환경에서 사용되었습니다. | 64비트 API는 CICS에서 지원되지 않습니다. | |
44 | 서비스 호출에 대한 잘못된 CP 빌드 | ||
46 | 서비스 셀에 대한 잘못된 CP 가져오기 | ||
48 | 서비스 셀에 대한 잘못된 CP 사용 가능화 | ||
60 | SRVQ 잠금 가져오기 실패 | ||
62 | SRVQ 잠금 해제 실패 | ||
86 | WebSphere Application Server for z/OS 마스터 BGVT를 찾을 수 없습니다. | WebSphere Application Server for z/OS 시스템 이미지에서 시작되지 않았습니다. 임의의 WebSphere Application Server 최적화된 로컬 어댑터 클라이언트 프로세스를 시작하기 전에 디먼 및 노드/서버가 시작되었는지 확인하십시오. | |
88 | WebSphere Application Server for z/OS 스텁 테이블을 찾을 수 없습니다. | WebSphere Application Server가 현재 z/OS 시스템 이미지에서 시작되었지만 최적화된 로컬 어댑터 클라이언트 스텁 테이블이 지원되는 레벨에서 실행 중이 아닙니다. 애플리케이션 서버의 유지보수 레벨과 호환되지 않는 WebSphere Application Server 버전 8.0.0.1 최적화된 로컬 어댑터 스텁 인터페이스를 실행 중일 수 있습니다. V8.0.0.1 최적화된 로컬 어댑터 스텁을 사용하려면 애플리케이션 서버도 WebSphere Application Server 버전 8.0.0. 레벨에서 실행 중이어야 합니다. 애플리케이션이 이 z/OS 시스템의 WebSphere Application Server와 호환되는 최적화된 로컬 어댑터 스텁 레벨로 실행 중인지 확인하십시오. | |
90 | WebSphere Application Server for z/OS 최적화된 로컬 어댑터 마스터 클라이언트 스텁 테이블을 찾을 수 없습니다. | WebSphere Application Server가 현재 z/OS 시스템 이미지에서 시작되었지만 최적화된 로컬 어댑터 클라이언트 스텁 테이블이 지원되는 레벨에서 실행 중이 아닙니다. 애플리케이션 서버의 유지보수 레벨과 호환되지 않는 WebSphere Application Server 버전 8.0.0.1 최적화된 로컬 어댑터 스텁 인터페이스를 실행 중일 수 있습니다. V8.0.0.1 최적화된 로컬 어댑터 스텁을 사용하려면 애플리케이션 서버도 WebSphere Application Server 버전 8.0.0. 레벨에서 실행 중이어야 합니다. 애플리케이션이 이 z/OS 시스템의 WebSphere Application Server와 호환되는 최적화된 로컬 어댑터 스텁 레벨로 실행 중인지 확인하십시오. |
특정 요청 수신
특정 연결에서 로컬 WebSphere Application Server의 요청을 수신합니다. 제공된 입력 연결 핸들에 대해 요청 및 관련 데이터를 수신합니다. 요청 데이터 길이를 리턴합니다. 리턴된 연결 핸들을 사용하는 데이터 가져오기 API 호출은 수신된 메시지 데이터를 리턴합니다.API | 구문 |
---|---|
BBOA1RCS 또는 BBGA1RCS | BBOA1RCS(connectionhandle, requestservicename, requestservicenamel, requestdatalen, async(0|1), rc, rsn) BBGA1RCS(connectionhandle, requestservicename, requestservicenamel, requestdatalen, async(0|1), rc, rsn) |
매개변수:
connectionhandle(입력)수신 요청에 사용되는 12바이트의 연결 핸들입니다.
requestservicename(입/출력)서비스 이름이 포함된 최대 256바이트인 EBCDIC 문자열입니다. 이는 WebSphere Application Server 애플리케이션의 InteractionSpec에 지정된 대상 서비스 이름입니다. * 값은 현재 등록 이름으로 수신 중인 모든 서비스 이름에 대해 서버로 설정되도록 표시합니다.
requestservicenamel(입/출력)서비스 시작하려는 서비스 이름의 길이 또는 이름이 널로 종료되는 경우 0을 포함하는 정수입니다.
requestdatalen(출력)수신된 요청 데이터 길이가 포함된 31비트 모드의 32비트 부호 없는 값 또는 64비트 모드의 64비트 부호 없는 값이 리턴됩니다. 그러면 이 길이는 호출자가 데이터 가져오기 API를 호출하여 복사하려는 스토리지를 확보하는 데 사용할 수 있습니다. 호출자가 즉시 제어를 다시 확보하는 1로 async가 설정되는 경우, 이는 요청 데이터가 아직 수신되지 않은 경우 모든 0xFFs에 설정됩니다. 이 경우, API는 인바운드 요청을 수신하기 위해 다시 호출되어야 합니다.
async(0|1)(입력)1로 설정되는 정수 값은 요청 길이를 아직 알 수 없는 경우에도 호출자에게 제어가 즉시 리턴되도록 표시합니다. async가 0으로 설정되면 이 호출은 WebSphere Application Server에서 요청이 수신되기를 대기합니다.
rc(출력)이 호출의 성공 또는 실패를 나타내는 정수의 리턴 코드입니다.
rsn(출력)이 호출 실패에 대한 이유를 설정하는 정수의 이유 코드입니다.
- 이 호출에 지정된 WebSphere Application Server for z/OS 디먼 그룹 및 서버가 시작되고 로컬 어댑터 지원이 사용되도록 해야 합니다.
- 이 API 사용 전에 일치하는 이름으로 현재 주소 공간에서 성공적인 등록(BBOA1REG API) 호출이 완료되어야 합니다.
리턴 코드 | 이유 코드 | 설명 | 조치 |
---|---|---|---|
0 | - | 성공 | |
4 | - | 경고 - 이유 코드 참조 | |
8 | - | 오류 - 이유 코드 참조 | |
8 | 등록 이름 토큰이 이미 있습니다. | 전달된 등록 이름이 유효한지 확인하십시오. | |
10 | 연결 핸들은 릴리스 또는 적절하지 못한 상태입니다. | 유효한 연결 핸들이 전달되어야 합니다. | |
11 | WebSphere Application Server에서 잘못된 데이터 전송 | ||
16 | 요청 서비스 이름 길이가 유효하지 않습니다. | 프로그램을 정정하고 호출을 다시 시도하십시오. | |
19 | 로컬 통신 기존 데이터 실패 | ||
21 | 로컬 통신 미리보기 데이터 실패 | ||
28 | 연결 핸들이 연관된 등록이 더 이상 활성화되어 있지 않습니다. | 연결 가져오기 및 특정 요청 수신을 호출하기 전에 등록 이름을 다시 호출하십시오. | |
36 | 연결 상태가 유효하지 않습니다. | 이 요청에 사용되는 연결 핸들 상태가 잘못되었습니다. 연결 상태 규칙에 대해 API 문서를 참조하십시오. | |
38 | 클라이언트 연결 핸들이 유효하지 않습니다. | 이 요청에 사용되는 클라이언트 연결 핸들이 유효하지 않습니다. 클라이언트 연결 핸들 정보에 대해서는 API 문서를 참조하십시오. | |
40 | 로컬 통신 오류가 발생했습니다. | 모든 로컬 통신 오류 메시지에 대해서는 WebSphere Application Server 서버 로그를 확인하십시오. | |
46 | 로컬 통신 전송 요청 호출에서 오류가 발생했습니다. | WebSphere Application Server 로그를 참조하여 오류를 판별하십시오. | |
76 | 서버가 더 이상 실행되지 않아서 서버 통신 시도가 실패했습니다. | 서버를 시작하고 통신을 다시 시도하십시오. | |
78 | 연결에서 이 연결에서 처리 중인 트랜잭션의 파트가 아닌 요청이 선택되도록 하는 내부 오류가 발생했습니다. | 연결을 연결 풀로 리턴하십시오. 문제점이 계속되면 IBM 지원 센터에 문의하십시오. | |
80 | 이 연결에서 활성화된 트랜잭션이 제한시간을 초과하여 연결 상태를 다른 요청이 처리될 수 있도록 재설정하지 못했습니다. | 연결을 연결 풀로 리턴하십시오. 문제점이 계속되면 IBM 지원 센터에 문의하십시오. | |
96 | 이 API는 IMS 초기화 동안 또는 IMS 사전 초기화 종료 중에 구동할 수 없습니다. | IMS 초기화가 완료된 후에 이 API를 호출하십시오. | |
12 | 10 | WebSphere Application Server 디먼 그룹 또는 서버를 찾을 수 없습니다. | WebSphere Application Server 디먼 및 서버가 시작되었는지 및 로컬 연결 지원이 활성화되어 있는지 확인하고 호출을 다시 시도하십시오. |
14 | 제공된 연결 핸들을 사용하는 API 호출 벡터를 찾을 수 없거나 확인할 수 없습니다. | 연결 핸들이 유효하지 않거나 API(BBOA1URG API)가 연결 풀을 무효화했을 수도 있습니다. | |
34 | IMS 환경에서 64비트 API 스텁이 사용되었습니다. | 64비트 API는 IMS에서 지원되지 않습니다. | |
38 | 64비트 API 스텁이 CICS 환경에서 사용되었습니다. | 64비트 API는 CICS에서 지원되지 않습니다. | |
44 | 서비스 셀에 대한 잘못된 CP 빌드 | ||
46 | 서비스 호출에 대한 잘못된 CP 가져오기 | ||
48 | 서비스 셀에 대한 잘못된 CP 사용 가능화 | ||
60 | SRVQ 잠금 가져오기 실패 | ||
62 | SRVQ 잠금 해제 실패 | ||
86 | WebSphere Application Server for z/OS 마스터 BGVT를 찾을 수 없습니다. | WebSphere Application Server for z/OS 시스템 이미지에서 시작되지 않았습니다. 임의의 WebSphere Application Server 최적화된 로컬 어댑터 클라이언트 프로세스를 시작하기 전에 디먼 및 노드/서버가 시작되었는지 확인하십시오. | |
88 | WebSphere Application Server for z/OS 스텁 테이블을 찾을 수 없습니다. | WebSphere Application Server가 현재 z/OS 시스템 이미지에서 시작되었지만 최적화된 로컬 어댑터 클라이언트 스텁 테이블이 지원되는 레벨에서 실행 중이 아닙니다. 애플리케이션 서버의 유지보수 레벨과 호환되지 않는 WebSphere Application Server 버전 8.0.0.1 최적화된 로컬 어댑터 스텁 인터페이스를 실행 중일 수 있습니다. V8.0.0.1 최적화된 로컬 어댑터 스텁을 사용하려면 애플리케이션 서버도 WebSphere Application Server 버전 8.0.0. 레벨에서 실행 중이어야 합니다. 애플리케이션이 이 z/OS 시스템의 WebSphere Application Server와 호환되는 최적화된 로컬 어댑터 스텁 레벨로 실행 중인지 확인하십시오. | |
90 | WebSphere Application Server for z/OS 최적화된 로컬 어댑터 마스터 클라이언트 스텁 테이블을 찾을 수 없습니다. | WebSphere Application Server가 현재 z/OS 시스템 이미지에서 시작되었지만 최적화된 로컬 어댑터 클라이언트 스텁 테이블이 지원되는 레벨에서 실행 중이 아닙니다. 애플리케이션 서버의 유지보수 레벨과 호환되지 않는 WebSphere Application Server 버전 8.0.0.1 최적화된 로컬 어댑터 스텁 인터페이스를 실행 중일 수 있습니다. V8.0.0.1 최적화된 로컬 어댑터 스텁을 사용하려면 애플리케이션 서버도 WebSphere Application Server 버전 8.0.0. 레벨에서 실행 중이어야 합니다. 애플리케이션이 이 z/OS 시스템의 WebSphere Application Server와 호환되는 최적화된 로컬 어댑터 스텁 레벨로 실행 중인지 확인하십시오. |
응답 길이 수신
응답 길이 수신은 이전 전송 요청 호출에서 응답 데이터 길이를 수신하는 데 사용됩니다.API | 구문 |
---|---|
BBOA1RCL 또는 BBGA1RCL | BBOA1RCL(connectionhandle, async(0|1), responsedatalen, rc, rsn) BBGA1RCL(connectionhandle, async(0|1), responsedatalen, rc, rsn) |
매개변수:
connectionhandle(입력)이 요청에 사용되는 12바이트의 연결 핸들입니다.
async(입력)1로 설정되는 정수 값은 응답 길이를 아직 알 수 없는 경우에도 호출자에게 제어가 즉시 리턴되도록 표시합니다. async가 0으로 설정되면 이 호출은 WebSphere Application Server에서 응답이 리턴될 때까지 기다리고 응답 길이를 responsedatalen 매개변수 값으로 제공합니다.
responsedatalen(출력)수신된 데이터 길이가 포함된 31비트 모드의 32비트 부호 없는 값 및 64비트 모드의 64비트 부호 없는 값이 리턴됩니다. 이 길이는 호출자가 데이터 가져오기 API를 호출하여 복사하려는 스토리지를 확보하는 데 사용할 수 있습니다. async가 1로 설정되면 응답 데이터가 아직 수신되지 않은 경우 이는 모든 FFs로 리턴될 수 있습니다.
rc(출력)이 호출의 성공 또는 실패를 나타내는 정수의 리턴 코드입니다.
rsn(출력)이 호출 실패에 대한 이유를 설정하는 정수의 이유 코드입니다.
- 이 호출에 지정된 WebSphere Application Server for z/OS 디먼 그룹 및 서버가 시작되고 로컬 어댑터 지원이 사용되도록 해야 합니다.
- 이 API 사용 전에 일치하는 이름으로 현재 주소 공간에서 성공적인 등록(BBOA1REG 또는 BBGA1REG API) 호출이 완료되어야 합니다.
- 성공적인 연결 가져오기(BBOA1CNG 또는 BBGA1CNG API) 호출이 완료되고 핸들이 이 호출에 대한 입력으로 제공되는지 확인하십시오.
- 성공적인 전송 요청(BBOA1SRQ 또는 BBGA1SRQ API) 호출이 이 호출 전에 완료되었는지 확인하십시오.
리턴 코드 | 이유 코드 | 설명 | 조치 |
---|---|---|---|
0 | - | 성공 | |
4 | - | 경고 - 이유 코드 참조 | |
8 | - | 오류 - 이유 코드 참조 | |
8 | 등록 이름 토큰이 이미 있습니다. | 전달된 등록 이름이 유효한지 확인하십시오. | |
11 | WebSphere Application Server에서 잘못된 데이터가 전송되었습니다. | ||
19 | 로컬 통신 기존 데이터 실패 | ||
21 | 로컬 통신 미리보기 데이터 실패 | ||
34 | 대상 서비스를 찾을 수 없음 | 대상 엔터프라이즈 Bean을 포함하는 애플리케이션이 대상 WebSphere Application Server에 설치되어 시작되었는지 확인하십시오. | |
36 | 연결 상태가 유효하지 않습니다. | 이 요청에 사용되는 연결 핸들이 잘못된 상태로 판별되었습니다. 연결 상태 규칙에 대해 API 문서를 참조하십시오. | |
38 | 클라이언트 연결 핸들이 유효하지 않습니다. | 이 요청에 사용되는 클라이언트 연결 핸들이 유효하지 않은 것으로 판별되었습니다. 클라이언트 연결 핸들 정보에 대해서는 API 문서를 참조하십시오. | |
40 | 로컬 통신 오류가 발생했습니다. | 모든 로컬 통신 오류 메시지에 대해서는 WebSphere Application Server 서버 로그를 확인하십시오. | |
96 | 이 API는 IMS 초기화 동안 또는 IMS 사전 초기화 종료 중에 구동할 수 없습니다. | IMS 초기화가 완료된 후에 이 API를 호출하십시오. | |
12 | 10 | WebSphere Application Server 디먼 그룹 또는 서버를 찾을 수 없습니다. | WebSphere Application Server 디먼 및 서버가 시작되었는지 및 로컬 연결 지원이 활성화되어 있는지 확인하고 호출을 다시 시도하십시오. |
14 | 제공된 연결 핸들을 사용하는 API 호출 벡터를 찾을 수 없거나 확인할 수 없습니다. | 연결 핸들이 유효하지 않거나 API(BBOA1URG API)가 연결 풀을 무효화했을 수도 있습니다. | |
34 | IMS 환경에서 64비트 API 스텁이 사용되었습니다. | 64비트 API는 IMS에서 지원되지 않습니다. | |
38 | 64비트 API 스텁이 CICS 환경에서 사용되었습니다. | 64비트 API는 CICS에서 지원되지 않습니다. | |
86 | WebSphere Application Server for z/OS 마스터 BGVT를 찾을 수 없습니다. | WebSphere Application Server for z/OS 시스템 이미지에서 시작되지 않았습니다. 임의의 WebSphere Application Server 최적화된 로컬 어댑터 클라이언트 프로세스를 시작하기 전에 디먼 및 노드/서버가 시작되었는지 확인하십시오. | |
88 | WebSphere Application Server for z/OS 스텁 테이블을 찾을 수 없습니다. | WebSphere Application Server가 현재 z/OS 시스템 이미지에서 시작되었지만 최적화된 로컬 어댑터 클라이언트 스텁 테이블이 지원되는 레벨에서 실행 중이 아닙니다. 애플리케이션 서버의 유지보수 레벨과 호환되지 않는 WebSphere Application Server 버전 8.0.0.1 최적화된 로컬 어댑터 스텁 인터페이스를 실행 중일 수 있습니다. V8.0.0.1 최적화된 로컬 어댑터 스텁을 사용하려면 애플리케이션 서버도 WebSphere Application Server 버전 8.0.0. 레벨에서 실행 중이어야 합니다. 애플리케이션이 이 z/OS 시스템의 WebSphere Application Server와 호환되는 최적화된 로컬 어댑터 스텁 레벨로 실행 중인지 확인하십시오. | |
90 | WebSphere Application Server for z/OS 최적화된 로컬 어댑터 마스터 클라이언트 스텁 테이블을 찾을 수 없습니다. | WebSphere Application Server가 현재 z/OS 시스템 이미지에서 시작되었지만 최적화된 로컬 어댑터 클라이언트 스텁 테이블이 지원되는 레벨에서 실행 중이 아닙니다. 애플리케이션 서버의 유지보수 레벨과 호환되지 않는 WebSphere Application Server 버전 8.0.0.1 최적화된 로컬 어댑터 스텁 인터페이스를 실행 중일 수 있습니다. V8.0.0.1 최적화된 로컬 어댑터 스텁을 사용하려면 애플리케이션 서버도 WebSphere Application Server 버전 8.0.0. 레벨에서 실행 중이어야 합니다. 애플리케이션이 이 z/OS 시스템의 WebSphere Application Server와 호환되는 최적화된 로컬 어댑터 스텁 레벨로 실행 중인지 확인하십시오. |
메시지 데이터 가져오기
이 API는 수신된 메시지 데이터를 복사하는 데 사용됩니다. 이 호출에서 리턴 시 메시지는 어댑터 메시지 캐시에서 제거됩니다.API | 구문 |
---|---|
BBOA1GET 또는 BBGA1GET | BBOA1GET(connectionhandle, msgdata, msgdatalen, rc, rsn, rv) BBGA1GET(connectionhandle, msgdata, msgdatalen, rc, rsn, rv) |
매개변수:
connectionhandle(입력)이 요청에 사용되는 12바이트의 연결 핸들입니다.
msgdata(입력)복사되는 데이터 영역의 시작 주소에 대한 31비트 또는 64비트 포인터입니다. 지시되는 스토리지는 호출자가 쓰기 가능한 키 안에 있어야 합니다.
msgdatalen(입력)복사되는 데이터 길이가 포함된 31비트 모드의 32비트 부호 없는 값 또는 64비트 모드의 64비트 부호 없는 값입니다.
rc(출력)이 호출의 성공 또는 실패를 나타내는 정수의 리턴 코드입니다.
rsn(출력)이 호출 실패에 대한 이유를 설정하는 정수의 이유 코드입니다.
rv(출력)이 요청에 대한 컨텍스트 버퍼 크기가 포함된 32비트 정수의 리턴값입니다.
- 이 호출에 지정된 WebSphere Application Server for z/OS 디먼 그룹 및 서버가 시작되고 로컬 어댑터 지원이 사용되도록 해야 합니다.
- 응답 요청 API 사용 전에 일치하는 이름으로 현재 주소 공간에서 성공적인 등록(BBOA1REG 또는 BBGA1REG API) 호출이 완료되어야 합니다.
- 성공적인 연결 가져오기(BBOA1CNG 또는 BBGA1CNG API) 호출이 완료되고 핸들이 이 호출에 대한 입력으로 제공되는지 확인하십시오.
- API 호출자 입력 msgdatalen 매개변수가 실제 메시지 응답보다 큰 경우, 리턴 코드에는 0이 포함되고 실제 메시지 길이는 리턴 값에 제공됩니다.
- 중요사항: 메시지 데이터 가져오기 호출이 호출자에게 리턴되면 메시지 데이터는 지속되지 않으며 연결이 다른 전송 또는 요청 호출 수신에 사용 가능한 상태로 리턴됩니다. 메시지 데이터 가져오기 또는 응답 길이 수신에 대한 후속 호출은 오류로 리턴됩니다.
리턴 코드 | 이유 코드 | 설명 | 조치 |
---|---|---|---|
0 | - | 성공 | |
4 | - | 경고 - 이유 코드 참조 | |
8 | - | 오류 - 이유 코드 참조 | |
8 | 등록 이름 토큰이 이미 있습니다. | 전달된 등록 이름이 유효한지 확인하십시오. | |
36 | 연결 상태가 유효하지 않습니다. | 이 요청에 사용되는 연결 핸들이 잘못된 상태로 판별되었습니다. 연결 상태 규칙에 대해 API 문서를 참조하십시오. | |
38 | 클라이언트 연결 핸들이 유효하지 않습니다. | 이 요청에 사용되는 클라이언트 연결 핸들이 유효하지 않은 것으로 판별되었습니다. 클라이언트 연결 핸들 정보에 대해서는 API 문서를 참조하십시오. | |
40 | 로컬 통신 오류가 발생했습니다. | 모든 로컬 통신 오류 메시지에 대해서는 WebSphere Application Server 서버 로그를 확인하십시오. | |
48 | 로컬 통신 읽기 요청에서 오류가 발생했습니다. | WebSphere Application Server 로그를 참조하여 오류를 판별하십시오. | |
50 | WebSphere Application Server와의 연결이 종료되었습니다. | WebSphere Application Server 로그를 참조하여 오류를 판별하십시오. | |
72 | 응답 길이 입력 매개변수가 응답 메시지를 포함할 만큼 크지 않습니다. | 메시지 일부만 리턴됩니다. 나머지는 제거됩니다. 메시지 응답 크기에 대해서는 리턴값을 참조하십시오. | |
96 | 이 API는 IMS 초기화 동안 또는 IMS 사전 초기화 종료 중에 구동할 수 없습니다. | IMS 초기화가 완료된 후에 이 API를 호출하십시오. | |
98 | 제공된 요청 버퍼 시작에 액세스할 수 없습니다. | 제공된 요청 버퍼 주소 및 길이가 올바른지 확인하십시오. | |
100 | 제공된 요청 버퍼 끝에 액세스할 수 없습니다. | 제공된 요청 버퍼 주소 및 길이가 올바른지 확인하십시오. | |
102 | 제공된 응답 버퍼 시작에 액세스할 수 없습니다. | 제공된 응답 버퍼 주소 및 길이가 올바른지 확인하십시오. | |
104 | 제공된 응답 버퍼 끝에 액세스할 수 없습니다. | 제공된 응답 버퍼 주소 및 길이가 올바른지 확인하십시오. | |
12 | 10 | WebSphere Application Server 디먼 그룹 또는 서버를 찾을 수 없습니다. | WebSphere Application Server 디먼 및 서버가 시작되었는지 및 로컬 연결 지원이 활성화되어 있는지 확인하고 다시 시도하십시오. |
12 | 10 | WebSphere Application Server 디먼 그룹 또는 서버를 찾을 수 없습니다. | WebSphere Application Server 디먼 및 서버가 시작되었는지 및 로컬 연결 지원이 활성화되어 있는지 확인하고 호출을 다시 시도하십시오. |
14 | 제공된 연결 핸들을 사용하는 API 호출 벡터를 찾을 수 없거나 확인할 수 없습니다. | 연결 핸들이 유효하지 않거나 API(BBOA1URG API)가 연결 풀을 무효화했을 수도 있습니다. | |
34 | IMS 환경에서 64비트 API 스텁이 사용되었습니다. | 64비트 API는 IMS에서 지원되지 않습니다. | |
38 | 64비트 API 스텁이 CICS 환경에서 사용되었습니다. | 64비트 API는 CICS에서 지원되지 않습니다. | |
86 | WebSphere Application Server for z/OS 마스터 BGVT를 찾을 수 없습니다. | WebSphere Application Server for z/OS 시스템 이미지에서 시작되지 않았습니다. 임의의 WebSphere Application Server 최적화된 로컬 어댑터 클라이언트 프로세스를 시작하기 전에 디먼 및 노드/서버가 시작되었는지 확인하십시오. | |
88 | WebSphere Application Server for z/OS 스텁 테이블을 찾을 수 없습니다. | WebSphere Application Server가 현재 z/OS 시스템 이미지에서 시작되었지만 최적화된 로컬 어댑터 클라이언트 스텁 테이블이 지원되는 레벨에서 실행 중이 아닙니다. 애플리케이션 서버의 유지보수 레벨과 호환되지 않는 WebSphere Application Server 버전 8.0.0.1 최적화된 로컬 어댑터 스텁 인터페이스를 실행 중일 수 있습니다. V8.0.0.1 최적화된 로컬 어댑터 스텁을 사용하려면 애플리케이션 서버도 WebSphere Application Server 버전 8.0.0. 레벨에서 실행 중이어야 합니다. 애플리케이션이 이 z/OS 시스템의 WebSphere Application Server와 호환되는 최적화된 로컬 어댑터 스텁 레벨로 실행 중인지 확인하십시오. | |
90 | WebSphere Application Server for z/OS 최적화된 로컬 어댑터 마스터 클라이언트 스텁 테이블을 찾을 수 없습니다. | WebSphere Application Server가 현재 z/OS 시스템 이미지에서 시작되었지만 최적화된 로컬 어댑터 클라이언트 스텁 테이블이 지원되는 레벨에서 실행 중이 아닙니다. 애플리케이션 서버의 유지보수 레벨과 호환되지 않는 WebSphere Application Server 버전 8.0.0.1 최적화된 로컬 어댑터 스텁 인터페이스를 실행 중일 수 있습니다. V8.0.0.1 최적화된 로컬 어댑터 스텁을 사용하려면 애플리케이션 서버도 WebSphere Application Server 버전 8.0.0. 레벨에서 실행 중이어야 합니다. 애플리케이션이 이 z/OS 시스템의 WebSphere Application Server와 호환되는 최적화된 로컬 어댑터 스텁 레벨로 실행 중인지 확인하십시오. |
호출
이 API는 다른 기반이되는 기본 API 함수를 사용하여 로컬 WebSphere Application Server의 메소드를 호출합니다. 이는 응답 출력 영역 최대 크기를 먼저 알 수 있는 상황에서 사용 가능합니다.API | 구문 |
---|---|
BBOA1INV 또는 BBGA1INV | BBOA1INV(registername, requesttype, requestservicename, requestservicenamel, requestdata, requestdatalen, responsedata, responsedatalen, waittime, rc, rsn, rv) BBGA1INV(registername, requesttype, requestservicename, requestservicenamel, requestdata, requestdatalen, responsedata, responsedatalen, waittime, rc, rsn, rv) |
매개변수:
registername(입력)이 호출에 대한 연결을 검색하는 연결 풀을 찾는 데 사용되는 이름이 포함된 입력 변수 또는 입력 상수입니다. 이는 정확하게 12자의 공백으로 채워지는 문자열이어야 합니다.
requesttype(입력)처리하려는 작업 요청 유형을 표시하는 요청 유형이 포함된 정수입니다. 지원되는 유형 값: 1 = 로컬 EJB 작업 요청, 2 = 원격 EJB 작업 요청.
requestservicename(입력)호출하려는 서비스 이름이 포함된 최대 길이가 256바이트인 EBCDIC 문자열입니다. 유형=1, EJB에 대해 이는 대상의 JNDI 홈 이름입니다.
requestservicenamel(입력)서비스 시작하려는 서비스 이름의 길이 또는 이름이 널로 종료되는 경우 0을 포함하는 정수입니다.
requestdata(입력)전송하려는 요청 데이터 시작 주소에 대한 31비트 또는 64비트 포인터입니다.
requestdatalen(입력)전송하려는 데이터 길이가 포함된 31비트 모드의 32비트 부호 없는 값 또는 64비트 모드의 64비트 부호 없는 값입니다.
responsedata(입력)복사되는 응답 데이터 영역의 시작 주소에 대한 31비트 또는 64비트 포인터입니다. 지시되는 스토리지는 호출자가 쓰기 가능한 키 안에 있어야 합니다.
responsedatalen(입력)전송하려는 데이터 길이가 포함된 31비트 모드의 32비트 부호 없는 값 또는 64비트 모드의 64비트 부호 없는 값입니다.
waittime(입력)연결 사용 불가능 이유 코드를 리턴하기 전에 연결이 완료되기를 기다리는 시간(초)가 포함된 정수입니다. 0 값은 대기 시간이 없으며 이 API가 무한정 대기하는 것을 나타냅니다.
rc(출력)이 호출의 성공 또는 실패를 나타내는 정수의 리턴 코드입니다.
rsn(출력)이 호출 실패에 대한 이유를 설정하는 정수의 이유 코드입니다.
rv(출력)수신되어 호출자 응답 영역에 복사된 메시지 데이터의 크기가 포함된 32비트 정수의 리턴값입니다.
- 이 호출에 지정된 WebSphere Application Server for z/OS 디먼 그룹 및 서버가 시작되고 로컬 어댑터 지원이 사용되도록 해야 합니다.
- 응답 요청 API 사용 전에 일치하는 이름으로 현재 주소 공간에서 성공적인 등록(BBOA1REG 또는 BBGA1REG API) 호출이 완료되어야 합니다.
- API 호출자 입력 responsedatalen 매개변수가 실제 메시지 응답보다 큰 경우, 리턴 코드에는 0이 포함되고 실제 메시지 길이는 리턴 값에 제공됩니다.
리턴 코드 | 이유 코드 | 설명 | 조치 |
---|---|---|---|
0 | - | 성공 | |
4 | - | 경고 - 이유 코드 참조 | |
8 | - | 오류 - 이유 코드 참조 | |
8 | 등록 이름 토큰이 이미 있습니다. | 전달된 등록 이름이 유효한지 확인하십시오. | |
10 | 연결이 사용 불가능합니다. 연결 요청을 확보하기 전에 대기 시간이 만료되었습니다. | 애플리케이션 동작은 다양합니다. 대기한 후에 다시 시도하거나 이 실패한 호출 API 호출을 승인하십시오. 또는, 등록 API 호출에서 최대 연결 설정을 늘릴 수도 있습니다. | |
11 | WebSphere Application Server에서 잘못된 데이터가 전송되었습니다. | ||
14 | 메시지 저장 중에 메모리 부족 조건이 발생했습니다. | 메시지 처리를 위해 호출에 사용할 수 있는 메모리가 부족합니다. 현재 주소 공간이 개인 스토리지를 벗어났습니다. | |
16 | 요청 서비스 이름 길이가 유효하지 않습니다. | 프로그램을 정정하고 호출을 다시 시도하십시오. | |
18 | 응답 길이가 시스템 한계를 초과했습니다. | 메시지 크기가 WebSphere Application Server 크기가 지원할 수 있는 크기보다 큽니다. 크기가 유효한지 확인하십시오. 크기가 유효한 경우 WebSphere Application Server 크기가 메시지 크기를 수용할 정도로 큰지 확인하십시오. | |
19 | 로컬 통신 기존 데이터 실패. | ||
21 | 로컬 통신 미리보기 데이터 실패. | ||
24 | 등록 호출이 성공한 후에 풀에서 연결을 가져오는 중에 오류가 발생했습니다. | 서버가 시작되었는지 확인하십시오. 제대로 작동하지 않으면 서버를 다시 시작하고 API 요청을 다시 시도하십시오. | |
26 | 글로벌 트랜잭션을 시작할 수 없습니다. | ||
28 | 등록은 있지만 비활성 상태입니다. | ||
32 | API 호출의 요청 유형이 유효하지 않습니다. | 요청 유형 매개변수가 유효하지 않습니다. 프로그램을 정정하고 호출을 다시 시도하십시오. | |
34 | 대상 서비스를 찾을 수 없음 | 대상 엔터프라이즈 Bean을 포함하는 애플리케이션이 대상 WebSphere Application Server에 설치되어 시작되었는지 확인하십시오. | |
36 | 연결 상태가 유효하지 않습니다. | 이 요청에 사용되는 연결 핸들이 잘못된 상태로 판별되었습니다. 연결 상태 규칙에 대해 API 문서를 참조하십시오. | |
38 | 클라이언트 연결 핸들이 유효하지 않습니다. | 이 요청에 사용되는 클라이언트 연결 핸들이 유효하지 않은 것으로 판별되었습니다. 클라이언트 연결 핸들 정보에 대해서는 API 문서를 참조하십시오. | |
40 | 로컬 통신 오류가 발생했습니다. | 모든 로컬 통신 오류 메시지에 대해서는 WebSphere Application Server 서버 로그를 확인하십시오. | |
44 | 대상 엔터프라이즈 Bean에서 예외 또는 예기치 않은 조건이 발생했습니다. | WebSphere Application Server 로그에서 예외 데이터를 검토하십시오. | |
46 | 로컬 통신 전송 요청에서 오류가 발생했습니다. | WebSphere Application Server 로그를 참조하여 오류를 판별하십시오. | |
48 | 로컬 통신 읽기 요청에서 오류가 발생했습니다. | WebSphere Application Server 로그를 참조하여 오류를 판별하십시오. | |
50 | WebSphere Application Server와의 연결이 종료되었습니다. | WebSphere Application Server의 내용을 참조하여 오류를 판별하십시오. | |
72 | 응답 길이 입력 매개변수가 응답 메시지를 포함할 만큼 크지 않습니다. | 메시지 일부만 리턴됩니다. 나머지는 제거됩니다. 메시지 응답 크기에 대해서는 리턴값을 참조하십시오. | |
96 | 이 API는 IMS 초기화 동안 또는 IMS 사전 초기화 종료 중에 구동할 수 없습니다. | IMS 초기화가 완료된 후에 이 API를 호출하십시오. | |
98 | 제공된 요청 버퍼 시작에 액세스할 수 없습니다. | 제공된 요청 버퍼 주소 및 길이가 올바른지 확인하십시오. | |
100 | 제공된 요청 버퍼 끝에 액세스할 수 없습니다. | 제공된 요청 버퍼 주소 및 길이가 올바른지 확인하십시오. | |
102 | 제공된 응답 버퍼 시작에 액세스할 수 없습니다. | 제공된 응답 버퍼 주소 및 길이가 올바른지 확인하십시오. | |
104 | 제공된 응답 버퍼 끝에 액세스할 수 없습니다. | 제공된 응답 버퍼 주소 및 길이가 올바른지 확인하십시오. | |
12 | 10 | WebSphere Application Server 디먼 그룹 또는 서버를 찾을 수 없습니다. | WebSphere Application Server 디먼 및 서버가 시작되었는지 및 로컬 연결 지원이 활성화되어 있는지 확인하고 호출을 다시 시도하십시오. |
14 | 제공된 연결 핸들을 사용하는 API 호출 벡터를 찾을 수 없거나 확인할 수 없습니다. | 연결 핸들이 유효하지 않거나 API(BBOA1URG API)가 연결 풀을 무효화했을 수도 있습니다. | |
24 | 등록 호출이 성공한 후에 연결 풀에서 연결을 가져오는 중에 오류가 발생했습니다. | 서버가 시작되었는지 확인하십시오. 시작되지 않은 경우, 서버를 다시 시작하고 API 요청을 다시 시도하십시오. | |
34 | IMS 환경에서 64비트 API 스텁이 사용되었습니다. | 64비트 API는 IMS에서 지원되지 않습니다. | |
38 | 64비트 API 스텁이 CICS 환경에서 사용되었습니다. | 64비트 API는 CICS에서 지원되지 않습니다. | |
86 | WebSphere Application Server for z/OS 마스터 BGVT를 찾을 수 없습니다. | WebSphere Application Server for z/OS 시스템 이미지에서 시작되지 않았습니다. 임의의 WebSphere Application Server 최적화된 로컬 어댑터 클라이언트 프로세스를 시작하기 전에 디먼 및 노드/서버가 시작되었는지 확인하십시오. | |
88 | WebSphere Application Server for z/OS 스텁 테이블을 찾을 수 없습니다. | WebSphere Application Server가 현재 z/OS 시스템 이미지에서 시작되었지만 최적화된 로컬 어댑터 클라이언트 스텁 테이블이 지원되는 레벨에서 실행 중이 아닙니다. 애플리케이션 서버의 유지보수 레벨과 호환되지 않는 WebSphere Application Server 버전 8.0.0.1 최적화된 로컬 어댑터 스텁 인터페이스를 실행 중일 수 있습니다. V8.0.0.1 최적화된 로컬 어댑터 스텁을 사용하려면 애플리케이션 서버도 WebSphere Application Server 버전 8.0.0. 레벨에서 실행 중이어야 합니다. 애플리케이션이 이 z/OS 시스템의 WebSphere Application Server와 호환되는 최적화된 로컬 어댑터 스텁 레벨로 실행 중인지 확인하십시오. | |
90 | WebSphere Application Server for z/OS 최적화된 로컬 어댑터 마스터 클라이언트 스텁 테이블을 찾을 수 없습니다. | WebSphere Application Server가 현재 z/OS 시스템 이미지에서 시작되었지만 최적화된 로컬 어댑터 클라이언트 스텁 테이블이 지원되는 레벨에서 실행 중이 아닙니다. 애플리케이션 서버의 유지보수 레벨과 호환되지 않는 WebSphere Application Server 버전 8.0.0.1 최적화된 로컬 어댑터 스텁 인터페이스를 실행 중일 수 있습니다. V8.0.0.1 최적화된 로컬 어댑터 스텁을 사용하려면 애플리케이션 서버도 WebSphere Application Server 버전 8.0.0. 레벨에서 실행 중이어야 합니다. 애플리케이션이 이 z/OS 시스템의 WebSphere Application Server와 호환되는 최적화된 로컬 어댑터 스텁 레벨로 실행 중인지 확인하십시오. |
호스트 서비스
로컬 WebSphere Application Server를 위한 호스트 서비스입니다. 이 API는 다른 기반이 되는 기본 API 함수를 사용하여 기본 언어 z/OS 프로그램을 로컬 WebSphere Application Server의 최적화된 로컬 어댑터용 서버 및 대상으로 설정합니다. 이는 요청 영역 최대 크기를 먼저 알 수 있는 상황에서 사용 가능합니다.API | 구문 |
---|---|
BBOA1SRV 또는 BBGA1SRV | BBOA1SRV(registername, requestservicename, requestservicenamel, requestdata, requestdatalen, connectionhandle, waittime, rc, rsn, rv) BBGA1SRV(registername, requestservicename, requestservicenamel, requestdata, requestdatalen, connectionhandle, waittime, rc, rsn, rv) |
매개변수:
registername(입력)이 호출에 대한 연결을 검색하는 연결 풀을 찾는 데 사용되는 이름이 포함된 입력 변수 또는 입력 상수입니다. 이는 정확하게 12자의 공백으로 채워지는 문자열이어야 합니다.
requestservicename(입/출력)서비스 이름이 포함된 최대 256바이트인 EBCDIC 문자열입니다. 이는 WebSphere Application Server 애플리케이션의 InteractionSpec에 지정된 대상 서비스 이름입니다. * 값은 현재 등록 이름으로 수신 중인 모든 서비스 이름에 대해 서버로 설정되도록 표시합니다.
requestservicenamel(입/출력)서비스 시작하려는 서비스 이름의 길이 또는 이름이 널로 종료되는 경우 0을 포함하는 정수입니다.
requestdata(입력)수신된 요청 데이터 시작 주소에 대한 31비트 또는 64비트 포인터입니다. 지시되는 스토리지는 호출자가 쓰기 가능한 키 안에 있어야 합니다.
requestdatalen(입력)메시지가 수신되는 데이터 영역의 길이가 포함된 31비트 모드의 32비트 부호 없는 값 또는 64비트 모드의 64비트 부호 없는 값입니다.
connectionhandle(출력)호출자에게 리턴되고 이 요청에 대한 응답 전송에 사용되는 12바이트의 연결 핸들입니다.
waittime(입력)연결 사용 불가능 이유 코드를 리턴하기 전에 연결이 완료되기를 기다리는 시간(초)가 포함된 정수입니다. 0 값은 대기 시간이 없으며 API가 무한정 대기하는 것을 나타냅니다.
rc(출력)이 호출의 성공 또는 실패를 나타내는 정수의 리턴 코드입니다.
rsn(출력)이 호출 실패에 대한 이유를 설정하는 정수의 이유 코드입니다.
rv(출력)수신되어 호출자 영역에 복사된 메시지 요청의 크기가 포함된 32-bit비트 정수의 리턴값입니다.
사용법 참고
- 이 호출에 지정된 WebSphere Application Server for z/OS 디먼 그룹 및 서버가 시작되고 로컬 어댑터 지원이 사용되도록 해야 합니다.
- 이 API 사용 전에 일치하는 이름으로 현재 주소 공간에서 성공적인 등록(BBOA1REG 또는 BBGA1REG API) 호출이 완료되어야 합니다.
- API 호출자 입력 requestdatalen 매개변수가 실제 메시지 응답보다 큰 경우, 리턴 코드에는 0이 포함되고 실제 메시지 길이는 리턴 값에 제공됩니다.
- 리턴된 연결 핸들은 BBOA1SRP 또는 BBGA1SRP API를 사용하여 이 호스트 호출에 대한 모든 응답에 제공되어야 합니다. 후속 BBOA1SRV 또는 BBGA1SRVAPI 호출은 동일한 연결 핸들을 재사용합니다. 그런 경우 API는 이전 요청에 대한 응답이 없는 것으로 간주합니다.
- 중요사항: 호스트 서비스 호출이 호출자에게 리턴되면 메시지 데이터는 지속되지 않으며 연결은 다른 API 요청에 사용할 수 있는 상태로 리턴됩니다.
리턴 코드 | 이유 코드 | 설명 | 조치 |
---|---|---|---|
0 | - | 성공 | |
4 | - | 경고 - 이유 코드 참조 | |
8 | - | 오류 - 이유 코드 참조 | |
8 | 등록 이름 토큰이 이미 있습니다. | 전달된 등록 이름이 유효한지 확인하십시오. | |
10 | 연결 핸들은 릴리스 상태입니다. | 올바른 연결 핸들이 전달되어야 합니다. | |
12 | 연결 핸들은 등록 이름 내에 있는 연결이 아닙니다. | 프로그램을 정정하고 호출을 다시 시도하십시오. | |
16 | 요청 서비스 이름 길이가 유효하지 않습니다. | 프로그램을 정정하고 호출을 다시 시도하십시오. | |
18 | 응답 길이가 시스템 한계를 초과했습니다. | 메시지 크기가 WebSphere Application Server 크기가 지원할 수 있는 크기보다 큽니다. 크기가 유효한지 확인하십시오. 크기가 유효한 경우 WebSphere Application Server 크기가 메시지 크기를 수용할 정도로 큰지 확인하십시오. | |
40 | 로컬 통신 오류가 발생했습니다. | 모든 로컬 통신 오류 메시지에 대해서는 WebSphere Application Server 서버 로그를 확인하십시오. | |
46 | 로컬 통신 전송 요청 호출에서 오류가 발생했습니다. | WebSphere Application Server 로그를 참조하여 오류를 판별하십시오. | |
48 | 로컬 통신 읽기 요청에서 오류가 발생했습니다. | WebSphere Application Server 로그를 참조하여 오류를 판별하십시오. | |
50 | WebSphere Application Server와의 연결이 종료되었습니다. | WebSphere Application Server 로그를 참조하여 오류를 판별하십시오. | |
72 | 응답 길이 입력 매개변수가 응답 메시지를 포함할 만큼 크지 않습니다. | 메시지 일부만 리턴됩니다. 나머지는 제거됩니다. 메시지 응답 크기에 대해서는 리턴값을 참조하십시오. | |
76 | 서버가 더 이상 실행되지 않아서 서버 통신 시도가 실패했습니다. | 서버를 시작하고 통신을 다시 시도하십시오. | |
96 | 이 API는 IMS 초기화 동안 또는 IMS 사전 초기화 종료 중에 구동할 수 없습니다. | IMS 초기화가 완료된 후에 이 API를 호출하십시오. | |
98 | 제공된 요청 버퍼 시작에 액세스할 수 없습니다. | 제공된 요청 버퍼 주소 및 길이가 올바른지 확인하십시오. | |
100 | 제공된 요청 버퍼 끝에 액세스할 수 없습니다. | 제공된 요청 버퍼 주소 및 길이가 올바른지 확인하십시오. | |
12 | 10 | WebSphere Application Server 디먼 그룹 또는 서버를 찾을 수 없습니다. | WebSphere Application Server 디먼 및 서버가 시작되었는지 및 로컬 연결 지원이 활성화되어 있는지 확인하고 다시 시도하십시오. |
14 | 제공된 연결 핸들을 사용하는 API 호출 벡터를 찾을 수 없거나 확인할 수 없습니다. | 연결 핸들이 유효하지 않거나 API(BBOA1URG 또는 BBGA1URG API)가 연결 풀을 무효화했을 수도 있습니다. | |
34 | IMS 환경에서 64비트 API 스텁이 사용되었습니다. | 64비트 API는 IMS에서 지원되지 않습니다. | |
38 | 64비트 API 스텁이 CICS 환경에서 사용되었습니다. | 64비트 API는 CICS에서 지원되지 않습니다. | |
44 | 서비스 셀에 대한 잘못된 CP 빌드. | ||
46 | 서비스 셀에 대한 잘못된 CP 가져오기. | ||
48 | 서비스 셀에 대한 잘못된 CP 사용 가능화. | ||
60 | SRVQ 잠금 가져오기 실패. | ||
62 | SRVQ 잠금 해제 실패. | ||
86 | WebSphere Application Server for z/OS 마스터 BGVT를 찾을 수 없습니다. | WebSphere Application Server for z/OS 시스템 이미지에서 시작되지 않았습니다. 임의의 WebSphere Application Server 최적화된 로컬 어댑터 클라이언트 프로세스를 시작하기 전에 디먼 및 노드/서버가 시작되었는지 확인하십시오. | |
88 | WebSphere Application Server for z/OS 스텁 테이블을 찾을 수 없습니다. | WebSphere Application Server가 현재 z/OS 시스템 이미지에서 시작되었지만 최적화된 로컬 어댑터 클라이언트 스텁 테이블이 지원되는 레벨에서 실행 중이 아닙니다. 애플리케이션 서버의 유지보수 레벨과 호환되지 않는 WebSphere Application Server 버전 8.0.0.1 최적화된 로컬 어댑터 스텁 인터페이스를 실행 중일 수 있습니다. V8.0.0.1 최적화된 로컬 어댑터 스텁을 사용하려면 애플리케이션 서버도 WebSphere Application Server 버전 8.0.0. 레벨에서 실행 중이어야 합니다. 애플리케이션이 이 z/OS 시스템의 WebSphere Application Server와 호환되는 최적화된 로컬 어댑터 스텁 레벨로 실행 중인지 확인하십시오. | |
90 | WebSphere Application Server for z/OS 최적화된 로컬 어댑터 마스터 클라이언트 스텁 테이블을 찾을 수 없습니다. | WebSphere Application Server가 현재 z/OS 시스템 이미지에서 시작되었지만 최적화된 로컬 어댑터 클라이언트 스텁 테이블이 지원되는 레벨에서 실행 중이 아닙니다. 애플리케이션 서버의 유지보수 레벨과 호환되지 않는 WebSphere Application Server 버전 8.0.0.1 최적화된 로컬 어댑터 스텁 인터페이스를 실행 중일 수 있습니다. V8.0.0.1 최적화된 로컬 어댑터 스텁을 사용하려면 애플리케이션 서버도 WebSphere Application Server 버전 8.0.0. 레벨에서 실행 중이어야 합니다. 애플리케이션이 이 z/OS 시스템의 WebSphere Application Server와 호환되는 최적화된 로컬 어댑터 스텁 레벨로 실행 중인지 확인하십시오. |
JCA 어댑터 API
- ConnectionSpec
- InteractionSpec
- 레코드 I/O
ConnectionSpec API는 통신하려는 등록 이름 표시에 사용됩니다. 등록 이름은 등록 API 사용 시에 작성됩니다. 이는 연결할 서브시스템도 식별합니다. 서브시스템은 둘 이상의 등록 이름을 가질 수 있습니다.
프로그램 링크 트랜잭션 ID 이름은 WebSphere Application Server에서 CICS로 전달 가능하며 프로그램 링크 호출 태스크 실행에 사용됩니다. 이는 4자여야 하며 CICS 리젼에 정의됩니다. BBO# 트랜잭션과 동일한 속성 및 프로그램 이름으로 설정해야 합니다(프로그램: BBOACLNK). 이 트랜잭션 ID가 setLinkTaskTranid 메소드를 사용하여 전달되면 이는 BBO# API 및 LTX=xxx 매개변수가 포함된 BBOC를 사용하여 지정된 모든 트랜잭션 ID를 대체합니다.
setUseCICSContainer 메소드 또는 JCA MappedRecord 인터페이스를 사용하여 애플리케이션을 채널과 컨테이너를 통해 CICS로 전송할 수 있습니다.
- setUseCICSContainer 메소드는 ConnectionSpecImpl에서 제공됩니다. 1로 설정되면
메시지 요청 CICS 컨테이너의 이름과 유형이 setLinkTaskReqContid()
및 setLinkTaskReqContType(0|1)을 사용하여
CICS로 전송 가능합니다(여기서, 0=CHAR 및 1=BIT). 메시지 요청
CICS 컨테이너가 CICS로 전달되는 경우,
대상 프로그램은 선택한 BIT 또는 CHAR 유형으로 작성되는 이름 지정된 컨테이너로
전달되는 자체 입력 데이터를 포함합니다.
메시지 응답 CICS 컨테이너의 이름과 유형은 메소드 setLinkTaskRspContid() 및 setLinkTaskRspContType(bit|char)을 사용하여 CICS에 전달 가능합니다. 전달되면 대상 프로그램 응답에서는 선택한 유형 BIT 또는 CHAR의 이름 지정한 컨테이너에서 오는 것으로 예상합니다.
- JCA MappedRecord 인터페이스는 하나 이상의 컨테이너를 CICS로 전달하는
데 사용할 수 있습니다. JCA MappedRecord
인터페이스를 사용하는 경우 이름 지정된 채널이 대상 프로그램과의
통신에 사용됩니다. MappedRecord 인터페이스를 사용하는 경우, UseCICSContainer를 1로 설정하고
CICS 채널 이름과 유형은 메소드 setLinkTaskChanID() 및 setLinkTaskChanType(bit|char)을 사용하여
CICS에 전달해야 합니다.
문제점 방지: CICS로 컨테이너를 전달하는 데 사용된 JCA MappedRecord 인터페이스는 WOLA 연결 오브젝트에서 확보한 recordFactory를 사용하여 recordFactory.createMappedRecord() 메소드를 호출해서 확보합니다. setLinkTaskReqContId(), setLinkTaskReqContType(), setLinkTaskRspContId() 또는 SetLinkTaskRspContType() 메소드를 JCA MappedRecord 인터페이스와 같이 사용하지 마십시오. gotcha
IMS 애플리케이션 트랜잭션의 경우 연결 스펙에서 setOTMAMaxRecvSize(nnn) 메소드를 사용하여 최대 메시지 수신 크기를 설정하십시오. 최대 세그먼트 연결 레벨 값을 설정하려면 연결 스펙에서 setOTMAMaxSegments(nnn) 메소드를 사용하십시오. OTMA에서 IMS와 같이 최적화된 로컬 어댑터를 사용하는 자세한 정보는 OTMA에서 최적화된 로컬 어댑터를 사용하여 기존 IMS 트랜잭션 호출 주제를 참조하십시오.
InteractionSpec
InteractionSpec API는 대상으로 시작되는 서비스 지정에 사용됩니다. 이는 시작되는 서브시스템 또는 일괄처리 프로세스에 따라 다릅니다. 프로세스는 특정 서비스 또는 모든 서비스에 대해 요청을 수신하도록 선택할 수 있습니다. CICS에 대해 서비스 이름은 CICS에서 시작되는 프로그램 이름입니다.
레코드 I/O
애플리케이션은 JCA 레코드 인터페이스를 사용하여 데이터를 전달하고 데이터를 수신할 수 있습니다. 이 어댑터 API는 색인화된 인터페이스를 사용하여 호출자가 Cobol 카피북 및 C 구조를 포함하여 하나 이상의 구조를 외부 주소 공간으로 전달할 수 있도록 제안합니다. 목록의 각 색인은 별도의 카피북으로 사용되며 해당 순서대로 대상에 전달됩니다.
함수 호출에서의 리턴 매개변수를 승인하는 데 사용되는 경우 IndexedRecordImpl은 특정 매개변수 수를 승인하도록 사전 정의할 수 있고 개별 카피북 및 구조에 대해 어셈블리 도구에서 생성되는 클래스 이름이 제공 가능합니다. IndexedRecordImpl은 직렬화된 카피북과 구조를 확대하고 이를 IndexedRecordImpl에 설정하여 직렬화된 byte[] 표시 없이도 검색되고 사용 가능하도록 합니다.
이 API가 작동하는 방법에 대한 일반적인 아이디어를 제공하기 위해 선택된 메소드만 표시됩니다. 인터페이스에서 모든 메소드가 구현됩니다.