SAP 인터페이스 오류 해결: 완료 코드 2, 이유 2161, MQJMS2002 발생 시 IBM MQ jar 파일 설치 방법

SAP 인터페이스 오류(MQJMS2002)와 IBM MQ jar 파일 설치 안내

SAP 인터페이스에서 "완료 코드 2, 이유 2161, MQJMS2002" 오류 메시지가 표시되는 경우, 대부분 시스템에 IBM MQ 관련 jar 파일 또는 라이브러리가 올바르게 설치되어 있지 않은 것이 원인입니다.

MQ jar 파일이나 MQ C/C++ 라이브러리 파일을 시스템에 확보하는 방법은 아래 두 가지 중 하나를 설치하는 것뿐입니다.

jar 파일은 WebSphere MQ V7.0 클라이언트 SupportPacks에서 찾을 수 있으며, 설치 파일은 일반적으로 java/lib 디렉터리에 위치합니다.

또한 IBM Fix Central에서도 jar 파일을 내려받을 수 있습니다. Fix Central에 접속한 뒤 텍스트 검색창에 "Java"를 입력하면 관련 파일을 찾을 수 있습니다.

다운로드할 파일명은 다음 형식을 따릅니다.

<V.R.M.F>-[IBM|WS]-MQ-Install-Java-All.jar

예를 들어 MQ V9.0의 경우 다음과 같습니다.

9.0.0.0-IBM-MQ-Install-Java-All.jar

Java 애플리케이션용 IBM MQ 클래스를 실행해야 하는 시스템으로 복사해야 할 파일은 다음과 같습니다.

jar 파일을 실행하려면 먼저 시스템에 JRE(Java Runtime Environment)가 설치되어 있고, 시스템 경로(PATH)에 등록되어 있어야 합니다. jar 파일은 실행 가능한 파일이므로 별도의 변환 없이 직접 실행할 수 있습니다.

설치를 시작하려면 다운로드한 파일이 있는 디렉터리에서 다음 명령어를 실행합니다.

java -jar 9.0.0.0-IBM-MQ-Install-Java-All.jar

그다음 IBM 국제 라이선스 계약에 동의해야 합니다.

"IBM MQ V9.0을 사용, 추출 또는 설치하기 전에 ① 프로그램 평가용 IBM 국제 라이선스 계약, ② IBM 국제 프로그램 라이선스 계약 및 추가 라이선스 정보의 조건에 동의해야 합니다. 아래 라이선스 계약서를 주의 깊게 읽어 주십시오."

라이선스에 동의한 후에는 제품 파일이 설치될 대상 디렉터리를 지정합니다. 설치 경로를 직접 입력하거나, 값을 입력하지 않고 Enter 키를 눌러 화면에 표시된 기본 위치에 설치할 수도 있습니다. 설치가 완료되면 확인 메시지가 표시됩니다.

정상 설치 시 출력 예시는 다음과 같습니다.

H:\WMQ\wmq 에 파일 추출 중...
모든 제품 파일이 성공적으로 추출되었습니다.
파일 설치 완료.

설치가 정상적으로 완료되면 "wmq"라는 새 디렉터리가 생성됩니다. 해당 디렉터리로 이동하면 다음 세 개의 하위 디렉터리를 확인할 수 있습니다.

각 디렉터리의 구성 내용은 다음과 같습니다.

.\JavaEE

.\JavaSE

.\OSGi

Java용 IBM MQ 클래스 설치에 대한 더 자세한 내용은 아래 링크를 참고하시기 바랍니다.