mqsimigratecomponents 명령

지원되는 플랫폼

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

목적

mqsimigratecomponents 명령은 제품의 이전에 설치된 한 버전(버전 2.1 또는 버전 5 전용)에서 다른 버전으로 하나 이상의 구성요소를 이동합니다. 이 명령은 소스 또는 목적지인지 여부에 따라 반드시 나중에 설치된 제품의 버전에서 실행되어야 합니다.
주:
  1. 버전 2.1 제품의 경우 버전 2.1.0.8 릴리스부터 지원됩니다.
  2. 버전 5 제품의 경우 버전 5.0.0.4 릴리스부터 지원됩니다.
  3. -t-s 매개변수는 Version.Release.Modification.Fixpack 양식(예: 5.0.0.4)으로 버전 번호를 승인할 수 있으며, 지원되는 이전 버전의 단축 양식으로 "5" 및 "2.1"을 승인할 수도 있습니다.

필수 구성요소 코드가 있는 제품의 버전 6.0 설치가 설치되어 있어야 합니다. 즉, 필요한 경우 브로커 구성요소가 설치됩니다.

이주를 시작하기 전에 제어 센터의 디버깅 세션을 정지하십시오. 디버그 중인 메시지 플로우를 이주할 수는 없습니다.

다양한 옵션을 사용하여 명령을 호출하여 다음 조치 중 하나를 수행할 수 있습니다.
  • 변경사항을 작성하지 않고 하나 이상의 구성요소를 점검하여 구성요소가 필수 이주에 적합한지 확인.
  • 하나 이상의 구성요소를 전체 또는 부분적으로 다른 버전으로 이동.
  • 한 버전에서 다른 버전으로의 전체 또는 부분적 이동을 실행 취소 즉, 취소.
  • 성공적으로 이동되었는지 확인.

구문

매개변수

-c
(선택사항) 지정된 구성요소의 이주 전 점검을 수행하여 다음 사항을 확인하십시오.
  • 둘 이상의 브로커 구성요소가 지정되는 경우 브로커가 데이터베이스 스키마를 공유합니다.
  • 모든 경우 이주하는 데이터베이스 스키마는 동시에 이주되지 않는 브로커와 공유할 수 없습니다.
  • 브로커의 자동 발견 버전은 명령행에서 지정된 버전과 일치합니다.
  • 버전 6.0에서 이전 릴리스로 이주하는 경우 64비트 실행 그룹이 없습니다.
  • 이전 릴리스에서 복사할 데이터베이스 테이블에는 버전 6.0 색인 요구사항을 위반하는 행이 포함되지 않습니다.
    • 모든 행을 스캔하는 것이 가장 쉬운 방법입니다.
    • 브로커가 버전 2.1인 경우 전역 잠금이 수행됩니다.

이주 점검은 실행 중인 구성요소나 구성요소 세트에 대해 실행할 수 있습니다. 이는 약간의 성능 손실을 제외하고는 구성요소에 영향을 주지 않습니다. UNIX 시스템에서 점검 명령이 브로커 데이터베이스에 액세스할 수 있어야 하므로 점검을 실행하기 전에 odbc.ini 파일을 병합해야 합니다(즉, 기존의 것과 동일한 데이터 소스 세트로 새 형식 odbc.ini 파일을 작성해야 함).

점검 명령이 성공하거나 실패하고, 이주가 성공하는지 여부에 대한 메시지를 인쇄하지만 프로세스 중 수정사항이 작성되지 않습니다.

-v
(선택사항) 지정된 구성요소의 이주 후 점검을 수행하여 다음 사항을 확인하십시오.
  • 지정된 버전에 대한 올바른 데이터베이스 테이블 및 큐가 존재합니다.
  • 레지스트리가 지정된 버전에 대한 올바른 형식으로 되어 있습니다.
