MQ Explorer 및 runmqsc 명령행을 사용하여 큐 관리자 관리

이 안내서에서는 MQ Explorer 애플리케이션 및 runmqsc 명령행 인터페이스를 사용하여 IBM MQ on Cloud 큐 관리자를 관리하는 방법을 설명합니다.

MQ 탐색기:

MQ 탐색기는 사용자가 선택한 시스템에 설치하고 클라이언트 연결을 사용하여 하나 이상의 큐 관리자에 원격으로 연결되는 IBM MQ를 관리하는 데 필요한 Eclipse 기반 도구입니다. Windows 및 Linux 64비트 환경을 위한 기본 설치 프로그램이 있으며 아래의 전제조건에 설명된 대로 Docker 컨테이너를 통해 Mac OS에서 실행될 수 있습니다.

Mac OS에서 MQ 탐색기의 Eclipse 플러그인은 쓰기 시 TLS 연결을 지원하지 않습니다. 버전 9.2.1 개정 1 이상의 MQ on Cloud 큐 관리자에 대한 관리 채널에서 TLS를 사용할 수 있습니다. Linux 또는 Windows에서 관리해야 합니다.

runmqsc

"MQ 클라이언트" 번들의 일부인 runqmsc는 명령행 또는 스크립트 파일에서 일련의 사전 정의된 단계를 실행하여 MQ 큐 관리자의 구성을 자동화할 수 있는 명령행 인터페이스(CLI) 도구입니다. 이는 Windows 및 Linux를 포함한 다양한 운영 체제에서 지원됩니다(Mac OS에서는 현재 지원되지 않음).

MQ 클라이언트에서 MQ 탐색기 또는 runmqsc를 사용하여 수행할 수 있는 여러 조치가 있습니다. 다음을 수행할 수 있습니다.

큐 관리자에 연결
새 큐 작성
큐에 메시지 넣기
큐 삭제

이 외에도 MQ 탐색기에서 다음을 수행할 수 있습니다. browse a queue to view messages runmqsc 명령행에서 get messages from a queue 도 실행할 수 있습니다.

시작하기 전에

기존 큐 관리자(지시사항은 큐 관리자 작성 안내서를 따르십시오).
IBM MQ 서비스 인스턴스 내의 큐 관리자에 액세스할 수 있는 권한이 있습니다(지시사항은 큐 관리자를 위해 관리자 액세스 구성 안내서를 따르십시오).
관리 방법에 따라 다음 중 하나를 수행하십시오.

IBM MQ Explorer의 기존 설치. Windows 및 Linux용 다운로드 및 설치 지시사항은 여기에서 볼 수 있으며 Mac OS용은 여기에서 볼 수 있습니다. or
자체 시스템에 IBM MQ 클라이언트의 기존 설치가 있습니다.

여기서 클라이언트를 다운로드하십시오.
- CD 클라이언트의 사용 가능한 최신 버전 옆에 있는 HTTP 링크를 클릭하면 Fix Central로 이동합니다. 여기서 운영 체제 플랫폼에 적합한 Redist(재배포 가능) 클라이언트 번들을 검색하여 선택할 수 있습니다. 여기에는 샘플 애플리케이션 및 runmqsc가 포함됩니다.
- 번들을 다운로드한 후 선택한 위치에 압축을 해제하십시오.
- bin 디렉토리의 전체 경로를 기록해 두십시오. 이 디렉토리의 위치는 번들을 압축 해제하기 위해 선택한 위치에 따라 다릅니다. 이 경로는 이 태스크의 나머지에 대해 <PATH_TO_BIN_DIR>(으)로 참조됩니다.
- 샘플 애플리케이션이 포함된 디렉토리의 전체 경로를 기록해 두십시오. 이 경로는 이 태스크의 나머지에 대해 <PATH_TO_SAMPLE_BIN_DIR>(으)로 참조됩니다.
  - Windows의 경우 이는 이전 단계에서 압축 해제된 bin 디렉토리이며 이 디렉토리의 위치는 번들을 압축 해제하기 위해 선택한 위치에 따라 다릅니다.
  - Linux의 경우 이는 이전 단계에서 압축 해제된 samp/bin 디렉토리이며 이 디렉토리의 위치는 번들을 압축 해제하기 위해 선택한 위치에 따라 다릅니다.

필수 연결 세부사항 수집

