mqsichangebroker 명령

지원되는 운영 체제

  • Windows
  • LinuxUNIX 시스템
  • 변경 시작z/OS. 브로커 PDSE 컨텐츠 를 참조하여 BIPCHBK를 사용할 수도 있습니다.변경 끝

목적

mqsichangebroker 명령을 사용하여 브로커의 시동 매개변수 중 일부를 변경하십시오. 예를 들면, 암호를 변경하는 경우 이 명령을 실행해야 합니다. 이 명령을 사용하여 브로커의 UserExitPath 등록 정보를 설정할 수도 있습니다.

명령을 실행하기 전에 브로커를 중지하고 변경을 적용하려면 브로커를 다시 시작해야 합니다.

Windows, LinuxUNIX 시스템에서 mqsistopmqsistart 명령을 사용하십시오.

z/OS에서 /S 옵션을 사용하여 처음에 브로커 제어 프로세스를 시작했어야 합니다. /F broker, PC 옵션을 사용하여 브로커 구성요소를 정지하고 /S broker, SC 옵션을 사용하여 브로커 구성요소를 시작해야 합니다.

자세한 정보는 mqsistop 명령mqsistart 명령을 참조하십시오.

구문

Windows, LinuxUNIX 시스템

z/OS 콘솔 명령

동의어: cb

매개변수

brokername
(필수 - Windows, Linux, and UNIX 시스템) 이 매개변수는 첫 번째 매개변수여야 합니다. 수정하려는 브로커의 이름을 지정하십시오.
-a ServicePassword
(선택사항 - Windows, LinuxUNIX 시스템) ServiceUserID의 암호.

기존 시스템과의 호환성의 경우 password를 지정할 수 있습니다. 그러나 명령을 실행할 때 이 매개변수로 암호를 지정하지 않는 경우 호출 중 암호를 입력하고 올바르게 입력했는지 확인하기 위해 두 번째로 암호를 입력하도록 프롬프트가 표시됩니다.

LinuxUNIX 시스템에서, -aWindows 시스템의 호환성을 위해 필요하지만, ServiceUserID와 관련되어 사용되지는 않습니다. 이 옵션은 -p를 지정하지 않는 경우에만 디폴트 값으로 사용됩니다(자세한 내용은 -p 매개변수의 설명 참조).

데이터베이스 액세스용으로 이 사용자 ID와 암호도 사용하도록 브로커를 작성한 경우(즉, -u DataSourceUserID-p DataSourcePassword 매개변수를 생략했거나 또는 포함했지만 -a ServicePassword-i ServiceUserID를 사용하여 서비스 사용자 ID에 동일한 사용자 ID 및 암호를 입력한 경우) -p DataSourcePassword도 제공하여 해당 명령에서 암호 인스턴스 둘 다를 갱신해야 합니다.

암호를 변경하려면 다음을 수행해야 합니다.

  • 브로커를 정지하십시오.
  • 해당 운영 체제 기능을 사용하여 암호를 변경하십시오.
  • 이 명령을 사용하여 동일한 암호를 참조하는 모든 매개변수를 갱신하십시오.
  • 브로커를 재시작하십시오.
-i ServiceUserID
(선택사항 - Windows, LinuxUNIX 시스템) 브로커를 실행하는 사용자 ID. 이 값을 변경하면 암호(-a)도 변경해야 합니다.

사용자 ID는 올바른 username 구문으로 지정할 수 있습니다. Windows 시스템에서는 다음과 같습니다.

  • domain\username
  • \\server\username
  • .\username
  • username

LinuxUNIX 시스템에서는 최종 형식인 username만 유효합니다.

Windows 시스템에서 이 사용자 ID(username)에 대해 규정되지 않은 형식을 사용하면, 운영 체제는 로컬 시스템부터 시작하여 해당 도메인 전체에서 사용자 ID를 검색합니다. 검색을 완료하는 데 어느 정도의 시간이 걸릴 수 있습니다.

지정한 ServiceUserIDmqbrkrs 로컬 그룹의 구성원이어야 합니다. Windows 시스템에서는 그룹의 간접 또는 직접 구성원이 될 수 있습니다. ServiceUserID에는 홈 디렉토리(WebSphere Message Broker가 설치된 위치) 및 작업 디렉토리(mqsicreatebroker -w 매개변수로 지정한 경우)에 대한 액세스 권한도 부여되어야 합니다. 또한, 이 ID는 로컬 그룹 mqm의 구성원(직접 또는 간접)이어야 합니다.

