mqsideploy 명령

지원되는 플랫폼

  • Windows
  • Linux 및 UNIX 시스템
  • z/OS

목적

mqsideploy 명령을 사용하여 구성 관리자에 전개 요청을 발행합니다. 그러면, 수동으로 개입하지 않고도 배치 명령 스크립트로 여러 형태의 전개 요청을 발행할 수 있습니다.

디폴트 상태는 델타 또는 증가 전개입니다. -m을 선택하여 디폴트 조작을 대체하십시오.

-n, -q, -i-p 매개변수에서 모든 필수 연결 세부사항을 확보할 수 있기 때문에 mqsideploy에는 구성 관리자 이름 매개변수가 필요하지 않습니다.

구문

Windows 플랫폼, Linux 및 UNIX 시스템

z/OS 콘솔 명령

동의어: dp

매개변수

-n cfgParameterFileName
(선택사항) 구성 관리자에 연결 매개변수를 설명하는 .configmgr 파일의 이름.
이 파일은 Eclipse GUI에 의해 저장된 .configmgr 형식을 사용하는 XML 파일입니다. 예를 들면, 다음과 같습니다.
<?xml version="1.0" encoding="UTF-8"?>
<configmgr host="localhost" listenerPort="1414" queueManager="QNAME"
           securityExit="test.myExit"/>
z/OS에서 이 파일을 사용 중인 경우, 첫 줄에서 encoding="UTF-8" 명령문을 제거하여 다음 명령문이 남도록 하고
<?xml version="1.0"?>
호스트 속성 값을 제거하여 다음 명령문이 남도록 해야 합니다.
<configmgr host="" listenerPort="1414" queueManager="QNAME"
           securityExit="test.myExit"/>
주: 이 매개변수를 제공하지 않는 경우, -i, -p-q 매개변수를 제공해야 합니다.
-i ipAddress
(선택사항) 구성 관리자의 호스트 이름 또는 IP 주소.

z/OS에서 이 파일을 사용 중이고 로컬 호스트에 연결하려는 경우, 값을 \"\"로 설정해야 합니다.

-p Port
(선택사항) 구성 관리자의 포트 번호.
-q qMgr
(선택사항) 구성 관리자가 사용 중인 WebSphere MQ 큐 관리자의 이름.

-i, -p-q 매개변수를 제공하지 않는 경우, -n 매개변수를 지정해야 합니다.

-b Brokername
(필수) 전개할 브로커의 이름. -t 또는 -l 플래그가 지정된 경우 -b 옵션이 무시됩니다. 이는 토픽 또는 토폴로지를 전개할 때 도메인의 모든 브로커가 영향을 받기 때문입니다. -e-a 플래그 없이 브로커 구성 전개가 시작됩니다.

-c 옵션으로 특정 브로커에 대한 전개가 취소됩니다.

-e EGName
(선택사항) 전개할 실행 그룹의 이름. 이 옵션과 함께 -b-a 옵션도 지정해야 합니다.
-aBARFileName
(선택사항) 메시지 플로우 또는 메시지 세트 전개에 사용할 BAR(브로커 아카이브) 파일의 이름. 이 옵션과 함께 -b-e 옵션도 지정해야 합니다.

z/OS에서 BAR 파일은 파일 시스템에 있어야 합니다. 명령을 실행하는 사람이나 구성 관리자의 사용자 ID가 이 파일에 액세스하여 읽을 수 있으면 BAR 파일은 어느 위치에나 있을 수 있습니다.

-t
(선택사항) 모든 토픽 구성 정보를 전개합니다. 도메인의 모든 브로커로 정보가 전개됩니다.
-l
(선택사항) 이 플래그는 토폴로지 구성을 전개하도록 지정합니다. -m 플래그도 설정하면 도메인의 모든 브로커로 정보가 전개됩니다. 그렇지 않으면 변경된 토폴로지 구성이 있는 브로커에만 정보가 전개됩니다.
-c
(선택사항) 구성 관리자에서 이전에 전송된 전개 요청에 대한 응답 대기를 정지하도록 지시합니다. -b 옵션으로 사용된 경우 구성 관리자에서 지정된 브로커의 미해결 전개 응답 대기를 정지하고 -b 옵션이 없는 경우 구성 관리자에서 도메인의 모든 미해결 전개 요청에 대한 응답 대기를 정지합니다.