-q
(선택사항) 조작 중 더 적은 상태 메시지를 인쇄합니다.
-1
(선택사항) 레지스트리와 파일 시스템 작업만 수행합니다. -2 또는 -3 매개변수 앞에 -1 매개변수를 사용하십시오.
-2
(선택사항) WebSphere MQ 작업만 수행합니다.
-3
(선택사항) 데이터베이스 작업만 수행합니다.
-u
(선택사항) 실패한 이주 단계를 실행 취소합니다. 또한 -1, -2 또는 -3 중 하나 이상을 지정해야 합니다. 이주에 실패하고 자동 복구에도 실패한 경우에만 이 옵션을 사용합니다(예: 분할 이주 중 실패).
-sSource Version
(선택사항) 구성요소의 이전 버전. 이 값이 지정되지 않는 경우 자동으로 감지됩니다. 지원되는 제품의 버전 번호에 대한 제한사항은 목적을 참조하십시오.
-tTarget Version
(선택사항) 구성요소의 목적지 버전. 이 값은 지정되지 않는 경우 현재 버전으로 가정됩니다. 지원되는 제품의 버전 번호에 대한 제한사항은 목적을 참조하십시오.
구성요소 이름
(필수) 이주할 구성요소의 이름. 하나 이상을 지정해야 합니다.

권한 부여

단일 단계 이주를 실행할 때 이 명령을 호출하는 데 사용된 사용자 ID에는 다음과 같은 기능이 있어야 합니다.
  • 제품에 대한 레지스트리에 기록
  • 구성요소와 연관된 데이터베이스 수정
  • 큐 정의 수정
분할 이주의 경우 이 명령을 호출하는 데 사용된 사용자 ID에는 항상 제품에 대한 레지스트리에서 읽을 수 있는 권한이 있으며, 각 단계를 완료하기 위한 특정 권한도 있습니다.
  • -1에는 큐 정의를 수정하는 기능이 필요합니다.
  • -2에는 제품에 대한 레지스트리에 기록하는 기능이 필요합니다.
  • -3에는 구성요소와 연관된 데이터베이스를 수정하는 기능이 필요합니다.

응답

이 명령은 다양한 조작의 결과에 따라 가능한 많은 수의 응답을 생성할 수 있습니다. 이 명령은 메시지를 생성하는 방법에서 다른 명령과 다름에 유의하십시오. 프로그램 끝에 배치로 생성되지 않고 필요한 대로 표시됩니다.

다음 예는 V2.1에서 버전 6.0으로의 BROKER1의 이주를 점검합니다.

mqsimigratecomponents –c BROKER1
BIP 0001I: Starting migration check for component ‘BROKER1’ to FAD level ‘3’
BIP 0002I: ‘BROKER1’ is version 2.1 (auto-detected)
BIP 0003I: Broker database ‘BKRDB’ and schema ‘WMQIUSER’ are not shared with other components.
BIP 0004I: No invalid rows found in broker database.
BIP 0005I: Migration check passed.
BIP 8071I: Successful command completion.

다음 예는 V2.1에서 버전 6.0으로의 BROKER1의 자동 이주를 수행합니다.