ServiceUserID에 대한 보안 요구사항은 Windows 시스템의 경우 Windows 플랫폼의 보안 요구사항에서 자세히 설명되고, LinuxUNIX 시스템의 경우 Linux 및 UNIX 플랫폼의 보안 요구사항에서 설명됩니다.

-p DataSourcePassword
(선택사항 -Windows, LinuxUNIX 시스템) 브로커 테이블을 포함하는 데이터베이스 및 사용자 데이터에 액세스할 사용자 ID의 암호.

기존 시스템과의 호환성의 경우 password를 지정할 수 있습니다. 그러나 명령을 실행할 때 이 매개변수로 암호를 지정하지 않는 경우 호출 중 암호를 입력하고 올바르게 입력했는지 확인하기 위해 두 번째로 암호를 입력하도록 프롬프트가 표시됩니다.

LinuxUNIX 시스템의 DB2의 경우, -p는 빈 문자열(두 개의 큰따옴표, "")로 지정할 수 있습니다. 이 경우, DB2가 "이미 확인됨"으로 데이터베이스 연결을 작성하는 ServiceUserID의 권한을 WebSphere Message Broker에 부여합니다. -a-p에 대해 빈 문자열을 지정하면, WebSphere Message Broker에 의해 암호가 저장되지 않고 대부분의 보안 구성이 작성됩니다.

이 암호를 사용하는 모든 인스턴스를 변경해야 합니다. 서비스 사용자 ID 및 데이터베이스 액세스를 위해 같은 사용자 ID와 암호를 사용하는 브로커를 작성(또는, 변경)한 경우, 두 인스턴스를 동시에 갱신해야 합니다. 자세한 내용은 -a 매개변수의 설명을 참조하십시오.

-s UserNameServerQueueManagerName
(선택사항) 사용자 이름 서버와 연관된 WebSphere MQ 큐 관리자의 이름. 토픽 기반의 보안을 제거하려면 빈 문자열(두 개의 큰 따옴표, "")을 지정하십시오.

z/OS에서 이 이름은 대소문자가 구분되므로 이름에 대소문자가 혼합되어 있는 경우에는 이름을 작은따옴표로 묶어야 함에 유의하십시오.

-j
(선택사항) 브로커에서 Publish/subscribe 액세스를 사용할 수 없습니다.
-d
(선택사항) 브로커에서 Publish/subscribe 액세스를 사용할 수 없습니다.
-t
(선택사항 - Windows, LinuxUNIX 시스템) 브로커를 WebSphere MQ 트러스트 응용프로그램으로 실행하도록 요청합니다.

WebSphere MQ 트러스트 응용프로그램 사용에 대한 자세한 내용은 WebSphere MQ상호통신을 참조하십시오.

-n
(선택사항 - Windows, LinuxUNIX 시스템) 브로커를 WebSphere MQ 트러스트 응용프로그램으로 실행하지 않도록 요청합니다.
-l UserLilPath
(선택사항) 브로커가 사용자 정의 메시지 처리 노드에 대해 LIL(Loadable Implementation Library)를 로드하는 경로(디렉토리) 목록을 지정합니다.

.lil 또는 .jar 파일을 저장하기 위한 고유의 디렉토리를 작성해야 합니다. WebSphere Message Broker 설치 디렉토리에 저장하지 마십시오.

둘 이상의 추가 디렉토리를 지정하는 경우, 운영 체제 특정 디폴트 경로 분리 문자로 디렉토리를 분리해야 합니다(Windows 시스템의 경우 세미콜론(;), Linux, UNIX 시스템 및 z/OS의 경우 콜론(:)).

이 경로에 환경 변수를 포함시킬 수 없습니다. 포함시키면 무시됩니다.

LinuxUNIX 시스템 및 z/OS에서, 이 이름은 대소문자가 구분되므로 이름에 대소문자가 혼합되어 있는 경우에는 이름을 작은따옴표로 묶어야 합니다.

-g ConfigurationTimeout
(선택사항) 브로커의 실행 그룹이 구성 변경을 적용하도록 허용되는 시간의 길이(초)를 정의합니다(예: Workbench에서 전개한 갱신).

메시지 플로우가 응용프로그램 메시지를 처리 중일 때, 구성 변경에 응답할 수 없습니다. 실행 그룹에서 구성 변경의 요청을 받은 메시지 플로우 중 하나가 응용프로그램 메시지의 처리를 완료하지 못하여 이 시간 종료 내에 구성 변경을 적용하지 못하면, 실행 그룹이 전개된 구성 메시지에 부정적인 응답을 리턴합니다.