-c 옵션을 주의하여 지정해야 합니다. 영향을 받는 브로커가 전개 요청에 반응할 가능성이 없는 경우에만 사용하고 이후에 브로커가 취소된 전개 요청을 처리하는 경우 구성 관리자에서 응답을 무시하므로 브로커에 대한 동기화가 해제됩니다.

-w timeoutValue
(선택사항) 제어를 명령행으로 리턴하기 전에 유틸리티가 브로커의 응답을 기다리는 시간(초 단위). mqsideploy 명령은 송신된 전개 요청의 결과를 찾는 구성 관리자의 로그 레코드를 폴링합니다. 관련 로그 레코드에 전개의 성공 여부를 나타내는 정보가 포함됩니다. timeoutValue는 시간 종료 전에 대기해야 하는 초 수로, 범위는 1 - 999 999입니다. timeoutValue를 제공하지 않거나, 값이 1보다 작거나 999 999보다 크면 오류가 리턴됩니다.
-d DeployedObjects
(선택사항) 실행 그룹에서 제거할 오브젝트 세트를 설명합니다. 여러 전개 파일은 ":" 문자로 분리하여 지정할 수 있습니다.

모호한 오브젝트 이름이 지정되면(예를 들면, "top.dictionary"와 "top.cmf"가 모두 동일한 실행 그룹에 전개되면 "top") BIP1089 메시지와 함께 전체 명령이 실패한다는 제한사항과 함께 모든 유형의 오브젝트를 지정할 수 있습니다. 이 경우 제거할 오브젝트의 완전한 이름이 지정되어야 합니다(예: "top.dictionary:top.cmf").

-v TraceFileName
(선택사항) 내부 구성 관리자 프록시 디버깅 추적을 지정된 파일로 송신합니다.
-m -complete
(선택사항) 다음과 같은 완전한 정보를 전개합니다.
  • BAR 파일 전개의 경우, -m은 전개의 일부로 현재 전개된 모든 메시지 플로우 및 메시지 세트를 실행 그룹에서 제거합니다. -m을 설정하지 않으면 실행 그룹에서 이미 전개된 내용 이외에 BAR 파일의 컨텐츠도 전개됩니다. 이 경우, BAR 파일 내의 항목과 같은 이름으로 전개된 오브젝트가 BAR 내에 있는 버전으로 대체됩니다.
  • 토폴로지 구성 전개의 경우 -m은 완전한 브로커 간 구성 정보를 모든 브로커로 전개합니다. -m을 설정하지 않으면 변경된 브로커 간 구성 정보만 브로커 간 구성이 변경된 브로커로 전개됩니다.
  • 브로커 구성 전개의 경우 이 플래그는 올바르지 않습니다.
  • 토픽 트리 전개의 경우, -m은 전체 토픽 트리를 모든 브로커로 전개합니다. -m을 설정하지 않으면 토픽 트리의 변경사항만 모든 브로커로 전개됩니다.
  • 메시지 플로우 제거 또는 메시지 세트 제거 조작에서는 플래그가 무시됩니다.

권한 부여

전개하려면 명령을 발행하는 사용자 ID에 구성 관리자에서 정의된 충분한 권한이 있어야 합니다. 필요한 권한은 Message Brokers Toolkit에서 해당 기능을 수행하는 데 필요한 권한과 동일합니다. 구성 관리자에서 정의할 수 있는 권한 목록의 경우 ACL 사용권한을 참조하십시오.

응답