mqsimigratecomponents BROKER1
BIP 0001I: Starting migration check for component ‘BROKER1’ to FAD level ‘3’
BIP 0002I: ‘BROKER1’ is version 2.1 (auto-detected)
BIP 0003I: Broker database ‘BKRDB’ and schema ‘WMQIUSER’ are not shared with other components.
BIP 0004I: No invalid rows found in broker database.
BIP 0005I: Migration check passed.
BIP 0020I: Starting registry migration for component ‘BROKER1’.
BIP 0021I: Created top-level ‘CurrentVersion’ key
BIP 0021I: Created ‘DSN’ subkey
BIP 0022I: Created ‘HTTPListener’ subkey
BIP 0023I: Created ‘HTTPListener.HTTPConnector’ subkey
BIP 0024I: Created ‘FADLevel’ value; set to ‘3’
BIP 0025I: Created ‘converters’ value; set to ‘’
BIP 0028I: Moving registry data into ‘CurrentVersion’.
BIP 0029I: Moved value ‘AdminAgentPID’.
[repeat for each value]
BIP 0030I: Completed moving registry data into ‘CurrentVersion’.
BIP 0025I: Finished registry migration for component ‘BROKER1’.
BIP 0011I: Starting database table migration for ‘BKRDB’.’WMQIUSER’.
BIP 0012I: Moving table ’BROKERRESOURCES’ to ’somethingBROKERRESOURCES’.
BIP 0013I: Creating new table ’BROKERRESOURCES’.
BIP 0014I: Copying data from ‘somethingBROKERRESOURCES’ to ’BROKERRESOURCES’.
BIP 0015I: Successfully copied all data (322 rows).
 [repeat for each table]
BIP 0016I: Finished database table migration for ‘BKRDB’.’WMQIUSER’.
BIP 0017I: Starting queue migration for ‘BKRQM’.
BIP 0018I: Creating new queue ‘SYSTEM.BROKER.AGGR.CONTROL’.
BIP 0018I: Creating new queue ‘SYSTEM.BROKER.AGGR.REPLY’.
BIP 0018I: Creating new queue ‘SYSTEM.BROKER.AGGR.REQUEST’.
BIP 0018I: Creating new queue ‘SYSTEM.BROKER.AGGR.TIMEOUT’.
BIP 0018I: Creating new queue ‘SYSTEM.BROKER.AGGR.UNKNOWN’.
BIP 0018I: Creating new queue ‘SYSTEM.BROKER.INTERBROKER.MODEL.QUEUE’.
BIP 0018I: Creating new queue ‘SYSTEM.BROKER.TIMEOUT.QUEUE’.
BIP 0018I: Creating new queue ‘SYSTEM.BROKER.WS.ACK’.
BIP 0018I: Creating new queue ‘SYSTEM.BROKER.WS.INPUT’.
BIP 0018I: Creating new queue ‘SYSTEM.BROKER.WS.REPLY’.
BIP 0026I: Clearing queue ‘SYSTEM.BROKER.ADMIN.QUEUE’.
BIP 0026I: Clearing queue ‘SYSTEM.BROKER.EXECUTIONGROUP.QUEUE’.
BIP 0026I: Clearing queue ‘SYSTEM.BROKER.EXECUTIONGROUP.REPLY’.
BIP 0026I: Clearing queue ‘SYSTEM.BROKER.IPC.QUEUE’.
BIP 0019I: Finished queue migration for ‘BKRQM’.
BIP 0005I: Migration succeeded for component ‘BROKER1’.
BIP 8071I: Successful command completion.

다음 예는 이전 예의 반복이지만 -q 플래그가 지정되어 있습니다.

mqsimigratecomponents -q BROKER1
BIP 0001I: Starting migration check for component ‘BROKER1’ to FAD level ‘3’
BIP 0002I: ‘BROKER1’ is version 2.1 (auto-detected)
BIP 0005I: Migration check passed.
BIP 0020I: Starting registry migration for component ‘BROKER1’.
BIP 0025I: Finished registry migration for component ‘BROKER1’.
BIP 0011I: Starting database table migration for ‘BKRDB’.’WMQIUSER’.
BIP 0016I: Finished database table migration for ‘BKRDB’.’WMQIUSER’.
BIP 0017I: Starting queue migration for ‘BKRQM’.
BIP 0019I: Finished queue migration for ‘BKRQM’.
BIP 0005I: Migration succeeded for component ‘BROKER1’.
BIP 8071I: Successful command completion.
주의사항 | 등록상표 | 다운로드 | 라이브러리 | 지원 | 피드백
Copyright IBM Corporation 1999, 2005 마지막 갱신 날짜: 11/07/2005
an26150_