IBM Cloud 콘솔에 로그인하십시오.
'햄버거 메뉴'를 클릭하십시오.
대시보드를 클릭하십시오.
- 리소스 그룹이 모든 리소스로 설정되어 있는지 확인하십시오.
'서비스' 표제 아래에 있는 IBM MQ 서비스 인스턴스를 찾아서 클릭하십시오.
큐 관리자 목록에서 관리할 큐 관리자를 클릭하십시오.
다음 단계에서 사용할 수 있도록 큐 관리자 이름, 호스트 이름 및 포트 값을 기록해 두십시오.
MQ 사용자 이름 및 IBM Cloud API 키를 이미 알고 있는 경우에는 이 태스크의 다음 절로 건너뛸 수 있습니다. 그렇지 않으면 관리 탭을 클릭하십시오.
나중에 사용할 수 있도록 MQ 사용자 이름을 기록해 두십시오.
- 기존 사용자 또는 애플리케이션의 MQ 사용자 이름 편집 또는 제거 안내서를 따라 언제든지 MQ 사용자 이름을 편집할 수 있습니다.
기존 IBM Cloud API 키가 아직 없는 경우:
- IBM Cloud API 키 작성을 클릭하십시오.
- 표시를 클릭하여 API 키를 표시하여 나중에 사용할 수 있도록 API 키를 복사하여 저장하거나 다운로드를 클릭하여 API 키를 파일에 저장하십시오.
  - 이 단계에서 생성된 API 키는 이 API 키를 작성한 사용자로서 IBM Cloud에 대해 인증하는 데 사용됩니다. 따라서 이 API 키는 다른 사용자와 공유해서는 안 되며 안전하게 저장해야 합니다.
  - IBM MQ 서비스를 통해 작성된 API 키는 큐 관리자 관리 탭에서 재설정할 수 있습니다.
- 닫기를 클릭하십시오.

큐 관리자에 연결

MQ 탐색기 사용:

IBM MQ 탐색기를 시작하십시오.
'MQ 탐색기 - 네비게이터' 패널에서 IBM MQ를 펼치십시오.
큐 관리자를 마우스 오른쪽 단추로 클릭하십시오.
**원격 큐 관리자 추가...**를 클릭하십시오.
관리할 큐 관리자 이름을 입력하십시오.
다음을 클릭하십시오.
2단계에서 기록해 둔 호스트 이름을 입력하십시오.
포트 번호를 2단계에서 기록해 둔 포트 번호로 겹쳐쓰십시오.
서버 연결 채널 이름을 CLOUD.ADMIN.SVRCONN으로 겹쳐쓰십시오.
다음을 클릭하십시오.
다음을 클릭하십시오.
'사용자 ID 사용'의 선택란을 선택하십시오.
'사용자 ID 호환 모드'의 선택란을 선택 취소하십시오.
MQ 사용자 이름을 사용자 ID로 입력하십시오.

전체 사용자 이름 필드를 표시하는 이미지

** 완료**를 누르십시오.
플랫폼 API 키를 '비밀번호' 텍스트 상자에 붙여넣으십시오.
확인을 클릭하십시오.

이제 큐 관리자 연결이 'MQ 탐색기 - 네비게이터' 패널의 큐 관리자 폴더 아래에 표시됩니다.

runmqsc 사용

다음 단계에서 사용할 명령 쉘을 여십시오.
'MQSERVER' 변수를 내보내십시오.
- Linux: export MQSERVER="CLOUD.ADMIN.SVRCONN/TCP/<Hostname>(<Port>)"
- Windows(명령 프롬프트): set MQSERVER=CLOUD.ADMIN.SVRCONN/TCP/<Hostname>(<Port>)
- Windows (PowerShell): $env:MQSERVER="CLOUD.ADMIN.SVRCONN/TCP/<Hostname>(<Port>)"
<PATH_TO_BIN_DIR>/runmqsc -c -u <your MQ username> -w60 <QUEUE_MANAGER_NAME> 실행
비밀번호 입력 프롬프트가 표시되면 플랫폼 API 키를 입력하십시오.

'DEV.TEST.1'이라는 새 테스트 큐 작성

MQ 탐색기 사용:

'MQ 탐색기 - 네비게이터 > IBM MQ > 큐 관리자' 보기에서 다음을 수행하십시오.

큐 관리자에 대한 항목을 펼치십시오.
큐를 마우스 오른쪽 단추로 클릭하십시오.
'새로 작성' > '로컬 큐...'를 선택하십시오.
'이름' 텍스트 상자에 'DEV.TEST.1'을 입력하십시오.
** 완료**를 누르십시오.
확인을 클릭하십시오.

새 큐가 큐 목록에 표시됩니다.

runmqsc 사용

큐 이름은 애플리케이션 사용자가 이 접두부에만 액세스하도록 구성되어 있으므로 DEV*(예: DEV.myQueue)로 시작해야 합니다.

이전 단계에서 사용된 동일한 쉘에서 다음을 수행하십시오.