이 명령은 다음 응답을 리턴합니다.
0
(Success) 구성 관리자에서 전개 요청을 발행하고 시간 종료되기 전에 모든 관련 브로커에서 성공적으로 응답한 상태.
2
(Failure) 구성 관리자에서 전개 요청을 발행하고 하나 이상의 브로커에서 부정적으로 응답한 경우. 자세한 정보는 유틸리티에서 출력된 메시지(또는 구성 관리자의 이벤트 로그)를 참조하십시오.
3
(Initiated) 구성 관리자에서 응답하면서 전개가 시작되었지만 시간이 종료되기 전에 브로커 응답이 수신되지 않았음을 표시하는 상태.
5
(Submitted) 전개 메시지가 구성 관리자로 송신되었지만 시간이 종료되기 전에 응답이 수신되지 않은 상태.
6
(SuccessSoFar) 구성 관리자에서 전개 요청을 발행하고 시간이 종료되기 전에 모든 관련 브로커에서 성공적으로 응답하지는 않고 부정적으로 응답한 브로커가 없는 상태.
98
구성 관리자에 도달할 수 없는 상태.
99
유틸리티에 제공된 인수가 유효하지 않은 상태.

파일 cm1.configmgr에 매개변수가 설명된 연결 파일을 사용하여 Publish/Subscribe 이웃을 전개하고 10분 동안 브로커가 응답하도록 허용한 후 전체 브로커 간 구성 정보를 전개하십시오.
mqsideploy -n cm1.configmgr -m -w 600 
i, pq 매개변수를 사용하여 Publish/Subscribe 이웃을 전개하여 구성 관리자에 연결하고 10분 동안 브로커가 응답하도록 허용한 후 전체 브로커 간 구성 정보를 전개하십시오.
mqsideploy -i localhost -p 1414 -q QMNAME -m -w 600 

다음 예에서는 -n 매개변수 대신 i, pq 매개변수를 사용할 수 있습니다.

파일 cm1.configmgr에 매개변수가 설명된 연결 파일을 사용하여 토픽 계층을 전개하고 10분 동안 브로커가 응답하도록 허용한 후 전체 브로커 간 구성 정보를 전개하십시오.
mqsideploy -n cm1.configmgr -t -m -w 600 
파일 cm1.configmgr에 매개변수가 설명된 연결 파일을 사용하여 BAR 파일을 전개하고 10분 동안 브로커가 응답하도 록 허용한 후 현재 전개된 모든 메시지 플로우 및 메시지 세트를 전개의 일부로 실행 그룹에서 제거하십시오.
mqsideploy -n cm1.configmgr -b broker1 -e default -a mybar.bar -m -w 600 
파일 cm1.configmgr에 매개변수가 설명된 연결 파일을 사용하여 브로커 구성을 지정된 브로커에 전개하고 15분 동안 브로커가 응답하도록 허용하십시오.
mqsideploy -n cm1.configmgr -b broker1 -w 900 

파일 cm1.configmgr에서 매개변수가 설명된 연결 파일을 사용하여 브로커 b1의 실행 그룹 default에서 메시지 플로우 top 및 사전 bar를 제거해 보십시오.

topbar이라는 다른 오브젝트가 실행 그룹에 전개되지 않은 경우 -d 옵션의 값을 top:bar로 축약할 수 있습니다.
   mqsideploy –n cm1.configmgr –b B1 –e default –d top.cmf:bar.dictionary
파일 cm1.configmgr에 매개변수가 설명된 연결 파일을 사용하여 전개를 취소하고 15분 동안 브로커가 응답하도록 허용하십시오. 이 예에서는 구성 관리자가 도메인에서 모든 미해결 전개 요청에 대한 대기를 중지합니다. 전개를 취소할 특정 브로커를 지정하려면 -b 매개변수를 사용하십시오.
mqsideploy -n cm1.configmgr -c -w 900 
관련 개념
런타임 환경
관련 태스크
전개
주의사항 | 등록상표 | 다운로드 | 라이브러리 | 지원 | 피드백
Copyright IBM Corporation 1999, 2006 마지막 갱신 날짜: 2006/08/21
an09020_