modifySIBWMQServer 명령
modifySIBWMQServer 명령을 사용하여 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 관리자는
serverName QM1의 IBM MQ 큐 관리자를
나타내는 "My European Area Server"라는
IBM MQ 서버를 작성하는 경우, 역시 동일한 큐 관리자를
나타내는 "My UK Country Server"라는 두 번째 IBM MQ 서버를 작성할 수 있습니다.
대상 오브젝트
선택된 IBM MQ 서버.
필수 매개변수
- -name
- IBM MQ 서버의 이름입니다. IBM MQ 서버 정의를 작성할 때 이름이 지정됩니다.
조건부 매개변수
없음
선택적 매개변수
- -serverName
- 큐 관리자 또는 큐 공유 그룹의 이름입니다. 이것은 큐 관리자 또는 큐 공유 그룹이 식별되는 이름입니다. 값은 IBM MQ 관리에 의해 해당 IBM MQ 자원에 할당됩니다. 관리자는 항상 IBM MQ 관리에 의해 할당되는 이름을 사용합니다.
- -host
- host 속성의 새 값입니다. 이 값은 이 IBM MQ
서버가 나타내는 큐 공유 그룹 또는 큐 관리자와 통신할 때
연결이 설정되는 호스트의 IP 주소 또는 이름입니다. 값은
문자열이며 다음 중 하나여야 합니다.
- 기호 호스트 이름
- IPv4 주소
- IPv6 주소
- -bindingsMode
- bindingsMode 속성의 새 값입니다.
이 값은 큐 관리자 또는 큐 공유 그룹에 연결할 때 바인딩
전송 모드 연결이 사용되는지 여부를 판별합니다.
애플리케이션 서버와 큐 관리자가 동일한 노드에 있을
경우 바인딩 모드 연결을 사용할 수 있지만 동일한 노드에
여러 큐 관리자가 있더라도 연결은 단일 큐 관리자에 대해서만
허용됩니다. 이 매개변수는 다음 두 가지 값을 가집니다.
- TRUE
- 사용 가능할 경우 바인딩 모드가 사용됩니다. 이 옵션을 선택하고 바인딩 모드를 사용할 수 없을 경우 연결 메커니즘은 클라이언트 전송 모드를 기본값으로 합니다.
- FALSE
- 클라이언트 모드가 항상 사용됩니다.
- -port
- IBM MQ port 속성의 새 값입니다. 이 값은 이 IBM MQ 서버가 나타내는 큐 관리자 또는 큐 공유 그룹이 청취하는 TCP/IP 포트 번호입니다. 기본값은 1414입니다.
- -channel
- IBM MQ channel 속성의 새 값입니다. 이 값은 이 IBM MQ 서버가 나타내는 큐 관리자 또는 큐 공유 그룹에 연결할 때 사용할 IBM MQ 클라이언트 채널 이름입니다. 이 이름은 IBM MQ 관리에 의해 IBM MQ 오브젝트에 할당되며, 항상 WebSphere Application Server 관리자에 의해 사용되어야 합니다. 기본값은 SYSTEM.DEF.SVRCONN입니다.
- -description
- description 속성의 새 값입니다. 이 값은 IBM MQ 서버에 대한 간략한 설명이며 관리 용도로만 사용됩니다.
- -securityAuthAlias
- securityAuthorizationAlias 속성의 새 값입니다. 이 값은 큐 관리자 또는 큐 공유 그룹에 연결할 때 사용할 인증 별명입니다. 이 매개변수는 발견 인증 별명과는 다릅니다.
- -transportChain
- transportChain 속성의 새 값입니다. 이 값은 IBM MQ와의 연결을 설정할 때 사용할 아웃바운드 전송 체인입니다. 기본값은 OutboundBasicWMQClient입니다.
- -trustUserIds
- trustUserIds 속성의 새 값입니다.
IBM MQ의 메시지에서 수신된 사용자 ID가 메시지로
전달되는지 여부(메시지 데이터의 일부로 수신된
사용자 ID가 서비스 통합 버스에서 사용되는지 여부)를
판별합니다. 애플리케이션 사용자 ID는 항상 jsAppUserId RFH2 값으로부터
설정됩니다. 이 ID가 없을 경우(키/값 쌍이 RFH2 헤더에
없거나 메시지에 RFH2 헤더가 없기 때문에) 이 필드는
설정되지 않습니다. 이 값을 FALSE로 설정하는 경우
사용자 ID를 IBM MQ 서버 이름으로
겹쳐씁니다. 이 매개변수는 다음 두 가지 값을 가집니다.
- TRUE
- 사용자 ID가 메시지에 전파됩니다.
- FALSE
- 사용자 ID가 메시지에 전파되지 않습니다.
- -allowDiscovery
- allowDiscovery 속성의 새 값입니다.
이 값은 IBM MQ 자원의 자동화된 발견이 수행되는지 여부를 판별합니다.
이 매개변수는 다음 두 가지 값을 가집니다.
- TRUE
- 자동 자원 발견이 사용 가능합니다.
- FALSE
- 자동 자원 발견이 사용 불가능합니다.
- -discoveryAuthAlias
- discoveryAuthAlias 속성의 새 값입니다. 이 값은 큐 관리자 또는 큐 공유 그룹에 대한 자원 발견 연결을 설정할 때 사용할 인증 별명이며 보안 인증 별명 매개변수와는 다릅니다.
- -replyToQueue
- replyToQueue 속성의 새 값입니다. 이 값은 자원 복구에 사용할 응답처 큐이며, IBM MQ 관리에 의해 IBM MQ 오브젝트에 할당되는 이름이며, 임시 동적 큐에 대한 모델 큐의 이름이어야 합니다. WebSphere Application Server 관리는 항상 IBM MQ 관리가 동의하는 이름을 사용해야 합니다. 기본값은 SYSTEM.DEFAULT.MODEL.QUEUE입니다.
예제
- Jython 사용:
wsadmin>AdminTask.modifySIBWMQServer(["-name", "Finance dept QM", "-allowDiscovery", "false"] )
- Jacl 사용:
wsadmin>$AdminTask modifySIBWMQServer {-name "Finance dept QM" -allowDiscovery false}