DEFINE QLOCAL(DEV.TEST.1) 실행
DISPLAY QLOCAL(DEV.TEST.1) 실행
- 큐 'DEV.TEST.1'의 세부사항이 표시됩니다.
end 실행
- runmqsc 세션이 닫힙니다.
- 다음 단계에서 사용하기 위해 프롬프트를 유지하십시오.

테스트 큐에 메시지 넣기

MQ 탐색기 사용:

큐 'DEV.TEST.1'을 마우스 오른쪽 단추로 클릭하십시오.
'테스트 메시지 넣기...'를 클릭하십시오.
'메시지 데이터' 텍스트 상자에 테스트 메시지를 입력하십시오.
메시지 넣기를 클릭하십시오.
닫기를 클릭하십시오.
'큐' 패널에서 새로 고치기를 클릭하십시오.

'DEV.TEST.1'의 '현재 큐 깊이'가 이제 1임을 알 수 있습니다.

runmqsc 사용:

샘플 프로그램 amqsputc을(를) 사용하여 테스트 큐에 메시지를 넣을 수 있습니다. 이전 단계에서 사용된 동일한 쉘에서 다음을 수행하십시오.

'MQSAMP_USER_ID' 변수를 내보내십시오.
- Linux: export MQSAMP_USER_ID="<your MQ username>"
- Windows(명령 프롬프트): set MQSAMP_USER_ID=<your MQ username>
- Windows (PowerShell): $env:MQSAMP_USER_ID="<your MQ username>"
<PATH_TO_SAMPLE_BIN_DIR>/amqsputc DEV.TEST.1 <your QMGR name> 실행
비밀번호 입력 프롬프트가 표시되면 플랫폼 API 키를 입력하십시오.
테스트 메시지를 입력하십시오.
Enter를 두 번 눌러 amqsputc 샘플을 종료하십시오.

테스트 큐에서 메시지 찾아보기

이 단계는 MQ Explorer에서 고유하며 명령행을 사용하여 달성할 수 없습니다.

큐 'DEV.TEST.1'을 마우스 오른쪽 단추로 클릭하십시오.
'메시지 찾아보기...'를 클릭하십시오.
테스트 메시지가 표시되는지 확인한 후 닫기를 클릭하십시오.

amqsgetc 샘플 프로그램을 사용하여 메시지 가져오기

이 단계는 runmqsc에 고유하며 MQ Explorer에서는 수행할 수 없습니다.

이전 단계에서 사용된 동일한 쉘에서 다음을 수행하십시오.

<PATH_TO_SAMPLE_BIN_DIR>/amqsgetc DEV.TEST.1 <your QMGR name> 실행
비밀번호 입력 프롬프트가 표시되면 플랫폼 API 키를 입력하십시오.

테스트 메시지가 표시됩니다.

잠시 후 추가 메시지가 발견되지 않으면 amqsputc 샘플 프로그램이 종료됩니다.

테스트 큐 삭제

MQ 탐색기 사용

큐 'DEV.TEST.1'을 마우스 오른쪽 단추로 클릭하십시오.
'삭제'를 클릭하십시오.
'삭제'를 클릭하십시오.
'큐에서 모든 메시지 지우기' 상자를 선택하십시오.
삭제를 클릭하십시오.
확인을 클릭하십시오.

큐 'DEV.TEST.1'이 큐 목록에서 제거되었음을 알 수 있습니다.

runmqsc 사용

이전 단계에서 사용된 동일한 쉘에서 다음을 수행하십시오.

<PATH_TO_BIN_DIR>/runmqsc -c -u <your MQ username> -w60 <QUEUE_MANAGER_NAME> 실행
비밀번호 입력 프롬프트가 표시되면 플랫폼 API 키를 입력하십시오.
DELETE QLOCAL(DEV.TEST.1) 실행
- 큐가 삭제되었다는 메시지가 수신됩니다.
DISPLAY QLOCAL(DEV.TEST.1)을 실행하여 큐가 삭제되었음을 증명하십시오.
- 큐를 찾을 수 없다는 메시지가 수신됩니다.
end 실행
- runmqsc 세션이 닫힙니다.

결론

정상적으로 다음을 수행했습니다.

MQ Explorer 또는 runmqsc을(를) 사용하여 큐 관리자에 연결하고 새 테스트 큐를 작성했습니다.
테스트 큐에 테스트 메시지 넣기
테스트 큐를 탐색하여 테스트 메시지를 보거나 amqsgetc을(를) 사용하여 테스트 메시지를 보십시오.
테스트 큐를 지우고 삭제하여 정리

다음 단계

MQ 탐색기 및 runmqsc를 사용하여 큐 관리자를 관리하는 방법을 학습했으므로 다음을 시도하십시오.