createSIBWMQServer 명령
createSIBWMQServer 명령을 사용하여 셀 범위에서 새 IBM MQ 서버를 작성합니다.
이 주제에서 설명된 대로 wsadmin 도구를 사용하거나 IBM MQ 서버 정의 작성에서 설명된 대로 관리 콘솔을 사용하여 새 IBM MQ 서버를 작성할 수 있습니다.
명령을 실행하려면 wsadmin 스크립트 클라이언트의 AdminTask 오브젝트를 사용하십시오.
wsadmin 스크립트 클라이언트는 Qshell에서
실행됩니다. .
자세한 정보는 wsadmin 스크립트를 사용하여 WebSphere 스크립트를 실행하도록 Qshell 구성의 내용을 참조하십시오..
서비스 통합 버스에 대해 명령행 도움말이 제공됩니다.
- Jython의 사용 가능한 서비스 통합 버스 명령 목록과 각 명령의 간단한 설명에 대해서는
wsadmin 프롬프트에 다음 명령을 입력하십시오.
print AdminTask.help('SIBAdminCommands')
- 제공된 명령에 대한 개요 도움말을 보려면 다음 명령을 wsadmin 프롬프트에 입력하십시오.
print AdminTask.help('command_name')
명령을 사용한 후에는 다음 명령을 사용하여 변경사항을
마스터 구성에 저장하십시오.
AdminConfig.save()
목적
IBM MQ 서버는 IBM MQ 큐 관리자 또는(z/OS용 IBM MQ의 경우) 큐 공유 그룹을 나타냅니다. 이 명령은
셀 범위에서 새 IBM MQ 서버를 작성하고 제공된 값을 사용하여 해당 매개변수를 채웁니다.
참고: IBM MQ 서버를 작성할 때 -name 및 -serverName 매개변수의 중요성을 이해하는 것이 중요합니다.
예를 들면, WebSphere Application Server 관리에서 이름이 "My
European area server"인 IBM MQ 서버 오브젝트를 작성한 경우 이는 serverName QM1인 IBM MQ 큐 관리자를 나타냅니다. 그러면 WebSphere Application Server 관리는
이름이 "My UK country server"인 두 번째 IBM MQ 서버 오브젝트를 작성할 수 있으며 이는 또한 serverName QM1인 같은 IBM MQ 큐 관리자를 나타냅니다.
대상 오브젝트
WebSphere Application Server 셀.
필수 매개변수
- -name
- IBM MQ 서버의 이름입니다. 이 값은 관리 전용이며 관리자가 결정할 수 있습니다. 이름은 WebSphere Application Server 관리 내에서만 의미가 있으며 셀 레벨에서 고유해야 합니다. 기본값이 없습니다. 이 매개변수는 수정할 수 없습니다.
- -serverName
- 큐 관리자 또는 큐 공유 그룹의 이름. 이 값은 큐 관리자 또는 큐 공유 그룹이 식별되는 이름이며, IBM MQ 관리에서 해당 IBM MQ 오브젝트에 할당됩니다. WebSphere Application Server 관리자는 항상 IBM MQ 관리에서 할당된 이름을 사용해야 합니다.
- -host
- 큐 관리자 또는 큐 공유 그룹과 통신하도록 연결이 설정된 호스트. 이 값은 이 IBM MQ 서버가 나타내는 큐 관리자 또는 큐 공유 그룹의 호스트 이름 또는 IP 주소입니다. 값은 문자열이며 다음 중 하나여야 합니다.
- 기호 호스트 이름
- IPv4 주소
- IPv6 주소
- -transportChain
- IBM MQ와 연결을 설정하는 데 사용할 채널 프레임워크 아웃바운드 전송 체인. 이 옵션을 지정하지 않은 경우 OutboundBasicWMQClient가 기본값으로 가정됩니다.
조건부 매개변수
없음
선택적 매개변수
선택적 호스트, 포트, 채널 및 인증 별명 속성은 함께 서비스 통합에서 실행 중인 메시징 애플리케이션에 대해 이 IBM MQ 서버에 대한 연결 액세스 경로를 지정합니다. 자세한 정보는 IBM MQ 서버: 연결 및 인증의 내용을 참조하십시오.
- -port
- 이 IBM MQ 서버가 나타내는 큐 관리자 또는 큐 공유 그룹이 청취하는 TCP/IP 포트 번호입니다. 기본값은 1414입니다.
- -channel
- 이 IBM MQ 서버가 나타내는 큐 관리자 또는 큐 공유 그룹에 연결할 때 사용할 IBM MQ 클라이언트 채널 이름입니다. 이 값은 IBM MQ 관리가 IBM MQ 오브젝트에 할당한 이름이며, 항상 WebSphere Application Server 관리에서 사용되어야 합니다. 기본값은 SYSTEM.DEF.SVRCONN입니다.
- -description
- IBM MQ 서버에 대한 간략한 설명입니다. 이 값은 관리 목적으로만 제공됩니다.
- -securityAuthAlias
- 큐 관리자 또는 큐 공유 그룹에 연결할 때 사용할 인증 별명. 이 매개변수는 발견 인증 별명과 혼동해서는 안 됩니다.
- -trustUserIds
- IBM MQ에서
메시지에 수신된 사용자 ID가 서비스 통합 버스에 의해 메시지와 함께
전달되었는지 여부를 판별합니다. 애플리케이션 사용자 ID는
항상 jsAppUserId RFH2
값에서 설정됩니다. 존재하지 않는 경우(키/값 쌍이 RFH2 헤더에 없거나
메시지에 RFH2 헤더가 없는 경우) 이 필드는 설정되지 않습니다.
이 값을 FALSE로 설정하면 사용자 ID를 IBM MQ 서버 이름이 겹쳐씁니다. 이 매개변수에서는
두 개의 값이 가능합니다.
- TRUE
- 사용자 ID는 메시지로 전파됩니다.
- FALSE
- 사용자 ID는 메시지로 전파되지 않습니다.
- -allowDiscovery
- IBM MQ
자원의 자동화된 발견 수행 여부를 판별합니다.
이 매개변수에서는
두 개의 값이 가능합니다.
- TRUE
- 자동 발견이 사용됩니다.
- FALSE
- 자동 발견이 사용되지 않습니다.
- -discoveryAuthAlias
- 큐 관리자 또는 큐 공유 그룹에 대한 자원 발견 연결을 설정할 때 사용할 인증 별명. 이 값을 보안 인증 별명과 혼동해서는 안 됩니다.
- -replyToQueue
- 자원 발견에 사용할 회신 큐. 이 값은 IBM MQ 관리가 IBM MQ 오브젝트에 할당한 이름이며, 임시 동적 큐에 대한 모델 큐 이름이어야 합니다. WebSphere Application Server 관리자는 항상 IBM MQ 관리에서 할당된 이름을 사용해야 합니다. 기본값은 SYSTEM.DEFAULT.MODEL.QUEUE입니다.
- -type
- WebSphere Application Server 관리에서 판별한 대로 IBM MQ 서버 오브젝트가 큐 관리자인지 또는 큐 공유 그룹인지를 판별합니다.
이 매개변수에서는
두 개의 값이 가능합니다.
- MQ_QUEUE_MANAGER
- IBM MQ 서버는 큐 관리자를 나타냅니다. 이 값을 선택하면 자원 발견 프로세스에서 큐 관리자에 속하는 큐 이름을 검색합니다.
- MQ_QUEUE_SHARING_GROUP
- IBM MQ 서버는 큐 공유 그룹을 나타냅니다. 이 값을 선택하면 자원 발견 프로세스에서 큐 공유 그룹에 속하는 큐 이름을 검색합니다.
- -bindingsMode
- 큐 관리자 또는 큐 공유 그룹에 연결할 때 사용되는 바인딩 전송 모드 연결의 사용
여부를 판별합니다.
애플리케이션 서버 및 큐 관리자가 동일한 노드에 있는 경우
바인딩 모드 연결이 사용 가능합니다. 여러 큐 관리자가 동일한 노드에
있어도 바인딩 모드로 단일 큐 관리자에만 연결할 수 있습니다. 이 매개변수에서는
두 개의 값이 가능합니다.
- TRUE
- 사용 가능한 경우 바인딩 모드가 사용됩니다. 이 옵션을 선택하고 바인딩 모드가 사용 불가능한 경우 연결 메커니즘의 기본값은 클라이언트 전송 모드입니다.
- FALSE
- 항상 클라이언트 모드가 사용됩니다.
예제
- Jython 사용:
wsadmin>AdminTask.createSIBWMQServer(["-name", "Finance dept QM", "-serverName", "FDQM", "-type", "MQ_QUEUE_MANAGER", "-bindingsMode", "true", "-host", "findep01.ibm.com", "-port", 1414, "-transportChain", "OutboundSecureWMQClient"])
- Jacl 사용:
wsadmin>$AdminTask createSIBWMQServer {-name "Finance dept QM" -serverName FDQM -type MQ_QUEUE_MANAGER -bindingsMode true -host findep01.ibm.com -port 1414 -transportChain OutboundSecureWMQClient}