이 시간 종료에 설정하는 값은 시스템 로드(CPU 사용 포함) 및 각 실행 그룹의 로드에 따라 달라집니다. 브로커의 전체 구성을 전개하여 초기값을 예상할 수 있습니다. 이 작업을 완료하는 데 걸리는 시간으로 설정해야 하는 최소 값을 알 수 있습니다.

값은 초 단위로 지정되며 범위는 10 -3600입니다. 디폴트 값은 300입니다.

ConfigurationTimeoutConfigurationDelayTimeout(아래 설명됨)의 합계는 브로커가 부정적인 응답을 생성하기 전에 전개된 구성 메시지를 처리하도록 허용되는 최대 시간 길이를 나타냅니다.

-k ConfigurationDelayTimeout
(선택사항) 브로커가 구성의 최소 변경을 처리하도록 허용되는 시간의 길이(초)를 정의합니다(예를 들면, Workbench에서 전개한 갱신).

이 값은 브로커 및 실행 그룹이 전개된 최소 구성 메시지를 처리하는 데 걸리는 시간을 나타내며, 큐 관리자 네트워크 지연, 브로커의 큐 관리자 및 시스템 로드에 따라 다릅니다.

단순 구성 변경을 요청하는 명령을 발행하여 이 값을 예상할 수 있습니다. 예를 들면, 다음과 같습니다.
  • Windows, LinuxUNIX 시스템에서:
    mqsireporttrace brokerName -e "Execution Group Name" -u
  • z/OS에서:
    F MQP1BRK,reporttrace u=yes,e='exgrp1'

z/OS에서 이 이름은 대소문자가 구분되므로 이름에 대소문자가 혼합되어 있는 경우에는 이름을 작은따옴표로 묶어야 함에 유의하십시오.

각 실행 그룹의 응답 시간은 시스템 로드 및 해당 프로세스 로드에 따라 다릅니다. 설정하는 값은 실행 그룹이 응답하는 데 걸리는 가장 긴 응답 시간을 나타내야 합니다. 값을 너무 작게 설정하면, 브로커가 부정적인 응답을 리턴하여 로컬 오류 로그에 오류 메시지가 발행될 수 있습니다.

값은 초 단위로 지정되며 범위는 10 -3600입니다. 디폴트 값은 60입니다.

브로커가 프로덕션 시스템에 있는 경우, 구성 변경이 적용되기 전에 현재 메시지 플로우가 처리 중인 응용프로그램 메시지가 완료되도록 ConfigurationTimeoutConfigurationDelayTimeout의 값을 증가시키는 것이 바람직합니다.

브로커가 개발 또는 테스트 시스템에 있는 경우, 시간 종료 값을 줄여서(특히, ConfigurationTimeout) 인식되는 응답 시간을 줄이고 예상대로 작동하지 않는 브로커가 강제로 응답을 표시하도록 할 수 있습니다. 그러나, 시간 종료 값을 줄이면 구성 변경을 전개할 수 있는 가능성도 감소합니다.

-P HTTPListenerPort
(선택사항) 웹 서비스 지원이 대기 중인 포트 번호를 입력하십시오.

이 리스너는 웹 서비스 지원을 포함하는 메시지 플로우가 시작될 때 시작되며, 디폴트 값은 7080입니다.

지정하는 포트가 다른 목적으로 지정되지 않았는지 확인해야 합니다.

-v statisticsMajorInterval
(선택사항) WebSphere Message Broker 통계 및 계정에 아카이브 레코드가 출력되어야 함을 알리는 타이머 간격을 분 단위로 지정하십시오. 내부 계정인 경우, 올바른 범위는 10에서 14400분 사이입니다.

0분 간격은 운영 체제에 외부 알림 메소드가 있으므로 WebSphere Message Broker 내의 내부 타이머를 사용하지 않음을 나타냅니다.

