Comando mqsimigratecomponents

Plataformas Suportadas

  • Windows
  • Sistemas Linux e UNIX
  • z/OS

Finalidade

O comando mqsimigratecomponents move um ou mais componentes de uma versão instalada anteriormente (apenas Versão 2.1 ou Versão 5) do produto para outra.Esse comando deve ser executado a partir da versão mais recente do produto instalado; quer seja a origem ou o destino.
Nota:
  1. Para a Versão 2.1 do produto, a Versão 2.1.0.8 é o release mais antigo do produto suportado.
  2. Para a Versão 5 do produto, a Versão 5.0.0.4 é o release mais antigo do produto suportado .
  3. Os parâmetros -t e -s podem aceitar números de versões no formato Version.Release.Modification.Fixpack, por exemplo, 5.0.0.4, e também podem aceitar "5" e "2.1" como um formato abreviado para as versões anteriores que são suportadas.

Você deve ter uma instalação na Versão 6.0 do produto com o código do componente requerido instalado, ou seja, o componente intermediário é instalado, se necessário, e assim por diante.

Antes de iniciar a migração, pare as sessões de depuração no Centro de Controle. Não é possível migrar fluxos de mensagens que estão sendo depurados.

Você pode chamar o comando com várias opções para desempenhar uma das seguintes ações:
  • Verificar em um ou mais componentes, sem fazer alterações, para assegurar que os componentes sejam adequados para a migração requerida.
  • Mover um ou mais componentes para uma versão diferente, total ou parcialmente.
  • Desfazer, ou seja, reverter uma movimentação bem-sucedida de uma versão para outra, total ou parcialmente.
  • Verificar se uma movimentação foi bem-sucedida.

Sintaxe

Parâmetros

-c
(Opcional) Execute uma verificação de pré-migração dos componentes especificados para assegurar o seguinte:
  • Se mais de um componente intermediário for especificado, os intermediários compartilharão um esquema do banco de dados.
  • Em todos os casos, um esquema de banco de dados do intermediário de migração não pode ser compartilhado com um intermediário que não esteja sendo migrado ao mesmo tempo.
  • A versão detectada automaticamente do intermediário corresponde a qualquer versão especificada na linha de comandos.
  • Não haverá grupos de execução de 64 bits, se estiver migrando da Versão 6.0 para um release anterior.
  • As tabelas de banco de dados a serem copiadas de um release anterior não contêm linhas que violam requisitos de índice da Versão 6.0:
    • A varredura em todas as linhas é o modo mais fácil.
    • O bloqueio global será obtido se o intermediário for Versão 2.1

A verificação de migração pode ser executada para um componente, ou conjunto de componentes, em execução. Isso não impacta os componentes, exceto que causa uma pequena perda de desempenho. Observe que, em sistemas UNIX, o arquivo odbc.ini precisa ser migrado (ou seja, um arquivo odbc.ini de novo formato precisa ser criado com o mesmo conjunto de origens de dados que o antigo) antes da verificação ser executada, pois o comando de verificação precisa ser capaz de acessar o banco de dados do intermediário.

O comando de verificação obtém êxito ou falha e imprime uma mensagem sobre se a migração deverá ou não obter êxito, mas nenhuma modificação é feita durante o processo.

-v
(Opcional) Execute uma verificação de pós-migração dos componentes especificados para assegurar o seguinte:
  • As tabelas de banco de dados e as filas corretas existem para a versão especificada.
  • O registro está no formato correto para a versão especificada.
-q
(Opcional) Imprime menos mensagens de status durante a operação.
-1
(Opcional) Execute somente trabalho do registro e do sistema de arquivo. Utilize o parâmetro -1 antes dos parâmetros -2 ou -3.
-2
(Opcional) Executa somente trabalho do WebSphere MQ.
-3
(Opcional) Executa somente trabalho do banco de dados.
-u
(Opcional) Desfaz uma etapa de migração com falha; você também deve especificar pelo menos -1, -2 ou -3. Essa opção deverá ser utilizada somente quando a migração tiver falhado e sua recuperação automática também tiver falhado (por exemplo, uma falha durante a migração dividida).
-sSource Version
(Opcional) A versão anterior do componente. O valor é detectado automaticamente, se não especificado. Consulte Finalidade para obter as restrições para os números de versão do produto que são suportados.
-tTarget Version
(Opcional) A versão de destino do componente. Esse valor é assumido como a versão atual, se não especificado. Consulte Finalidade para obter as restrições para os números de versão do produto que são suportados.
Nome do Componente
(Obrigatório) O nome do componente a ser migrado; pelo menos um deve ser especificado.

Autorização

Ao executar uma migração de etapa única, o ID do usuário utilizado para invocar esse comando deve ter a capacidade para:
  • Gravar no registro do produto
  • Modificar bancos de dados associados aos componentes
  • Modificar definições de filas
Para uma migração dividida, o ID do usuário para invocar esse comando deve sempre ter a capacidade para ler o registro do produto e também ter autorização específica para que cada etapa obtenha êxito:
  • -1 requer a capacidade para modificar definições de filas
  • -2 requer a capacidade para gravar no registro do produto
  • -3 requer a capacidade para modificar bancos de dados associados aos componentes

Respostas

Esse comando pode produzir um grande número de respostas possíveis, dependendo dos resultados das diversas operações. Observe que esse comando difere de outros comandos quanto ao modo de produzir mensagens - elas são exibidas conforme necessário, em vez de serem produzidas em um batch no final do programa.

Exemplos

O exemplo a seguir verifica a migração de BROKER1 da V2.1 para a Versão 6.0:

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.

O exemplo a seguir faz a migração automática de BROKER1 da V2.1 para a Versão 6.0:

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.

O exemplo a seguir é uma repetição do exemplo anterior, mas com o sinalizador -q especificado:

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.
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2005 Última Atualização: 07/11/2005
an26150_