mqsideploy 명령

지원되는 플랫폼

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

목적

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

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

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

구문

주: 명령 플래그는 이전 버전의 mqsideploy에서 사용된 명령 플래그와 서로 다릅니다. Windows 플랫폼에서 이전 버전에서와 같은 명령을 사용하려면 mqsideploy.bat 명령을 사용하십시오.

매개변수

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

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

-w timeoutValue
(선택사항) 제어를 명령행으로 리턴하기 전에 유틸리티가 브로커의 응답을 기다리는 시간(초 단위). mqsideploy 명령은 송신된 전개 요청의 결과를 찾는 구성 관리자의 로그 레코드를 폴링합니다. 관련 로그 레코드에 전개의 성공 여부를 나타내는 정보가 포함됩니다. timeoutValue는 시간 종료 전에 대기해야 하는 초 수로, 범위는 1 - 999 999입니다. timeoutValue를 제공하지 않거나, 값이 1보다 작거나 999 999보다 크면 오류가 리턴됩니다.
-d DeployedObjects
(선택사항) 실행 그룹에서 제거할 오브젝트 세트를 설명합니다. 여러 전개 파일은 ":" 문자로 분리하여 지정할 수 있습니다.
모든 유형의 오브젝트는 다음의 제한사항으로 지정할 수 있습니다.
  1. 메시지 플로우 및 메시지 세트는 명령이 연결된 구성 관리자이 버전 6이 아닌 경우에만 지정될 수 있습니다.
  2. 예를 들어, 버전 6.0 구성 관리자에 연결된 경우 XSL 파일을 제거하면 "object not found"라는 유형 오류가 보고됩니다.
  3. 모호한 오브젝트 이름이 지정되면(예를 들어, "top.dictionary"와 "top.cmf"가 모두 동일한 실행 그룹에 전개되면 "top") BIP1089 메시지와 함께 전체 명령이 실패합니다. 이 경우 제거할 오브젝트의 완전한 이름이 지정되어야 합니다(예: "top.dictionary:top.cmf").
-v TraceFileName
(선택사항) 내부 구성 관리자 프록시 디버깅 추적을 지정된 파일로 송신합니다.
-m -complete
(선택사항) 다음과 같은 완전한 정보를 전개합니다.
  • BAR 파일 전개의 경우, -m은 전개의 일부로 현재 전개된 모든 메시지 플로우 및 메시지 세트를 실행 그룹에서 제거합니다. -m을 설정하지 않으면 실행 그룹에서 이미 전개된 내용 이외에 BAR 파일의 컨텐츠도 전개됩니다. 이 경우, BAR 파일 내의 항목과 같은 이름으로 전개된 오브젝트가 BAR 내에 있는 버전으로 대체됩니다.
  • 토폴로지 구성 전개의 경우 -m은 완전한 브로커 간 구성 정보를 모든 브로커로 전개합니다. -m을 설정하지 않으면 변경된 브로커 간 구성 정보만 브로커 간 구성이 변경된 브로커로 전개됩니다.
  • 브로커 전개의 경우, -m은 모든 브로커의 사용 가능한 구성 속성(예: 멀티캐스트 매개변수)을 지정된 브로커로 전개합니다. -m을 설정하지 않으면 변경된 구성 속성만 전개됩니다.
  • 토픽 트리 전개의 경우 -m은 전체 토픽 트리를 모든 브로커로 전개합니다. -m을 설정하지 않으면 토픽 트리의 변경사항만 모든 브로커로 전개됩니다.
  • 메시지 플로우 제거 또는 메시지 세트 제거 조작에서는 플래그가 무시됩니다.

권한 부여

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

응답

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

cm1.configmgr 파일에서 연결 매개변수가 설명된 구성 관리자에 연결하고 b1 브로커의 default 실행 그룹에서 메시지 플로우 top 및 사전 bar을 제거하십시오.

topbar이라는 다른 오브젝트가 실행 그룹에 전개되지 않은 경우 -d 옵션의 값을 top:bar로 축약할 수 있습니다.

   mqsideploy –n cm1.configmgr –b B1 –e default –d top.cmf:bar.dictionary
관련 개념
런타임 환경
관련 작업
전개
주의사항 | 등록상표 | 다운로드 | 라이브러리 | 지원 | 피드백
Copyright IBM Corporation 1999, 2005 마지막 갱신 날짜: 11/08/2005
an09020_