-y LdapPrincipal
(선택사항 - 모든 운영 체제, LdapCredentials가 제공되는 경우 필수) JMS 제공자에 대한 JNDI 관리 초기 컨텍스트를 보유하는 선택적 LDAP 디렉토리에 대한 액세스용 사용자 프린시펄.
-z LdapCredentials
(선택사항 - 모든 운영 체제, LdapPrincipal가 제공되는 경우 필수) LDAP에 대한 액세스용 사용자 암호.
-c ICUConverterPath
(선택사항) 추가 코드 페이지 변환기를 검색하기 위한 구분된 디렉토리 세트. Windows 시스템에서 디리미터는 쉼표(,)입니다. UNIXLinux 시스템에서 디리미터는 콜론(:)입니다. 코드 페이지 변환기는 icudt32_codepagename.cnv 양식이거나 icudt32.dat라는 ICU 데이터 패키지에 있어야 합니다.
-x UserExitPath
(선택사항) 이 브로커의 32비트 실행 그룹에 대해 로드되는 모든 사용자 엑시트의 위치를 포함하는 경로입니다. 이 경로는 실행 그룹 프로세스의 시스템 라이브러리 검색 경로(PATH,LIBPATH,LD_LIBRARY_PATH,SHLIBPATH)에만 추가됩니다.
-e activeUserExits
(선택사항) 활성 사용자 엑시트. 디폴트로 사용자 엑시트는 비활성입니다. 이 콜론으로 분리된 목록에 userExit 이름을 추가하면 이 브로커의 디폴트 상태가 활성으로 변경됩니다. 디폴트 상태는 mqsichangeflowuserexits 명령을 사용하여 실행 그룹 또는 메시지 플로우 레벨에서 대체될 수 있습니다. 사용자 엑시트 이름이 지정되었지만 실행 그룹이 시작될 때 해당 사용자 엑시트를 제공하는 라이브러리가 없으면 시스템 로그에 BIP2314 메시지가 기록되고 실행 그룹이 시작되지 않습니다.

다른 브로커 등록 정보를 변경하려면, 브로커를 삭제하고 재작성한 후 Workbench를 사용하여 브로커의 구성을 재전개해야 합니다. 데이터베이스 액세스에 사용된 사용자 ID를 변경하려면 브로커 도메인 관리를 참조하십시오.

권한 부여

Windows 시스템에서 이 명령을 호출하는 데 사용되는 사용자 ID에는 로컬 시스템에서 Administrator 권한이 있어야 합니다.

LinuxUNIX 시스템에서 이 명령을 호출하는 데 사용되는 사용자 ID는 mqbrkrs 그룹의 구성원이어야 합니다.

z/OS 시스템에서 이 명령을 호출하는 데 사용되는 사용자 ID는 구성요소 디렉토리에 대한 READ 및 WRITE 액세스가 있는 그룹의 구성원이어야 합니다.

LDAP 사용: 레지스트리가 비인가 액세스를 방지하도록 적절히 보안 설정되어 있는지 확인하십시오. mqsichangebroker에서 LdapPrincipalLdapCredentials 옵션의 설정이 브로커의 올바른 조작에 필요하지 않습니다. 암호는 파일 시스템에서 지우기 텍스트로 저장되지 않습니다.

응답

이 명령은 다음 응답을 리턴합니다.
  • BIP2595 '...' 문자열을 정수로 캐스트하는 중에 오류가 발생했습니다(z/OS에만 해당).
  • BIP8003 중복 플래그가 발견되었습니다(z/OS에만 해당).
  • BIP8012 시스템 구성요소에 연결할 수 없습니다.
  • BIP8013 구성요소가 존재하지 않습니다.
  • BIP8018 구성요소가 실행 중입니다.
  • BIP8021 사용자 ID/암호가 올바르지 않습니다.
  • BIP8022 올바르지 않은 사용자 ID/암호가 제공되었습니다.
  • BIP8023 암호가 필수입니다.
  • BIP8030 사용자 ID 권한을 수정할 수 없습니다.
  • BIP8068 ... 인수가 이 플래그에 대해 올바른 정수가 아닙니다(z/OS에만 해당).
  • BIP8073 올바르지 않은 브로커 이름입니다(WindowsUNIX 시스템에만 해당).
  • BIP8101 사용 명령문에 대한 변경
  • BIP8158 명령에 대해 올바르지 않은 형식입니다(z/OS에만 해당).
  • BIP8159 "..." 매개변수를 알 수 없습니다(z/OS에만 해당).

Windows, LinuxUNIX 시스템:
mqsichangebroker WBRK_BROKER -s WBRK_UNS_QM
mqsichangebroker WBRK_BROKER -s ""
mqsichangebroker WBRK_BROKER -x /opt/3rdparty/wmbexit
z/OS:
F MQP1BRK,cb g=100,k=200
변경 시작z/OS에서는 각 명령 옵션 사이에 쉼표를 사용해야 합니다. 다음 명령은 이 요구사항을 나타내며 ue 옵션을 모두 사용합니다.
/f MA05BRK,cb x='/u/test/wbi/MsgFlowTrackingUserExit/zOS',e='MqsiStrUserExit02:MqsiStrUserExit03'
변경 끝
주의사항 | 등록상표 | 다운로드 | 라이브러리 | 지원 | 피드백
Copyright IBM Corporation 1999, 2006 마지막 갱신 날짜: 2006/08/21
an07090_